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