Types of Scpi Messages, Abor VOLT? | Agilent Technologies E4356A

Types of SCPI Messages

There are two types of SCPI messages, program and response.

∙A program message consists of one or more properly formatted SCPI commands sent from the controller to the power supply. The message, which may be sent at any time, requests the power supply to perform some action.

∙A response message consists of data in a specific SCPI format sent from the power supply to the controller. The power supply sends the message only when commanded by a special program message called a "query."

Structure of a SCPI Message

SCPI messages consist of one or more message units ending in a message terminator. The terminator is not part of the syntax, but implicit in the way your programming language indicates the end of a line (such as a newline or end-of-line character).

The following command message (see Figure 6-2) is briefly described here, with more details in subsequent paragraphs.

Figure 6-2. Command Message Structure

The basic parts of the message in Figure 6-1 are:

Message Component	Example
Headers	VOLT LEV PROT CURR
Header Separator	The colon in VOLT:LEV
Data	4.5 4.8
Data Separator	The space in VOLT 4. 5 and PROT 4. 8
Message Units	VOLT:LEV 4.5 PROT 4.8 CURR?
Message Unit Separator	The semicolons in VOLT: LEV 4. 5; and PROT 4. 8;
Root Specifier	The colon in PROT 4. 8; : CURR?
Query Indicator	The question mark in CURR?
Message Terminator	The <NL> (newline) indicator. Terminators are not part of the SCPI syntax.

The Message Unit. The simplest SCPI command is a single message unit consisting of a command header (or keyword) followed by a message terminator.

ABOR

VOLT?

The message unit may include a parameter after the header. The parameter usually is numeric, but it can be a string:

VOLT 20

VOLT MAX

Remote Programming 49

Image 49

Agilent Technologies E4356A manual Types of Scpi Messages, Structure of a Scpi Message, Abor VOLT?, Volt Volt MAX

Contents

