Programming Guide Dynamic Measurement DC Source Agilent Models 66312A, 66332A System DC Power Supply Agilent Models 6631B, 6632B, 6633B, 6634B 6611C, 6612C, 6613C, 6614C Agilent Part No. 5962-8198 Microfiche No 5962-8199 Printed in U.S.A.
Safety Guidelines The beginning of the Operating Guide has a Safety Summary page. Be sure you are familiar with the information on this page before programming the dc source for operation from a controller. Printing History The edition and current revision of this manual are indicated below. Reprints of this guide containing minor corrections and updates may have the same printing date. Revised editions are identified by a new printing date.
Table of Contents Safety Guidelines Printing History Table of Contents 1 - GENERAL INFORMATION About this Guide Documentation Summary External References GPIB References SCPI References 2 2 3 7 7 7 8 8 8 2 - INTRODUCTION TO PROGRAMMING 9 VXIplug&play Power Products Instrument Drivers Supported Applications System Requirements Downloading and Installing the Driver Accessing Online Help GPIB Capabilities of the DC Source GPIB Address RS-232 Capabilities of the DC Source RS-232 Data Format RS-232 Flow Co
Output Trigger System Model Setting the Voltage or Current Trigger Levels Initiating the Output Trigger System Generating Triggers Making Measurements Voltage and Current Measurements Internally Triggered Measurements SCPI Triggering Nomenclature Measurement Trigger System Model Initiating the Measurement Trigger System (Agilent 66312A, 66332A Only) Selecting the Measurement Trigger Source (Agilent 66312A, 66332A Only) Generating Measurement Triggers (Agilent 66312A, 66332A Only) Measuring Output Pulses (Ag
MEASure:CURRent? FETCh:CURRent? MEASure:CURRent:ACDC? FETCh:CURRent:ACDC? MEASure:CURRent:HIGH? FETCh:CURRent:HIGH? MEASure:CURRent:LOW? FETCh:CURRent:LOW? MEASure:CURRent:MAXimum? FETCh:CURRent: MAXimum? MEASure:CURRent:MINimum? FETCh:CURRent:MINimum? MEASure:VOLTage? FETCh:VOLTage? MEASure:VOLTage:ACDC? FETCh:VOLTage:ACDC? MEASure:VOLTage:HIGH? FETCh:VOLTage:HIGH? MEASure:VOLTage:LOW? FETCh:VOLTage:LOW? MEASure:VOLTage:MAXimum? FETCh:VOLTage:MAXimum? MEASure:VOLTage:MINimum? FETCh:VOLTage:MINimum? SENSe:C
System Commands DISPlay DISPlay:MODE DISPlay:TEXT SYSTem:ERRor? SYSTem:LANGuage SYSTem:VERSion? SYSTem:LOCal SYSTem:REMote SYSTem:RWLock *IDN? *OPT? *RCL *RST *SAV *TST? Trigger Commands ABORt INITiate:SEQuence INITiate:NAME INITiate:CONTinuous:SEQuence1 INITiate:CONTinuous:NAME TRIGger TRIGger:SOURce TRIGger:SEQuence2 TRIGger:ACQuire TRIGger:SEQuence2:COUNt:CURRent TRIGger:ACQuire:COUNt:CURRent TRIGger:SEQuence2:COUNt:VOLTage TRIGger:ACQuire:COUNt:VOLTage TRIGger:SEQuence2:HYSTeresis:CURRent TRIGger:ACQuir
1 General Information About this Guide This guide provides remote programming information for the following series of GPIB programmable dc power supplies: • Agilent 66312A • Agilent 66332A • Agilent 6631B/6632B/6633B/6634B • Agilent 6611C/6612C/6613C/6614C You will find the following information in the rest of this guide: Chapter 1 Introduction to this guide. Chapter 2 Introduction to SCPI messages structure, syntax, and data formats.
1 - General Information External References GPIB References The most important GPIB documents are your controller programming manuals - BASIC, GPIB Command Library for MS DOS, etc. Refer to these for all non-SCPI commands (for example: Local Lockout). The following are two formal documents concerning the GPIB interface: ♦ ANSI/IEEE Std. 488.1-1987 IEEE Standard Digital Interface for Programmable Instrumentation. Defines the technical details of the GPIB interface.
2 Introduction to Programming VXIplug&play Power Products Instrument Drivers VXIplug&play instrument drivers for Microsoft Windows 95 and Windows NT are now available on the Web at http://www.agilent.com/find/drivers. These instrument drivers provide a high-level programming interface to your Agilent Technologies instrument. VXIplug&play instrument drivers are an alternative to programming your instrument with SCPI command strings.
2 - Introduction to Programming 6. To use the VXIplug&play instrument driver, follow the directions in the VXIplug&play online help under “Introduction to Programming”. Accessing Online Help A comprehensive online programming reference is provided with the driver. It describes how to get started using the instrument driver with Agilent VEE, LabVIEW, and LabWindows. It includes complete descriptions of all function calls as well as example programs in C/C++ and Visual BASIC.
Introduction to Programming - 2 Baud Rate The front panel Address key lets you select one of the following baud rates, which is stored in non-volatile memory: 300 600 1200 2400 4800 9600 RS-232 Flow Control The RS-232 interface supports several flow control options that are selected using the front panel Address key. For each case, the dc source will send a maximum of five characters after holdoff is asserted by the controller.
2 - Introduction to Programming FUNCTION gets$ C$ = “” WHILE c$ <> CHR$ (10) C$ = INPUT$ (1, #1) Resp$ = resp$ + c$ WEND gets$ = resp$ END FUNCTION ‘ Get ‘ ‘ Set ‘ ‘ ‘ End ‘ a new line feed terminated string from device #1 Set C$ to null loop to stop at Line Feed Read 1 bit into file #1 Concantenate bit with previous bits of WHILE loop Assign response to gets$ RS-232 Troubleshooting If you are having trouble communicating over the RS-232 interface, check the following: ♦ The computer and the dc source m
Introduction to Programming - 2 Types of SCPI Commands SCPI has two types of commands, common and subsystem. ♦ Common commands generally are not related to specfic operation but to controlling overall dc source functions, such as reset, status, and synchronization. All common commands consist of a three-letter nmemonic preceded by an asterisk: *RST *IDN? *SRE 8 ♦ Subsystem commands perform specific dc source functions. They are organized into an inverted tree structure with the "root" at the top.
2 - Introduction to Programming Moving Among Subsystems In order to combine commands from different subsystems, you need to be able to reset the header path to a null string within a message. You do this by beginning the command with a colon (:), which discards any previous header path.
Introduction to Programming - 2 Data Message Unit Keywords VOLT : LEV 20 ; Query Indicator PROT 21 ; : CURR? Keyword Separator Message Unit Separators Message Terminator Root Specifier Figure 2-2. Command Message Structure The Message Unit The simplest SCPI command is a single message unit consisting of a command header (or keyword) followed by a message terminator. The message unit may include a parameter after the header. The parameter can be numeric or a string.
2 - Introduction to Programming NOTE: All RS-232 response data sent by the dc source is terminated by the ASCII character pair . This differs from GPIB response data which is terminated by the single character with EOI asserted. SCPI Data Formats All data programmed to or returned from the dc source is ASCII. The data may be numerical or character string.
Introduction to Programming - 2 SCPI Command Completion SCPI commands sent to the dc source are processed either sequentially or in parallel. Sequential commands finish execution before a subsequent command begins. Parallel commands allow other commands to begin executing while the parallel command is still executing. Commands that affect trigger actions are among the parallel commands.
3 Programming the DC Source Introduction This chapter contains examples on how to program your dc source. Simple examples show you how to program: u output functions such as voltage and current u internal and external triggers u measurement functions u the status and protection functions NOTE: These examples in this chapter show which commands are used to perform a particular function, but do not show the commands being used in any particular programming environment.
3 - Programming the DC Source Output Voltage The output voltage is controlled with the VOLTage command. For example, to set the output voltage to 25 volts, use: VOLTage 125 The dc source can be programmed to turn off its output if the output voltage exceeds a preset peak voltage limit. This protection feature is implemented with the VOLTage:PROTection command as explained in chapter 4.
Programming the DC Source - 3 Triggering Output Changes The dc source has two independent trigger systems. One is used for generating output changes, and the other is used for triggering measurements. This section describes the output trigger system. The measurement trigger system is described under "Triggering Measurements". SCPI Triggering Nomenclature In SCPI terms, trigger systems are called sequences.
3 - Programming the DC Source Initiating the Output Trigger System When the dc source is turned on, the trigger subsystem is in the idle state. In this state, the trigger subsystem 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 dc source to receive triggers.
Programming the DC Source - 3 Making Measurements The dc source has the ability to make several types of voltage or current measurements. The measurement capabilities of the Agilent 66312A and Agilent 66332A models are particulary useful for loads that draw current in pulses. NOTE: You cannot measure output voltage and current simultaneously.
3 - Programming the DC Source This results in a data acquisition time of 32 milliseconds. Adding a command processing overhead of about 20 milliseconds results in a total measurement time of about 50 milliseconds per measurement sample. Ripple rejection is a function of the number of cycles of the ripple frequency contained in the acquisition window. More cycles in the aquisition window results in better ripple rejection.
Programming the DC Source - 3 Internally Triggered Measurements You can use the data acquisition trigger system to synchronize the timing of the voltage and current data acquisition with a BUS or internal trigger source. Then use the FETCh commands to return different calculations from the data acquired by the measurement trigger.
3 - Programming the DC Source INITiate:SEQuence2 or INITiate:NAME ACQuire After a trigger is received and the data acquisition completes, the trigger system will return to the Idle state (unless multiple measurements are desired). Thus it will be necessary to initiate the system each time a triggered acquisition is desired. NOTE: You cannot initiate measurement triggers continuously. Otherwise, the measurement data in the data buffer would continuously be overwritten by each triggered measurement.
Programming the DC Source - 3 Trigger occurs on rising edge Trigger occurs on falling edge when signal crosses positive when signal crosses negative hysteresis band limit hysteresis band limit TRIG:ACQ:HYST:CURR TRIG:ACQ:HYST:VOLT TRIG:ACQ:LEV:CURR TRIG:ACQ:LEV:VOLT TRIG:ACQ:SLOP:CURR TRIG:ACQ:SLOP:VOLT TRIG:ACQ:SLOP:CURR NEG TRIG:ACQ:SLOP:VOLT Figure 3-3.
3 - Programming the DC Source Measuring Output Pulses (Agilent 66312A, 66332A Only) Current Detector Check that the current detector is set to ACDC when measuring current pulses or other waveforms with a frequency content greater than a few kilohertz. SENSe:CURRent:DETect ACDC Only select DC as the measurement detector if you are making only DC current measurements and you require a measurement offset better than 2mA on the High current measurement range.
Programming the DC Source - 3 Controlling Measurement Samples Varying the Voltage or Current Sampling Rate You can vary both the number of data points in a measurement sample, as well as the time between samples. This is illustrated in Figure 3-5. SENS:SWE:TINT
3 - Programming the DC Source Pre-event and Post-event Triggering (Agilent 66312A, 66332A Only) When a measurement is initiated, the dc source continuously samples either the instantaneous output voltage or current. As shown in figure 3-6, you can move the block of data being read into the acquisition buffer with reference to the acquisition trigger. This permits pre-event or post-event data sampling.
Programming the DC Source - 3 10 20 30 40 50 60 80 90 100 110 120 130 140 150 160 170 180 190 200 210 220 230 240 250 260 270 280 290 300 310 320 330 340 350 360 370 380 390 400 410 420 430 440 450 460 470 480 490 500 510 520 530 !Rev A.00.
3 - Programming the DC Source Programming the Status Registers You can use status register programming to determine the operating condition of the dc source at any time. For example, you may program the dc source to generate an interrupt (assert SRQ) when an event such as a current limit occurs. When the interrupt occurs, your program can then act on the event in the appropriate fashion. Figure 3-7 shows the status register structure of the dc source. Table 3-1 defines the status bits.
Programming the DC Source - 3 Table 3-1.
3 - Programming the DC Source Questionable Status Group The Questionable Status registers record signals that indicate abnormal operation of the dc source. As shown in figure 3-7, the group consists of the same type of registers as the Status Operation group. The outputs of the Questionable Status group are logically-ORed into the QUEStionable summary bit (3) of the Status Byte register.
Programming the DC Source - 3 The MSS Bit This is a real-time (unlatched) summary of all Status Byte register bits that are enabled by the Service Request Enable register. MSS is set whenever the dc source has one or more reasons for requesting service. *STB? reads the MSS in bit position 6 of the response but does not clear any of the bits in the Status Byte register. The RQS Bit The RQS bit is a latched version of the MSS bit.
3 - Programming the DC Source event to be summed into the Questionable summary bit. Use: STATus:QUEStionable:PTR 19;ENABle 19 (1 + 2 + 16 = 19) Step 3 Program the Service Request Enable register to allow both the Operation and the Questionable summary bits from the Status Byte register to generate RQS.
Programming the DC Source - 3 Using the Inhibit/Fault Port as a Digital I/O You can configure the inhibit/fault port to provide a digital input/output to be used with custom digital interface circuits or relay circuits. As shipped from the factory, the port is shipped for inhibit/fault operation.
4 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 dc source. It is assumed that you are familiar with the material in “Chapter 2 "Remote Programming". That chapter explains the terms, symbols, and syntactical structures used here and gives an introduction to programming.
4 - Language Dictionary ABORt CALibrate :CURRent [:SOURce] [:DC] [:POSitive] Table 4-1.
Language Dictionary - 4 Table 4-1.
4 - Language Dictionary Table 4-1.
Language Dictionary - 4 Common Commands Common commands begin with an * and consist of three letters (command) or three letters and a ? (query). They are defined by the IEEE 488.2 standard to perform common interface functions. Common commands and queries are categorized under System, Status, or Trigger functions and are listed at the end of each group. The dc source responds to the following commands: Table 4-2.
4 - Language Dictionary Calibration Commands Calibration commands let you: u Enable and disable the calibration mode u Change the calibration password u Calibrate the current and voltage programming and measurement, and store new calibration constants in nonvolatile memory. NOTE: If calibration mode has not been enabled with CALibrate:STATe, programming the calibration commands will generate an error.
Language Dictionary - 4 CALibrate:DATA This command enters a calibration value that you obtain by reading an external meter. You must first select a calibration level (with CALibrate:LEVel) for the value being entered. Command Syntax Parameters Unit Examples Related Commands CALibrate:DATA A (amperes) CAL:DATA 3222.3 MA CAL:STAT CAL:LEV CAL:DATA 5.000 CALibrate:LEVel This command selects the next point in the calibration sequence.
4 - 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 - 4 Measurement Commands Measurement commands consist of measure and sense commands. Measure commands measure the output voltage or current. Measurements are performed by digitizing the instantaneous output voltage or current for a defined number of samples and sample interval, storing the results in a buffer, and calculating the measured result. Two types of measurement commands are available: MEASure and FETCh.
4 - Language Dictionary MEASure:CURRent? FETCh:CURRent? FETCh:CURRent? applies to Agilent 66312A, 66332A Only These queries return the dc output current. Query Syntax Parameters Examples Returned Parameters Related Commands MEASure:[SCALar]:CURRent[:DC]? FETCh:[SCALar]:CURRent[:DC]? None MEAS:CURR? MEAS:CURR:DC? MEAS:VOLT? MEASure:CURRent:ACDC? FETCh:CURRent:ACDC? Agilent 66312A, 66332A Only These queries return the ac+dc rms output current.
Language Dictionary - 4 MEASure:CURRent:LOW? FETCh:CURRent:LOW? Agilent 66312A, 66332A Only These queries return the Low level current of a current pulse waveform. The instrument first measures the minimum and maximum data points of the pulse waveform. It then generates a histogram of the pulse waveform using 1024 bins between the maximum and minimum data points. The bin containing the most data points below the 50% point is the low bin.
4 - Language Dictionary MEASure:VOLTage? FETCh:VOLTage? FETCh:VOLTage? applies to Agilent 66312A, 66332A Only These queries return the dc output voltage. Query Syntax Parameters Examples Returned Parameters Related Commands MEASure[:SCALar]:VOLTage[:DC]? MEASure[:SCALar]:VOLTage[:DC]? None MEAS:VOLT? FETC:VOLT:DC? MEAS:CURR? MEASure:VOLTage:ACDC? FETCh:VOLTage:ACDC? Agilent 66312A, 66332A Only These queries return the ac+dc rms output voltage.
Language Dictionary - 4 MEASure:VOLTage:LOW? FETCh:VOLTage:LOW? Agilent 66312A, 66332A Only These queries return the Low level voltage of a voltage pulse waveform. The instrument first measures the minimum and maximum data points of the pulse waveform. It then generates a histogram of the pulse waveform using 1024 bins between the maximum and minimum data points. The bin containing the most data points below the 50% point is the low bin.
4 - Language Dictionary SENSe:CURRent:RANGe This command selects the dc current measurement range. All models have two current measurement ranges: High Range: 0 through MAX (see Table 4-3) Low Range: 0 through 0.02 A (all models) The High range covers the full current measurement capability of the instrument. The Low range measures currents up to a maximum of 20 mA. This increases the low current measurement sensitivity for greater accuracy and resolution.
Language Dictionary - 4 SENSe:FUNCtion Agilent 66312A, 66332A Only This command configures the measurement sensor to measure either voltage or current when an acquire trigger is used. The query returns the function setting, either VOLT or CURR.
4 - Language Dictionary SENSe:WINDow This command sets the window function that is used in output measurement calculations. The following functions can be selected: HANNing A signal conditioning window that reduces errors in dc and rms measurement calculations in the presence of periodic signals such as line ripple. It also reduces jitter when measuring successive pulse waveforms. The Hanning 4 window multiplies each point in the measurement sample by the function cos .
Language Dictionary - 4 Output Commands Output commands consist of output and source commands. Output commands control the output and digital port functions. They also control the output relay on units with Relay Option 760. Source commands program the actual voltage, current, and digital port output. OUTPut This command enables or disables the dc source output. The state of a disabled output is a condition of zero output voltage and a model-dependent minimum source current (see *RST).
4 - Language Dictionary OUTPut:PON:STATe This command selects the power-on state of the dc source. This information is saved in non-volatile memory. The following states can be selected: RST RCL0 Sets the power-on state to *RST. Refer to the *RST command as described in this chapter for more information. Sets the power-on state to *RCL 0. Refer to the *RCL command as described in this chapter for more information.
Language Dictionary - 4 OUTPut:RELay Agilent 66332A, 6632B, 6633B, 6634B, 6611C, 6612C, 6613C, 6614C Only This command is only valid for units with Relay Option 760, otherwise an error will occur. Programming ON closes the output relay contacts; programming OFF opens them. The relay is controlled independently of the output state. If the dc source is supplying power to a load, that power will appear at the relay contacts during switching.
4 - Language Dictionary [SOURce:]CURRent This command sets the immediate current level of the dc source . The immediate level is the current programmed for the output terminals.
Language Dictionary - 4 [SOURce:]DIGital:DATA This command sets and reads the dc source digital control port when that port is configured for Digital I/O operation. The port has three signal pins and a digital ground pin. Pins 1 and 2 are output pins controlled by bits 0 and 1. Pin 3 is controlled by bit 2, and can be programmed to serve either as an input or an output. It normally serves as an output. Bit 2 must be programmed high to use pin 3 as an input. Pin 4 is the digital ground.
4 - Language Dictionary [SOURce:]VOLTage:ALC:BANDwidth? [SOURce:]VOLTage:ALC:BWIDth? Agilent 66332A, 6631B, 6632B, 6633B and 6634B Only These queries return the setting of the output mode switch. The output mode switch is used to connect or disconnect the the output capacitor located inside the unit. The returned value is 15,000 if the switch is set to Normal and 60,000 if the switch is set to Fast.
Language Dictionary - 4 Status Commands Status commands program the dc source status registers. The dc source has three groups of status registers; Operation, Questionable, and Standard Event. The Standard Event group is programmed with Common commands as described later in this section. The Operation and Questionable status groups each consist of the Condition, Enable, and Event registers and the NTR and PTR filters.
4 - Language Dictionary STATus:OPERation:ENABle This command and its query set and read the value of the Operational Enable register. This register is a mask for enabling specific bits from the Operation Event register to set the operation summary bit (OPER) of the Status Byte register. This bit (bit 7) is the logical OR of all the Operatonal Event register bits that are enabled by the Status Operation Enable register.
Language Dictionary - 4 Table 4-5.
4 - Language Dictionary STATus:QUEStionable:NTR STATus:QUEStionable:PTR These commands allow you to set or read the value of the Questionable NTR (Negative-Transition) and PTR (Positive-Transistion) registers.
Language Dictionary - 4 *ESE This command programs the Standard Event Status Enable register bits. The programming determines which events of the Standard Event Status Event register (see *ESR?) are allowed to set the ESB (Event Summary Bit) of the Status Byte register. A "1" in the bit position enables the corresponding event. All of the enabled events of the Standard Event Status Event Register are logically ORed to cause the Event Summary Bit (ESB) of the Status Byte Register to be set.
4 - Language Dictionary * OPC does not prevent processing of subsequent commands, but bit 0 will not be set until all pending operations are completed. *OPC? causes the instrument to place an ASCII "1" in the Output Queue when all pending operations are completed. Unlike *OPC, *OPC? prevents processing of all subsequent commands. It is intended to be used at the end of a command line so that the application program can then monitor the bus for data until it receives the "1" from the dc source Output Queue.
Language Dictionary - 4 Command Syntax Parameters Power-on Value Example Query Syntax Returned Parameters Related Commands CAUTION: *SRE 0 to 255 see *PSC *SRE 20 *SRE? (register binary value) *ESE *ESR *PSC If *PSC is programmed to 0, the *SRE command causes a write cycle to nonvolatile memory. Nonvolatile memory has a finite maximum number of write cycles.
4 - Language Dictionary System Commands System commands consist of system, display, and common commands. System commands commands control system functions that are not directly related to output control or measurement functions. Display commands control the front panel display of the . Common commands also perform system functions. The following common commands are discussed in this section: *IDN? *OPT? *RCL *RST *SAV *TST?. DISPlay This command turns the front panel display on or off.
Language Dictionary - 4 SYSTem:ERRor? This query returns the next error number followed by its corresponding error message string from the remote programming error queue. The queue is a FIFO (first-in, first-out) buffer that stores errors as they occur. As it is read, each error is removed from the queue. When all errors have been read, the query returns 0,NO ERROR.
4 - Language Dictionary SYSTem:LOCal For RS-232 Operation Only This command places the dc source in local mode during RS-232 operation. The front panel keys are functional. Command Syntax Parameters Example Related Commands SYSTem:LOCal None SYST:LOC SYST:REM SYST:RWL SYSTem:REMote For RS-232 Operation Only This command places the dc source in remote mode during RS-232 operation. This disables all front panel keys except the Local key.
Language Dictionary - 4 *OPT? This query requests the dc source to identify any options that are installed. Options are identified by number A 0 indicates no options are installed. Query Syntax Returned Parameters *OPT? *RCL WARNING: Recalling a previously stored state may place hazardous voltages at the dc source output. This command restores the dc source to a state that was previously stored in memory with the *SAV command to the specified location.
4 - Language Dictionary Table 4-8. *RST Settings CAL:STAT DIG:DATA DISP:STAT DISP:MODE DISP:TEXT INIT:CONT OUTP OUTP:DFI OUTP:DFI:SOUR OUTP:PROT:DEL OUTP:REL OUTP:REL:POL SENS:CURR:RANG SENS:CURR:DET SENS:FUNC SENS:SWE:OFFS:POIN SENS:SWE:POIN SENS:SWE:TINT OFF 0 ON NORM ‘ ‘ OFF OFF OFF OFF .08 Norm; .008 Fast OFF NORM MAX ACDC VOLT 0 2048 15.
Language Dictionary - 4 Trigger Commands Trigger commands consist of trigger and initiate commands. Trigger commands control the remote triggering of the dc source . Trigger commands (and Initate commands) are referenced either by name or by number. The correspondence between names and numbers is: Sequence Number Sequence Name Description 1 (the default) TRANsient Output transient trigger sequence 2 ACQuire Measurement acquire trigger sequence Initiate commands initialize the trigger system.
4 - Language Dictionary TRIGger When the transient trigger subsystem is initiated, this command generates a trigger signal. The trigger will then: 1. Initiate a pending level change as specified by CURRent:TRIGger or VOLTage;TRIGger. 2. Clear the WTG bit in the Status Operation Condition register after both transient and acquire trigger sequences have completed. (WTG is the logical-or of both transient and acquire sequences.) 3.
Language Dictionary - 4 TRIGger:SEQuence2:COUNt:CURRent TRIGger:ACQuire:COUNt:CURRent Agilent 66312A, 66332A Only This command sets up a successive number of triggers for measuring current data. With this command, the trigger system needs to be initialized only once at the start of the acquisition period. After each completed measurement, the instrument waits for the next valid trigger condition to start another measurement. This continues until the count has completed.
4 - Language Dictionary TRIGger:SEQuence2:HYSTeresis:CURRent TRIGger:ACQuire:HYSTeresis:CURRent Agilent 66312A, 66332A Only This command defines a band around the trigger level through which the signal must pass before an internal measurement can occur. The band limit above and below the trigger level is one half of the hysteresis value added to or subtracted from the trigger level.
Language Dictionary - 4 TRIGger:SEQuence2:LEVel:CURRent TRIGger:ACQuire:LEVel:CURRent Agilent 66312A, 66332A Only This command sets the trigger level for internally triggered current measurements. A positive current trigger occurs when the current level changes from a value less than the lower hysteresis band limit to a value greater than the upper hysteresis band limit.
4 - Language Dictionary TRIGger:SEQuence2:SLOPe:CURRent TRIGger:ACQuire:SLOPe:CURRent Agilent 66312A, 66332A Only This command sets the slope of an internally triggered current measurement. POSitive triggering occurs on the rising edge. NEGative triggering occurs on the falling edge. EITHer triggering occurs on either edge.
Language Dictionary - 4 TRIGger:SEQuence2:SOURce TRIGger:ACQuire:SOURce Agilent 66312A, 66332A Only These commands select the trigger source for measurement triggers as follows: BUS GPIB device, *TRG, or (Group Execute Trigger) INTernal trigger is generated internally when the measured waveform crosses the trigger level with the selected slope.
A SCPI Conformance Information SCPI Version The Agilent Dynamic Measurement DC Source conforms to SCPI Version 1995.0.
B Compatibility Language Introduction The Agilent power supplies covered by this manual are programmatically compatible with the HP/Agilent 6632A, 6633A, and 6634A dc power supplies. This means that by using COMPatibility language mode you can program these newer dc sources over the GPIB using COMPatibility commands. To switch from SCPI commands to COMPatibility commands (and vice versa), use the SYST:LANG command, as documented in chapter 4. The language setting is saved in non-volatile memory.
B - Compatibility Language Compatibility Command ASTS? CLR DC 0 | 1 DLY DSP 0 | 1 ERR? FAULT? ID? IOUT? ISET OCP 0 | 1 OUT 0 | 1 84 Table B-2. COMPatibility Commands Description This command reads the contents of the accumulated status register, which stores any bit condition entered in the status register since the accumulated status register was last read, regardless of whether the condition still exists.
Compatibility Language - B Compatibility Command OVSET POL 0 | 1 PON 0 | 1 RELAY 0 | 1 RLYPON 0 | 1 ROM? RST SENS:CURR :RANG SENS:SWE :POIN SENS:SWE :TINT SRQ 0 | 1 STS? SYST:LANG TEST? Table B-2. COMPatibility Commands (continued) Description This command programs the overvoltage protection. See Table 4-3 for the programming range of this command. Initial condition: MAX Only applies to units with Option 760.
B - Compatibility Language Compatibility Command UNMASK xxx VOUT? VSET Table B-2. COMPatibility Commands (continued) Description These commands determine the conditions that will set bits in the fault register, allowing the operator to define the conditions that will be reported as fault Fault conditions can be enabled by sending the decimal equivalent of the total bit weight of all conditions to be enabled. This command measures and returns the actual output voltage. Data Representation: SZZD.
Compatibility Language - B STATUS REGISTER CV 1 +CC 2 UNR 4 OV 8 OT 16 not used 32 OC 64 FAULT ERR 128 REGISTER INH 256 -CC 1 512 FAST 1024 NORM 2048 2 4 SERIAL POLL 8 16 ACCUMULATED STATUS REGISTER MASKUS 32 REGISTER 64 REGISTER FAU 1 PON 128 1 CV 1 256 not used 2 +CC 2 512 not used 4 UNR 4 1024 2048 2 4 8 RDY 16 ERR 32 8 OV 8 16 OT 16 RQS 64 32 not used 128 32 not used 64 OC 64 128 ERR 128 256 INH 256 512 -CC 512 1024 FAST
C Error Messages Error Number List This appendix gives the error numbers and descriptions that are returned by the dc 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 Table C-1. Error Numbers (continued) Error Number –141 –144 –148 –150 –151 –158 –160 –161 –168 –170 –171 –178 –200 –222 –223 –224 –225 –270 –272 –273 –276 –277 –310 –350 –400 –410 –420 –430 –440 0 1 2 3 4 5 10 11 12 13 14 15 80 90 Error String [Description/Explanation/Examples] Invalid character data [bad character, or unrecognized] Character data too long Character data not allowed String data error Invalid string data [e.g.
Error Messages - C Table C-1.
D Example Programs Introduction The example programs in this section are intended to show how some of the same dc source functions can be programmed to each of the following GPIB interfaces: 1. HP Vectra PC controller with Agilent 82335A GPIB Interface Command Library 2. IBM PC controller with National Instuments GPIB-PCII Interface/Handler 3. Agilent controller with BASIC Language System Assigning the GPIB Address in Programs The dc source address cannot be set remotely.
D - Example Programs Your application program will not include the dc source’s symbolic name and GPIB address. These must be specified during configuration (when you run IBCONF.EXE). Note that the primary address range is from 0 to 30 but any secondary address must be specified in the address range of 96 to 126. The dc source expects a message termination on EOI or line feed, so set EOI w/last byte of Write. It is also recommended that you set Disable Auto Serial Polling.
Example Programs - D 1085 ’ 1090 ’Query dc source outputs CURRENT?" :GOSUB 2000 :GOSUB 3000 1100 VOUT = OUTPUTS(1) 1105 IOUT = OUTPUTS(2) 1110 PRINT "The output levels are "VOUT" Volts and "IOUT" Amps" 1115 ’ 1120 ’Program triggered current level to value insufficient to maintain 1125 ’supply within its CV operating characteristic 1130 CODES$ = "CURR:TRIG MIN" :GOSUB 2000 1135 ’ 1140 ’Set operation status mask to detect mode change from CV to CC 1145 CODES$ = "STAT:OPER:ENAB 1024;PTR 1024" :GOSUB 2000 1150
D - Example Programs Example 2. IBM Controller Using National Interface 990 ’---------------------- Merge DECL.
Example Programs - D 1225 ’ 1230 ’Clear status circuit 1235 CODES$="*CLS" :GOSUB 2000 1240 FOR I=1 TO 50 :NEXT I ’Wait for supply to clear 1245 ’ 1250 ’Disable output and save present state to location 2 1255 CODES$ = "OUTPUT OFF;*SAV 2" :GOSUB 2000 1260 END 1265 ’ 2000 ’Send command to dc source 2005 CALL IBWRT(PS%,CODES$) 2010 IF IBSTAT% 2015 RETURN 1250 ’Disable output and save present state to location 2 1255 CODES$ = "OUTPUT OFF;*SAV 2" :GOSUB 2000 1260 END 1265 ’ 2000 ’Send command to dc source 2005 C
D - Example Programs Example 3.
INDEX —A— AARD, 16 ABORT, 73 ACDC, 52 maximum, 20 measurement range, 24 measurements, 23 current measurement detector, 28, 52 current measurement range, 52 —D— —B— bus, 79 —C— calibration commands, 44 CAL CURR, 44 CAL CURR MEAS AC, 44 CAL CURR NEG, 44 CAL DATA, 45 CAL LEV, 45 CAL PASS, 45 CAL SAVE, 45 CAL STAT, 46 CAL VOLT, 46 CAL VOLT PROT, 46 calibration commands:CAL CURR MEAS LOWR ", 44 character strings, 16 combine commands common commands, 14 from different subsystems, 14 root specifier, 14 command
Index —H— hanning, 54 header, 15 long form, 15 short form, 15 history, 2 HP 8235A driver, 93 HP BASIC controllers, 94 HP-IB address, 10 capabilities of the dc source, 10 triggers, 26 newline, 15 message unit separator, 15 minimum measurements, 24 monitoring both phases of status transition, 36 moving among subsystems, 14 MSS bit, 35 multiple measurements, 29 —N— National Instruments GPIB driver, 93 negative, 78 numerical data formats, 16 —I— INH, 36 initialization, 19 initiate commands, 73 INIT CONT NAM
Index —R— rectangular, 54 remote inhibit, 36 returning voltage or current data, 24 RI, 36 rms measurements, 24 root specifier, 15 RQS bit, 35 RS-232 capabilities of the dc source, 10 data format, 10, 12 data terminator, 16 flow control, 11 RTS-CTS, 11 —S— safety guidelines, 2 SCPI command completion, 17 command syntax, 39 command tree, 13 common commands, 13 conformance, 81 data format, 16 device clear, 17 header path, 13 message structure, 14 message types, 14 message unit, 15 multiple commands, 13 non-c
Index —V— varying voltage or current sampling, 29 voltage, 20 maximum, 20 measurements, 23 —W— waiting for measurement results, 27 —X— XON-XOFF, 11 102
Manual Updates The following updates have been made to this manual since the December 1998 printing indicated on the Printing History page. 11/9/99 Information about installing VXIplug&play Power Products Instrument Drivers has been included in the beginning of chapter 2. 1/4/00 All references to HP have been changed to Agilent. All references to HP-IB have been changed to GPIB.