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