Operating Programming Guide Certification General Safety Summary Symbol Description Safety Symbol DefinitionsAcoustic Noise Information Herstellerbescheinigung Printing History Declaration General Information Table of Contents Operating Configurations Setting Up Remote Sense OperationController Connections Scpi Command Completion Programming Examples Types of Scpi CommandsScpi Confirmed Commands NON-SCPI Commands Description Of Common Commands Calibration Commands Current Subsystem Description Of Subsystem CommandsSystem Commands Command Summary Programming Parameters 105 111 109113 119Page General Information Safety ConsiderationsIntroduction Getting Started Map Operator Replaceable Parts List AccessoriesOptions Front Panel Programming DescriptionRemote Programming Analog Programming Output Ranges Output CharacteristicDownprogramming Inspection InstallationDamage Packaging Material Items Supplied Input Power Source Location and Temperature Connecting Power Cord Downloading and Installing the Driver VXI plug&play Power Products Instrument DriversAccessing Online Help Supported Applications System Requirements Turn-On Checkout Power-On CheckoutPreliminary Checkout Turn-On Checkout Output Checkout Using the KeypadShifted Keys Backspace Key Press Prot Clear Checking the Current Function Determining The Gpib Address Checking The Save And Recall FunctionsCase Of Trouble Line Fuse Selftest Errors Error MessagesPower-On Error Messages Runtime Error Messages Checksum ErrorsError Display Power-On Selftest Errors Failed Test Runtime Errors Meaning Display Analog Connector Load Wire SelectionUser Connections Rear Panel Connections Connecting the Power supply to the Load Digital ConnectorOutput Isolation Capacitive Loads Inductive Loads Battery Charging Setting Up Remote Sense Operation Connecting One Power supply to a Single Load Operating ConfigurationsOVP Considerations Stability Connecting Units in Auto-Parallel Connecting One Power supply To Multiple Loads Auto-Parallel Connection Remote Sensing Optional Connecting Units in Series Series Connection Remote Sensing Optional External Voltage Control Stand-Alone Connections Controller ConnectionsLinked Connections 10. Controller Connections Getting Acquainted Front Panel OperationFront Panel Operation Volts Amps Control or IndicatorOCP SRQ  System Keys Front Panel Controls and Indicators Function Keys  Entry Keys Establishing Initial Conditions Programming The OutputProgramming Voltage Programming Overvoltage Protection Programming Current Unregulated Operation CV Mode vs. CC ModeProgramming Overcurrent Protection Types of Power supply Gpib Addresses Setting The Gpib AddressSaving and Recalling Operating States Turn-On Conditions Action Display Shows Changing the Power supply Gpib Address Prerequisites for Remote Programming Remote ProgrammingExternal Documents Scpi References Types of Scpi Commands Gpib Capabilities of the Power supplyIntroduction To Scpi Conventions Active Header Path Traversing the Command TreeEffect of Optional Headers Moving Among Subsystems Including Common CommandsScpi Queries Value Coupling Structure of a Scpi Message Types of Scpi MessagesAbor VOLT? Volt Volt MAX Outpprotdel Voltage, Volt, volt Numerical Data Scpi Data FormatsBoolean Data Character Data Programming Examples Scpi Command CompletionWAI OPC? Programming Protection Circuits Programming Voltage and CurrentChanging Outputs by Trigger Saving and Recalling States Programming Status Writing to the DisplayDetecting Events via SRO Reading Specific Registers System Considerations Setting the Gpib AddressProgramming the Digital I/O Port Digdata Assign @PS to Assigning the Gpib Address In Programs DOS Drivers Error HandlingTypes of Drivers Agilent Basic Controllers Iout = OUTPUTS2 Programming Some Power supply Functions CODES$ = Output OFF*SAV CODES$ = STATOPEREVEN? Gosub While C O NON-SCPI Commands Scpi Confirmed Commands1 Language Dictionary Command Syntax Description Of Common CommandsCLS Meaning and Type ESR? ESEESE ESR? PSC *STB? IDN? Parameters None Related CommandsOPC OPC? *WAI OPT? OPC?OPC *TRIG WAI OPT? ESE *SRE RCLPSC *RST *SAV SAV RSTPSC SAV SAV Bit Configuration of Status Byte Register Bit Position Condition Bit WeightSRE STB? TST? TRGWAI Calibration Commands Description Of Subsystem CommandsAbor Abor Curr Currtrig Current SubsystemCurrprotstat Display Subsystem Digital SubsystemDigdata Disp Disptext Dispmode Measure Subsystem Initiate SubsystemInit Initcont MEASCURR? MEASVOLT? Outp Output SubsystemOutpprotcle Outpprotdel Outprel Status SubsystemOutprelpol Statpres STATOPER? Status Operation RegistersSTATOPERCOND? Statoperenab Status Questionable Registers Statoperntr StatoperptrSTATOUES? STATQUES? Statquesenab STATQUESCOND?Statquesntr Statquesptr Statusquestionableptr SYSTERR? System CommandsSystlang SYSTVERS? Voltage Subsystem Trigger SubsystemTrig Trigsour Voltagelevel 200 MA VoltprotVoltagelevelimmediateamplitude Voltageleveltriggered Command Summary Command SummaryCommand Parameters Subsystem Commands Common Commands Command Parameters Command ParametersPower supply Programming Parameters see note Programming Parameters Register Commands Power supply Status StructureStatus Reporting Operation Status Group Status Byte and Service Request Enable Registers Bit Signal Bit Configurations of Status Registers MeaningOperation Status Group Standard Event Status Group CAL WTG UNR Questionable Status Group Status Questionable Commands Register Query Cleared ByStandard Event Status Group STATQUESNTR? Status Byte Register Inhibit/Fault Indicator PON Power-On Bit Initial Conditions At Power OnDetermining the Cause of a Service Interrupt Status Register Programming Examples Monitoring Both Phases of a Status Transition Servicing an Operation Status Mode EventAdding More Operation Events Servicing Questionable Status Events Value Specifications Typical Common Mode Noise Current Temperature CoefficientsMaximum Input VA and Power AC Input Ranges Output Terminal Isolation Command Processing Time Table A-2. Supplemental Characteristics Parameter ValueOutput Voltage Rise Time/Fall Time Full-load Programming Speed Up Time/Down Time Table A-2. Supplemental Characteristics Test Setup General ProcedureCalibration Equipment Required Changing the Calibration Password Disabling the Calibration ModeFront Panel Calibration Entering the Calibration Values Display Response Table B-2. Typical Front Panel Calibration Procedure Action Error Meaning Table B-3. Gpib Calibration Error Messages MeaningFront Panel Command Corresponding Scpi Calibration Over The Gpib Calcurr Calibration Language DictionaryCalcurrlev Calpass Calvolt CalstatCalvoltlev Calvoltprot Pause Clear Screen Basic Calibration Program Figure B-2. Basic Calibration Program Test Equipment Required VerificationList of Equipment Current Monitoring Resistor Performing The Tests Remove the short from across the load Current Programming and Readback AccuracyVoltage Programming and Readback Current Programming and ReadbackPage Power supply Hardware Error Messages Error MessagesCalibration Error Messages System Error Messages Error Number Line Voltage Conversion Line Voltage ConversionPage Digital Port Functions Fault/Inhibit Operation Figure F-2. Example of Inhibit Input Figure F-4. Digital Port Configuration Jumper Changing The Port Configuration Relay Link Operation Digital I/O OperationIN/OUT 2 pin Common pin Figure F-6. Relay Link Connections Page Parallel Polling Compatibility LanguageCompatibility Language Table G-1. Arps Commands Description Arps Command1Similar Scpi Command Outpprotcle Volttrig Currtrig HOLD? TRG RST Hold OFF Hold onVOLTTRIG? CURRTRIG? Init Ontrig Init ON*TRG STO RCL STS? ASTS? TEST? ID? Systlang UNMASK? FAULT?TST? IDN? Systlang Index Index Index Scpi Curr Prot Stat CURR, Curr TRIG, 73 DIG Data Index Agilent Sales and Support Offices Manual Updates