An Introduction to the Scpi Language | Agilent Technologies E3633A

Chapter 4 Remote Interface Reference An Introduction to the SCPI Language

An Introduction to the SCPI Language

SCPI (Standard Commands for Programmable Instruments) is an ASCII- based instrument command language designed for test and measurement instruments. Refer to ‘‘Simplified Programming Overview’’, starting on page 80 for an introduction to the basic techniques used to program the power supply over the remote interface.

SCPI commands are based on a hierarchical structure, also known as a tree system. In this system, associated commands are grouped together under a common node or root, thus forming subsystems. A portion of the SOURce subsystem is shown below to illustrate the tree system.

[SOURce:]

CURRent {<current>MINMAXUPDOWN}

CURRent? [MINMAX]

CURRent:

TRIGgered {<current>MINMAX}

TRIGgered?{MINMAX}

VOLTage {<voltage>MINMAXUPDOWN}

VOLTage? [MINMAX]

VOLTage:

TRIGgered {<voltage>MINMAX}

TRIGgered? {MINMAX}

SOURce is the root keyword of the command, CURRent and VOLTage are second-level keywords, and TRIGgered is third-level keywords. A colon (:) separates a command keyword from a lower-level keyword.

113

4

Image 114

Agilent Technologies E3633A, E3634A manual An Introduction to the Scpi Language, 113

Contents

