Keysight Technologies 6811C Programming Manual

Notices Copyright Notice © Keysight Technologies 2017 No part of this manual may be repro- duced in any form or by any means (including electronic storage and retrieval or translation into a foreign language) without prior agreement and written consent from Keysight Technol- ogies as governed by United States and international copyright laws. Manual Part Number 06811-90005 Edition Edition 1, October 2, 2017 Printed in: Printed in Malaysia Published by: Keysight Technologies Bayan Lepas Free Industrial Zone, 11900 Penang, Malaysia Technology Licenses The hardware and/or software described in this document are fur- nished under a license and may be used or copied only in accordance with the terms of such license. Declaration of Conformity Declarations of Conformity for this product and for other Keysight prod- ucts may be downloaded from the Web. Go to http://www.keysight.com/ go/conformity. You can then search by product number to find the latest Dec- laration of Conformity. U.S. Government Rights The Software is “commercial computer software,” as defined by Federal Acqui- sition Regulation (“FAR”) 2.101. Pursu- ant to FAR 12.212 and 27.405-3 and Department of Defense FAR Supple- ment (“DFARS”) 227.7202, the U.S. government acquires commercial com- puter software under the same terms by which the software is customarily provided to the public. Accordingly, Keysight provides the Software to U.S. government customers under its stan- dard commercial license, which is embodied in its End User License Agreement (EULA), a copy of which can be found at http://www.keysight.com/ find/sweula. The license set forth in the EULA represents the exclusive authority by which the U.S. government may use, modify, distribute, or disclose the Soft- ware. The EULA and the license set forth therein, does not require or per- mit, among other things, that Keysight: (1) Furnish technical information related to commercial computer soft- ware or commercial computer software documentation that is not customarily provided to the public; or (2) Relinquish to, or otherwise provide, the govern- ment rights in excess of these rights customarily provided to the public to use, modify, reproduce, release, per- form, display, or disclose commercial computer software or commercial com- puter software documentation. No additional government requirements beyond those set forth in the EULA shall apply, except to the extent that those terms, rights, or licenses are explicitly required from all providers of commercial computer software pursu- ant to the FAR and the DFARS and are set forth specifically in writing else- where in the EULA. Keysight shall be under no obligation to update, revise or otherwise modify the Software. With respect to any technical data as defined by FAR 2.101, pursuant to FAR 12.211 and 27.404.2 and DFARS 227.7102, the U.S. government acquires no greater than Limited Rights as defined in FAR 27.401 or DFAR 227.7103-5 (c), as applicable in any technical data. Warranty THE MATERIAL CONTAINED IN THIS DOCUMENT IS PROVIDED “AS IS,” AND IS SUBJECT TO BEING CHANGED, WITHOUT NOTICE, IN FUTURE EDITIONS. FURTHER, TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, KEYSIGHT DIS- CLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, WITH REGARD TO THIS MANUAL AND ANY INFORMA- TION CONTAINED HEREIN, INCLUD- ING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MER- CHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. KEYSIGHT SHALL NOT BE LIABLE FOR ERRORS OR FOR INCIDENTAL OR CONSE- QUENTIAL DAMAGES IN CONNECTION WITH THE FURNISHING, USE, OR PERFORMANCE OF THIS DOCUMENT OR OF ANY INFORMATION CON- TAINED HEREIN. SHOULD KEYSIGHT AND THE USER HAVE A SEPARATE WRITTEN AGREEMENT WITH WAR- RANTY TERMS COVERING THE MATE- RIAL IN THIS DOCUMENT THAT CONFLICT WITH THESE TERMS, THE WARRANTY TERMS IN THE SEPARATE AGREEMENT SHALL CONTROL.

