Agilent 6814B - Manuals

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:PH...

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 MEASur...

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. Youwill find the following information in the rest of thi...

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

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 i...

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 IEEE488.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 GPI...

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 voltageand frequency and to read back the model number and output voltage. The program was written to run onany controller using Microsoft QBasi...

Introduction to Programming - 2 17 Introduction to SCPI SCPI (Standard Commands for Programmable Instruments) is a programming language for controllinginstrument functions over the GPIB. SCPI is layered on top of the hardware-portion of IEEE 488.2. Thesame SCPI commands and parameters control the sa...

2 - Introduction to Programming 18 The SCPI Command Tree As previously explained, the basic SCPI communication method involves sending one or more properlyformatted commands from the SCPI command tree to the instrument as program messages. Thefollowing figure shows a portion of a subsystem command t...

2 - Introduction to Programming 20 Including Common Commands You can combine common commands with system commands in the same message. Treat the commoncommand as a message unit by separating it with a semicolon (the message unit separator). Commoncommands do not affect the active header path; you ma...

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 Separ...

2 - Introduction to Programming 22 HeaderConvention In the command descriptions in Chapter 3 of this manual, headers are emphasized withboldface type. The proper short form is shown in upper-case letters, such as DELay. HeaderSeparator If a command has more than one header, you must separate them wi...

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 characterstring. Numerical Data Formats Symbol Data Form Talking Formats <NR1> Digits with an implied decimal point assumed at the right of the leas...

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

Introduction to Programming - 2 25 Error Handling If there is no error-handling code in your program, undetected errors can cause unpredictable results. Thisincludes "hanging up" the controller and forcing you to reset the system. Both of the above DOS drivershave routines for detecting prog...

27 3 Language Dictionary Introduction This section gives the syntax and parameters for all the IEEE 488.2 SCPI commands and the Commoncommands used by the ac sources when operating in Normal mode. It is assumed that you are familiarwith the material in Chapter 2 "Introduction to Programming"...

3 - Language Dictionary 28 Subsystem Commands Subsystem commands are specific to functions. They can be a single command or a group ofcommands. The groups are comprised of commands that extend one or more levels below the root. Thedescription of common commands follows the description of the subsyst...

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 nonvolatilemem...

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

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

Language Dictionary - 3 55 Output Subsystem This subsystem controls the main outputs, the signal outputs, the power-on state, and the outputprotection function of the ac source. Subsystem Syntax OUTPut [:STATe] <bool> Enable/disable output voltage, current, power, etc. :COUPling <coupling&g...

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

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 inthe output waveform phase. Subsystem Syntax ...

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 ofvoltage, voltage offset, and function shape values. Therefore, the maximum...

3 - Language Dictionary 94 Status Subsystem This subsystem programs the ac source status registers. The ac source has four groups of statusregisters; Operation, Questionable, Questionable Instrument ISummary and Standard Event. TheStandard Event group is programmed with Common commands. The Operatio...

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 constantsWTG = Interface is waiting for a trigger.CV = Output voltage is regulate...

Language Dictionary - 3 97 Bit Configuration of Questionable Status Registers BitPosition 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 BitWeight 16384 8192 4096 2048 1024 512 16 8 4 2 1 OV over-voltage protection has tripped OCP...

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? Retu...

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 wavefo...

Language Dictionary - 3 107 Trigger Subsystem This subsystem controls the triggering of the ac source. See Chapter 4 under "Triggering OutputChanges" for an explanation of the Trigger Subsystem. The INITiate commands control the initialization ofboth the transient and measurement trigger sys...

3 - Language Dictionary 108 ABORt This command resets the measurement and transient trigger systems to the Idle state. Any outputtransient or measurement that is in progress is immediately aborted. ABORt also cancels any lists orpulses that may be in process. ABORt also resets the WTG bit in the Ope...

Language Dictionary - 3 109 INITiate:CONTinuous:SEQuenceINITiate: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 ...

Language Dictionary - 3 113 Common Commands Common commands begin with an * and consist of three letters (command) IEEE 488.2 standard toperform some common interface functions. The Agilent ac sources respond to the required commoncommands that control status reporting, synchronization, and internal...

3 - Language Dictionary 114 *CLS This command clears the following registers (see Chapter 4 under “Programming the Status Registers” fordescriptions of all registers): u Standard Event Status u Operation Status Event u Questionable Status Event u Status Byte u Error Queue Command Syntax *CLS Paramet...

