Agilent Technologies 6814B manual

Programming Guide AC Power Solutions Agilent Models 6811B, 6812B, 6813B 6814B, 6834B, and 6843A Agilent Part No. 5962-0889 Printed in U.S.A. Microfiche No 6962-0890 December, 1998 Update April 2000[...]

2 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 t[...]

3 Table of Contents Safety Summary 2 Printing History 2 Table of Contents 3 1 - GENERAL INFORMATION 11 About this Guide 11 Earlier AC Source Models 11 Documentation Summary 11 External References 12 SCPI References 12 GPIB References 12 Agilent VX I plug&play Power Products Instrument Drivers 12 Supported Applications 12 System Requirements 13 [...]

4 System Considerations 24 Assigning the GPIB Address in Programs 24 Types of DOS Drivers 24 Error Handling 25 Agilent BASIC Controllers 25 3 - LANGUAGE DICTIONARY 27 Introduction 27 Subsystem Commands 28 Calibration Subsystem Commands 29 Subsystem Syntax 29 CALibrate:CURRent:AC 29 CALibrate:CURRent:MEASure 30 CALibrate:DATA 30 CALibrate:IMPedance [...]

5 MEASure:CURRent:HARMonic? FETCh:CURRent:HARMonic? 44 MEASure:CURRent:HARMonic:PHASe? FETCh:CURRent:HARMonic:PHASe? 45 MEASure:CURRent:HARMonic:THD? FETCh:CURRent:HARMonic:THD? 45 MEASure:CURRent:NEUTral? FETCh:CURRent:NEUTral? 45 MEASure:CURRent:NEUTral:AC? FETCh:CURRent:NEUTral:AC? 46 MEASure:CURRent:NEUTral:ACDC? FETCh:CURRent:NEUTral:ACDC? 46 [...]

6 Source Subsystem (Frequency) 65 Subsystem Syntax 65 FREQuency 65 FREQuency:MODE 65 FREQuency:SLEW 66 FREQuency:SLEW:MODE 66 FREQency:SLEW:TRIGgered 66 FREQuency:TRIGgered 67 Source Subsystem (Function) 68 Subsystem Syntax 68 FUNCtion 68 FUNCtion:MODE 69 FUNCtion:TRIGgered 69 FUNCtion:CSINusoid 70 Source Subsystem (List) 71 Subsystem Syntax 71 LIS[...]

7 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[...]

8 Trigger Subsystem 107 Subsystem Syntax 107 ABORt 108 INITiate:SEQuence INITiate:NAME 108 INITiate:CONTinuous:SEQuence INITiate:CONTinuous:NAME 109 TRIGger 109 TRIGger:DELay 109 TRIGger:SOURce 110 TRIGger:SEQuence2:SOURce TRIGger:SYNChronize:SOURce 110 TRIGger:SEQuence2:PHASe TRIGger:SYNCHronize:PHASe 111 TRIGger:SEQuence3 TRIGger:ACQuire 111 TRIG[...]

9 Specifying a Trigger Delay 135 Synchronizing Output Changes to a Reference Phase Angle 135 Generating Output Triggers 136 Specifying a Dwell Time for Each List Point 136 Making Measurements 137 Voltage and Current Measurements 137 Power Measurements 138 Harmonic Measurements 138 Simultaneous Output Phase Measurements (Agilent 6834B only) 138 Retu[...]

10 Function Keys 163 Entry Keys 164 E9012 Language Command Summary 164 E - IEC MODE COMMAND SUMMARY 167 Introduction 167 Using the SENSe:CURRent:ACDC:RANGe command 167 Command Syntax 168 CALCulate:INTegral:TIME 169 CALCulate:SMOothing 169 CALCulate:LIMit:UPPer 170 FORMat 171 FORMat:BORDer 172 MEASure:ARRay:CURRent:HARMonic? 173 MEASure:ARRay:VOLTag[...]

