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