Language Dictionary - 3 119 *STB? This query reads the Status Byte register, which contains the status summary bits and the Output QueueMAV bit. Reading the Status Byte register does not clear it. The input summary bits are cleared when theappropriate event registers are read (see Chapter 4 under “P...

121 4 Programming Examples Introduction This chapter contains examples on how to program your ac source. Simple examples show you how toprogram: u output functions such as voltage, frequency, and phase u the transient waveform generator u internal and external triggers u measurement functions u user...

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 outputvoltage to 125 volts rms, use: VOLTage 125 NOTE: In the three-phase model, all phases are programmed to 125 volts rms because theINSTrument:COUPle ...

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

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

4 - Programming Examples 128 Programming both the current and the voltage range in one program message unit can be done in anyorder and will not cause an error if the final combination specifies a valid current limit for the indicatedrange. If the commands VOLTage:RANGe 300 CURRent 10;:VOLTage:RANGe...

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 thedata that generates each mode. When a trigger is received in step or pulse modes, the triggered functions are set from their IMMediate totheir ...

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 convenientway to do this is with the *RST command. Then set the mode of the function that willgenerate the transient to STEP or PULSe as required. For example,...

Programming Examples - 4 131 List Transients List mode lets you generate complex sequences of output changes with rapid, precise timing, which maybe synchronized with internal or external signals. Each function that can participate in output transientscan also have an associated list of values that ...

4 - Programming Examples 132 Step 4 Determine the number of times the list is repeated before it completes. For example, torepeat 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 respond...

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 arrowsshow the transitions between states. These are labeled with the input or event that causes the transition tooccur. Figure 4-2. Model of Outpu...

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 systemignores all triggers. Sending the following commands at any time returns the trigger system to the Idlestate: ABORt *RST *RCL T...

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 outputtransient. 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 TRIG...

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

Programming Examples - 4 137 Making Measurements The ac source has the capability to return a number of current, voltage, and power measurements. Whenthe ac source is turned on, it is continuously sampling the instantaneous output voltage and current forseveral output cycles and writing the results ...

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 an...

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 systemignores all triggers. Sending the following commands at any time returns the tri...

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 anytime. For example, you may program the ac source to generate an interrupt (assert SRQ) whe...

Programming Examples - 4 145 Questionable Status Group The Questionable Status registers record signals that indicate abnormal operation of the ac source. Asshown in the figure 4-5, the group consists of the same type of registers as the Status Operation group. Register Command Description Condition...

4 - Programming Examples 146 Register Command Description Condition STAT:QUES:INST:ISUM:COND? A register that holds real-time status of thecircuits being monitored. It is a read-only register. PTR Filter STAT:QUES:INST:ISUM:PTR <n> A positive transition filter that functions asdescribed underS...

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

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 forQuestionable Status conditions at bits 0,...

Programming Examples - 4 149 Trigger Out BNC This chassis-referenced digital output can be programmed to supply a pulse output at the leading ortrailing edge of a step or pulse, or at the leading edge of any point in a list sequence. The output signal isnominally a 10 microsecond low-true pulse. To ...

4 - Programming Examples 150 Remote Inhibit (RI) Remote inhibit is an external logic signal routed through the rear panel INH connection, which allows anexternal device to signal a fault. To select an operating modes for the remote inhibit signal, use: OUTPut:RI:MODE LATChing | LIVE | OFF LATChing -...

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

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[:AMP...

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

157 C Error Messages Error Number List This appendix gives the error numbers and descriptions that are returned by the ac source. Errornumbers 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:ER...

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 9012Plug-in Programmer. The command to switch languages is: SYSTem:LANGuage SCPI | E9012 The language selection is st...

D - Elgar Model 9012 Compatibility 162 Status Model In E9012 language, status information is provided through the serial poll response byte and the errorqueue. The error queue operates as it does in SCPI language, providing error status of selftest and otherruntime errors. The SYSTem:ERRor? query op...

Elgar Model 9012 Compatibility - D 163 All power source functions not set by the above commands go to the state defined by the SCPI *RSTcommand, with the following exceptions: OUTPut:STATe ON VOLT:SENSe:SOURce EXTernal VOLT:SENSe:DETector RMS Protection The SOA fault, overtemperature, rail fault, ov...

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 functi...

167 E IEC Mode Command Summary Introduction The Agilent 6812B, 6813B, and 6843A ac sources are designed to operate in Normal as well as IECmode. 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. I...

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:AR...

181 Index —A— ac voltage, 122assigning HP-IB address in programs, 24 —B— BNC connectors, 148 —C— calibration subsystem, 29 CALibrate CURRent AC, 29CALibrate CURRent MEASure, 30CALibrate DATA, 30CALibrate IMPedance, 30CALibrate LEVel, 30CALibrate PASSword, 31CALibrate PWM FREQuency, 31CALibrate PWM R...

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 te...

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.