AC Power Solutions
Agilent Models 6811B, 6812B, 6813B
6814B, 6834B, and 6843A
Programming Guide
Safety Summary
Printing History
2 - INTRODUCTION TO PROGRAMMING
Table of Contents
1 - GENERAL INFORMATION
3 - LANGUAGE DICTIONARY
Measurement Subsystem Frequency
Source Subsystem Frequency
System Commands
Source Subsystem Voltage
Status Subsystem
Trace Subsystem
4 - PROGRAMMING EXAMPLES
A - SCPI COMMAND TREE
C - ERROR MESSAGES
B - SCPI CONFORMANCE INFORMATION
D - ELGAR MODEL 9012 COMPATIBILITY
E - IEC MODE COMMAND SUMMARY
INDEX
E9012 Language Command Summary
Introduction
General Information
About this Guide
Earlier AC Source Models
Documentation Summary
External References
SCPI References
GPIB References
Supported Applications
System Requirements
Downloading and Installing the Driver
Accessing Online Help
Page
Introduction to Programming
GPIB Capabilities of the AC Source
RS-232Capabilities of the AC Source
GPIB Address
RS-232Troubleshooting
RS-232Programming Example
Types of SCPI Commands
Introduction to SCPI
Conventions Used in This Guide
Types of SCPI Messages
Active Header Path
The SCPI Command Tree
The Root Level
The Effect of Optional Headers
Moving Among Subsystems
Including Common Commands
Using Queries
Coupled Commands
Structure of a SCPI Message
Combining Message Units
Headers
Figure 2-2.Command Message Structure
Message Component
Query Indicator
Message Unit Separator
Root Specifier
Message Terminator
SCPI Data Formats
Numerical Data Formats
Suffixes and Multipliers
Character Data
Types of DOS Drivers
System Considerations
Assigning the GPIB Address in Programs
Error Handling
Agilent BASIC Controllers
Page
Language Dictionary
Introduction
Subsystem Commands
Subsystem
Calibration Subsystem Commands
Subsystem Syntax
CALibrate CURRent AC
CAL CURR AC
CALibrate:CURRent:MEASure
CALibrate:DATA
CALibrate:IMPedance
CALibrate:LEVel
CALibrate:PASSword
CALibrate:PWM:FREQuency
CALibrate:PWM:RAMP
CALibrate:SAVE
CALibrate:STATe
CALibrate:VOLTage:AC
CALibrate:VOLTage:DC
CAL:STAT 1,6812 CAL:STAT OFF
CALibrate:VOLTage:OFFSet
CALibrate:VOLTage:PROTection
CALibrate:VOLTage:RTIMe
CAL:VOLT:OFFS
Display Subsystem Commands
DISPlay
DISPlay:MODE
DISPlay:TEXT
Instrument Subsystem
INSTrument:COUPle
INST:COUP ALL
Subsystem Syntax
INSTrument:NSELect INSTrument:SELect
Command Syntax Parameters RST Value Examples
Query Syntax Returned Parameters Related Commands
Agilent 6834B Only
Subsystem Syntax
Measurement Subsystem Arrays
MEASure:ARRay:CURRent? FETCh:ARRay:CURRent?
MEASure:ARRay:CURRent:HARMonic:PHASe?
FETCh:ARRay:CURRent:HARMonic:PHASe?
MEASure:ARRay:CURRent:HARMonic?
FETCh:ARRay:CURRent:HARMonic?
MEASure:ARRay:CURRent:NEUTral?
FETCh:ARRay:CURRent:NEUTral?
MEASure:ARRay:CURRent:NEUTral:HARMonic?
FETCh:ARRay:CURRent:NEUTral:HARMonic?
MEASure:ARRay:VOLTage? FETCh:ARRay:VOLTage?
MEASure:ARRay:CURRent:NEUTral:HARMonic:PHASe?
FETCh:ARRay:CURRent:NEUTral:HARMonic:PHASe?
MEASure ARRay VOLTage HARMonic PHASe?
FETCh:ARRay:VOLTage:HARMonic:PHASe?
MEASure:ARRay:VOLTage:HARMonic?
FETCh:ARRay:VOLTage:HARMonic?
Subsystem Syntax
Measurement Subsystem Current
MEASure:CURRent? FETCh:CURRent?
MEASure:CURRent:AC? FETCh:CURRent:AC?
MEASure:CURRent:ACDC? FETCh:CURRent:ACDC?
MEASure CURRent AMPLitude MAXimum?
FETCh:CURRent:AMPLitude:MAXimum?
MEASure:CURRent:HARMonic? FETCh:CURRent:HARMonic?
MEASure:CURRent:CREStfactor?
FETCh:CURRent:CREStfactor?
MEASure:CURRent:HARMonic:PHASe?
FETCh:CURRent:HARMonic:PHASe?
MEASure:CURRent:HARMonic:THD?
FETCh:CURRent:HARMonic:THD?
MEASure CURRent NEUTral AC?
FETCh CURRent NEUTral AC?
MEASure:CURRent:NEUTral:ACDC?
FETCh:CURRent:NEUTral:ACDC?
MEASure:CURRent:NEUTral:HARMonic:PHASe?
FETCh:CURRent:NEUTral:HARMonic:PHASe?
Related Commands
Agilent 6834B Only
Subsystem Syntax
Measurement Subsystem Frequency
MEASure:FREQuency? FETCh:FREQuency?
Measurement Subsystem Power
MEASure:POWer? FETCh:POWer?
MEASure:POWer:AC? FETCh:POWer:AC?
Subsystem Syntax
MEASure:POWer:AC:APParent?
FETCh:POWer:AC:APParent?
MEASure:POWer:AC:REACtive?
FETCh:POWer:AC:REACtive?
MEASure POWer AC TOTal? FETCh POWer AC TOTal?
MEAS:POW:AC:TOT?
Agilent 6834B Only
Query Syntax
Measurement Subsystem Voltage
MEASure:VOLTage? FETCh:VOLTage?
MEASure VOLTage AC? FETCh VOLTage AC?
Subsystem Syntax
MEASure:VOLTage:ACDC? FETCh:VOLTage:ACDC?
MEASure:VOLTage:HARMonic? FETCh:VOLTage:HARMonic?
MEASure:VOLTage:HARMonic:PHASe?
FETCh:VOLTage:HARMonic:PHASe?
MEASure:VOLTage:HARMonic:THD?
FETCh:VOLTage:HARMonic:THD?
Subsystem Syntax
Output Subsystem
OUTPut
OUTPut:COUPling
OUTPut:DFI
OUTPut:DFI:SOURce
OUTP:COUP DC
OUTPut IMPedance
OUTPut:IMPedance:REAL
OUTPut:IMPedance:REACtive
OUTP:IMP:REAL
OUTPut PROTection DELay
OUTPut:PON:STATe
OUTPut PROTection CLEar
OUTP:PON:STAT RST
OUTPut:RI:MODE
OUTPut TTLTrg
OUTPut TTLTrg SOURce
OUTP:TTLT
Subsystem Syntax
Sense Subsystem
SENSe:CURRent:ACDC:RANGe
SENSe:SWEep:OFFSet:POINts
SENSe SWEep TINTerval
SENSe:WINDow
SENS:WIND KBES
Subsystem Syntax
Source Subsystem Current
CURRent
CURR:PEAK:MODE FIX
CURRent:PEAK
CURRent:PEAK:MODE
CURRent:PEAK:TRIGgered
CURRent:PROTection:STATe
Source Subsystem Frequency
FREQuency
FREQuency:MODE
Subsystem Syntax
FREQuency SLEW
FREQuency:SLEW:MODE
FREQency:SLEW:TRIGgered
FREQ:SLEW:IMM
FREQuency:TRIGgered
FREQ:TRIG
Command Syntax Parameters Unit RST Value Examples
Query Syntax Returned Parameters Related Commands
Subsystem Syntax
Source Subsystem Function
FUNCtion
FUNC:MODE FIX
FUNCtion:MODE
FUNCtion:TRIGgered
FUNC:CSIN 10 THD
FUNCtion:CSINusoid
FUNC:CSIN
Source Subsystem List
Subsystem Syntax
LIST CURRent POINts?
LIST:COUNt
LIST:CURRent
LIST:FREQuency
LIST:DWELl
LIST:DWELl:POINts?
LIST:PHASe
LIST:FREQuency:POINts?
LIST:FREQuency:SLEW
LIST:FREQuency:SLEW:POINts?
LIST:SHAPe:POINts?
LIST:PHASe:POINts?
LIST:SHAPe
LIST:STEP
LIST:TTLTrg
LIST:TTLTrg:POINts?
LIST:STEP ONCE
LIST:VOLTage
LIST:VOLTage:POINts?
LIST:VOLTage:SLEW
LIST:VOLT:POIN?
LIST:VOLTage:SLEW:POINts?
LIST VOLTageOFFSet
LIST:VOLTage:OFFSet:POINts?
LIST:VOLT:SLEW:POIN?
LIST:VOLT:OFFSet:SLEW:POIN?
LIST:VOLTage:OFFSet:SLEW
LIST:VOLTage:OFFSet:SLEW:POINts?
Source Subsystem Phase
PHASe
PHASe:MODE
PHASe:TRIGgered
Source Subsystem Pulse
PULSe:COUNt
PULSe:DCYCle
Subsystem Syntax
PULSe:HOLD
PULS:HOLD DCYC
PULSe:PERiod
PULSe:WIDTh
PULS PER
Returned Parameters Related Commands
Source Subsystem Voltage
Subsystem Syntax
VOLTage
VOLTage:TRIGgered
VOLTage:MODE
VOLTage:OFFSet
VOLT:OFFS:MODE FIX
VOLTage:OFFSet:MODE
VOLTage:OFFSet:TRIGgered
VOLT:OFFS:SLEW:MODE STEP
VOLTage:OFFSet:SLEW
VOLTage:OFFSet:SLEW:MODE
VOLTage:OFFSet:SLEW:TRIGgered
VOLTage:PROTection
VOLTage:PROTection:STATe
VOLT:PROT:STAT
VOLTage:RANGe
VOLTage:SENSe:DETector VOLTage:ALC:DETector
VOLTage SENSe SOURce VOLTage ALC SOURce
VOLTage:SLEW
VOLT:SLEW:MODE STEP
VOLTage SLEW MODE
VOLTage:SLEW:TRIGgered
Subsystem Syntax
STATus:PRESet
Status Subsystem
Bit Configuration of Operation Status Registers
STATus:OPERation:ENABle
STATus:OPERation?
STATus:OPERation:CONDition?
STATus:OPERation:NTRansition
STATus OPERation PTRansition
Command Syntax Parameters Default Value Examples
Query Syntax
STATus:QUEStionable?
STATus:QUEStionable:CONDition?
STAT:QUES:EVEN?
STAT:QUES:COND?
STATus QUEStionable ENABle
STATus:QUEStionable:NTRansition
STATus:QUEStionable:PTRansition
STAT:QUES:ENAB
STATus:QUEStionable:INSTrument:ISUMmary?
Agilent 6834B Only Phase Selectable
Related Commands
Query Syntax
STAT:QUES:INST:ISUM:ENAB
STATus:QUEStionable:INSTrument:ISUMmary:ENABle
STAT:QUES:INST:ISUM:COND?
STATus:QUEStionable:INSTrument:ISUMmary:NTR
STATus:QUEStionable:INSTrument:ISUMmary:PTR
Command Syntax Parameters Default Value Examples
Agilent 6834B Only
System Commands
SYSTem:CONFigure
SYST:CONF NORM
Subsystem Syntax
SYSTem:CONFigure:NOUTputs
SYSTem:ERRor?
SYSTem:VERSion?
SYST:CONF:NOUT
SYSTem:LANGuage
SYSTem:LOCal
SYSTem:REMote
SYSTem:RWLock
Subsystem Syntax
Trace Subsystem
TRACe DATA
TRACe:CATalog? DATA:CATalog?
TRACe DEFine DATA DEFine
TRACe:DELete DATA:DELete
TRAC:DEF flattop
Trigger Subsystem
Subsystem Syntax
ABORt
INITiate SEQuence INITiate NAME
ABOR
INIT SEQ1
TRIGger:DELay
INITiate:CONTinuous:SEQuence
INITiate:CONTinuous:NAME
TRIGger
TRIGger SYNChronize SOURce
TRIGger:SOURce
TRIGger:SEQuence2:SOURce
TRIGger:SEQuence2:PHASe TRIGger:SYNCHronize:PHASe
TRIGger:SEQuence3 TRIGger:ACQuire
Command Syntax Parameters RST Value Examples
Command Syntax
TRIGger SEQuence3 DEFine
TRIGger:SEQuence3:SOURce TRIGger:ACQuire:SOURce
TRIGger:SEQuence1:DEFine TRIGger:SEQuence2:DEFine
Common Commands
Common Commands Syntax
Page
ESR?
IDN?
OPT?
Command Syntax *RST Parameters None
Related Commands *PSC *SAV
Page
TST?
Bit Configuration of Status Byte Register
STB?
Command Syntax WAI? Parameters None
Related Commands *OPC
Power-onInitialization
Programming Examples
Programming the Output
Enabling the Output
Voltage Ranges Agilent 6814B/6834B/6843A only
AC Voltage and Frequency
Maximum Voltage
Voltage and Frequency Slew Rates
Waveform Shapes
Frequency
Voltage Slew
User-DefinedWaveform
Individual Phases Agilent 6834B only
Clipped Waveform
Programming the Output Phase
Current Limit
Selecting a Phase
DC Output Agilent 6811B/6812B/6813B only
Peak Current Limit Agilent 6811B/6812B/6813B only
Coupled Commands
VOLTage:LEVel, VOLTage:OFFSet, and FUNCtion:SHAPe
Programming Output Transients
STEP
PULSe
LIST
Transient System Model
Figure 4-1.Model of Transient System
Step and Pulse Transients
Step Step Step Step Step Step 6 Example
Step
List Transients
Step Step
Triggering Output Changes
SCPI Triggering Nomenclature
Output Trigger System Model
Figure 4-2.Model of Output Triggers
Initiating the Output Trigger System
Selecting the Output Trigger Source
Specifying a Trigger Delay
Generating Output Triggers
Specifying a Dwell Time for Each List Point
Single Triggers
Continuous Triggers
Making Measurements
Voltage and Current Measurements
Power Measurements
Harmonic Measurements
SCPI Triggering Nomenclature
Triggering Measurements
Measurement Trigger System Model
Figure 4-3.Model of Measurement Triggers
Initiating the Measurement Trigger System
Selecting the Measurement Trigger Source
Pre-eventand Post-eventTriggering
Generating Measurement Triggers
Varying the Voltage and Current Sampling Rate
Operation Status Group
Power-OnConditions
Programming the Status Registers
Signal
Table 4-1.Bit Configuration of Status Registers
Status Byte and Service Request Enable Registers
Meaning Operation Status Group
Figure 4-5.Ac Source Status Model
Questionable Status Group
Questionable Instrument Isummary Status Group
Standard Event Status Group
Command
Command Action
The PON Power On Bit
Status Byte Register
Examples
Command Action
Determining the Cause of a Service Interrupt
Trigger In BNC
Monitoring Both Phases of a Status Transition
Servicing Questionable Status Events
Step
Remote Inhibit and Discrete Fault Indicator
Trigger Out BNC
Remote Inhibit RI
SCPI Command Completion
Discrete Fault Indicator DFI
SCPI Command Tree
Command Syntax
FETCh | MEASure
ABORt
A - SCPI Command Tree
OUTPut
SENSe
SOURce
SCPI Command Tree - A
SCPI Common Commands
STATus
SYSTem
Page
SCPI Confirmed Commands
SCPI Conformance Information
Non SCPI Commands
B - SCPI Conformance Information
Error Messages
Error Number List
Execution Errors –200through –299sets Standard Event Status Register bit #4
Page
Page
Elgar Model 9012 Compatibility
Elgar Model 9012 Plug-inProgrammer Compatibility
Main Board W1 Jumper Option Emulation
Syntax Compatibility
Power-onState
Status Model
Command Description
Byte
Protection
Front Panel Operation
System Keys
Function Keys
E9012 Language Command Summary
Entry Keys
Command
Description
Page
Introduction
Using the SENSe:CURRent:ACDC:RANGe command
IEC Mode Command Summary
Command Syntax
CALCulate:INTegral:TIME
CALCulate:SMOothing
CALCulate:LIMit:UPPer
Command Syntax
vss delta dmax limit
dc limit dt tlimit dt limit
FORMat
Command Syntax
Related Commands
Parameters
FORMat:BORDer
Command Syntax
Related Commands
Parameters
Command Syntax Parameters Examples
Related Commands
MEASure:ARRay:CURRent:HARMonic?
SOURce:FREQ
MEASure ARRay VOLTage FLUCtuations ALL?
12 point Pst array
Returned Parameters Related Commands
MEASure:ARRay:VOLTage:FLUCtuations:FLICker?
Command Syntax Parameters Examples
Returned Parameters Related Commands
MEASure:ARRay:VOLTage:FLUCtuations:PST?
Command Syntax Parameters Examples
SENSe:CURRent:PREFerence
SENSe:WINDow
SYSTem:CONFigure
Agilent 6812B, 6813B, 6843A Only
Page
Index
Index
Page
VOLTage RANGe,
QUEStionable INSTrument ISUMmary ENABle?
SYSTem CONFgure, SYSTem CONFigure NOUTputs,
QUEStionable INSTrument ISUMmary CONDition?
QUEStionable INSTrument ISUMmary?,
Agilent Sales and Support Offices
United States
Latin America
Canada
Manual Updates
4/15/00
All references to HP have been changed to Agilent
All references to HP-IBhave been changed to GPIB