3 Safety Information CAUTION A CAUTION notice denotes a hazard. It calls attention to an operating procedure, practice, or the like that, if not correctly performed or adhered to, could result in damage to the product or loss of important data. Do not proceed beyond a CAUTION notice until the indicated conditions are fully understood and met. La mention ATTENTION signale un danger. Si la manoeuvre ou la procédure correspondante n’est pas exécutée correctement, il peut y avoir un risque d’endommagement de l’appareil ou de perte de données importantes. En présence de la mention ATTENTION, il convient de ne pas poursuivre tant que les conditions indiquées n’ont pas été parfaitement comprises et remplies. WARNING A WARNING notice denotes a hazard. It calls attention to an operating procedure, practice, or the like that, if not correctly performed or adhered to, could result in personal injury or death. Do not proceed beyond a WARNING notice until the indicated conditions are fully understood and met. La mention AVERTISSEMENT signale un danger pour la sécurité de l’opérateur. Si la manoeuvre ou la procédure correspondante n’est pas exécutée correctement, il peut y avoir un risque grave, voire mortel pour les personnes. En présence d’une mention AVERTISSEMENT, il convient de s’interrompre tant que les conditions indiquées n’ont pas été parfaitement comprises et satisfaites.

Safety Considerations Read the information below before using this instrument. The following general safety precautions must be observed during all phases of operation, service, and repair of this instrument. Failure to comply with these precautions or with specific warnings elsewhere in this guide violates safety standards for design, manufacture, and intended use of the instrument. Keysight Technologies assumes no liability for the customer’s failure to comply with these requirements. WARNING ENERGY HAZARD. AC sources can supply 425 V peak at their output. DEATH on contact may result if the output terminals or circuits connected to the output are touched when power is applied. RISQUE ÉNERGÉTIQUE. Les sources AC peuvent fournir une tension de sortie de 425 V maximum. Tout contact peut entraîner la MORT si les circuits ou bornes de sortie connectés à la sortie sont touchés lorsqu’ils sont sous tension.

5 Waste Electrical and Electronic Equipment (WEEE) Directive This instrument complies with the WEEE Directive marking requirement. This affixed product label indicates that you must not discard this electrical or electronic product in domestic household waste. Product category: With reference to the equipment types in the WEEE directive Annex 1, this instrument is classified as a “Monitoring and Control Instrument” product. The affixed product label is as shown below. Do not dispose in domestic household waste. To return this unwanted instrument, contact your nearest Keysight Service Center, or visit http://about.keysight.com/en/companyinfo/environment/takeback.shtml for more information. Sales and Technical Support To contact Keysight for sales and technical support, refer to the support links on the following Keysight websites: – www.keysight.com/find/6800 (product-specific information and support, software and documentation updates) – www.keysight.com/find/assist (worldwide contact information for repair and service)

THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK. all-guides.co m

7 Table of Contents Safety Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 Safety Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 Waste Electrical and Electronic Equipment (WEEE) Directive . . . . . . . .5 Product category: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 Sales and Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 1 General Information About this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24 Documentation summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24 External References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25 SCPI references . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25 GPIB references . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25 Keysight IO Libraries Suite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26 2 Introduction to Programming Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28 USB Capabilities of the AC Source . . . . . . . . . . . . . . . . . . . . . . . . . . . .29 Vendor Identification (VID) and Product Identification (PID) . . . . . .29 LAN Capabilities of the AC Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30 Instrument Web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30 GPIB Capabilities of the AC Source . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 GPIB address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 RS-232 Capabilities of the AC Source . . . . . . . . . . . . . . . . . . . . . . . . . .32 RS-232 data format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32 Baud rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32 RS-232 Programming Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33 RS-232 troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34 Introduction to SCPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35 Conventions used in this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35 Types of SCPI commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36

Types of SCPI messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 The SCPI Command Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 The root level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Active header path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 The effect of optional headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Moving among subsystems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Including common commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Using queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Coupled commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Structure of a SCPI Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 The message unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Combining message units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Query indicator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Message unit separator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Root specifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Message terminator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 SCPI Data Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Numerical data formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Suffixes and multipliers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Character data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 System Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Assigning the GPIB address in programs . . . . . . . . . . . . . . . . . . . . . 49 Types of DOS drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Error handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Keysight BASIC controllers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 3 Language Dictionary Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Subsystem Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 Calibration Subsystem Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 CALibrate:COUNt? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 CALibrate:CURRent:AC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