11 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 Introduction to this guide.[...]

1 - General Information 12 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 P[...]

General Information - 1 13 System Requirements The Agilent VXI plug&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 instrum[...]

[...]

15 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 [...]

2 - Introduction to Programming 16 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 RS[...]

Introduction to Programming - 2 17 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[...]

2 - Introduction to Programming 18 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 [...]

Introduction to Programming - 2 19 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:[...]

2 - Introduction to Programming 20 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:T[...]

Introduction to Programming - 2 21 Combining Message Units The following command message is briefly described here, with details in subsequent paragraphs. Figure 2-2. Command Message Structure The basic parts of the above message are: Message Component Example Headers VOLT LEV PROT CURR Header Separator The colon in VOLT:LEV Data 8088 Data Separato[...]

2 - Introduction to Programming 22 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). O[...]

Introduction to Programming - 2 23 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 <NR1> Digits with an implied decimal point assumed at the right of the least-significant digit. Examples: 273 <NR2> Di[...]

2 - Introduction to Programming 24 System Considerations The remainder of this chapter addresses some system issues concerning programming. These are ac source addressing and the use of the following types of GPIB system interfaces: u HP Vectra PC controller with Agilent 82335A GPIB Interface Command Library u IBM PC controller with National Instru[...]

Introduction to Programming - 2 25 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 dete[...]

[...]

27 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[...]

3 - Language Dictionary 28 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 li[...]

Language Dictionary - 3 29 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. Subsystem Syntax CALibrate :CURRent :AC Begi[...]

3 - Language Dictionary 30 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 CALibrate:CURRent:MEASure Parameters None Examples CAL:CURR:MEAS Related Comma[...]

Language Dictionary - 3 31 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 c[...]

3 - Language Dictionary 32 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 [...]

Language Dictionary - 3 33 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 CALibrate:VOLTage:OFFSet Parameters None Examples CAL:VOLT:OFFS Related Commands CAL:SAVE CAL:STAT CAL:LEV CALibrate:VOLTage:[...]

3 - Language Dictionary 34 Display Subsystem Commands This subsystem programs the front panel display of the ac source. Subsystem Syntax DISPlay [:WINDow] [:STATe] <bool> Enable/disable front panel display :MODE <mode> Set display mode (NORMal | TEXT) :TEXT [:DATA] <display string> Set text displayed in text mode DISPlay This comm[...]

Language Dictionary - 3 35 Instrument Subsystem This subsystem programs the three-phase output capability of the Agilent 6834B . Subsystem Syntax INSTrument :COUPle <phase> Couple all phases for programming (ALL | NONE) :NSELect <n> Select the output phase to program (1 | 2 | 3) :SELect <output> Select the output phase to program [...]

3 - Language Dictionary 36 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 [...]

Language Dictionary - 3 37 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 retu[...]

3 - Language Dictionary 38 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 measur[...]

Language Dictionary - 3 39 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 digi[...]

3 - Language Dictionary 40 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 d[...]

Language Dictionary - 3 41 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[...]

3 - Language Dictionary 42 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. Indivi[...]

Language Dictionary - 3 43 MEASure:CURRent:AC? FETCh:CURRent:AC? Phase Selectable These queries return the ac component rms current being sourced at the output terminals. Query Syntax MEASure:[SCALar]:CURRent:AC? FETCh:[SCALar]:CURRent:AC? Parameters None Examples MEAS:CURR:AC? FETC:CURR:AC? Returned Parameters <NR3> Related Commands MEAS:VOL[...]

3 - Language Dictionary 44 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. Query Syntax MEASure:[SCALar]:CURRent:CREStfactor? FETCh:[SCALar]:CURRent:CRESfactor? Parameters None Examples MEAS:CURR:CRES? FETC:[...]

Language Dictionary - 3 45 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 compon[...]

