Programming Guide AC Power Solutions Agilent Models 6811B, 6812B, 6813B 6814B, 6834B, and 6843A Agilent Part No. 5962-0889 Microfiche No 6962-0890 Printed in U.S.A.
Safety Summary The beginning of the ac source User’s Guide has a Safety Summary page. Be sure you are familiar with the information on this page before programming the ac source from a controller. 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. Printing History The edition and current revision of this manual are indicated below.
Table of Contents Safety Summary Printing History Table of Contents 1 - GENERAL INFORMATION About this Guide Earlier AC Source Models Documentation Summary External References SCPI References GPIB References Agilent VXIplug&play Power Products Instrument Drivers Supported Applications System Requirements Downloading and Installing the Driver Accessing Online Help 2 - INTRODUCTION TO PROGRAMMING GPIB Capabilities of the AC Source GPIB Address RS-232 Capabilities of the AC Source RS-232 Data Format Baud Rat
System Considerations Assigning the GPIB Address in Programs Types of DOS Drivers Error Handling Agilent BASIC Controllers 3 - LANGUAGE DICTIONARY Introduction Subsystem Commands Calibration Subsystem Commands Subsystem Syntax CALibrate:CURRent:AC CALibrate:CURRent:MEASure CALibrate:DATA CALibrate:IMPedance CALibrate:LEVel CALibrate:PASSword CALibrate:PWM:FREQuency CALibrate:PWM:RAMP CALibrate:SAVE CALibrate:STATe CALibrate:VOLTage:AC CALibrate:VOLTage:DC CALibrate:VOLTage:OFFSet CALibrate:VOLTage:PROTecti
MEASure:CURRent:HARMonic? FETCh:CURRent:HARMonic? MEASure:CURRent:HARMonic:PHASe? FETCh:CURRent:HARMonic:PHASe? MEASure:CURRent:HARMonic:THD? FETCh:CURRent:HARMonic:THD? MEASure:CURRent:NEUTral? FETCh:CURRent:NEUTral? MEASure:CURRent:NEUTral:AC? FETCh:CURRent:NEUTral:AC? MEASure:CURRent:NEUTral:ACDC? FETCh:CURRent:NEUTral:ACDC? MEASure:CURRent:NEUTral:HARMonic? FETCh:CURRent:NEUTral:HARMonic? MEASure:CURRent:NEUTral:HARMonic:PHASe? FETCh:CURRent:NEUTral:HARMonic:PHASe? Measurement Subsystem (Frequency) Subs
Source Subsystem (Frequency) Subsystem Syntax FREQuency FREQuency:MODE FREQuency:SLEW FREQuency:SLEW:MODE FREQency:SLEW:TRIGgered FREQuency:TRIGgered Source Subsystem (Function) Subsystem Syntax FUNCtion FUNCtion:MODE FUNCtion:TRIGgered FUNCtion:CSINusoid Source Subsystem (List) Subsystem Syntax LIST:COUNt LIST:CURRent LIST:CURRent:POINts? LIST:DWELl LIST:DWELl:POINts? LIST:FREQuency LIST:FREQuency:POINts? LIST:FREQuency:SLEW LIST:FREQuency:SLEW:POINts? LIST:PHASe LIST:PHASe:POINts? LIST:SHAPe LIST:SHAPe:PO
Source Subsystem (Voltage) 85 Subsystem Syntax 85 VOLTage 86 VOLTage:TRIGgered 86 VOLTage:MODE 87 VOLTage:OFFSet 87 VOLTage:OFFSet:MODE 88 VOLTage:OFFSet:TRIGgered 88 VOLTage:OFFSet:SLEW 89 VOLTage:OFFSet:SLEW:MODE 89 VOLTage:OFFSet:SLEW:TRIGgered 90 VOLTage:PROTection 90 VOLTage:PROTection:STATe 90 VOLTage:RANGe 91 VOLTage:SENSe:DETector VOLTage:ALC:DETector 91 VOLTage:SENSe:SOURce VOLTage:ALC:SOURce 92 VOLTage:SLEW 92 VOLTage:SLEW:MODE 93 VOLTage:SLEW:TRIGgered 93 Status Subsystem 94 Subsystem Syntax 94 S
Trigger Subsystem Subsystem Syntax ABORt INITiate:SEQuence INITiate:NAME INITiate:CONTinuous:SEQuence INITiate:CONTinuous:NAME TRIGger TRIGger:DELay TRIGger:SOURce TRIGger:SEQuence2:SOURce TRIGger:SYNChronize:SOURce TRIGger:SEQuence2:PHASe TRIGger:SYNCHronize:PHASe TRIGger:SEQuence3 TRIGger:ACQuire TRIGger:SEQuence3:SOURce TRIGger:ACQuire:SOURce TRIGger:SEQuence1:DEFine TRIGger:SEQuence2:DEFine TRIGger:SEQuence3:DEFine Common Commands Common Commands Syntax *CLS *ESE Bit Configuration of Standard Event Stat
Specifying a Trigger Delay Synchronizing Output Changes to a Reference Phase Angle Generating Output Triggers Specifying a Dwell Time for Each List Point Making Measurements Voltage and Current Measurements Power Measurements Harmonic Measurements Simultaneous Output Phase Measurements (Agilent 6834B only) Returning Voltage and Current Data From the Data Buffer Regulatory-Compliant Measurement of Quasi-Stationary Harmonics Triggering Measurements SCPI Triggering Nomenclature Measurement Trigger System Model
Function Keys Entry Keys E9012 Language Command Summary E - IEC MODE COMMAND SUMMARY Introduction Using the SENSe:CURRent:ACDC:RANGe command Command Syntax CALCulate:INTegral:TIME CALCulate:SMOothing CALCulate:LIMit:UPPer FORMat FORMat:BORDer MEASure:ARRay:CURRent:HARMonic? MEASure:ARRay:VOLTage:FLUCtuations:ALL? MEASure:ARRay:VOLTage:FLUCtuations:FLICker? MEASure:ARRay:VOLTage:FLUCtuations:PST? SENSe:CURRent:PREFerence SENSe:WINDow SYSTem:CONFigure INDEX 10 163 164 164 167 167 167 168 169 169 170 171
1 General Information About this Guide This manual contains programming information for the Agilent 6811B, 6812B, 6813B, 6814B, 6834B, 6843A AC Power Solutions. These units will be referred to as "ac sources" throughout this manual. You will find the following information in the rest of this guide: Chapter 1 Chapter 2 Chapter 3 Chapter 4 Appendix A Appendix B Appendix C Appendix D Appendix E Introduction to this guide. Introduction to SCPI messages structure, syntax, and data formats.
1 - General Information External References SCPI References The following documents will assist you with programming in SCPI: u Beginner’s Guide to SCPI. Agilent Part No. H2325-90001. Highly recommended for anyone who has not had previous experience programming with SCPI. u Tutorial Description of the General Purpose Interface Bus. Agilent Part No. 5952-0156. Highly recommended for those not familiar with the IEEE 488.1 and 488.2 standards.
General Information - 1 System Requirements The Agilent VXIplug&play Power Products instrument driver complies with the following: ñ ñ ñ ñ Microsoft Windows 95 Microsoft Windows NT 4.0 HP VISA revision F.01.02 National Instruments VISA 1.1 Downloading and Installing the Driver NOTE: Before installing the Agilent VXIplug&play instrument driver, make sure that you have one of the supported applications installed and running on your computer. 1. Access Agilent Technologies’ Web site at http://www.ag.
2 Introduction to Programming GPIB Capabilities of the AC Source All ac source functions except for setting the GPIB address are programmable over the GPIB. The IEEE 488.2 capabilities of the ac source are listed in the appendix A of the User’s Guide. 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.
2 - Introduction to Programming 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. The program was written to run on any controller using Microsoft QBasic. NOTE: The ac source must be configured for RS232 and the same baud rate and parity as the controller.
Introduction to Programming - 2 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.
2 - Introduction to Programming The SCPI Command Tree As previously explained, the basic SCPI communication method involves sending one or more properly formatted commands from the SCPI command tree to the instrument as program messages. The following figure shows a portion of a subsystem command tree, from which you access the commands located along the various paths (you can see the complete tree in appendix A).
Introduction to Programming - 2 If you now enter :CLEar, you have reached the end of the command string. The active header path remains at :CLEar. If you wished, you could have entered :CLEar;DELay 20 and it would be accepted as a compound message consisting of: OUTPut:PROTection:CLEAr and OUTPut:PROTection:DELay 20. The entire message would be: OUTPut:PROTection:CLEar;DELay 20 The message terminator after DELay 20 returns the path to the root.
2 - Introduction to Programming Including Common Commands You can combine common commands with system commands in the same message. Treat the common command as a message unit by separating it with a semicolon (the message unit separator). Common commands do not affect the active header path; you may insert them anywhere in the message. VOLTage:TRIGger 7.
Introduction to Programming - 2 Combining Message Units The following command message is briefly described here, with details in subsequent paragraphs. Data Message Unit Headers Query Indicator VOLT:LEV 80 ; PROT 88 Header Separator ;: CURR? Message Terminator Message Unit Separators Root Specifier Figure 2-2.
2 - Introduction to Programming Header Convention In the command descriptions in Chapter 3 of this manual, headers are emphasized with boldface type. The proper short form is shown in upper-case letters, such as DELay. Header Separator If a command has more than one header, you must separate them with a colon (VOLT:PROT OUTPut:RELay:POLarity). Optional Headers The use of some headers is optional. Optional headers are shown in brackets, such as OUTPut[:STATe] ON.
Introduction to Programming - 2 SCPI Data Formats All data programmed to or returned from the ac source is ASCII. The data may be numerical or character string. Numerical Data Formats Symbol Data Form Talking Formats Digits with an implied decimal point assumed at the right of the least-significant digit. Examples: 273 Digits with an explicit decimal point. Example: .0273 Digits with an explicit decimal point and an exponent. Example: 2.73E+2 Boolean Data.
2 - Introduction to Programming System Considerations The remainder of this chapter addresses some system issues concerning programming.
Introduction to Programming - 2 Error Handling If there is no error-handling code in your program, undetected errors can cause unpredictable results. This includes "hanging up" the controller and forcing you to reset the system. Both of the above DOS drivers have routines for detecting program execution errors. Important Use error detection after every call to a subroutine. Agilent BASIC Controllers The Agilent BASIC Programming Language provides access to GPIB functions at the operating system level.
3 Language Dictionary Introduction This section gives the syntax and parameters for all the IEEE 488.2 SCPI commands and the Common commands used by the ac sources when operating in Normal mode. It is assumed that you are familiar with the material in Chapter 2 "Introduction to Programming". Because the SCPI syntax remains the same for all programming languages, the examples given for each command are generic.
3 - Language Dictionary Subsystem Commands Subsystem commands are specific to functions. They can be a single command or a group of commands. The groups are comprised of commands that extend one or more levels below the root. The description of common commands follows the description of the subsystem commands. The subsystem command groups are listed in alphabetical order and the commands within each subsystem are grouped alphabetically under the subsystem.
Language Dictionary - 3 Calibration Subsystem Commands The commands in this subsystem allow you to do the following: u Enable and disable the calibration mode u Change the calibration password u Calibrate the current and voltage output levels, and store new calibration constants in nonvolatile memory.
3 - Language Dictionary CALibrate:CURRent:MEASure Agilent 6811B, 6812B, 6813B, 6843A Only This command is used to initiate the calibration of the current metering circuits and the peak current limit circuits. It can only be used in the calibration mode. Command Syntax Parameters Examples Related Commands CALibrate:CURRent:MEASure None CAL:CURR:MEAS CAL:STAT CAL:SAV CAL:LEV CALibrate:DATA Phase Selectable This command is only used in calibration mode.
Language Dictionary - 3 CALibrate:PASSword This command can only be used in calibration mode. It allows you to change the calibration password. A new password is automatically stored in nonvolatile memory and does not have to be stored with CALibrate:SAVE. If the password is set to 0, password protection is removed and the ability to enter the calibration mode is unrestricted. Command Syntax Parameters Examples Related Commands CALibrate:PASSword 0 (default) CAL:PASS 6812 CAL:PASS 02.
3 - Language Dictionary CALibrate:STATe This command enables and disables calibration mode. The calibration mode must be enabled before the will accept any other calibration commands. The first parameter specifies the enabled or disabled state. The second parameter is the password. It is required if the calibration mode is being enabled and the existing password is not 0. If the password is not entered or is incorrect, an error is generated and the calibration mode remains disabled.
Language Dictionary - 3 CALibrate:VOLTage:OFFSet Agilent 6811B, 6812B, 6813B, Only This command can only be used in calibration mode. It initiates the calibration of the offset voltage programming circuits. Command Syntax Parameters Examples Related Commands CALibrate:VOLTage:OFFSet None CAL:VOLT:OFFS CAL:SAVE CAL:STAT CAL:LEV CALibrate:VOLTage:PROTection This command can only be used in calibration mode. It calibrates the overvoltage protection (OV) circuit.
3 - Language Dictionary Display Subsystem Commands This subsystem programs the front panel display of the ac source. Subsystem Syntax DISPlay [:WINDow] [:STATe] :MODE :TEXT [:DATA] Enable/disable front panel display Set display mode (NORMal | TEXT) Set text displayed in text mode DISPlay This command turns the front panel display on and off. It does not affect the annunciators.
Language Dictionary - 3 Instrument Subsystem This subsystem programs the three-phase output capability of the Agilent 6834B .
3 - Language Dictionary INSTrument:NSELect INSTrument:SELect Agilent 6834B Only These commands allow the selection of individual outputs in a three-phase model for subsequent commands or queries. Their operation is dependent on the setting of INSTrument:COUPle. If INST:COUP NONE is programmed, then the phase selectable commands are sent only to the particular output phase set by INSTrument:NSELect. If INST:COUP ALL is programmed, then all commands are sent to all three output phases.
Language Dictionary - 3 Measurement Subsystem (Arrays) This subsystem lets you retrieve arrays containing measurements data. Only current and voltage measurements are stored in an array. Two measurement commands are available: MEASure and FETCh. MEASure triggers the acquisition of new data before returning the readings from the array. FETCh returns previously acquired data from the array. Individual outputs of a three-phase source are specified by the setting of INSTrument:NSELect.
3 - Language Dictionary MEASure:ARRay:CURRent:HARMonic? FETCh:ARRay:CURRent:HARMonic? Phase Selectable These queries return an array of harmonic amplitudes of output current in rms amperes. The first value returned is the dc component, the second value is the fundamental frequency, and so on up to the 50th harmonic. Harmonic orders can be measured up to the fundamental measurement bandwidth of the measurement system, which is 12.6kHz.
Language Dictionary - 3 MEASure:ARRay:CURRent:NEUTral? FETCh:ARRay:CURRent:NEUTral? Agilent 6834B Only These queries return an array containing the instantaneous output current of the neutral output terminal in amperes. The output voltage and current are digitized whenever a measure command is given or whenever an acquire trigger occurs. If digitization is caused by a measure command, the time interval between samples is determined by the output frequency.
3 - Language Dictionary MEASure:ARRay:CURRent:NEUTral:HARMonic:PHASe? FETCh:ARRay:CURRent:NEUTral:HARMonic:PHASe? Agilent 6834B Only These queries return an array of harmonic phases of output current of the neutral output terminal in degrees, referenced to the positive zero crossing of the fundamental component. The first value returned is the dc component (always returned as 0 degrees phase) , the second value is the fundamental frequency, and so on up to the 50th harmonic.
Language Dictionary - 3 MEASure:ARRay:VOLTage:HARMonic? FETCh:ARRay:VOLTage:HARMonic? Phase Selectable These queries return an array of harmonic amplitudes of output voltage in rms volts. The first value returned is the dc component, the second value is the fundamental frequency, and so on up to the 50th harmonic. Harmonic orders can be measured up to the fundamental measurement bandwidth of the measurement system, which is 12.6kHz.
3 - Language Dictionary Measurement Subsystem (Current) This subsystem programs the current measurement capability of the ac source. Two measurement commands are available: MEASure and FETCh. MEASure triggers the acquisition of new measurement data before returning a reading. FETCh returns a reading computed from previously acquired data. Individual outputs of a three-phase source are specified by the setting of INSTrument:NSELect.
Language Dictionary - 3 MEASure:CURRent:AC? FETCh:CURRent:AC? Phase Selectable These queries return the ac component rms current being sourced at the output terminals. Query Syntax Parameters Examples Returned Parameters Related Commands MEASure:[SCALar]:CURRent:AC? FETCh:[SCALar]:CURRent:AC? None MEAS:CURR:AC? FETC:CURR:AC? MEAS:VOLT:AC? MEAS:CURR? MEASure:CURRent:ACDC? FETCh:CURRent:ACDC? Phase Selectable These queries return the ac+dc rms current being sourced at the output terminals.
3 - Language Dictionary MEASure:CURRent:CREStfactor? FETCh:CURRent:CREStfactor? Phase Selectable These queries return the output current crest factor. This is the ratio of peak output current to rms output current.
Language Dictionary - 3 MEASure:CURRent:HARMonic:PHASe? FETCh:CURRent:HARMonic:PHASe? Phase Selectable These queries return the phase angle of the Nth harmonic of output current, referenced to the positive zero crossing of the fundamental component. The parameter is the desired harmonic number. Queries sent with a value of 0 return the dc component. A value of 1 returns the fundamental output frequency.
3 - Language Dictionary MEASure:CURRent:NEUTral:AC? FETCh:CURRent:NEUTral:AC? Agilent 6834B Only These queries return the ac rms current in the neutral output terminal of a three-phase ac source.
Language Dictionary - 3 MEASure:CURRent:NEUTral:HARMonic:PHASe? FETCh:CURRent:NEUTral:HARMonic:PHASe? Agilent 6834B Only These queries return the phase angle of the Nth harmonic of current in the neutral output terminal of a three-phase ac source, referenced to the positive zero crossing of the fundamental component. The parameter is the desired harmonic number. Queries sent with a value of 0 return the dc component. A value of 1 returns the fundamental output frequency.
3 - Language Dictionary Measurement Subsystem (Frequency) This subsystem programs the frequency measurement capability of the ac source. Two measurement commands are available: MEASure and FETCh. MEASure triggers the acquisition of new measurement data before returning a reading. FETCh returns a reading computed from previously acquired data.
Language Dictionary - 3 Measurement Subsystem (Power) This subsystem programs the power measurement capability of the ac source. Two measurement commands are available: MEASure and FETCh. MEASure triggers the acquisition of new measurement data before returning a reading. FETCh returns a reading computed from previously acquired data. Individual outputs of a three-phase source are specified by the setting of INSTrument:NSELect.
3 - Language Dictionary MEASure:POWer:AC:APParent? FETCh:POWer:AC:APParent? Phase Selectable These queries return the apparent power being sourced at the output terminals in volt-amperes.
Language Dictionary - 3 MEASure:POWer:AC:TOTal? FETCh:POWer:AC:TOTal? Agilent 6834B Only These queries return the total power being sourced at the output terminals of a three-phase ac source.
3 - Language Dictionary Measurement Subsystem (Voltage) This subsystem programs the voltage measurement capability of the ac source. Two measurement commands are available: MEASure and FETCh. MEASure triggers the acquisition of new measurement data before returning a reading. FETCh returns a reading computed from previously acquired data. Individual outputs of a three-phase source are specified by the setting of INSTrument:NSELect.
Language Dictionary - 3 MEASure:VOLTage:ACDC? FETCh:VOLTage:ACDC? Phase Selectable These queries return the ac+dc rms voltage being sourced at the output terminals. Query Syntax Parameters Examples Returned Parameters Related Commands MEASure:[SCALar]:VOLTage:ACDC? FETCh:[SCALar]:VOLTage:ACDC? None MEAS:VOLT:ACDC? FETC:VOLT:ACDC? MEAS:CURR:ACDC? MEAS:VOLT? MEASure:VOLTage:HARMonic? FETCh:VOLTage:HARMonic? Phase Selectable These queries return the rms amplitude of the Nth harmonic of output voltage.
3 - Language Dictionary MEASure:VOLTage:HARMonic:PHASe? FETCh:VOLTage:HARMonic:PHASe? Phase Selectable These queries return the phase angle of the Nth harmonic of output voltage, referenced to the positive zero crossing of the fundamental component. The parameter is the desired harmonic number. Queries sent with a value of 0 return the dc component. A value of 1 returns the fundamental output frequency.
Language Dictionary - 3 Output Subsystem This subsystem controls the main outputs, the signal outputs, the power-on state, and the output protection function of the ac source. Subsystem Syntax OUTPut [:STATe] :COUPling :DFI [:STATE] :SOURce :IMPedance [:STATE] :REAL :REACtive :PON :STATe :PROTection :CLEar :DELay :RI :MODE :TTLTrg [:STATE] :SOURce Enable/disable output voltage, current, power, etc.
3 - Language Dictionary OUTPut:COUPling Agilent 6811B, 6812B, 6813B, Only This command enables ac or dc output coupling. When the output coupling is set to AC, a dc leveling loop attempts to maintain zero average output voltage. The loop has a corner frequency of about 2Hz. It will not prevent short transient waveforms that may have non-zero average voltage, but will cause a settling transient to an average value of 0 volts.
Language Dictionary - 3 OUTPut:IMPedance Agilent 6811B, 6812B, 6813B, Only This command enables or disables the output impedance programming capability of the ac source.
3 - Language Dictionary OUTPut:PON:STATe This command selects the power-on state of the ac source. The following states can be selected: RST RCL0 Sets the power-on state to *RST. Refer to the *RST command as described later in this chapter for more information. Sets the power-on state to *RCL 0. Refer to the *RCL command as described later in this chapter for more information.
Language Dictionary - 3 OUTPut:RI:MODE This command selects the mode of operation of the Remote Inhibit protection. The following modes can be selected: LATChing LIVE OFF A TTL low at the RI input latches the output in the protection shutdown state, which can only be cleared by OUTPut:PROTection:CLEar. The output state follows the state of the RI input. A TTL low at the RI input turns the output off; a TTL high turns the output on. The instrument ignores the RI input.
3 - Language Dictionary Sense Subsystem This subsystem controls the measurement current range, the data acquire sequence, and the harmonic measurement window of the ac source.
Language Dictionary - 3 SENSe:SWEep:OFFSet:POINts This command defines the trigger point relative to the start of the returned data record when an acquire trigger is used. The values can range from -4095 to 2E9. When the values are negative, the values in the beginning of the data record represent samples taken prior to the trigger.
3 - Language Dictionary Source Subsystem (Current) This subsystem programs the output current of the ac source.
Language Dictionary - 3 CURRent:PEAK Agilent 6811B, 6812B, 6813B, Only This command sets the output limit of the absolute value of peak instantaneous current.
3 - Language Dictionary CURRent:PEAK:TRIGgered Agilent 6811B, 6812B, 6813B, Only This command sets the output limit of the absolute value of peak instantaneous current when a step or pulse transient is triggered.
Language Dictionary - 3 Source Subsystem (Frequency) This subsystem programs the output frequency of the ac source.
3 - Language Dictionary FREQuency:SLEW This command sets the rate at which frequency changes for all programmed changes in output frequency. Instantaneous frequency changes can be obtained by sending MAXimum or INFinity. The SCPI keyword INFinity is represented by the number 9.9E37. Command Syntax Parameters *RST Value Examples Query Syntax Returned Parameters Related Commands [SOURce:]FREQuency:SLEW[:IMMediate] | INFinity 0 to 9.
Language Dictionary - 3 FREQuency:TRIGgered This command programs the frequency that the output will be set to during a triggered step or pulse transient.
3 - Language Dictionary Source Subsystem (Function) This subsystem programs the output function of the ac source.
Language Dictionary - 3 FUNCtion:MODE This command determines how the waveform shape is controlled during a triggered output transient. The choices are: The waveform shape is unaffected by a triggered output transient. The waveform shape is programmed to the value set by FUNCtion:TRIGgered when a triggered transient occurs. The waveform shape is changed to the value set by FUNCtion:TRIGgered for a duration determined by the pulse commands.
3 - Language Dictionary FUNCtion:CSINusoid This command sets the clipping level when a clipped sine output waveform is selected. The clipping characteristics can be specified in two ways: u The clipping level is expressed as a percentage of the peak amplitude at which clipping occurs. The range is 0 to 100 percent. These are the default units when the optional THD suffix is not sent. u The clipping level is expressed at the percentage of total harmonic distortion in the output voltage.
Language Dictionary - 3 Source Subsystem (List) This subsystem controls the generation of complex sequences of output changes with rapid, precise timing and synchronized with internal or external signals. Each subsystem command for which lists can be generated has an associated list of values that specify the output at each list step. LIST:COUNt determines how many times the sequences through a list before that list is completed.
3 - Language Dictionary LIST:COUNt This command sets the number of times that the list is executed before it is completed. The command accepts parameters in the range 1 through 9.9E37, but any number greater than 2E9 is interpreted as infinity. Use INFinity to execute a list indefinitely. Command Syntax Parameters *RST Value Examples Query Syntax Returned Parameters Related Commands [SOURce:]LIST:COUNt | INFinity 1 to 9.
Language Dictionary - 3 LIST:DWELl This command sets the sequence of list dwell times. Each value represents the time in seconds that the output will remain at the particular list step point before completing the step. At the end of the dwell time, the output of the depends upon the following conditions: u If LIST:STEP AUTO has been programmed, the output automatically changes to the next point in the list.
3 - Language Dictionary LIST:FREQuency:POINts? This query returns the number of points specified in LIST:FREQuency. Note that it returns only the total number of points, not the point values. Query Syntax Returned Parameters Examples Related Commands [SOURce:]LIST:FREQuency[:LEVel]:POINTs? LIST:FREQ:POIN? LIST:FREQ LIST:FREQuency:SLEW This command specifies the output frequency slew list points. The slew points are given in the command parameters, which are separated by commas.
Language Dictionary - 3 LIST:PHASe:POINts? This query returns the number of points specified in LIST:PHASe. Note that it returns only the total number of points, not the point values. Query Syntax Returned Parameters Examples Related Commands [SOURce:]LIST:PHASe:POINTs? LIST:PHAS:POIN? LIST:PHAS LIST:SHAPe This command sets the sequence of the waveform shape entries. The order in which the shapes are given determines the sequence in which the list of shape will be output when a list is triggered.
3 - Language Dictionary LIST:STEP This command specifies how the list sequencing responds to triggers. The following parameters may be specified: ONCE AUTO causes the list to advance only one point after each trigger. Triggers that arrive during a dwell delay are ignored causes the entire list to be output sequentially after the starting trigger, paced by its dwell delays.
Language Dictionary - 3 LIST:VOLTage Phase Selectable This command specifies the output voltage points in a list. The voltage points are given in the command parameters, which are separated by commas. The order in which the points are entered determines the sequence in which they are output when a list is triggered. Changing list data while a subsystem is in list mode generates an implied ABORt. The maximum peak voltage that the ac source can output is 425 V peak.
3 - Language Dictionary LIST:VOLTage:SLEW:POINts? This query returns the number of points specified in LIST:VOLTage:SLEW. Note that it returns only the total number of points, not the point values. Query Syntax Returned Parameters Examples Related Commands [SOURce:]LIST:VOLTage:SLEW:POINTs? LIST:VOLT:SLEW:POIN? LIST:VOLT:SLEW LIST:VOLTageOFFSet Agilent 6811B, 6812B, 6813B, Only This command specifies the dc offset points in a list.
Language Dictionary - 3 LIST:VOLTage:OFFSet:SLEW Agilent 6811B, 6812B, 6813B, Only This command specifies the dc offset slew list points. The slew points are given in the command parameters, which are separated by commas. The order in which the points are entered determines the sequence in which they are output when a list is triggered. Changing list data while a subsystem is in list mode generates an implied ABORt.
3 - Language Dictionary Source Subsystem (Phase) This subsystem programs the output phases of the . When phase commands are used to program singlephase units, the only discernible effect in using the phase commands is to cause an instantaneous shift in the output waveform phase.
Language Dictionary - 3 PHASe:MODE Phase Selectable This command determines how the output phase is controlled during a triggered output transient. The choices are: FIXed STEP PULSe LIST The output phase is unaffected by a triggered output transient. The output phase is programmed to the value set by PHASe:TRIGgered when a triggered transient occurs. The output phase is changed to the value set by PHASe:TRIGgered for a duration determined by the pulse commands.
3 - Language Dictionary Source Subsystem (Pulse) This subsystem controls the generation of output pulses. The PULSe:DCYCle, PULSe:HOLD, PULSe:PERiod, and PULSe:WIDTh commands are coupled, which means that the values programmed by any one of these commands can be affected by the settings of the others. Refer to the tables under PULSe:HOLD for an explanation of how these commands affect each other.
Language Dictionary - 3 PULSe:HOLD This command specifies whether the pulse width or the duty cycle is to be held constant when the pulse period changes. The following tables describe how the duty cycle, period, and width are affected when one, two, or all three parameters are set in a single program message.
3 - Language Dictionary PULSe:PERiod This command sets the period of a triggered output transient The command parameters are modeldependent. Command Syntax Parameters Unit *RST Value Examples Query Syntax Returned Parameters Related Commands [SOURce:]PULSe:PERiod 3-phase models: 0 to 1.07533E6 | MINimum | MAXimum 1-phase models: 0 to 4.30133E5 | MINimum | MAXimum S (seconds) .03333 PULS:PER 0.
Language Dictionary - 3 Source Subsystem (Voltage) This subsystem programs the output voltage of the ac source.
3 - Language Dictionary VOLTage Phase Selectable This command programs the ac rms output voltage level of the ac source. The maximum peak voltage that the ac source can output is 425 V peak. This includes any combination of voltage, voltage offset, and function shape values. Therefore, the maximum value that can be programmed depends on the peak-to-rms ratio of the selected waveform. For a sinewave, the maximum voltage that can be programmed is 300 V rms.
Language Dictionary - 3 VOLTage:MODE Phase Selectable This command determines how the ac rms output voltage is controlled during a triggered output transient. The choices are: FIXed STEP PULSe LIST The voltage is unaffected by a triggered output transient. The voltage is programmed to the value set by VOLTage:TRIGgered when a triggered transient occurs. The voltage is changed to the value set by VOLTage:TRIGgered for a duration determined by the pulse commands.
3 - Language Dictionary VOLTage:OFFSet:MODE Agilent 6811B, 6812B, 6813B, Only This command determines how the dc offset voltage is controlled during a triggered output transient. The choices are: FIXed STEP PULSe LIST The offset is unaffected by a triggered output transient. The offset is programmed to the value set by VOLTage:OFFSet:TRIGgered when a triggered transient occurs. The offset is changed to the value set by VOLTage:OFFSet:TRIGgered for a duration determined by the pulse commands.
Language Dictionary - 3 VOLTage:OFFSet:SLEW Agilent 6811B, 6812B, 6813B, Only This command sets the slew rate for all programmed changes in dc output voltage. A parameter of MAXimum or INFinity sets the slew to its maximum possible rate. The SCPI representation for INFinity is 9.9E37. Command Syntax Parameters Unit *RST Value Examples Query Syntax Returned Parameters Related Commands [SOURce:]VOLTage:OFFSet:SLEW[:IMMediate] | INFinity 0 to 9.
3 - Language Dictionary VOLTage:OFFSet:SLEW:TRIGgered Agilent 6811B, 6812B, 6813B, Only This command selects the dc offset slew rate that will be set during a triggered step or pulse transient. A parameter of MAXimum or INFinity sets the slew to its maximum possible rate. The SCPI representation for infinity is 9.9E37. Command Syntax Parameters Unit *RST Value Examples Query Syntax Returned Parameters Related Commands [SOURce:]VOLTage:OFFSet:SLEW:TRIGgered | INFinity 0 to 9.
Language Dictionary - 3 VOLTage:RANGe Agilent 6814B, 6834B, 6843A Only Phase Selectable This command sets the voltage range of the ac source. Two voltage ranges are available: a 150 volt range and a 300 volt range. Sending a parameter greater than 150 selects the 300 volt range, otherwise the 150 volt range is selected. When the range is set to 150, the maximum rms voltage that can be programmed for a sine wave is 150 volts.
3 - Language Dictionary VOLTage:SENSe:SOURce VOLTage:ALC:SOURce These commands select the source from which the output voltage is sensed. The commands are interchangeable; they both perform the same function. The following voltage sense sources can be selected: INTernal EXTernal This senses the voltage at the output of the power amplifier on the inboard side of the output disconnect relay.
Language Dictionary - 3 VOLTage:SLEW:MODE Phase Selectable This command determines how the output voltage slew rate is controlled during a triggered output transient. The choices are: FIXed STEP PULSe LIST The slew rate is unaffected by a triggered output transient. The slew rate is programmed to the value set by VOLTage:SLEW:TRIGgered when a triggered transient occurs. The slew rate is changed to the value set by VOLTage:SLEW:TRIGgered for a duration determined by the pulse commands.
3 - Language Dictionary Status Subsystem This subsystem programs the ac source status registers. The ac source has four groups of status registers; Operation, Questionable, Questionable Instrument ISummary and Standard Event. The Standard Event group is programmed with Common commands. The Operation, Questionable, and Instrument ISummary status groups each consist of the following five registers: Condition Enable Event NTR Filter PTR Filter.
Language Dictionary - 3 Bit Configuration of Operation Status Registers Bit Position Bit Name 15–9 8 7–6 5 4–1 0 not used CV not used WTG not used CAL Bit Weight 256 32 1 CAL = Interface is computing new calibration constants WTG = Interface is waiting for a trigger. CV = Output voltage is regulated. STATus:OPERation? This query returns the value of the Operation Event register.
3 - Language Dictionary STATus:OPERation:NTRansition STATus:OPERation:PTRansition These commands set or read the value of the Operation NTR (Negative-Transition) and PTR (PositiveTransition) registers.
Language Dictionary - 3 Bit Configuration of Questionable Status Registers Bit Position 15 14 13 12 11 10 9 8–5 4 3 2 1 0 Bit Name not used Meas Ovld Isum CL rms Rail CL peak RI not used OT UNR SOA OCP OV 16384 8192 4096 2048 1024 512 16 8 4 2 1 Bit Weight OV OCP SOA UNR OT RI CL peak Rail over-voltage protection has tripped over-current protection has tripped safe operating area protection has tripped (Agilent 6811B, 6812B, 6813B) output is unregulated over-temperat
3 - Language Dictionary STATus:QUEStionable:ENABle This command sets or reads the value of the Questionable Enable register. This register is a mask for enabling specific bits from the Questionable Event register to set the questionable summary (QUES) bit of the Status Byte register. This bit (bit 3) is the logical OR of all the Questionable Event register bits that are enabled by the Questionable Status Enable register.
Language Dictionary - 3 Bit Configuration of Questionable Instrument Summary Registers Bit Position 15–13 12 11 10 9 8–5 4 3 2 1 0 Bit Name not used CL rms Rail not used RI not used OT UNR not used OCP OV 4096 2048 16 8 2 1 Bit Weight OV OCP UNR OT RI Rail CL rms 512 over-voltage protection has tripped over-current protection has tripped output is unregulated over-temperature protection has tripped remote inhibit is active rail protection tripped (Agilent 6811B, 6812B, 6813B
3 - Language Dictionary STATus:QUEStionable:INSTrument:ISUMmary:CONDition? Agilent 6834B Only Phase Selectable This query returns the value of the Questionable Condition register for a specific output of a three-phase ac source. The particular output phase must first be selected by INST:NSEL. The Condition register is a read-only register which holds the real-time (unlatched) questionable status of the ac source.
Language Dictionary - 3 STATus:QUEStionable:INSTrument:ISUMmary:NTR STATus:QUEStionable:INSTrument:ISUMmary:PTR Agilent 6834B Only These commands set or read the value of the Questionable Instrument Isummary NTR (NegativeTransition) and PTR (Positive-Transition) registers for a three-phase ac source.
3 - Language Dictionary System Commands The system commands control the system-level functions of the ac source.
Language Dictionary - 3 SYSTem:CONFigure:NOUTputs Agilent 6834B Only This command selects the number of output phases for ac sources that have single-phase and threephase switchable capability. This selection is stored in non-volatile memory and is retained after power-off. The execution of this command disables all outputs, reconfigures the current readback and programming calibration constants, returns all lists and *RCL states to their factory default states, and reboots the ac source.
3 - Language Dictionary SYSTem:LANGuage Sets the command language of the ac source to either SCPI or Elgar Model 9012 PIP. The language selection is stored in non-volatile memory and is retained after power-off. Both the command and query form can be given regardless of the current language. Refer to Appendix D for more information.
Language Dictionary - 3 Trace Subsystem This subsystem programs the output waveform of the ac source. Two waveform commands are available: TRACe and DATA. These commands are interchangeable; they both perform the same function.
3 - Language Dictionary TRACe:CATalog? DATA:CATalog? These queries return a list of defined waveform names. The list includes both pre-defined waveforms such as SINusoid, SQUare, and CSINusoid, as well as any user-defined waveforms.
Language Dictionary - 3 Trigger Subsystem This subsystem controls the triggering of the ac source. See Chapter 4 under "Triggering Output Changes" for an explanation of the Trigger Subsystem. The INITiate commands control the initialization of both the transient and measurement trigger systems. NOTE: The trigger subsystem must first be enabled using the INITiate commands or no triggering action will occur.
3 - Language Dictionary ABORt This command resets the measurement and transient trigger systems to the Idle state. Any output transient or measurement that is in progress is immediately aborted. ABORt also cancels any lists or pulses that may be in process. ABORt also resets the WTG bit in the Operation Condition Status register (see Chapter 4 under “Programming the Status Registers”). ABORt is executed at power turn-on and upon execution of *RCL, RST, or any implied abort command (see List Subsystem).
Language Dictionary - 3 INITiate:CONTinuous:SEQuence INITiate:CONTinuous:NAME These commands control the transient generator trigger system as follows: Continuously initiates the transient trigger system. Turns off continuous triggering. In this state, the trigger system must be initiated for each triggered event using INITiate:SEQuence. 1 or ON 0 or OFF INITiate:CONTinuous:SEQuence references the transient trigger sequence by its number, while INITiate:CONTinuous:NAME references it by its name.
3 - Language Dictionary TRIGger:SOURce This command selects the trigger source for the first sequence in generating a step, pulse, or list output as follows: BUS EXTernal IMMediate GPIB device, *TRG, or (Group Execute Trigger) ac source’s backplane Trigger In BNC trigger is generated as soon as the trigger system is initiated.
Language Dictionary - 3 TRIGger:SEQuence2:PHASe TRIGger:SYNCHronize:PHASe These commands set the phase angle with respect to an internal phase reference at which PHASe:SYNChronous:SOURce becomes true. The range is from −360 to +360 degrees.
3 - Language Dictionary TRIGger:SEQuence3:SOURce TRIGger:ACQuire:SOURce These commands select the trigger source for a triggered measurement sequence as follows: BUS EXTernal TTLTrg GPIB device, *TRG, or (Group Execute Trigger) ac source’s backplane Trigger In BNC the signal driving the Trigger Out BNC Command Syntax Parameters *RST Value Examples Query Syntax Returned Parameters Related Commands TRIGger:SEQuence3:SOURce TRIGger:ACQuire:SOURce BUS | EXTernal | TTLTrg BUS TRIG:ACQ:SOUR
Language Dictionary - 3 Common Commands Common commands begin with an * and consist of three letters (command) IEEE 488.2 standard to perform some common interface functions. The Agilent ac sources respond to the required common commands that control status reporting, synchronization, and internal operations. The ac sources also respond to optional common commands that control triggers, power-on conditions, and stored operating parameters. Common commands and queries are listed alphabetically.
3 - Language Dictionary *CLS This command clears the following registers (see Chapter 4 under “Programming the Status Registers” for descriptions of all registers): u Standard Event Status u Operation Status Event u Questionable Status Event u Status Byte u Error Queue Command Syntax Parameters *CLS None *ESE This command programs the Standard Event Status Enable register bits.
Language Dictionary - 3 *ESR? This query reads the Standard Event Status Event register. Reading the register clears it. The bit configuration of this register is the same as the Standard Event Status Enable register (see *ESE). See Chapter 4 under “Programming the Status Registers” for a detailed explanation of this register. Query Syntax Parameters Returned Parameters Related Commands *ESE? None (register value) *CLS *ESE *ESE? *OPC *IDN? This query requests the ac source to identify itself.
3 - Language Dictionary *OPT? This query requests the ac source to identify any options that are installed. Options are identified by number. A 0 indicates no options are installed.
Language Dictionary - 3 *RST This command resets the to the following factory-defined states: CAL:STAT OFF DISP:STAT DISP:MODE INIT:CONT INST:COUP INST:NSEL OUTP OUTP:COUP OUTP:DFI OUTP:DFI:SOUR OUTP:IMP OUTP:IMP:REAL OUTP:IMP:REAC OUTP:PROT:DEL OUTP:RI:MODE OUTP:TTLT OUTP:TTLT:SOUR SENS:CURR:ACDC:RANG SENS:SWE:OFFS:POIN SENS:SWE:TINT SENS:WIND [SOUR:]CURR [SOUR:]CURR:PEAK [SOUR:]CURR:PEAK:TRIG [SOUR:]CURR:PEAK:MODE [SOUR:]CURR:PROT:STAT [SOUR:]FREQ [SOUR:]FREQ:MODE [SOUR:]FREQ:SLEW [SOUR:]FREQ:SLEW:MODE [
3 - Language Dictionary *SAV This command stores the present state of the ac source to a specified location in memory. Up to 16 states can be stored in nonvolatile memory. If a particular state is desired at power-on, it should be stored in location 0. It then will be recalled at power-on if the OUTPut:PON:STATe command is set to RCL0. Use *RCL to retrieve instrument states. Note that List data cannot be saved in state storage. Only one list is saved in non-volatile memory.
Language Dictionary - 3 *STB? This query reads the Status Byte register, which contains the status summary bits and the Output Queue MAV bit. Reading the Status Byte register does not clear it. The input summary bits are cleared when the appropriate event registers are read (see Chapter 4 under “Programming the Status Registers” for more information). A serial poll also returns the value of the Status Byte register, except that bit 6 returns Request for Service (RQS) instead of Master Status Summary (MSS).
3 - Language Dictionary *WAI This command instructs the ac source not to process any further commands until all pending operations are completed. Pending operations are complete when: u All commands sent before *WAI have been executed. This includes overlapped commands. Mo st commands are sequential and are completed before the next command is executed. Overlapped commands are executed in parallel with other commands.
4 Programming Examples Introduction This chapter contains examples on how to program your ac source. Simple examples show you how to program: u output functions such as voltage, frequency, and phase u the transient waveform generator u internal and external triggers u measurement functions u user-defined waveforms u the status and protection functions NOTE: These examples in this chapter are generic SCPI commands. See Chapter 2 for information about encoding the commands as language strings.
4 - Programming Examples AC Voltage and Frequency The ac rms output voltage is controlled with the VOLTage command. For example, to set the ac output voltage to 125 volts rms, use: VOLTage 125 NOTE: In the three-phase model, all phases are programmed to 125 volts rms because the INSTrument:COUPle at *RST is set to ALL. The ac source can be programmed to turn off its output if the ac output voltage exceeds a preset peak voltage limit.
Programming Examples - 4 Frequency The output frequency is controlled with the FREQuency command. To set the output frequency to 50 Hz, use: FREQuency 50 Voltage and Frequency Slew Rates Voltage Slew The ac source has the ability to control the slew rate of ac amplitude changes. This can be used to generate ramps or to protect sensitive loads.
4 - Programming Examples Clipped Waveform To select a clipped sine waveform use: FUNCtion:SHAPe CSINusoid To set the clipping level to 50%, use: FUNCtion:SHAPe:CSINusoid 50 The clipping level is the percentage of the peak amplitude at which clipping occurs. The clipping level can also be specified in terms of the percent total harmonic distortion in the clipped sine waveform by adding a THD suffix to the command.
Programming Examples - 4 Selecting a Phase Two commands determine which output phase or phases receive commands in the three-phase model. These are: INSTrument:COUPle ALL | NONE INSTrument:NSELect The *RST setting for INSTrument:COUPle is ALL. This setting causes programming commands to be sent to all output phases simultaneously. To send a programming command to only one of the output phases, set INSTrument:COUPle to NONE, then select the desired output to receive the command with INSTrument:NSELect.
4 - Programming Examples The ac source can be programmed to turn off its output if the rms current limit is reached. This protection feature is implemented with the CURRent:PROTection:STATe command as explained in Chapter 3. NOTE: On the Agilent 6814B, 6834B and 6843A, the CURRent command is coupled with the VOLTage:RANGe. This means that the maximum current limit that can be programmed at a given time depends on the voltage range setting in which the unit is presently operating.
Programming Examples - 4 Coupled Commands This section describes how to avoid programming errors that may be caused because of the error checking done for coupled commands. VOLTage:LEVel, VOLTage:OFFSet, and FUNCtion:SHAPe When using these commands, assume the present state of the ac source has ac amplitude set to 240 volts rms and dc offset set to 0, and a new state is desired with ac amplitude of 0 and dc offset of 300 volts.
4 - Programming Examples Programming both the current and the voltage range in one program message unit can be done in any order and will not cause an error if the final combination specifies a valid current limit for the indicated range. If the commands VOLTage:RANGe 300 CURRent 10;:VOLTage:RANGe 150 are sent, no error will be generated because the combined current limit and voltage range specified on the second line are within the output ratings of the above models.
Programming Examples - 4 Transient System Model Figure 4-1 is a model of the transient system. The figure shows the transient modes and the source of the data that generates each mode. When a trigger is received in step or pulse modes, the triggered functions are set from their IMMediate to their TRIGgered value. In Step mode, the triggered value becomes the immediate value. In Pulse mode, the functions return to their immediate value during the low portion of the pulse.
4 - Programming Examples Step and Pulse Transients Step 1 Set the functions that you do not want to generate transients to FIXed mode. A convenient way to do this is with the *RST command. Then set the mode of the function that will generate the transient to STEP or PULSe as required. For example, to enable the voltage function to generate a single triggered output voltage change, use: *RST VOLTage:MODE STEP Step 2 Set the triggered level of the function that will generate the transient.
Programming Examples - 4 List Transients List mode lets you generate complex sequences of output changes with rapid, precise timing, which may be synchronized with internal or external signals. Each function that can participate in output transients can also have an associated list of values that specify its output at each list point.
4 - Programming Examples Step 4 Determine the number of times the list is repeated before it completes. For example, to repeat a list 10 times use: LIST:COUNt 10 Entering INFinity makes the list repeat indefinitely. At *RST, the count is set to 1. Step 5 Determines how the list sequencing responds to triggers. For a closely controlled sequence of output levels, you can use a dwell-paced list.
Programming Examples - 4 Output Trigger System Model Figure 4-2 is a model of the output trigger system. The rectangular boxes represent states. The arrows show the transitions between states. These are labeled with the input or event that causes the transition to occur.
4 - Programming Examples Initiating the Output Trigger System When the ac source is turned on, the trigger system is in the idle state. In this state, the trigger system ignores all triggers. Sending the following commands at any time returns the trigger system to the Idle state: ABORt *RST *RCL The INITiate commands move the trigger system from the Idle state to the Initiated state. This enables the ac source to receive triggers.
Programming Examples - 4 Specifying a Trigger Delay A time delay can be programmed between the receipt of the trigger signal and the start of the output transient. At *RST the trigger delay is set to 0, which means that there is no delay. To program a delay, use: TRIGger:SEQuence1:DELay .01or TRIGger:TRANsient:DELay .01 which sets a delay time of 10 milliseconds. NOTE: A trigger delay can only be programmed for SEQuence1 (or TRANsient) triggers.
4 - Programming Examples Generating Output Triggers Providing that you have specified the appropriate trigger source, you can generate triggers as follows: Single Triggers u By sending one of the following over the GPIB: TRIGger:IMMediate *TRG a group execute trigger u By applying a signal with a high-to-low transition to the Trig In BNC connector. u By pressing the front panel Trigger key when the unit is operating in local mode.
Programming Examples - 4 Making Measurements The ac source has the capability to return a number of current, voltage, and power measurements. When the ac source is turned on, it is continuously sampling the instantaneous output voltage and current for several output cycles and writing the results into a buffer. The buffer holds 4096 voltage and current data points. The ac source uses the data from the voltage and current buffer to calculate the requested measurement information.
4 - Programming Examples Power Measurements The MEASure and FETCh queries can return real, apparent, and reactive power measurements as well as dc power and power factor using the following commands: MEASure:POWer:AC:APParent? MEASure:POWer:AC:REACtive? MEASure:POWer:AC:REAL? MEASure:POWer:AC:PFACtor? MEASure:POWer:AC:TOTal? MEASure:POWer:DC? measures the ac component of apparent power in VA measures the reactive power measures the in-phase component of power in watts returns the output power factor measu
Programming Examples - 4 INSTrument:NSELect 1 FETCh:VOLTage:AC? INSTrument:NSELect 2 FETCh:VOLTage:AC? INSTrument:NSELect 3 FETCh:VOLTage:AC? Returning Voltage and Current Data From the Data Buffer The MEASure and FETch queries can also return all 4096 data values of the instantaneous voltage and current buffers.
4 - Programming Examples ABOR IDLE STATE *RST *RCL INIT[:IMM] INITIATED STATE TRIGGER RECEIVED DATA ACQUISITION Figure 4-3. Model of Measurement Triggers Initiating the Measurement Trigger System When the ac source is turned on, the trigger system is in the idle state. In this state, the trigger system ignores all triggers.
Programming Examples - 4 To select GPIB bus triggers (group execute trigger, device trigger, or *TRG command), use: TRIGger:SEQuence3:SOURce BUS or TRIGger:ACQuire:SOURce BUS To select the signal driving the Trigger Out BNC connector, use: TRIGger:SEQuence3:SOURce TTLTrg or TRIGger:ACQuire:SOURce TTLTrg Generating Measurement Triggers Providing that you have specified the appropriate trigger source, you can generate triggers as follows: u By sending one of the following over the GPIB: TRIGger:SEQuence3
4 - Programming Examples OFFSET = -4096 4096 DATA POINTS OFFSET = -2048 4096 DATA POINTS OFFSET = 0 4096 DATA POINTS OFFSET = 0 to 2 9 4096 DATA POINTS TIME ACQUISITION TRIGGER Figure 4-4. Pre-event and Post-event Triggering Programming the Status Registers You can use status register programming to determine the operating condition of the ac source at any time. For example, you may program the ac source to generate an interrupt (assert SRQ) when an event such as a current limit occurs.
Programming Examples - 4 NTR Filter STAT:OPER:NTR A negative transition filter that functions as described under STAT:OPER:NTR|PTR commands in Chapter 3. It is a read/write register. Event STAT:OPER:EVEN? A register that latches any condition that is passed through the PTR or NTR filters. It is a read-only register that is cleared when read. Enable STAT:OPER:ENAB? A register that functions as a mask for enabling specific bits from the Event register. It is a read/write register.
4 - Programming Examples QUESTIONABLE STATUS 0 CONDITION 0 OV 0 I 3 OCP EVENT STATUS QUERY EXAMPLE: ENABLE STAT:QUES:EVEN? 1536 I 2 1 I 1 PTR/NTR 0 1 1 1 1 2 2 2 2 4 4 4 4 8 8 8 8 16 16 16 16 EXPLANATION: 2 SOA 1536 = 512 + 1024 (bit 9 + bit 10) 3 UNR Both RI and CL peak conditions have occurred OT LOGICAL OR 4 5-8 n.u.
Programming Examples - 4 Questionable Status Group The Questionable Status registers record signals that indicate abnormal operation of the ac source. As shown in the figure 4-5, the group consists of the same type of registers as the Status Operation group. Register Command Description Condition STAT:QUES:COND? A register that holds real-time status of the circuits being monitored. It is a read-only register.
4 - Programming Examples Register Command Description Condition STAT:QUES:INST:ISUM:COND? A register that holds real-time status of the circuits being monitored. It is a read-only register. PTR Filter STAT:QUES:INST:ISUM:PTR A positive transition filter that functions as described under STAT:QUES:INST:ISUM:NTR|PTR commands in Chapter 3. It is a read/write register.
Programming Examples - 4 Status Byte Register This register summarizes the information from all other status groups as defined in the IEEE 488.2 Standard Digital Interface for Programmable Instrumentation. The bit configuration is shown in Table 4-1.
4 - Programming Examples Servicing Questionable Status Events This example assumes you want a service request generated whenever the ac source’s overvoltage, overcurrent, or overtemperature circuits have tripped. From figure 4-5, note the required path for Questionable Status conditions at bits 0, 1, and 4 to generate a service request (RQS) at the Status Byte register.
Programming Examples - 4 Trigger Out BNC This chassis-referenced digital output can be programmed to supply a pulse output at the leading or trailing edge of a step or pulse, or at the leading edge of any point in a list sequence. The output signal is nominally a 10 microsecond low-true pulse. To enable the Trigger Out connector, use: OUTPut:TTLTrg:STATe ON At *RST, the Trigger Out connector is off.
4 - Programming Examples Remote Inhibit (RI) Remote inhibit is an external logic signal routed through the rear panel INH connection, which allows an external device to signal a fault. To select an operating modes for the remote inhibit signal, use: OUTPut:RI:MODE LATChing | LIVE | OFF LATChing -causes a low-true signal on the INH input to disable the output. The only way to clear the latch is by sending an OUTPut:PROTection:CLEAR command while the INH input is false.
A SCPI Command Tree Command Syntax ABORt CALibrate :CURRent :AC :MEASure :DATA :IMPedance :LEVel P1 | P2 | P3 | P4 :PASSword :PWM :FREQuency :RAMP :SAVE :STATe [, ] :VOLTage :AC :DC :OFFSet :PROTection :RTIMe DATA | TRACe :CATalog? [:DATA] , {, } :DEFine [, | 1024] :DELete [:NAME] DISPlay [:WINDow] [:STATe] :MODE NORMal | TEXT :TEXT [:DATA] INITiate [:IMMediate] :SEQuence[ 1 | 3 ] :NAME TRANsient | ACQu
A - SCPI Command Tree OUTPut [:STATe] :COUPling DC | AC :DFI [:STATe] :SOURce QUES | OPER | ESB | RQS | OFF :IMPedance [:STATe] :REAL :REACtive :PON :STATe RST | RCL0 :PROTection :CLEar :DELay :RI :MODE LATCHing | LIVE | OFF :TTLTrg [:STATe] :SOURce BOT | EOT | LIST SENSe :CURRent :ACDC :RANGe [:UPPEr] :SWEep :OFFSet :POINts :TINTerval :WINDow [:TYPE] KBESsel | RECTangular [SOURce:] CURRent [:LEVel] [:IMMediate] [:AMPLitude] :PEAK [:IMMediate] :
SCPI Command Tree - A STATus :OPERation [:EVENt]? :CONDition? :ENABle :NTRansition :PTRansition :PRESet :QUEStionable [:EVENt]? :CONDition? :ENABle :NTRansition :PTRansition :INSTrument :ISUMmary [:EVENt]? :CONDition? :ENABle :NTRansition :PTRansition SYSTem :CONFigure :NOUTputs 1 | 3 :ERRor? :VERSion? :LANGuage SCPI | E9012 :LOCal :REMote :RWLock TRIGger [:TRANsient | :SEQuence1] [:IMMediate] :SOURce BUS | EXTernal | IMMediate :DELay :SYNChonize | :SEQuence2 :SOURce
B SCPI Conformance Information The ac source responds to SCPI Version 1992.
B - SCPI Conformance Information Non SCPI Commands CAL:CURR:AC CAL:CURR:DC CAL:LEV CAL:PASS CAL:PWM:FREQ CAL:PWM:RAMP CAL:SAVE CAL:VOLT:AC CAL:VOLT:DC CAL:VOLT:OFFS DISP[:WIND]:MODE MEAS | FETC[:SCAL]:CURR:ACDC? MEAS | FETC[:SCAL]:CURR:AMPL:MAX? MEAS | FETC[:SCAL]:CURR:CRES? MEAS | FETC[:SCAL]:CURR:HARM[:AMPL]? MEAS | FETC[:SCAL]:CURR:HARM:PHAS? MEAS | FETC[:SCAL]:CURR:HARM:THD? MEAS | FETC[:SCAL]:CURR:NEUT[:DC]? MEAS | FETC[:SCAL]:CURR:NEUT:AC? MEAS | FETC[:SCAL]:CURR:NEUT:DC? MEAS | FETC[:SCAL]:CURR:NEUT
C Error Messages Error Number List This appendix gives the error numbers and descriptions that are returned by the ac source. Error numbers are returned in two ways: ♦ Error numbers are displayed on the front panel ♦ Error numbers and messages are read back with the SYSTem:ERRor? query. SYSTem:ERRor? returns the error number into a variable and returns two parameters, an NR1 and a string. The following table lists the errors that are associated with SCPI syntax errors and interface problems.
C - Error Messages –170 –171 –178 Expression error Invalid expression Expression data not allowed –200 –221 –222 –223 –224 –225 –270 –272 –273 –276 –277 Execution Errors –200 through –299 (sets Standard Event Status Register bit #4) Execution error [generic] Settings conflict [check current device state] Data out of range [e.g.
Error Messages - C 44 45 70 80 Current selftest error, output 2 Current selftest error, output 3 Fan voltage failure Digital I/O selftest error 200 201 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 401 402 403 404 405 406 600 601 602 603 604 605 606 607 608 609 610 Device-Dependent Errors 100 through 32767 (sets Standard Event Status Register bit #3) Outgrd not responding Front panel not responding Ingrd receiver framing error Ingrd uart overrun status Ingrd received bad token Ingrd receive
D Elgar Model 9012 Compatibility Elgar Model 9012 Plug-in Programmer Compatibility The ac source interface has a language switch command that allows it to emulate the Elgar Model 9012 Plug-in Programmer. The command to switch languages is: SYSTem:LANGuage SCPI | E9012 The language selection is stored in non-volatile memory and is retained after power-off.
D - Elgar Model 9012 Compatibility Status Model In E9012 language, status information is provided through the serial poll response byte and the error queue. The error queue operates as it does in SCPI language, providing error status of selftest and other runtime errors. The SYSTem:ERRor? query operates identically in SCPI and E9012 languages. The E9012 language provides an abbreviated status model consisting entirely of the serial poll response byte.
Elgar Model 9012 Compatibility - D All power source functions not set by the above commands go to the state defined by the SCPI *RST command, with the following exceptions: OUTPut:STATe ON VOLT:SENSe:SOURce EXTernal VOLT:SENSe:DETector RMS Protection The SOA fault, overtemperature, rail fault, overvoltage, and overcurrent protection features are operational in E9012 language and are reported through the serial poll response byte.
D - Elgar Model 9012 Compatibility Input key functions: Display Format INP:COUP Description Set coupling for front panel measurements (AC | DC | ACDC) Trigger Control key functions: Display Format JUMPER1 Description Set W1 emulation jumper (NORM | ALT) Pulse key functions: Display Format DROP Description Dropout for half cycles (JUMPER1 NORM) or for full cycles (JUMPER1 ALT) Entry Keys The Calibration key is not operational in E9012 language.
Elgar Model 9012 Compatibility - D Command Description ZERO The next voltage or frequency change is at 0 degrees phase (JUMPer1 NORMal), or 180 degrees phase (JUMPer1 ALTernate). The VOLTS or FREQ command must be part of the same program message unit. PEAK The next voltage or frequency change is at 90 degrees phase (JUMPer1 NORMal), or 270 degrees phase (JUMPer1 ALTernate). The VOLTS or FREQ command must be part of the same program message unit.
E IEC Mode Command Summary Introduction The Agilent 6812B, 6813B, and 6843A ac sources are designed to operate in Normal as well as IEC mode. In Normal mode, the units respond to all of the commands that program ac source operation. Normal mode commands are documented in this Programmer’s Guide. In IEC mode, when used in conjunction with the Agilent 14761A Harmonic and Flicker Emissions Tests software, ac source provides full EN 61000-3-2/EN 60555 Part 2 and EN 61000-3-3 compliance test capability.
E - IEC Mode Command Summary Command Syntax CALCulate :INTegral :TIME :LIMit :UPPer [:DATA] :SMOothing FORMat [:DATA] :BORDer MEASure :ARRay :CURRent :HARMonic? :VOLTage :FLUCtuations :FLICker? :PST? :ALL? SENSe :CURRent :PREFerence :WINDow [:TYPE] SYSTem :CONFigure 168 selects the Pst integration time for flicker measurements sets various limits associated with rms voltage fluctuation testing for IEC 1000-3-3 turns the
IEC Mode Command Summary - E CALCulate:INTegral:TIME This command selects the Pst integration time for IEC Flicker measurements. The parameter may only assume values of 1, 5, 10, and 15 minutes in accordance with IEC 868. The command will be accepted and may be queried, but will have no meaningful function unless the ac source is placed in IEC mode using the SYSTem:CONFigure command.
E - IEC Mode Command Summary CALCulate:LIMit:UPPer This command sets various limits associated with rms voltage fluctuations testing for IEC 1000-3-3. as described in the following table. All five parameters are type NRf. The order in which the five parameters are entered must correspond to the order in the table. 1 vss delta Sets the maximum peak-to-peak variation of relative voltage that defines 2 “steady-state”. At *RST this value is set to 0.003 .
IEC Mode Command Summary - E FORMat This command specifies the response data format for the following queries: MEASure:ARRay:CURRent:DC? MEASure:ARRay:VOLTage:DC? MEASure:ARRay:CURRent:HARMonic[:AMPLitude]? MEASure:ARRay:VOLTage:FLUCutations:ALL? MEASure:ARRay:VOLTage:FLUCutations:FLICker? MEASure:ARRay:VOLTage:FLUCutations:PST? When ASCii is selected, the response format for these queries is NR3 Numeric Response Data. This format is selected at *RST.
E - IEC Mode Command Summary FORMat:BORDer This command sets the byte order of IEEE floating point values returned within Arbitrary Block Response Data. When NORMal is selected, the first byte sent is the sign bit and seven most significant bits of the exponent, and the last byte sent is the least significant byte of the mantissa. This ordering is most useful for big-endian controllers such as those that use Motorola processors.
IEC Mode Command Summary - E MEASure:ARRay:CURRent:HARMonic? This query returns an array of current harmonic magnitudes. Operation of the query is modified by the SYSTem:CONF command (see summary table under SYSTem:CONFigure). The parameter specifies the number of harmonic arrays to be returned in response to the query. If SYSTem:CONFigure specifies NORMal operation, the parameter is ignored (ie it is forced to 1).
E - IEC Mode Command Summary MEASure:ARRay:VOLTage:FLUCtuations:ALL? This query measures voltage fluctuations in accordance with the IEC 868 standard. It is only available when IEC mode is selected with SYSTem:CONFigure. The parameter specifies the number of Pst integration periods during which data will be returned in response to the query. This query returns the data structures associated with both the MEAS:ARR:VOLT:FLUC:FLIC query and the MEAS:ARR:VOLT:FLUC:PST query.
IEC Mode Command Summary - E 0 ↓ 99 0 ↓ 99 Record Number Error Code P_0.
E - IEC Mode Command Summary MEASure:ARRay:VOLTage:FLUCtuations:FLICker? This query measures voltage fluctuations in accordance with the IEC 868 standard. It is only available when IEC mode is selected with SYSTem:CONFigure. The parameter specifies the number of Pst integration periods during which voltage fluctuation arrays will be returned in response to the query.
IEC Mode Command Summary - E MEASure:ARRay:VOLTage:FLUCtuations:PST? This query measures voltage fluctuations in accordance with the IEC 868 standard. It is only available when IEC mode is selected with SYSTem:CONFigure. The parameter specifies the number of Pst integration periods for which data will be returned in response to the query. This query returns 1 data structure per specified integration period for a total of structures.
E - IEC Mode Command Summary SENSe:CURRent:PREFerence This command sets the phase reference for current harmonic phase measurements. If VOLTage is selected, the reference is the fundamental component of the measured output voltage. If CURRent is selected, the reference is the fundamental component of the measured output current.
IEC Mode Command Summary - E SYSTem:CONFigure Agilent 6812B, 6813B, 6843A Only This command sets the overall operating mode of the ac source. The choices are Normal mode, which causes the product to closely mimic the operating characteristics of standard ac sources, or IEC mode, which modifies the basic behavior of the transient and measurement systems to facilitate IEC measurements.
Index —A— ac voltage, 122 assigning HP-IB address in programs, 24 —B— BNC connectors, 148 —C— calibration subsystem, 29 CALibrate CURRent AC, 29 CALibrate CURRent MEASure, 30 CALibrate DATA, 30 CALibrate IMPedance, 30 CALibrate LEVel, 30 CALibrate PASSword, 31 CALibrate PWM FREQuency, 31 CALibrate PWM RAMP, 31 CALibrate SAVE, 31 CALibrate STATe, 32 CALibrate VOLTage AC, 32 CALibrate VOLTage DC, 32 CALibrate VOLTage OFFSet, 33 CALibrate VOLTage PROTection, 33 CALibrate VOLTage RTIMe, 33 syntax, 29 characte
Index short form, 21 history, 2 HP 82335A driver, 24 HP BASIC controllers, 25 HP-IB capabilities of ac source, 15 command library for MS DOS, 12 controller programming, 12 IEEE Std for standard codes, 12 IEEE Std for standard digital interface, 12 HP-IB Address, 15 HP-IB References, 12 HP-IB source address, 24 —I— INH connection, 149 instrument subsystem, 35 INSTrument COUPle, 35 INSTrument NSELect, 36 INSTrument SELect, 36 syntax, 35 —L— language dictionary, 27 list transients, 131 —M— MAV bit, 147 maxi
Index syntax, 52 measurement system, 137 measurement trigger system initiating, 140 model, 139 measurement triggers generating, 141 selecting, 140 message terminator, 22 end or identify, 22 newline, 22 message unit separator, 22 Message Units combing message units, 21 Moving among subsystems, 19 MSS bit, 147 multipliers, 23 —N— National Instruments GP-IB driver, 24 NTR filter, 148 numerical data formats, 23 —O— offset, 126 operation status group, 142 Optional header LEVel, 19 Optional Headers effect of, 1
Index —S— safety summary, 2 sampling rate, 141 SCPI command syntax, 27 data formats, 23 subsystem commands, 28 triggering nomenclature, 132, 139 SCPI command completion, 150 SCPI command tree, 18 SCPI common commands, 17 SCPI message structure, 20 SCPI message types, 17 SCPI message unit, 20 SCPI parser, 19 SCPI program message, 17 SCPI References, 12 SCPI response message, 17 SCPI subsystem commands, 17 sense subsystem, 60 SENSe CURRent ACDC RANGe, 60 SENSe SWEep OFFSet POINts, 61 TINTerval, 61 SENSe WIND
Index bit configuration, 95 status registers programming, 142 status subsystem, 94 QUEStionable INSTrument ISUMmary CONDition?, 100 QUEStionable INSTrument ISUMmary ENABle?, 100 QUEStionable INSTrument ISUMmary?, 99 STATus OPERation CONDition?, 95 STATus OPERation ENABle?, 95 STATus OPERation NTRansition, 96 STATus OPERation PTRansition, 96 STATus OPERation?, 95 STATus PRESet, 94 STATus QUEStionable CONDition?, 97, 98 STATus QUEStionable INSTrument ISUMmary NTRansition, 101 STATus QUEStionable INSTrument IS
Agilent Sales and Support Offices For more information about Agilent Technologies test and measurement products, applications, services, and for a current sales office listing, visit our web site: http://www.agilent.com/find/tmdir You can also contact one of the following centers and ask for a test and measurement sales representative. United States: Agilent Technologies Test and Measurement Call Center P.O.
Manual Updates The following updates have been made to this manual since the print revision indicated on the title page. 4/15/00 All references to HP have been changed to Agilent. All references to HP-IB have been changed to GPIB.