9 CALibrate:CURRent:EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59 CALibrate:CURRent:MEASure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59 CALibrate:DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60 CALibrate:DATA? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60 CALibrate:DATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61 CALibrate:IMPedance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61 CALibrate:LEVel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62 CALibrate:PASSword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62 CALibrate:PHASe:AUXiliary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63 CALibrate:PWM:FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63 CALibrate:PWM:RAMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64 CALibrate:SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64 CALibrate:SECure:CODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65 CALibrate:SECure:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66 CALibrate:SHUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67 CALibrate:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68 CALibrate:STRing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69 CALibrate:VOLTage:AC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69 CALibrate:VOLTage:AUXiliary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70 CALibrate:VOLTage:DC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70 CALibrate:VOLTage:EXTernal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70 CALibrate:VOLTage:OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71 CALibrate:VOLTage:PROTection . . . . . . . . . . . . . . . . . . . . . . . . . . . .71 Display Subsystem Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72 DISPlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72 DISPlay:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73 DISPlay:TEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73 DISPlay:TEXT:CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73 LXI Subsystem Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74 LXI:IDENtify[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74 LXI:MDNS[:STATe] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75 LXI:MDNS:ENABle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75 LXI:MDNS:HNAMe[:RESolved]? . . . . . . . . . . . . . . . . . . . . . . . . . . . .76 LXI:MDNS:SNAMe:DESired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76

LXI:MDNS:SNAMe[:RESolved]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 LXI:RESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 LXI:RESTart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Measurement Subsystem (Arrays) Commands . . . . . . . . . . . . . . . . . . . 78 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 MEASure:ARRay:CURRent? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 MEASure:ARRay:CURRent:HARMonic? . . . . . . . . . . . . . . . . . . . . . . 80 MEASure:ARRay:CURRent:HARMonic:PHASe? . . . . . . . . . . . . . . . . 81 MEASure:ARRay:VOLTage? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 MEASure:ARRay:VOLTage:HARMonic? . . . . . . . . . . . . . . . . . . . . . . 83 MEASure:ARRay:VOLTage:HARMonic:PHASe? . . . . . . . . . . . . . . . . 84 Measurement Subsystem (Current) Commands . . . . . . . . . . . . . . . . . . 85 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 MEASure:CURRent? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 MEASure:CURRent:AC? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 MEASure:CURRent:ACDC? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 MEASure:CURRent:AMPLitude:MAXimum? . . . . . . . . . . . . . . . . . . . 87 MEASure:CURRent:CREStfactor? . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 MEASure:CURRent:HARMonic? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 MEASure:CURRent:HARMonic:PHASe? . . . . . . . . . . . . . . . . . . . . . . 89 MEASure:CURRent:HARMonic:THD? . . . . . . . . . . . . . . . . . . . . . . . . 89 Measurement Subsystem (Frequency) Commands . . . . . . . . . . . . . . . 90 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 MEASure:FREQuency? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 Measurement Subsystem (Power) Commands . . . . . . . . . . . . . . . . . . . 92 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 MEASure:POWer? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 MEASure:POWer:AC? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 MEASure:POWer:AC:APParent? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 MEASure:POWer:AC:REACtive? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 MEASure:POWer:AC:PFACtor? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Measurement Subsystem (TVOLt) Commands . . . . . . . . . . . . . . . . . . . 95 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 MEASure:TVOLt? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

11 MEASure:TVOLt:ABSolute? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97 Measurement Subsystem (Voltage) Commands . . . . . . . . . . . . . . . . . .98 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98 MEASure:VOLTage? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99 MEASure:VOLTage:AC? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99 MEASure:VOLTage:ACDC? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100 MEASure:VOLTage:HARMonic? . . . . . . . . . . . . . . . . . . . . . . . . . . .100 MEASure:VOLTage:HARMonic:PHASe? . . . . . . . . . . . . . . . . . . . . .101 MEASure:VOLTage:HARMonic:THD? . . . . . . . . . . . . . . . . . . . . . . .101 MEASure:VOLTage:RANKed? . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102 Output Subsystem Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103 OUTPut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104 OUTPut:COUPling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104 OUTPut:DFI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105 OUTPut:DFI:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105 OUTPut:IMPedance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106 OUTPut:IMPedance:REAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106 OUTPut:IMPedance:REACtive . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107 OUTPut:PON:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107 OUTPut:PROTection:CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108 OUTPut:PROTection:DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108 OUTPut:RI:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109 OUTPut:TTLTrg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109 OUTPut:TTLTrg:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110 Sense Subsystem Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111 SENSe:CURRent:ACDC:RANGe . . . . . . . . . . . . . . . . . . . . . . . . . . .112 SENSe:FREQuency:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113 SENSe:NSELect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114 SENSe:SWEep:OFFSet:POINts . . . . . . . . . . . . . . . . . . . . . . . . . . . .114 SENSe:SWEep:TINTerval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115 SENSe:WINDow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116 Source Subsystem (Current) Commands . . . . . . . . . . . . . . . . . . . . . . .117 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117 all-guides.co m

CURRent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 CURRent:PEAK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 CURRent:PEAK:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 CURRent:PEAK:TRIGgered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 CURRent:PROTection:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 Source Subsystem (Frequency) Commands . . . . . . . . . . . . . . . . . . . . 123 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 FREQuency:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 FREQuency:SLEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 FREQuency:SLEW:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 FREQuency:SLEW:TRIGgered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 FREQuency:TRIGgered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 Source Subsystem (Frequency Modulation) Commands . . . . . . . . . . 127 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 FM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 FM:DEViation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 FM:FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 Source Subsystem (Function) Commands . . . . . . . . . . . . . . . . . . . . . 129 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 FUNCtion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 FUNCtion:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 FUNCtion:TRIGgered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 FUNCtion:CSINusoid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 Source Subsystem (List) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 LIST:COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 LIST:CURRent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 LIST:CURRent:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 LIST:DWELl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 LIST:DWELl:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 LIST:FREQuency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 LIST:FREQuency:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 LIST:FREQuency:SLEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 LIST:FREQuency:SLEW:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

13 LIST:PHASe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .140 LIST:PHASe:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .140 LIST:SHAPe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141 LIST:SHAPe:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141 LIST:STEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .142 LIST:TTLTrg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .142 LIST:TTLTrg:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143 LIST:VOLTage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143 LIST:VOLTage:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144 LIST:VOLTage:SLEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144 LIST:VOLTage:SLEW:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144 LIST:VOLTage:OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145 LIST:VOLTage:OFFSet:POINts? . . . . . . . . . . . . . . . . . . . . . . . . . . . .145 LIST:VOLTage:OFFSet:SLEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146 LIST:VOLTage:OFFSet:SLEW:POINts? . . . . . . . . . . . . . . . . . . . . . .146 Source Subsystem (Phase) Commands . . . . . . . . . . . . . . . . . . . . . . . .147 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147 PHASe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147 PHASe:AUXiliary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148 PHASe:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148 PHASe:TRIGgered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149 Source Subsystem (Pulse) Commands . . . . . . . . . . . . . . . . . . . . . . . .150 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .150 PULSe:COUNt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .150 PULSe:DCYCle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151 PULSe:HOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151 PULSe:PERiod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153 PULSe:WIDTh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153 Source Subsystem (Voltage) Commands . . . . . . . . . . . . . . . . . . . . . . .154 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154 VOLTage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155 VOLTage:TRIGgered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156 VOLTage:AUXiliary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .157 VOLTage:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158 VOLTage:OFFSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159

VOLTage:OFFSet:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 VOLTage:OFFSet:TRIGgered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 VOLTage:OFFSet:SLEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 VOLTage:OFFSet:SLEW:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 VOLTage:OFFSet:SLEW:TRIGgered . . . . . . . . . . . . . . . . . . . . . . . . 162 VOLTage:PROTection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 VOLTage:PROTection:STATe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 VOLTage:SENSe:DETector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 VOLTage:SENSe:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 VOLTage:SLEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 VOLTage:SLEW:MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 VOLTage:SLEW:TRIGgered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 Status Subsystem Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 STATus:PRESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 STATus:OPERation? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 STATus:OPERation:CONDition? . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 STATus:OPERation:ENABle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 STATus:OPERation:NTRansition . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 STATus:QUEStionable? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 STATus:QUEStionable:CONDition? . . . . . . . . . . . . . . . . . . . . . . . . . 173 STATus:QUEStionable:ENABle . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 STATus:QUEStionable:NTRansition . . . . . . . . . . . . . . . . . . . . . . . . 174 System Subsystem Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 SECurity[:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 SYSTem:COMMunicate:LAN:CONTrol? . . . . . . . . . . . . . . . . . . . . . 177 SYSTem:COMMunicate:LAN:DHCP . . . . . . . . . . . . . . . . . . . . . . . . 178 SYSTem:COMMunicate:LAN:DNS[{1|2}] . . . . . . . . . . . . . . . . . . . . . 179 SYSTem:COMMunicate:LAN:DOMain? . . . . . . . . . . . . . . . . . . . . . . 180 SYSTem:COMMunicate:LAN:GATeway . . . . . . . . . . . . . . . . . . . . . . 181 SYSTem:COMMunicate:LAN:HOSTname . . . . . . . . . . . . . . . . . . . . 182 SYSTem:COMMunicate:LAN:IPADdress . . . . . . . . . . . . . . . . . . . . . 183 SYSTem:COMMunicate:LAN:MAC? . . . . . . . . . . . . . . . . . . . . . . . . 184 SYSTem:COMMunicate:LAN:SMASk . . . . . . . . . . . . . . . . . . . . . . . 185 SYSTem:COMMunicate:LAN:TELNet:PROMpt . . . . . . . . . . . . . . . . 186

15 SYSTem:COMMunicate:LAN:TELNet:WMESsage . . . . . . . . . . . . . .186 SYSTem:COMMunicate:LAN:UPDate . . . . . . . . . . . . . . . . . . . . . . .187 SYSTem:COMMunicate:RLSTate . . . . . . . . . . . . . . . . . . . . . . . . . . .188 SYSTem:COMMunicate:TCPip:CONTrol? . . . . . . . . . . . . . . . . . . . .188 SYSTem:ERRor? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189 SYSTem:LANGuage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189 SYSTem:PERSona:MANufacturer . . . . . . . . . . . . . . . . . . . . . . . . . .189 SYSTem:PERSona:MANufacturer:DEFault . . . . . . . . . . . . . . . . . . .190 SYSTem:PERSona:MODel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .190 SYSTem:PERSona:MODel:DEFault . . . . . . . . . . . . . . . . . . . . . . . . .190 SYSTem:SECurity:COUNt? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191 SYSTem:SECurity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191 SYSTem:SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192 SYSTem:VERSion? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192 SYSTem:LOCal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192 SYSTem:REMote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193 SYSTem:RWLock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193 Trace Subsystem Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194 TRACe:CATalog? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194 TRACe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195 TRACe:DEFine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .196 TRACe:DELete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .196 Trigger Subsystem Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197 Subsystem syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197 ABORt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .198 INITiate:SEQuence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199 INITiate:CONTinuous:SEQuence . . . . . . . . . . . . . . . . . . . . . . . . . . .200 TRIGger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200 TRIGger:DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201 TRIGger:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201 TRIGger:SEQuence2:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202 TRIGger:SEQuence2:PHASe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203 TRIGger:SEQuence3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203 TRIGger:SEQuence3:SOURce . . . . . . . . . . . . . . . . . . . . . . . . . . . . .204 TRIGger:SEQuence1:DEFine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205

Common Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 Common commands syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 *CLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 *ESE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 *ESR? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 *IDN? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 *LRN? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 *OPC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 *OPT? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211 *PSC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 *RCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 *RST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 *SAV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 *SRE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 *STB? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217 *TRG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 *TST? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 *WAI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 4 Compatibility of the B and C Versions of the AC Power Solutions Persona Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 Model number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 Manufacturer ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 New Feature Comparison with B and C AC Source . . . . . . . . . . . . . . 223 5 Programming Examples Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 Programming the Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 Power-on initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 Enabling the output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 AC voltage and frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 Voltage and frequency slew rates . . . . . . . . . . . . . . . . . . . . . . . . . . 230 Waveform shapes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 Programming the output phase . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 Current limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 DC output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 all-guides.co m

17 Coupled commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235 Programming Output Transients . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236 Transient system model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237 Step and pulse transients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239 List transients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .241 Triggering Output Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .244 SCPI triggering nomenclature . . . . . . . . . . . . . . . . . . . . . . . . . . . . .244 Output trigger system model . . . . . . . . . . . . . . . . . . . . . . . . . . . . .245 Initiating the output trigger system . . . . . . . . . . . . . . . . . . . . . . . . .246 Selecting the output trigger source . . . . . . . . . . . . . . . . . . . . . . . .246 Specifying a trigger delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .247 Synchronizing output changes to a reference phase angle . . . . . .248 Generating output triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .248 Specifying a dwell time for each list point . . . . . . . . . . . . . . . . . . .249 Making Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .250 Voltage and current measurements . . . . . . . . . . . . . . . . . . . . . . . .251 Power measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .251 Harmonic measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .252 Returning voltage and current data from the data buffer . . . . . . .253 Regulatory-compliant measurement of quasi-stationary harmonics . 253 Triggering Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254 SCPI triggering nomenclature . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254 Measurement trigger system model . . . . . . . . . . . . . . . . . . . . . . . .255 Initiating the measurement trigger system . . . . . . . . . . . . . . . . . . .256 Selecting the measurement trigger source . . . . . . . . . . . . . . . . . . .256 Generating measurement triggers . . . . . . . . . . . . . . . . . . . . . . . . .257 Controlling the instantaneous voltage and current data buffers . .257 Programming the Status Registers . . . . . . . . . . . . . . . . . . . . . . . . . . .259 Power-on conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .259 Operation status group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .259 Questionable Status Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .263 Standard event status group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .264 Status byte register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .265

Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266 Programming the Trigger In and Trigger Out BNC Connectors . . . . . 269 Remote Inhibit and Discrete Fault Indicator . . . . . . . . . . . . . . . . . . . . 271 Remote inhibit (RI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 Discrete fault indicator (DFI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 SCPI Command Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273 A SCPI Command Tree Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276 B SCPI Conformance Information SCPI Confirmed Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296 Non SCPI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 C Error Messages Error Number List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302

19 List of Figures Figure 2-1 Partial command tree . . . . . . . . . . . . . . . . . . . . . . . . . .37 Figure 2-2 Command message structure . . . . . . . . . . . . . . . . . . .43 Figure 5-1 Model of transient system . . . . . . . . . . . . . . . . . . . . .238 Figure 5-2 Model of output triggers . . . . . . . . . . . . . . . . . . . . . .245 Figure 5-3 Model of measurement triggers . . . . . . . . . . . . . . . .255 Figure 5-4 Pre-event and post-event triggering . . . . . . . . . . . . .258 Figure 5-5 AC source status model . . . . . . . . . . . . . . . . . . . . . . .262 Figure 5-6 BNC connector trigger model . . . . . . . . . . . . . . . . . .270

THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK.

21 List of Tables Table 5-1 Bit configuration of status registers . . . . . . . . . . . . . .260 Table C-1 Error numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .302 all-guides.co m

THIS PAGE HAS BEEN INTENTIONALLY LEFT BLANK.

Programming Guide 23 1 General Information About this Guide 24 External References 25 Keysight IO Libraries Suite 26 This chapter provides an introduction to this guide.

About this Guide This guide contains programming information for the Keysight Models 6811C, 6812C, and 6813C AC Power Solutions. These units will be referred to as “ac source” throughout this guide. You will find the following information in the rest of this guide: – Chapter 1, an introduction to this guide. – Chapter 2, an introduction to SCPI messages structure, syntax, and data formats. – Chapter 3, a dictionary of the available SCPI commands. – Chapter 4, information about the compatibility of the B and C versions of the ac source. – Chapter 5, an introduction to programming the ac source with SCPI commands. – Appendix A, the SCPI command tree. – Appendix B, SCPI conformance information. – Appendix C, list of error messages. Documentation summary The following documents that are related to this Programming Guide have additional helpful information for using the ac source. – Quick Start Guide. Information on how to quickly get started using the ac source. – User’s and Service Guide. Includes specifications and supplemental characteristics, how to use the front panel, how to connect to the ac source, and calibration procedures.

25 External References SCPI references The following documents will assist you with programming in SCPI: – Beginner's Guide to SCPI. Keysight part no. H2325-90001. Highly recommended for anyone who has not had previous experience programming with SCPI. – Tutorial Description of the General Purpose Interface Bus. Keysight part no. 5952-0156. Highly recommended for those not familiar with the IEEE 488.1 and 488.2 standards. To obtain a copy of the above documents, contact your local Keysight Sales and Support Office. GPIB references The most important GPIB documents are your controller programming manuals - Keysight BASIC, GPIB Command Library for MS DOS, etc. Refer to these for all non-SCPI commands (for example: Local Lockout). The following are two formal documents concerning the GPIB interface: – ANSI/IEEE Std. 488.1-1987 IEEE Standard Digital Interface for Programmable Instrumentation. Defines the technical details of the GPIB interface. While much of the information is beyond the need of most programmers, it can serve to clarify terms used in this guide and in related documents. – ANSI/IEEE Std. 488.2-1987 IEEE Standard Codes, Formats, Protocols, and Common Commands. Recommended as a reference only if you intend to do fairly sophisticated programming. Helpful for finding precise definitions of certain types of SCPI message formats, data types, or common commands. The above two documents are available from the IEEE (Institute of Electrical and Electronics Engineers), 345 East 47th Street, New York, NY 10017, USA.

Keysight IO Libraries Suite Keysight IO Libraries Suite is a collection of free instrument control software that automatically discovers instruments and allows you to control instruments over LAN, USB, GPIB, RS-232, and other interfaces. For more information, or to download IO Libraries, go to www.keysight.com/find/iosuite. all-guides.co m

Programming Guide 27 2 Introduction to Programming Introduction 28 USB Capabilities of the AC Source 29 LAN Capabilities of the AC Source 30 GPIB Capabilities of the AC Source 31 RS-232 Capabilities of the AC Source 32 Introduction to SCPI 35 The SCPI Command Tree 37 Structure of a SCPI Message 42 SCPI Data Formats 47 System Considerations 49 This chapter provides an introduction to SCPI messages structure, syntax, and data formats.

28 Keysight Models 6811C, 6812C, and 6813C Programming Guide Introduction The ac source supports the SCPI programming language on all of its remote I/O interfaces. NOTE It is not recommended to send SCPI commands simultaneously using more than one remote I/O interface.

2 Keysight Models 6811C, 6812C, and 6813C Programming Guide 29 USB Capabilities of the AC Source To use the USB interface for the ac source, no settings are required on the ac source. Vendor Identification (VID) and Product Identification (PID) The vendor identification (VID) and product identification (PID) of the ac sources are specified as below: VID PID Keysight model 0x2A8D 0x3601 6811C 0x3701 6812C 0x3801 6813C

30 Keysight Models 6811C, 6812C, and 6813C Programming Guide LAN Capabilities of the AC Source The ac source conforms to the LAN eXtensions for Instrumentation (LXI) Device Specification 2011 version 1.4. The Telnet, Socket, and VXI-11 interfaces are available to communicate with the ac source that works on either static or dynamic IP address. Instrument Web server The ac source has a built-in Web server that gives you direct control from an Internet browser on your computer. With the Web server, you can access the front panel control functions including the LAN configuration parameters. The Web server is enabled when shipped. Perform the following steps to launch the Web server: 1 Establish a LAN interface connection from your computer to the ac source. 2 To launch the Web server, enter the instrument's IP address or fully-qualified hostname into the browser’s Address field. 3 To begin controlling your instrument, click the Browser Web Control button in the navigation bar on the left. 4 For additional help, click the “Help Page” button on the navigation bar. NOTE The built-in Web server only operates over the LAN interface. It requires Internet Explorer 9 onwards.

2 Keysight Models 6811C, 6812C, and 6813C Programming Guide 31 GPIB Capabilities of the AC Source All ac source functions except for setting the GPIB address are programmable over the GPIB. GPIB address The ac source operates from a GPIB address that is set from the front panel. To set the GPIB address, press the Address key on the front panel and enter the address using the Entry keys. all-guides.co m

32 Keysight Models 6811C, 6812C, and 6813C Programming Guide RS-232 Capabilities of the AC Source The ac source provides an RS-232 programming interface, which is activated by commands located under the front panel Address key. All SCPI commands are available through RS-232 programming. The EIA RS-232 Standard defines the interconnections between Data Terminal Equipment (DTE) and Data Communications Equipment (DCE). The ac source is designed to be a DTE. It can be connected to another DTE such as a PC COM port through a null modem cable. RS-232 data format The RS-232 data is an 11-bit word with one start bit and two stop bits. The number of start and stop bits is not programmable. The following parity options are selectable using the front panel Address key: Parity options are stored in non-volatile memory. Baud rate The front panel Address key lets you select one of the following baud rates, which is stored in non-volatile memory:1200, 2400, 4800, or 9600. NOTE The RS-232 settings in your program must match the settings specified in the front panel Address menu. Press the front panel Address key if you need to change the settings. EVEN Seven data bits with even parity ODD Seven data bits with odd parity NONE Eight data bits without parity NOTE The ac source must have the same baud rate and parity as the controller.

2 Keysight Models 6811C, 6812C, and 6813C Programming Guide 33 RS-232 Programming Example The following program illustrates how to program the ac source using RS-232 to set the output voltage and frequency and to read back the model number and output voltage. ' Program to write and read via RS232 ' Configure serial port (e.g. COM1) for: ' Bits per second: select 9600 baud (or desired baudrate) ' Start bits: select 1 ' Data bits: select 8 ' Stop bits: select 2 ' Parity: select None ' Flow control: select None ' Send line feed [Enter] ' Reserve 1000 character buffer for serial I/O ' ' Ensure identical baud and parity settings on ac source (Default - Baudrate: 9600, Parity: None) ' ' Send SCPI commands *RST ' Resets the ac source VOLT 60 ' Set voltage to 60 volts FREQ 50 ' Set frequency to 50 hertz OUTPUT ON ' Turn on the output *IDN? ' Query the ac source identification string [Wait for response] MEAS:VOLT:AC? ' Query the ac source voltage

34 Keysight Models 6811C, 6812C, and 6813C Programming Guide RS-232 troubleshooting If you are having trouble communicating over the RS-232 interface, check the following: – The computer and the ac source must be configured for the same baud rate, parity, and number of data bits. Note that the ac source is configured for 1 start bit and 2 stop bits (these values are fixed). – The correct interface cables or adapters must be used, as described under “RS-232 connector” in the User's Guide. Note that even if the cable has the proper connectors for your system, the internal wiring may be incorrect. – The interface cable must be connected to the correct serial port on your computer (COM1, COM2, etc.). [Wait for response] ' END ' End of main program

2 Keysight Models 6811C, 6812C, and 6813C Programming Guide 35 Introduction to SCPI SCPI (Standard Commands for Programmable Instruments) is a programming language for controlling instrument functions over the GPIB. SCPI is layered on top of the hardware-portion of IEEE 488.2. The same SCPI commands and parameters control the same functions in different classes of instruments. For example, you would use the same DISPlay command to control the ac source display and the display of a SCPI-compatible multimeter. Conventions used in this guide Angle brackets < > Items within angle brackets are parameter abbreviations. For example, indicates a specific form of numerical data. Vertical bar | Vertical bars separate alternative parameters. For example, NORM | TEXT indicates that either “TEXT” or “NORM” can be used as a parameter. Square Brackets [ ] Items within square brackets are optional. The representation [SOURce:]LIST means that SOURce: may be omitted. Braces { } Braces indicate parameters that may be repeated zero or more times. It is used especially for showing arrays. The notation {<,B>} shows that parameter “A” must be entered, while parameter “B” may be omitted or may be entered one or more times. Computer font Computer font is used to show program lines in text. TRIGger:DELay .5 shows a program line.