3 - Language Dictionary 46 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. Query Syntax MEASure:[SCALar]:CURRent:NEUTral:AC? FETCh:[SCALar]:CURRent:NEUTral:AC? Parameters None Examples MEAS:CURR:NEUT:AC? FETC:CURR:NEUT:AC? Ret[...]

Language Dictionary - 3 47 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[...]

3 - Language Dictionary 48 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. Su[...]

Language Dictionary - 3 49 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[...]

3 - Language Dictionary 50 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. Query Syntax MEASure:[SCALar]:POWer:AC:APParent? FETCh:[SCALar]:POWer:AC:APParent? Parameters None Examples MEAS:POW:AC:APP? FETC:POW:AC:APP? Returned Paramete[...]

Language Dictionary - 3 51 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. Query Syntax MEASure:[SCALar]:POWer:AC:TOTal? FETCh:[SCALar]:POWer:AC:TOTal? Parameters None Examples MEAS:POW:AC:TOT? FETC:POW:AC:TOT? Returned Parameters[...]

3 - Language Dictionary 52 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. Indivi[...]

Language Dictionary - 3 53 MEASure:VOLTage:ACDC? FETCh:VOLTage:ACDC? Phase Selectable These queries return the ac+dc rms voltage being sourced at the output terminals. Query Syntax MEASure:[SCALar]:VOLTage:ACDC? FETCh:[SCALar]:VOLTage:ACDC? Parameters None Examples MEAS:VOLT:ACDC? FETC:VOLT:ACDC? Returned Parameters <NR3> Related Commands MEA[...]

3 - Language Dictionary 54 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 compon[...]

Language Dictionary - 3 55 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] <bool> Enable/disable output voltage, current, power, etc. :COUPling <coupling> Enables ac or dc output coupling (AC | DC) :DF[...]

3 - Language Dictionary 56 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 av[...]

Language Dictionary - 3 57 OUTPut:IMPedance Agilent 6811B, 6812B, 6813B, Only This command enables or disables the output impedance programming capability of the ac source. Command Syntax OUTPut:IMPedance[:STATe] <bool> Parameters 0 | 1 | OFF | ON *RST Value OFF Examples OUTP:IMP 1 OUTP:IMP ON Query Syntax OUTPut:IMPedance[:STATe]? Returned P[...]

3 - Language Dictionary 58 OUTPut:PON:STATe This command selects the power-on state of the ac source. The following states can be selected: RST Sets the power-on state to *RST. Refer to the *RST command as described later in this chapter for more information. RCL0 Sets the power-on state to *RCL 0. Refer to the *RCL command as described later in th[...]

Language Dictionary - 3 59 OUTPut:RI:MODE This command selects the mode of operation of the Remote Inhibit protection. The following modes can be selected: LATChing A TTL low at the RI input latches the output in the protection shutdown state, which can only be cleared by OUTPut:PROTection:CLEar. LIVE The output state follows the state of the RI in[...]

3 - Language Dictionary 60 Sense Subsystem This subsystem controls the measurement current range, the data acquire sequence, and the harmonic measurement window of the ac source. Subsystem Syntax SENSe :CURRent :ACDC :RANGe [:UPPer]<n> Sets measurement current range :SWEep :OFFSet :POINts <n> Define trigger points relative to the start [...]

Language Dictionary - 3 61 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. Command Synt[...]

