An Introduction to the Scpi Language | Agilent Technologies E3632A

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 78 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.

111

4

Image 112

Agilent Technologies E3632A manual An Introduction to the Scpi Language, 111

Contents

3DUW1XPEHU $SULO ‹&RS\ULJKW$JLOHQW7HFKQRORJLHV,QF $OO5LJKWV5HVHUYHG Convenient bench-top features Flexible system features Front Panel at a Glance Page Front-Panel Voltage and Current Limit Settings T e Display Annunciators OVP Rear Panel at a Glance Key to This Book Page Contents Contents Remote Interface Reference Error Messages General Information Safety Considerations Safety and EMC Requirements Options and Accessories AccessoriesGeneral Information Options and Accessories Options Description General Information Description R n i n g General Information Description R n i n g Initial Inspection InstallationCooling and Location General Information Installation Rack Mounting Page Input Power Requirements Power-Line CordPower-Line Voltage Selection General Information Input Power Requirements Power-line module Panel General Information Input Power Requirements Initial Operation Initial Operation Verify the power-line voltage setting on the rear panel Verify that the correct power-line fuse is installedConnect the power-line cord and turn on your power supply Preliminary Checkout Enable the outputs Initial Operation Power-On CheckoutAddr 05 or RS-232 Voltage Output Checkout Output CheckoutInitial Operation Output Checkout Adjust the voltage limit value to 1.0 volt Turn on the power supplyCurrent Output Checkout T e Initial Operation Output Checkout Front-Panel Operation Front-Panel Operation Front-Panel Operation Overview Front-Panel Operation Front-Panel Operation Overview Set the display to the limit mode Adjust the knob for the desired current limitConstant Voltage Operation Front-Panel Operation Constant Voltage Operation Return to the meter mode CURRent currentMINMAXVOLTage voltageMINMAX OUTPut on Constant Current Operation Adjust the knob for the desired voltage limitFront-Panel Operation Constant Current Operation Verify that the power supply is in the constant current mode Set up the power supply for the desired operating state Turn on the storage modeStoring and Recalling Operating States Store the operating state in memory location SAV RCL Programming Overvoltage Protection Setting the OVP Level and Enable the OVP CircuitLevel 32.0 Readjust the OVP trip level or the output voltage level Move to the clear mode Ovp onChecking OVP Operation Clearing the Overvoltage Condition Clear the overvoltage condition and exit this menu Voltprot voltageMINMAXVoltprotstat Offon Voltprotcle Setting the OCP Level and Enable the OCP Circuit Enable the OCP circuitProgramming Overcurrent Protection Front-Panel Operation Programming Overcurrent Protection Readjust the OCP trip level or the output current level Move to the clear mode Ocp onChecking OCP Operation Clearing the Overcurrent Condition Clear the overcurrent condition and exit this menu Currprot currentMINMAXCurrprotstat Offon Currprotcle Remote Voltage Sensing CV RegulationOutput Rating Output Noise Stability Remote Voltage Sensing Connections Front-Panel Operation Disabling the Output Disabling the OutputOutp Offon Disabling the Output Using an External Relay Knob Locking System-Related Operations Self-TestFront-Panel Operation System-Related Operations TST? Error Conditions ERRSYSTERR? 113, Undefined header Display Control Disp OffonDisptextcle Disptext ‘HELLO’ Firmware Revision Query Scpi Language VersionIDN? Returns HEWLETT-PACKARD,E3632A,0,X.X-X.X-X.X SYSTVERS? Front-Panel Operation Remote Interface Configuration Remote Interface ConfigurationRemote Interface Selection Baud Rate Selection RS-232 Gpib AddressParity Selection RS-232 To Set the Gpib Address Gpib To Set the Baud Rate and Parity RS-232 RS-232Baud Choose the RS-232 interface For one second Gpib Interface Configuration T e Front-Panel Operation Gpib Interface Configuration RS-232 Interface Configuration RS-232 Configuration OverviewFront-Panel Operation RS-232 Interface Configuration RS-232 Data Frame Format Connection to a Computer or Terminal DTR / DSR Handshake Protocol RS-232 Troubleshooting Calibration Security Calibration OverviewFront-Panel Operation Calibration Overview Code Calsecstat OFF, HP003632 Calsecstat ON, HP003632 Calseccode ZZ001443Calsecstat ON, ZZ00143 Calibration Message Calibration CountCalstr ‘CAL 05-1-97’ Remote Interface Reference Scpi Scpi Command Summary Remote Interface Reference Scpi Command Summary VOLTageDC? System-Related Commands Status Reporting Commands IEEE-488.2 Common Commands Using the APPLy Command Using the Low-Level CommandsSimplified Programming Overview ‘‘VOLT Reading a Query Response Selecting a Trigger Source‘‘SYSTERR?’’ ‘‘TRIGSOUR IMM’’ 3RZHU6XSSO\3URJUDPPLQJ5DQJHV Using the APPLy Command Remote Interface Reference Using the APPLy CommandAPPLy voltage DEF MIN MAX,current DEF MIN MAX APPLy? Curr UP Output Setting and Operation CommandsCurr Down CURRentSTEP numeric valueDEFault CURRentSTEP? DEFaultCURRentTRIGgered current MINimum MAXimum CURRentTRIGgered? MINimum MAXimum CURRentPROTection? MINimumMAXimum CURRentPROTectionSTATe 01OFFONCURRentPROTectionSTATe? CURRentPROTectionTRIPped? Volt UP Volt Down VOLTageSTEP? DEFault VOLTageTRIGgered voltage MINimum MAXimumVOLTageTRIGgered? MINimum MAXimum VOLTagePROTection voltageMINimumMAXimum VOLTagePROTectionSTATe 01OFFON VOLTagePROTectionSTATe?VOLTagePROTectionTRIPped? VOLTagePROTectionCLEar MEASureVOLTage? Triggering Commands Remote Interface Reference Triggering CommandsTrigger Source Choices Bus Software Triggering Trigger 705 group execute trigger Trigsour BUS*TRG*WAI*TRG*WAIImmediate Triggering Trigsour IMM Triggering Commands TRG System-Related Commands OUTPutRELay? SYSTemERRor?SYSTemBEEPer IDN? HEWLETT-PACKARD,E3632A,0,X.X-X.X-X.X RSTCurr Currstep Currtrig Currprot Currprotstat Disp Outp SAV 1 2 RCL 1 2 Calibration Commands CALibrationSECureCODE new code CALibrationSECureSTATe OFF ON,codeCALibrationSECureSTATe? CALibrationSTRing quoted string CALibrationVOLTagePROTection RS-232 Interface Commands What is an Event Register? What is an Enable Register?Scpi Status Registers Remote Interface Reference Scpi Status Registers Scpi Status System 101 Questionable Status Enable register is cleared when Questionable Status RegisterQuestionable Status Event register is cleared when 102 Standard Event Register 103 Status Byte Register Standard Event Enable register is cleared when104 ‡ RXHHFXWHWKH*SRE 0FRPPDQG ‡ RXHHFXWHWKH*CLSFOHDUVWDWXVFRPPDQGDiihfwlqvwuxphqwwkurxjksxw Using the Message Available Bit MAV Using *STB? to Read the Status ByteTo Interrupt Your Bus Controller Using SRQ Using *OPC to Signal When Data is in the Output Buffer To Determine When a Command Sequence is Completed107 Status Reporting Commands Remote Interface Reference Status Reporting CommandsSTATusQUEStionableCONDition? STATusQUEStionable? CLS ESE?ESR? OPC PSC? SRE?STB? WAI An Introduction to the Scpi Language 111 CURRent currentMINimumMAXimumUPDOWN Command Format Used in This Manual‘‘SOURceCURRentTRIGgered’’ ‘‘APPLy 3.5,1.5’’ 112 Command Separators Using the MIN and MAX ParametersSourvolt Mincurr MAX Sourvolt MIN Sourcurr MAX Querying Parameter Settings Scpi Command TerminatorsIEEE-488.2 Common Commands ‘‘CURR? MAX’’ Scpi Parameter Types Curr currentMINMAXUPDOWNTrigsour Busimm 115 Halting an Output in Progress ‡ 7KHSRZHUVXSSO\ªVLQSXWDQGRXWSXWEXIIHUVDUHFOHDUHG Scpi Conformance Information RQILUPHG&RPPDQGV 118 SOURce VOLTageLEVelIMMediateAMPLitude voltageMINMAXUPDOWN HYLFH6SHFLILF&RPPDQGV IEEE-488 Conformance Information Error Messages Error 113, Undefined header 122 Execution Errors Appl Program mnemonic too long Undefined headerExample Triggdel Invalid character in number Block data errors Expression errorsInvalid character data Character data too long Settings conflict CALibrationSTRing commandToo many errors Data out of range Isolator Uart framing error Isolator Uart overrun errorRS-232 framing error RS-232 overrun error Self-Test Errors Calibration Errors Bad DAC DNL error correction data Cal OVP or OCP status enabledCal checksum failed, DAC DNL error correction data Bad OVP cal data Application Programs 132 ++ Example for Gpibieee Application Programs C++ Example for GpibieeeDiode.c 133 Application Programs ++ Example for Gpibieee End of Program 134 Excel 5.0 Example for Windows 3.1 and Gpib 135 136 137 Visuccess End of Program 138 Tutorial 140 Tutorial Overview of Agilent E3632A Operation Overview of Agilent E3632A Operation141 142 Tutorial Output Characteristics Output Characteristics143 Output Characteristics 144 Unregulated State Unwanted Signals145 146 Connecting the Load Tutorial Connecting the LoadOutput Isolation Multiple Loads Remote Voltage Sensing Tutorial Connecting the Load R n i n g148 Load Consideration Capacitive LoadingInductive loading Pulse Loading Tutorial Connecting the Load Reverse Current Loading 150 Extending the Voltage and Current Range Series ConnectionsParallel Connections Tutorial Extending the Voltage and Current Range Tutorial Remote Programming Remote Programming152 153 Speed of Response Programming Down Tutorial Reliability Reliability154 Specifications 156 Specifications Performance Specifications Performance Specifications157 158 OCP Specifications Supplemental Characteristics Supplemental Characteristics159 160 Dimensions of Agilent E3632A Power Supply 161 Specifications Supplemental Characteristics 162 Index 163 164 165 166 Warranty Declaration of Conformity According to ISO/IEC Guide 22 and EN