3DUW1XPEHU $SULO ‹&RS\ULJKW$JLOHQW7HFKQRORJLHV,QF $OO5LJKWV5HVHUYHG Convenient bench-top features Flexible system features Front Panel at a Glance For Agilent E3633A Model **For Agilent E3634A Model Front-Panel Voltage and Current Limit Settings Display Annunciators Rear Panel at a Glance This Book Page Contents Contents Remote Interface Reference Error Messages Application ProgramsTutorial Specifications General Information Safety Considerations Safety and EMC Requirements Options and Accessories AccessoriesOptions Description General Information Description R n i n g General Information Description R n i n g Installation Initial InspectionCooling and Location General Information Installation Rack Mounting Page Power-Line Voltage Selection Input Power RequirementsPower-Line Cord General Information Input Power Requirements General Information Input Power Requirements General Information Input Power Requirements Initial Operation Initial Operation Preliminary Checkout Enable the outputs Power-On CheckoutInitial Operation Power-On Checkout Addr 05 or RS-232 Voltage Output Checkout Turn on the power supplyOutput Checkout Initial Operation Output Checkout Enable the output Adjust the voltage limit value to 1.0 voltCurrent Output Checkout Chapter Initial Operation Output Checkout Front-Panel Operation Front-Panel Operation Front-Panel Operation Overview Front-Panel Operation Front-Panel Operation Overview Constant Voltage Operation Set the display to the limit modeAdjust the knob for the desired current limit Front-Panel Operation Constant Voltage Operation CURRent currentMINMAX Adjust the knob for the desired output voltageReturn to the meter mode VOLTage voltageMINMAX Constant Current Operation Front-Panel Operation Constant Current Operation Adjust the knob for the desired output current Storing and Recalling Operating States Set up the power supply for the desired operating stateTurn on the storage mode Store the operating state in memory location Save the operating state Turn on the recall modeRestore the operating state Recall the stored operating state Programming Overvoltage Protection Setting the OVP Level and Enable the OVP CircuitEnable the OVP circuit Front-Panel Operation Programming Overvoltage Protection Clearing the Overvoltage Condition Move to the clear modeChecking OVP Operation Lower the output voltage level Voltprot voltageMINMAX Move to the OVP Clear modeRaise the OVP trip level Voltprotstat Offon Recommended Protection Circuit for Battery Charging Programming Overcurrent Protection Setting the OCP Level and Enable the OCP CircuitEnable the OCP circuit Front-Panel Operation Programming Overcurrent Protection Checking OCP Operation Clearing the Overcurrent ConditionLower the output current level Currprot currentMINMAX Move to the OCP Clear modeRaise the OCP trip level Currprotstat Offon CV Regulation Output RatingOutput Noise Stability Remote Voltage Sensing Connections Remote Voltage Sensing at the Rear Panel Rear local sensing connections Disabling the Output Front-Panel Operation Disabling the OutputOutp Offon Disabling the Output Using an External Relay Knob Locking Front-Panel Operation System-Related Operations System-Related OperationsSelf-Test TST? Error Conditions 102, ‘‘Syntax error’’ Disptext quoted string Display ControlDisp Offon Disptextcle Firmware Revision Query Scpi Language VersionSYSTVERS? Remote Interface Configuration Front-Panel Operation Remote Interface ConfigurationRemote Interface Selection Gpib Address Baud Rate Selection RS-232Parity Selection RS-232 Save the change and turn off the I/O configuration mode Turn on the remote configuration modeMove to the Gpib address setting mode To Set the Gpib Address Choose the RS-232 interface To Set the Baud Rate and Parity RS-232RS-232 message will be displayed Save the change and choose the parity Change Saved Gpib Interface Configuration T e Front-Panel Operation Gpib Interface Configuration Front-Panel Operation RS-232 Interface Configuration RS-232 Interface ConfigurationRS-232 Configuration Overview Parity and Data Bits None / 8 data bits factory setting Connection to a Computer or Terminal DTR / DSR Handshake Protocol RS-232 Troubleshooting Calibration Overview Calibration SecurityFront-Panel Operation Calibration Overview Secured Unsecured ‘‘CALSECCODE ZZ001443 ’’ Calseccode new code‘‘CALSECSTAT OFF, HP003633* or HP003634** ’’ ‘‘CALSECSTAT ON, ZZ001443 ’’ CALCOUN? Calibration CountCalibration Message Calstr quoted string Remote Interface Reference Scpi Scpi Command Summary Remote Interface Reference Scpi Command SummaryScpi First-time Scpi users, see Numeric value DEFault System-Related Commands Status Reporting Commands IEEE-488.2 Common Commands Simplified Programming Overview Using the APPLy CommandUsing the Low-Level Commands ‘‘VOLT Reading a Query Response Selecting a Trigger Source‘‘TRIGSOUR IMM ’’ Power Supply Programming Ranges Agilent E3633A Programming Ranges APPLy voltage DEF MIN MAX,current DEF MIN MAX Using the APPLy CommandRemote Interface Reference Using the APPLy Command APPLy? Output Setting and Operation Commands ‘‘CURR UP’’‘‘CURR DOWN’’ CURRentTRIGgered current MINimum MAXimum CURRentSTEP numeric valueDEFaultCURRentSTEP? DEFault CURRentTRIGgered? MINimum MAXimum CURRentPROTectionSTATe? CURRentPROTection? MINimumMAXimumCURRentPROTectionSTATe 01OFFON CURRentPROTectionTRIPped? ‘‘VOLTSTEP 0.02 ’’ ‘‘VOLTSTEP 0.01 ’’‘‘VOLT UP ’’ ‘‘VOLT Down ’’ VOLTageTRIGgered? MINimum MAXimum VOLTageSTEP? DEFaultVOLTageTRIGgered voltage MINimum MAXimum VOLTagePROTection voltageMINimumMAXimum VOLTagePROTectionTRIPped? VOLTagePROTectionSTATe 01OFFONVOLTagePROTectionSTATe? VOLTagePROTectionCLEar MEASureCURRent? MEASureVOLTage? Trigger Source Choices Triggering CommandsRemote Interface Reference Triggering Commands Bus Software Triggering Trigsour BUS*TRG*WAI*TRG*WAI Immediate TriggeringTrigsour IMM Triggering Commands TRG System-Related Commands +0, ‘‘No error’’ Outprel command SYSTemBEEPerSYSTemERRor? OUTPutRELay? Curr IDN?RST Currstep DISP, OUTP, OUTPREL, TRIGDEL, TRIGSOUR, Volt SAV 1 2CURR, CURRSTEP, CURRTRIG, CURRPROT, Currprotstat VOLTSTEP, VOLTTRIG, VOLTPROT, VOLTPROTSTAT, Calibration Commands CALibrationSECureSTATe? CALibrationSECureCODE new codeCALibrationSECureSTATe OFF ON,code CALibrationSTRing quoted string CALibrationVOLTagePROTection 100 SYSTemREMote RS-232 Interface CommandsRemote Interface Reference RS-232 Interface Commands Ctrl-C Scpi Status Registers What is an Event Register?What is an Enable Register? Remote Interface Reference Scpi Status Registers Scpi Status System 103 Questionable Status Event register is cleared when Questionable Status Enable register is cleared whenQuestionable Status Register 104 Standard Event Register 105 Standard Event Enable register is cleared when Status Byte Register106 Causing the service request Using Service Request SRQ and Serial PollStatus Byte Enable register Request Service is cleared when U t i o n To Interrupt Your Bus Controller Using SRQ Using *STB? to Read the Status ByteUsing the Message Available Bit MAV Clear To Determine When a Command Sequence is Completed Using *OPC to Signal When Data is in the Output Buffer109 STATusQUEStionableCONDition? Status Reporting CommandsRemote Interface Reference Status Reporting Commands STATusQUEStionable? ESR? CLSESE? OPC STB? PSC?SRE? WAI An Introduction to the Scpi Language 113 Command Format Used in This Manual CURRent currentMINimumMAXimumUPDOWN‘‘SOURceCURRentTRIGgered’’ ‘‘APPLy 3.5,1.5’’ 114 ‘‘SOURVOLT Mincurr MAX’’ Command SeparatorsUsing the MIN and MAX Parameters ‘‘SOURVOLT MIN’’ ‘‘SOURCURR MAX’’ IEEE-488.2 Common Commands Querying Parameter SettingsScpi Command Terminators ‘‘CURR? MAX’’ Trigsour Busimm Scpi Parameter TypesCurr currentMINMAXUPDOWN 117 Ioclear Halting an Output in ProgressClear 118 Remote Interface Reference Scpi Conformance Information Scpi Confirmed CommandsScpi Conformance Information 119 120 SOURce VOLTageLEVelIMMediateAMPLitude voltageMINMAXUPDOWN Non-SCPI Commands 121 IEEE-488 Conformance Information Error Messages *RST reset command command does not clear the error queue 102, ‘‘Syntax error’’ 124 Execution Errors 121 Invalid character in number 113 Undefined headerExample Triggdel Example *ESE #B01010102 170 to Expression errors Error Messages Execution Errors 141 Invalid character data160 to Block data errors 144 Character data too long Reported. See also ‘‘Self-Test Errors’’, starting on Error Messages Execution Errors 221 Settings conflictCALibrationSTRing command 350 Too many errors Example *IDN?SYSTVERS? Error Messages Execution Errors 430 Query Deadlocked440 Query Unterminated after indefinite response SYSTemLOCal , SYSTem REMote , and SYSTemRWLock Self-Test Errors Error Messages Self-Test Errors Calibration Errors 717 Cal OVP or OCP status enabled Error Messages Calibration Errors 714 Bad OVP cal data716 Bad DAC DNL error correction data 718 Gain out of range for Gain Error Correction Application Programs 134 Diode.c Example Program for C and C++Application Programs Example Program for C and C++ On next 135 On next 136 On next 137 End of Program 138 Example Example Program for ExcelApplication Programs Example Program for Excel Program result 140 Application Programs Example Program for Excel Diode Macro On next 141 End of Program 142 Declaration for Windows 95/NT 143 Application Programs Example Program for Excel 144 Tutorial 146 Overview of Agilent E3633A and Agilent E3634A Operation 147 Gpib RS-232148 Output Characteristics Tutorial Output Characteristics149 Output Characteristics 150 Unwanted Signals Unregulated State151 152 Output Isolation Connecting the LoadR n i n g Tutorial Connecting the Load Multiple Loads Tutorial Connecting the Load Remote Voltage Sensing154 Inductive loading Load ConsiderationCapacitive Loading Pulse Loading Tutorial Connecting the Load Reverse Current Loading 156 Parallel Connections Extending the Voltage and Current RangeSeries Connections Tutorial Extending the Voltage and Current Range Remote Programming Tutorial Remote Programming158 159 Speed of Response Programming Down Reliability Tutorial Reliability160 Specifications 162 Performance Specifications Specifications Performance Specifications163 OCP 164 Supplemental Characteristics Programming Language Maximum Input PowerOperating Temperature State Storage Memory Environmental Conditions DimensionsWeight 167 Specifications Supplemental Characteristics 168 Index 169 170 Gpib 171 Scpi 172 Warranty Declaration of Conformity According to ISO/IEC Guide 22 and EN