3 - Language Dictionary 62 Source Subsystem (Current) This subsystem programs the output current of the ac source. Subsystem Syntax [SOURce:] CURRent [:LEVel] [:IMMediate] [:AMPLitude] <n> Sets the rms current limit :PEAK [:IMMediate] <n> Sets the peak current limit :MODE <mode> Sets peak current limit mode (FIX | STEP | PULS | LI[...]

Language Dictionary - 3 63 CURRent:PEAK Agilent 6811B, 6812B, 6813B, Only This command sets the output limit of the absolute value of peak instantaneous current. Command Syntax [SOURce:]CURRent:PEAK[:IMMediate] <NRf+> Parameters refer to Specifications Table in User’s Guide Unit A (peak amperes) *RST Value 13 (Agilent 6811B/6812B) 26 (Agile[...]

3 - Language Dictionary 64 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. Command Syntax [SOURce:]CURRent:PEAK:TRIGgered <NRf+> Parameters refer to Specifications Table in User’s Guide Unit A (peak am[...]

Language Dictionary - 3 65 Source Subsystem (Frequency) This subsystem programs the output frequency of the ac source. Subsystem Syntax [SOURce:] FREQuency [:CW | :IMMediate] <n> Sets the frequency :MODE <mode> Sets frequency mode (FIX | STEP | PULS | LIST) :SLEW [:IMMediate] <n> | INFinity Sets the frequency slew rate :MODE <m[...]

3 - Language Dictionary 66 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 [SOURce:]FREQuency:SLEW[:IMMediate] <NRf+>[...]

Language Dictionary - 3 67 FREQuency:TRIGgered This command programs the frequency that the output will be set to during a triggered step or pulse transient. Command Syntax [SOURce:]FREQuency:TRIGgered <NRf+> Parameters refer to Specifications Table in User’s Guide Unit HZ (hertz) *RST Value 60 Examples FREQ:TRIG 50 Query Syntax [SOURce:]FR[...]

3 - Language Dictionary 68 Source Subsystem (Function) This subsystem programs the output function of the ac source. Subsystem Syntax [SOURce:] FUNCtion [:SHAPe] [:IMMediate] <shape> Sets the periodic waveform shape (SIN | SQU | CSIN | <user>) :MODE <mode> Sets the waveform shape mode (FIX | STEP | PULS | LIST) :TRIGgered <shap[...]

Language Dictionary - 3 69 FUNCtion:MODE This command determines how the waveform shape is controlled during a triggered output transient. The choices are: FIXed The waveform shape is unaffected by a triggered output transient. STEP The waveform shape is programmed to the value set by FUNCtion:TRIGgered when a triggered transient occurs. PULSe The [...]

3 - Language Dictionary 70 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 wh[...]

Language Dictionary - 3 71 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[...]

3 - Language Dictionary 72 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 [SOURce:]LIST:COUNt <NRf+> | INFinit[...]

Language Dictionary - 3 73 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, [...]

3 - Language Dictionary 74 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 [SOURce:]LIST:FREQuency[:LEVel]:POINTs? Returned Parameters <NR1> Examples LIST:FREQ:POIN? Related Commands LIST:FREQ LIST:FREQuency:SLE[...]

Language Dictionary - 3 75 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 [SOURce:]LIST:PHASe:POINTs? Returned Parameters <NR1> Examples LIST:PHAS:POIN? Related Commands LIST:PHAS LIST:SHAPe This command sets the seque[...]

3 - Language Dictionary 76 LIST:STEP This command specifies how the list sequencing responds to triggers. The following parameters may be specified: ONCE causes the list to advance only one point after each trigger. Triggers that arrive during a dwell delay are ignored AUTO causes the entire list to be output sequentially after the starting trigger[...]

Language Dictionary - 3 77 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 su[...]

3 - Language Dictionary 78 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 [SOURce:]LIST:VOLTage:SLEW:POINTs? Returned Parameters <NR1> Examples LIST:VOLT:SLEW:POIN? Related Commands LIST:VOLT:SLEW LIST:VO[...]

Language Dictionary - 3 79 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[...]

3 - Language Dictionary 80 Source Subsystem (Phase) This subsystem programs the output phases of the . When phase commands are used to program single- phase units, the only discernible effect in using the phase commands is to cause an instantaneous shift in the output waveform phase. Subsystem Syntax [SOURce:] PHASe [:IMMediate] <n> Sets the [...]

Language Dictionary - 3 81 PHASe:MODE Phase Selectable This command determines how the output phase is controlled during a triggered output transient. The choices are: FIXed The output phase is unaffected by a triggered output transient. STEP The output phase is programmed to the value set by PHASe:TRIGgered when a triggered transient occurs. PULSe[...]

3 - Language Dictionary 82 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 [...]

Language Dictionary - 3 83 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. Command Syntax [SOURce:]PULSe:HOLD &[...]

3 - Language Dictionary 84 PULSe:PERiod This command sets the period of a triggered output transient The command parameters are model- dependent. Command Syntax [SOURce:]PULSe:PERiod <NRf+> Parameters 3-phase models: 0 to 1.07533E6 | MINimum | MAXimum 1-phase models: 0 to 4.30133E5 | MINimum | MAXimum Unit S (seconds) *RST Value .03333 Exampl[...]

Language Dictionary - 3 85 Source Subsystem (Voltage) This subsystem programs the output voltage of the ac source. Subsystem Syntax [SOURce:] VOLTage [:LEVel] [:IMMediate] [:AMPLitude] <n> Sets the ac rms voltage amplitude :TRIGgered [:AMPLitude] <n> Sets the transient voltage amplitude :MODE <mode> Sets the voltage mode (FIX | ST[...]

3 - Language Dictionary 86 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[...]

Language Dictionary - 3 87 VOLTage:MODE Phase Selectable This command determines how the ac rms output voltage is controlled during a triggered output transient. The choices are: FIXed The voltage is unaffected by a triggered output transient. STEP The voltage is programmed to the value set by VOLTage:TRIGgered when a triggered transient occurs. PU[...]

3 - Language Dictionary 88 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 The offset is unaffected by a triggered output transient. STEP The offset is programmed to the value set by VOLTage:OFFSet:TRIGgered when a trigg[...]

Language Dictionary - 3 89 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 [SOURce:]VOLTage:OFFSet:SLEW[:IMMediate] <N[...]

3 - Language Dictionary 90 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 [SOURce:]VO[...]

Language Dictionary - 3 91 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 [...]

3 - Language Dictionary 92 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 This senses the voltage at the output of the power amplifier on the inboard [...]

Language Dictionary - 3 93 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 The slew rate is unaffected by a triggered output transient. STEP The slew rate is programmed to the value set by VOLTage:SLEW:TRIGgered when a triggered tra[...]

3 - Language Dictionary 94 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 [...]

Language Dictionary - 3 95 Bit Configuration of Operation Status Registers Bit Position 15–9 8 7–6 5 4–1 0 Bit Name 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 th[...]

3 - Language Dictionary 96 STATus:OPERation:NTRansition STATus:OPERation:PTRansition These commands set or read the value of the Operation NTR (Negative-Transition) and PTR (Positive- Transition) registers. These registers serve as polarity filters between the Operation Enable and Operation Event registers to cause the following actions: u When a b[...]

Language Dictionary - 3 97 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 Bit Weight 16384 8192 4096 2048 1024 512 16 8 4 2 1 OV over-voltage protection has tripped OCP over-current protection has tripped SOA safe [...]

3 - Language Dictionary 98 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 Eve[...]

Language Dictionary - 3 99 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 Bit Weight 4096 2048 512 16 8 2 1 OV over-voltage protection has tripped OCP over-current protection has tripped UNR output is unregulated[...]

3 - Language Dictionary 100 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[...]

Language Dictionary - 3 101 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 (Negative- Transition) and PTR (Positive-Transition) registers for a three-phase ac source. These registers serve as polarity filters [...]

3 - Language Dictionary 102 System Commands The system commands control the system-level functions of the ac source. Subsystem Syntax SYSTem :CONFigure <mode> Selects the operating mode of the ac source (NORM | IEC) :NOUTputs <n> Select the number of output phases ( 1 or 3 ) :ERRor? Returns the error number and error string :VERSion? Re[...]

Language Dictionary - 3 103 SYSTem:CONFigure:NOUTputs Agilent 6834B Only This command selects the number of output phases for ac sources that have single-phase and three- phase 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 [...]

3 - Language Dictionary 104 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. Command Syn[...]

Language Dictionary - 3 105 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. Subsystem Syntax TRACe | DATA :CATalog? Return list of defined waveforms [:DATA] <waveform_name>, <n> {, &[...]

3 - Language Dictionary 106 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. Query Syntax TRACe:CATalog? DATA:CATalog? Parameters None Examples TRAC:CAT? DATA:CAT? Returned Parameters <SR[...]

Language Dictionary - 3 107 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 b[...]

3 - Language Dictionary 108 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 [...]

Language Dictionary - 3 109 INITiate:CONTinuous:SEQuence INITiate:CONTinuous:NAME These commands control the transient generator trigger system as follows: 1 or ON Continuously initiates the transient trigger system. 0 or OFF Turns off continuous triggering. In this state, the trigger system must be initiated for each triggered event using INITiate[...]

3 - Language Dictionary 110 TRIGger:SOURce This command selects the trigger source for the first sequence in generating a step, pulse, or list output as follows: BUS GPIB device, *TRG, or <GET> (Group Execute Trigger) EXTernal ac source’s backplane Trigger In BNC IMMediate trigger is generated as soon as the trigger system is initiated. Com[...]

Language Dictionary - 3 111 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. Command Syntax TRIGger:SEQuence2:PHASe <NRf+> TRIGger:SYNChronize:PHASe <NRf+> Parameters [...]

3 - Language Dictionary 112 TRIGger:SEQuence3:SOURce TRIGger:ACQuire:SOURce These commands select the trigger source for a triggered measurement sequence as follows: BUS GPIB device, *TRG, or <GET> (Group Execute Trigger) EXTernal ac source’s backplane Trigger In BNC TTLTrg the signal driving the Trigger Out BNC Command Syntax TRIGger:SEQue[...]

Language Dictionary - 3 113 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 opti[...]

3 - Language Dictionary 114 *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 *CLS Parameters None *ESE This command programs the Stand[...]

Language Dictionary - 3 115 *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 [...]

3 - Language Dictionary 116 *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. Query Syntax *OPT? Returned Parameters <AARD> *PSC This command controls the automatic clearing at power-on of the Service Request Enable and the Standard Eve[...]

Language Dictionary - 3 117 *RST This command resets the to the following factory-defined states: CAL:STAT OFF [SOUR:]FUNC SIN DISP:STAT ON [SOUR:]FUNC:CSIN 100% DISP:MODE TEXT [SOUR:]LIST:COUN 1 INIT:CONT OFF [SOUR:]LIST:STEP AUTO INST:COUP ALL [SOUR:]PHAS φ 1=0 φ 2=240 φ 3=120 INST:NSEL 1 [SOUR:]PHAS:TRIG φ 1=0 φ 2=240 φ 3=120 OUTP OFF [SOU[...]

3 - Language Dictionary 118 *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[...]

Language Dictionary - 3 119 *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 in[...]

3 - Language Dictionary 120 *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 [...]

121 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 fu[...]

4 - Programming Examples 122 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 prog[...]

Programming Examples - 4 123 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 124 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 distorti[...]

Programming Examples - 4 125 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 <n> The *RST setting for INSTrument:COUPle is ALL. This setting causes programming commands to be sent to all output phases simultaneously. To [...]

4 - Programming Examples 126 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 CURR ent command is coupled with the VOLTage:RANGe. This means that the [...]

Programming Examples - 4 127 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 se[...]

4 - Programming Examples 128 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 becaus[...]

Programming Examples - 4 129 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 val[...]

4 - Programming Examples 130 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 si[...]

Programming Examples - 4 131 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. You can p[...]

4 - Programming Examples 132 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 [...]

Programming Examples - 4 133 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. Figure 4-2. Model of Output Triggers DELAYI NG STATE STEP INITIATED STA TE[...]

4 - Programming Examples 134 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 fro[...]

Programming Examples - 4 135 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 [...]

4 - Programming Examples 136 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 connec[...]

Programming Examples - 4 137 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[...]

4 - Programming Examples 138 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? measures the ac component of apparent power in VA MEASure:POWer:AC:REACtive? measures the reactive power MEASure:POWer:[...]

Programming Examples - 4 139 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. These are: MEASure:ARRay:CURRen[...]

4 - Programming Examples 140 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. Sending the following commands at any time returns the trigger system to the Idle state: ABORt *RST *RCL Th[...]

Programming Examples - 4 141 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[...]

4 - Programming Examples 142 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. When t[...]

Programming Examples - 4 143 NTR Filter STAT:OPER:NTR <n> 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 whe[...]

4 - Programming Examples 144 Figure 4-5. Ac Source Status Model OV CONDITION OCP SOA UNR OT RI CL peak Rai l CL rm s Isu m n.u. Meas Ovld 1 2 4 8 16 512 1024 2048 4096 8192 0 1 2 3 4 5 - 8 9 10 11 12 13 14 PTR/NTR 1 2 4 8 16 512 1024 2048 4096 8192 EVENT 1 2 4 8 16 512 1024 2048 4096 8192 ENABLE 1 2 4 8 16 512 1024 2048 4096 8192 L O G I C A L O R [...]

Programming Examples - 4 145 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 [...]

4 - Programming Examples 146 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 <n> A positive transition filter that functions as described under STAT:QUES:INST:ISUM:NTR|PTR commands in Chapter [...]

Programming Examples - 4 147 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. Command Action *STB? - reads the data in the register but does not clear it (returns MSS in bi[...]

4 - Programming Examples 148 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) [...]

Programming Examples - 4 149 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:TT[...]

4 - Programming Examples 150 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 disa[...]

151 A SCPI Command Tree Command Syntax ABORt CALibrate :CURRent :AC :MEASure :DATA <n> :IMPedance :LEVel P1 | P2 | P3 | P4 :PASSword <n> :PWM :FREQuency <n> :RAMP <n> :SAVE :STATe <bool> [, <n>] :VOLTage :AC :DC :OFFSet :PROTection :RTIMe DATA | TRACe :CATalog? [:DATA] <trace_name>, <n> {, <n>} [...]

A - SCPI Command Tree 152 OUTPut [:STATe] <bool> :COUPling DC | AC :DFI [:STATe] <bool> :SOURce QUES | OPER | ESB | RQS | OFF :IMPedance [:STATe] <bool> :REAL <n> :REACtive <n> :PON :STATe RST | RCL0 :PROTection :CLEar :DELay <n> :RI :MODE LATCHing | LIVE | OFF :TTLTrg [:STATe] <bool> :SOURce BOT | EOT | LI[...]

SCPI Command Tree - A 153 STATus :OPERation [:EVENt]? :CONDition? :ENABle <n> :NTRansition <n> :PTRansition <n> :PRESet :QUEStionable [:EVENt]? :CONDition? :ENABle <n> :NTRansition <n> :PTRansition <n> :INSTrument :ISUMmary [:EVENt]? :CONDition? :ENABle <n> :NTRansition <n> :PTRansition <n> SYST[...]

[...]

155 B SCPI Conformance Information The ac source responds to SCPI Version 1992.0 SCPI Confirmed Commands ABOR [SOUR]:VOLT:ALC | SENS:SOUR CAL:DATA [SOUR]:VOLT[:LEV][:IMM][:AMPL] CAL:STAT [SOUR]:VOLT[:LEV][:TRIG][:AMPL] DISP[:WIND][:STAT] [SOUR]:VOLT:MODE DISP[:WIND]:TEXT[:DATA] [SOUR]:VOLT:PROT[:AMPL] INIT[:IMM] [SOUR]:VOLT:RANG INIT[:IMM]:SEQ | NA[...]

B - SCPI Conformance Information 156 Non SCPI Commands CAL:CURR:AC [SOUR]:CURR:PEAK[:IMM] CAL:CURR:DC [SOUR]:CURR:PEAK:MODE CAL:LEV [SOUR]:CURR:PEAK:TRIG CAL:PASS [SOUR]:FREQ:SLEW[:IMM] CAL:PWM:FREQ [SOUR]:FREQ:SLEW:MODE CAL:PWM:RAMP [SOUR]:FREQ:SLEW:TRIG CAL:SAVE [SOUR]:FREQ:TRIG CAL:VOLT:AC [SOUR]:FUNC[:SHAP]:MODE CAL:VOLT:DC [SOUR]:FUNC[:SHAP]:T[...]

157 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:ERRo r? returns the error number into a variabl[...]

C - Error Messages 158 –170 Expression error –171 Invalid expression –178 Expression data not allowed Execution Errors –200 through –299 (sets Standard Event Status Register bit #4) –200 Execution error [generic] –221 Settings conflict [check current device state] –222 Data out of range [e.g., too large for this device] –223 Too m[...]

Error Messages - C 159 44 Current selftest error, output 2 45 Current selftest error, output 3 70 Fan voltage failure 80 Digital I/O selftest error Device-Dependent Errors 100 through 32767 (sets Standard Event Status Register bit #3) 200 Outgrd not responding 201 Front panel not responding 210 Ingrd receiver framing error 211 Ingrd uart overrun st[...]

[...]

161 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[...]

D - Elgar Model 9012 Compatibility 162 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. [...]

Elgar Model 9012 Compatibility - D 163 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 ar[...]

D - Elgar Model 9012 Compatibility 164 Input key functions: Display Format Description INP:COUP <enum> Set coupling for front panel measurements (AC | DC | ACDC) Trigger Control key functions: Display Format Description JUMPER1 <enum> Set W1 emulation jumper (NORM | ALT) Pulse key functions: Display Format Description DROP <value>[...]

Elgar Model 9012 Compatibility - D 165 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 degr[...]

[...]

167 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 [...]

E - IEC Mode Command Summary 168 Command Syntax CALCulate :INTegral :TIME <Nrf+> :LIMit :UPPer [:DATA] <Nrf+> :SMOothing <bool> selects the Pst integration time for flicker measurements sets various limits associated with rms voltage fluctuation testing for IEC 1000-3-3 turns the 1.5 second smoothing filter on or off FORMat [:DATA[...]

IEC Mode Command Summary - E 169 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 [...]

E - IEC Mode Command Summary 170 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. vss delta Sets the maximum pea[...]

IEC Mode Command Summary - E 171 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:FL UCutations:PST? When ASCii is [...]

E - IEC Mode Command Summary 172 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[...]

IEC Mode Command Summary - E 173 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 spec[...]

E - IEC Mode Command Summary 174 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. Th[...]

IEC Mode Command Summary - E 175 0 100 (120) rms ↓ voltage values 99 repeat 60 times 0 CALC:INT:TIME times <n> 100 (120) instantaneous ↓ flicker values 99 Record Number Error Code P_0.1 repeat P_1s <n> times P_3s P_10s P_50s Pst 12 point Pst array Dmax Dmax index Dc Dc index Dt Dt index Record Number Error Code 0 1024 log weighted b[...]

E - IEC Mode Command Summary 176 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[...]

IEC Mode Command Summary - E 177 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 [...]

E - IEC Mode Command Summary 178 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. Command Syntax [...]

IEC Mode Command Summary - E 179 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[...]

[...]

181 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 C[...]

Index 182 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 instru[...]

Index 183 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 Ins[...]

Index 184 —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 Ref[...]

Index 185 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 [...]

186 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 S[...]

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.[...]