Page 53
6
Language Dictionary
Introduction
This section gives the syntax and parameters for all the IEEE 488.2 SCPI commands and the Common commands used by the dc source. It is assumed that you are familiar with the material in chapter 4, which explains the terms, symbols, and syntactical structures used here and gives an introduction to programming. You should also be familiar with chapter 5, in order to understand how the dc source functions.
The programming examples are simple applications of SCPI commands. Because the SCPI syntax remains the same for all programming languages, the examples given for each command are generic.
Syntax Forms | Syntax definitions use the long form, but only short form headers (or "keywords") |
| appear in the examples. Use the long form to help make your program self- |
| documenting. |
Parameters | Most commands require a parameter and all queries will return a parameter. The |
| range for a parameter may vary according to the model of dc source. When this is the |
| case, refer to the Specifications table in Appendix A. |
Related | Where appropriate, related commands or queries are included. These are listed |
Commands | because they are either directly related by function, or because reading about them |
| will clarify or enhance your understanding of the original command or query. |
Order of | The dictionary is organized according to the following functions: calibration, display, |
Presentation | measurement, output, status, system, trigger, and common commands. Both the |
| subsystem commands and the common commands that follow are arranged in |
| alphabetical order under each heading. |
Subsystem Commands
Subsystem commands are specific to functions. They can be a single command or a group of commands. The groups are comprised of commands that extend one or more levels below the root.
The subsystem command groups are arranged according to function: Calibration, Display, Measurement, Output, Status, System, and Trigger. Commands under each function are grouped alphabetically. Commands followed by a question mark (?) take only the query form. When commands take both the command and query form, this is noted in the syntax descriptions. Table 6-1 lists all of the subsystem commands in alphabetical order.
Common Commands
Common commands begin with an * and consist of three letters (command) or three letters and a ? (query). They are defined by the IEEE 488.2 standard to perform common interface functions. Table 6-2 lists all of the common commands in alphabetical order.
Programming Parameters
Table 6-3 lists all of the output programming parameters.
53
Contents
Agilent Technologies Model N3280A Component Test DC Source
USER’S Guide
Certification
Warranty Information
General
Safety Summary
Safety Symbols
Declaration
Printing History
Acoustic Noise Information
Table of Contents
Scpi Command Completion Using Device Clear
Types of Scpi Commands
External References
Gpib Capabilities of the DC Source Introduction to Scpi
Measurement Commands
Scpi Programming Commands At a Glance Calibration Commands
Output Commands
Status Commands
Trigger Commands
System Commands
Common Commands
Voltage Priority Tests
Transient Response Tests
Error Number List 103
Ripple and Noise Tests
Page
Document Orientation
Safety Considerations
Description
Options and Accessories
Remote Programming
Option Description
Voltage Priority Operation
Output Characteristics
Current Priority Operation
Output Characteristic Current Priority
Measurement Characteristics
Start of a Measurement
Inspection
Cleaning
Damage Packaging Material
Additional Items
Bench Operation
Location
Rack Mounting
Do not block the fan exhaust at the rear of the unit
Connect the Power Cord
Power Connections
Outputs 1
Turn the unit off before connecting any wires
Output Connections
Voltage Drops and Lead Resistance
Current Ratings
Ampacity and Resistance of Stranded Copper Conductors
AWG No Maximum Ampacity Resistance at 20 deg. C Free air
Guard Connections for Test Fixtures
Coaxial Guard Connections
Computer Connections
External Trigger Connections
Maintaining Stability
OVP Considerations
Switch Setting
Settings for Power Module Configuration Switch
Switch Setting Address
Gpib Address
Front Panel Description
Explanation
Checkout Procedure
Procedure
Runtime Error Messages
Selftest Error Messages
Power-On Selftest Errors
Case of Trouble
Page
Gpib Capabilities of the DC Source
External References
Gpib References
Scpi References
Conventions Used in This Guide
Types of Scpi Commands
Introduction to Scpi
Including Common Commands
Multiple Commands in a Message
Using Queries
Moving Among Subsystems
Channel List Parameter
Types of Scpi Messages
Message Unit
Scpi Data Formats
Suffixes and Multipliers
Scpi Command Completion
Response Data Types
Class Suffix Unit Unit with Multiplier
Outputstate Example
Using Device Clear
Page
Introduction
Power-on Initialization
Programming the Output
Enabling the Output
Output Current
Output Mode
Overvoltage Protection
Output Trigger Model
Triggering Output Changes
Oscillation Protection
Selecting the Output Trigger Source
Setting the Voltage and Current Trigger Levels
Enabling the Output Trigger System
Average Measurements
Making Measurements
Generating Output Triggers
Measurement Samples and Time Interval
Power Line Cycles
Current Ranges
Triggered Measurements
Window Functions
Returning All Measurement Data From the Data Buffer
Selecting the Measurement Trigger Source
Measurement Trigger Model
Enabling the Measurement Trigger System
Generating Measurement Triggers
Output Settling Delay
Selecting the Sensing Function
Pre-trigger and Post-trigger Acquisition
Pre-trigger and Post-trigger Data Acquisition
DC Source Status Model
Programming the Status Registers
Operation Status Group
Bit Configurations of Status Registers
Standard Event Status Group
Questionable Status Group
Status Byte Register
MSS and RQS Bits
Servicing Operation Status and Questionable Status Events
Determining the Cause of a Service Interrupt
Programming Parameters
Subsystem Commands
Common Commands
Save new cal constants in non-volatile memory
Scpi Programming Commands At a Glance
Subsystem Commands Syntax
FUNCtion Mode mode, @list VOLTage
Mode mode, @list DELay
Sets the output voltage in voltage priority mode
Sets the triggered output voltage in voltage priority mode
ESE n
Common Commands Syntax
SRE n
Output Programming Parameters
CALibrateCURRent
Calibration Commands
CALibrateCURRentLIMitPOSitive CALibrateCURRentLIMitNEGative
CALibrateCURRentMEASure
CALibrateDATA
CALibratePASSword
CALibrateDATE
CALibrateLEVel
CALibrateVOLTage
CALibrateSAVE
CALibrateSTATe
FETChARRayCURRent? FETChARRayVOLTage?
Measurement Commands
FETChCURRent? FETChVOLTage?
Query Syntax
MEASureCURRent? MEASureVOLTage?
MEASureARRayCURRent? MEASureARRayVOLTage?
SENSeCURRentRANGe
Enter values greater than 0.015A
SENSeSWEepNPLCycles
SENSeFUNCtion
SENSeSWEepOFFSetPOINts
Query Syntax SENSeFUNCtion? @channel list
SENSeWINDow
SENSeSWEepPOINts
SENSeSWEepTINTerval
OUTPut
Output Commands
OUTPutOSCProtect
OUTPutPROTectionCLEar
SOURceCURRentIMMediate SOURceCURRentTRIGgered
Default Suffix
SOURceCURRentLIMitIMMediate SOURceCURRentLIMitTRIGgered
SOURceCURRentLIMitBWIDth
SOURceCURRentMODE SOURceCURRentLIMitMODE
SOURceDELay
SOURceDELayMODE
SOURceVOLTageALCBWIDth
SOURceFUNCtionMODE
SOURceVOLTageIMMediate SOURceVOLTageTRIGgered
Query Syntax SOURceFUNCMODE? @channel list
SOURceVOLTagePROTectionSTATe
SOURceVOLTageMODE
Query Syntax SOURceVOLTagePROTectionSTATe? @channel list
NR10 or
STATusOPERationENABle
Status Commands
Bit Configuration of Operation Status Registers
STATusOPERationEVENt?
Parameters Preset Value
STATusPRESet
Command Syntax STATusPRESet Parameters None Examples
STATusOPERationNTR STATusOPERationPTR
Query Syntax STATusQUEStionableENABle? @channel list
STATusQUEStionableENABle
STATusQUEStionableCONDition?
STATusQUEStionableNTR STATusQUEStionablePTR
SYSTemVERSion?
System Commands
SYSTemERRor?
ABORt
Trigger Commands
INITiateNAME
TRIGgerACQuire
TRIGgerTRANsientSOURce
TRIGgerACQuireSOURce
TRIGgerTRANsient
RST Value
Command Syntax *CLS Parameters None
Common Commands
Parameters Power-On Value Examples
Bit Configuration of Standard Event Status Enable Register
Query Syntax *OPT? Returned Parameters Aard
Field Information
Example
RST Settings
Power-on Value
Query Syntax TST? Returned Parameters NR1
Bit Configuration of Status Byte Register
Table A-1. Specifications
Table A-2 Supplemental Characteristics
Safety
Output Common Mode
Dimensions
Weight
Figure A-1. Output Impedance Graphs all outputs
Equipment Required
Measurement Techniques
Performance & Verification Tests
Programming
Test Setup
Electronic Load
Voltage Priority Tests
Program Commands
Voltage Programming and Readback Accuracy
Positive Current Limit +CL
Negative Current Limit -CL
Action Program Commands
Current Programming and Readback Accuracy
Current Priority Tests
Voltage Priority, Constant Voltage Load Effect
Load Effect Tests
Voltage Priority, -Current Limit Load Effect Test
Voltage Priority, +Current Limit Load Effect
Voltage Priority, Constant Voltage Source Effect
Source Effect Tests
Current Priority Constant Current Test
Voltage Priority, -Current Limit Source Effect
Voltage Priority, +Current Limit Source Effect
Current Priority, Constant Current Source Effect
Voltage Priority Ripple and Noise
Ripple and Noise Tests
Current Priority Ripple and Noise
Voltage Priority, Transient Recovery Time
Transient Response Tests
Figure B-2. Transient Waveform Voltage Priority
Current Priority Transient Recovery Time
Figure B-3. Transient Waveform Current Priority
Performance Test Equipment Form
Performance Test Record Form
Enable Calibration Mode
Performing the Calibration Procedure
Positive Current Limit Calibration
Negative Current Limit Calibration
5A Range Current Measurement Calibration
100
101
15mA Range Current Measurement Calibration
Saving the Calibration Constants
Calibration Error Messages
Changing the Calibration Password
Table B-3. Gpib Calibration Error Messages
Error Meaning
103
Error Number List
Table C-1. Error Numbers
104
Error Messages
105
Error Messages C
Page
107
Line Voltage Selection
Page
Mating Connector Part Numbers
Earlier Version Output Connectors
Rear Panel Pinout Assignments
CHG-2010-J01010-KEP
Page
111
Index
112
Index
Scpi
113
114
Canada Australia/New Zealand
United States Latin America
Europe Asia Pacific
Japan
Manual Updates