Scpi Command Reference, Linking Multiple Scpi Commands | HP E1429A

Linking Commands Linking commands means sending multiple commands in the same output string. This is done to avoid "settings conflict" errors since (command) coupling interactions are not resolved until the carriage return (CR) is received.

Linking IEEE 488.2 Common Commands

Use a semicolon between the commands. For example:

*RST;*CLS;*OPC?

Linking Multiple SCPI Commands

A semicolon (;) is used to separate commands within the same subsystem and saves typing. For example, sending this command message:

TRIG:SOUR TIM;TIM1 100E-9;COUN 100

Is the same as sending these three commands:

TRIG:SOUR TIM

TRIG:TIM1 100E-9

TRIG:COUN 100

When linking commands in different subsystems, a semicolon (;) and a colon (:) are used. For example:

ARM:SOUR IMM;COUN10;:TRIG:SOUR TIM;TIM1 100E-9;COUN 30000

Command Choices Some commands are listed as two commands separated with a vertical bar (“ ” ). This means that either command name can be used. For example, you could use either “ :STAR” or “:SEQ1” when

“ [:STARt SEQuence1]” is shown.

SCPI Command Reference

This section describes the SCPI commands for the HP E1429 Digitizer. Commands are listed alphabetically by subsystem, and alphabetically within each subsystem. A command guide is printed in the top margin of each page. The guide indicates the first command listed on that page.

184 Command Reference

Chapter 4

Image 184

HP E1429A manual Scpi Command Reference, Linking Ieee 488.2 Common Commands, Linking Multiple Scpi Commands

Contents

Contents HP E1429A/B Digitizer User’s Manual Contents ARM Data Period Value Table ESR? Contents HP E1429A/B Digitizer User’s Manual HP E1429A/B Digitizer User’s Manual Contents HP E1429A/B 20 MSa/s 2-Channel Digitizer User’s Manual Documentation History March 1 According to ISO/IEC Guide 22 and EN HP E1429A/B 20 MSa/s 2-Channel Digitizer User’s Manual Chapter Contents HP E1429A/B Features and VXIbus Configuration Getting Started Chapter HP E1429A/B VXIbus Configuration HP E1429A/B VXIbus Configuration Preparation for Use Assigning the Digitizer to a CommanderDigitizer Logical Address HP E1429A/B Logical Address Switch Location Digitizer Bus Request Level Installing the DigitizerBus Request Level Guidelines Addressing the Digitizer using an Embedded Controller Addressing the Digitizer over HP-IB Introductory Programs Sending the *IDN? CommandHEWLETT-PACKARD,E1429A,0,A.02.00 IOOUTPUTSADDR, *IDN? TST? SLFTST.C Repeat Output 70905SYSTERR? Resetting Clearing Digitizer IOOUTPUTSADDR, *TST?IOOUTPUTSADDR, SYSTERR? IOOUTPUTSADDR, DIAGTEST? Subend IOOUTPUTSADDR, *RST*CLS Querying Digitizer Configuration LRN?Integer Repeat LRN.C Chapter Getting Started Instrument and Programming Languages TRIGSTARTIM1 10E-6 OUTPEXT1STAT Ontrigsour EXT1OUTPEXT1STAT OFF Language Programs Command Line Compiling Microsoft QuickC clhpib.lib∙ Microsoft QuickC ∙ Turbo C++ Compiling in the Integrated Environment CLHPIB.LIB Introduction to Programming Other subsystems Using the MEASure CONFigure Commands Port Programming Sequence HP E1429A Programming Sequence Configuring the Channels Using MEASureHow to Make Measurements MEAS.C Can be used to set the desired number of pre-arm readings Taking Readings After Using CONFigure SENS1SWEOFFSPOIN CONF.C IOOUTPUTSADDR, FETC1? Querying Command Settings QUERY.C Enable Intr ERRORCHK.C Digitizer Command Module Deadlock Abort Where to go Next Using the Digitizer Programming Language Configuring the Digitizer Input INPUT.C Taking a Burst of Readings ARMCNT.C Level Arming ARMLEVEL.C PREPOST.C Pre- and Post-Arm ReadingsARMSOUR1 EXT Specifying a Sample Rate SAMPLE.CARMSOUR1 IMM Trigsour TIM Dual Rate Sampling DUALSAMP.CARMSLOP1 POS Senssweoffspoin Using Multiple Digitizers MULTAD.C OUTPTTLT0IMM OUTPTTLT0STAT onFETC2? Using the Packed Data Format PACKED.C Form Pack Diagchanlab For i = 0 i 20 i++ IOOUTPUTSADDR, SYSTERR? VME Bus Data Transfers VMEREAL.C Vinsconfvmemode GEN Trigstarsour VMEVinsconfvmefeed ’CONVCHAN1’ On Next Using the Digitizer Chapter VMESEG1.C Armstarsour IMM Armstarcoun On Next IOOUTPUTSADDR, *RST*CLS IOOUTPUTSADDR, SYSTERR? VME Bus Data Transfers Using an Embedded Controller DOS On Next Using the Digitizer Chapter On Next On Next #include Files INST.H Inst INST.CPP On Next Chapter Using the Digitizer E1429.H E1429.CPP Local Bus Data Transfers Vinslbusres Vinslbusmode GENVinslbusfeed ’CONVBOTH’ Formdata Pack IOOUTPUTSADDRMEM, Init IOOUTPUTSADDR, Init Using the Digitizer Chapter Chapter Using the Digitizer On Next Vinslbusfeed ’MEMCHAN1’ Vinslbusmode APP IOOUTPUTSADDRG, Init IOOUTPUTSADDRA, InitIOOUTPUTSADDRG, *OPC? On Next Using the Digitizer Chapter On Next Armstarsour TTLT0 Vinslbusfeed ’CONVCHAN1’ OUTPTTLT0FEED ’READY’ Vinslbusmode INS IOOUTPUTSADDRG, Init IOOUTPUTSADDRI, Init IOOUTPUTSADDRG, *OPC?,5 Using the Digitizer Chapter Chapter Using the Digitizer Using the Digitizer Chapter Using the Digitizer Status Registers STATUS.C Using the Digitizer Chapter HP E1429 Digitizer Block Diagram Understanding the Digitizer Understanding the HP E1429 Digitizer Chapter Digitizer Command Paths Message and Register Interfaces Scpi Command Control Digitizer Input Section SENSechan VOLTage Range range Enabling the 10 MHz Input Filter Setting the Input ImpedanceInverting and Non-inverting Differential Input Ports Setting the Signal Range Digitizer Attenuators Using the Single-Ended Input 1V Range Sensvoltrang HP E1429 Digitizer State Diagram Arming and Triggering ARM-TRIG State Diagram HP E1429 Digitizer Arming and Triggering ARM STARtSEQuence1 Set positive or negative transition Arm Window Boundaries Arm Level Range ARM Synchronization Signals OUTPutEXTernal1FEED source Routing the Signal to a Source Enabling the Synchronization Signal Triggering Digitizer Offset TRIGgerSTARtTIMer1 period Chapter Understanding the HP E1429 Digitizer Source Digitizer Reference ClockSpecifying the External Reference Frequency TRIGgerSTARtCOUNt count SENSechan SWEepPOINts count Trigger Synchronization Signals OUTPutEXTernal1FEED source Routing the Signal to a Source Analog-to-Digital Converter Data Flow, Storage, and Conversions HP E1429 Digitizer Data Flow HP E1429 Digitizer Reading Storage MEMory Subsystem 10. Memory Segments with Pre and Post-arm Readings Determining the Battery Charge Digitizer Data Formats Packed Reading Conversions Definite Length Arbitrary Block Header Removing the Arbitrary Block Header HP Basic Example Readings Language Example 16-bit readings READ? 11. Retrieving Readings from Digitizer Memory Retrieving Readings Using Retrieving Readings Using FETCh?READ? FETChing Readings from Memory Determining Number of Readings FETChed Separating Pre- and Post-Arm Readings Using DIAGnosticUPLoad SADDress? Memory Management DIAGnostic SubsystemLocating Unsegmented Readings ARMSTARtCOUNt Locating Segmented ReadingsMaximum Readings Ending segment address = segmentnumber * 65536 Therefore, the DIAGnosticFETCh? command would be executed as Locating the Data Register Base Address 12. Digitizer Registers in A16 and A24 Address Space Execute the following HP E1406 Command Module command On Next Data Register Offset VME VINStrument SubsystemDATA? Setting the VME bus Data Source Segmented Reading Transfers Understanding the HP E1429 Digitizer Chapter Multiple VME Bus Data Transfers 14. Local Bus Signal Line Definitions Local Bus Description How Data is Transferred 15. HP E1429B Local Bus Data Transfer Protocol Understanding the HP E1429 Digitizer Chapter Digitizer Local Bus Commands Local Bus Transfer ConfigurationsLbus Send EOF EOB D3 D3 D3 Multiple Digitizers and Serial TransfersEOF EOB D1 D1 D1 Digitizer Configuration Restrictions Setting the Local Bus Transfer Mode Setting the Local Bus Data Source Multiple Local Bus Data Transfers Digitizer Status Registers Status Subsystem CommandsStatus System Registers 16. HP E1429 Status Groups and Associated Registers Condition Register Questionable Signal Status GroupReading the Condition Register Enable Register Operation Status Group STATusOPERationCONDition? Standard Event Status Group Standard Event Status RegisterPON CME EXE DDE QYE Standard Event Status Enable Register Reading the Standard Event Status RegisterESR? ESE? Status Byte Register Status Byte Status GroupOper RQS ESB MAV Ques Presetting the Enable Register and Transition Filter Service Request Enable RegisterReading the Status Byte Register STB? Spoll Synchronizing the Digitizer Saving Digitizer ConfigurationsOPC OPC? WAI How to Save and Recall a Configuration RST Understanding the HP E1429 Digitizer Chapter Command Reference Command Types Common Command Format Scpi Command Format Abbreviated CommandsARM Armlevneg Implied Optional Keywords Variable Command Syntax Scpi Command ParametersParameter Types Explanations, Examples OUTPECLT0FEED ’EXT’ OUTPECLT0FEED \EXT\ Scpi Command Execution Querying Parameter SettingsOptional Parameters Definite length block MIN and MAX Parameters in Coupled Commands Executable When Initiated CommandsArmcoun Trigcoun MAX Linking Ieee 488.2 Common Commands Scpi Command ReferenceLinking Multiple Scpi Commands ∙ Executable when initiated Yes ∙ Coupled Command No ABORtABORt Example Aborting a measurement ARM ARMSTARtCOUNt STARtCOUNtSyntax Subsystem Parameter Range Default Name Type Values Parameters ARMSTARtCOUNt ARMSTARtDELay STARtDELayParameter Range Default Name Type Values MINimumMAXimum Example Setting the arming delay ARMSTARtIMMediateSTARtIMMediate ∙ *RST Condition none ARMSTARtLEVelchanNEGative voltage STARtLEVelchanNEGative voltageExample Arming for measurement Comments ∙ Executable while initiated No ARMSTARtLEVelchanPOSitive voltage STARtLEVelchanPOSitive voltage ARMSTARtSLOPen STARtSLOPen Example Setting the arm slope ARMSTARtSOURcen ∙ Related Commands ARMSTARtSLOPen , ARMSTARtLEVelchan Example Setting two arm start sources CALibrationchan COUNt?Subsystem Syntax Numeric None CALibrationchanDATA Data Comments ∙ Executable when initiated No ∙ Coupled Command No Assign @X to 70905FORMAT OFF CALibrationchanDELay DELay CALibrationchanGAIN Gain Seconds ∙ *RST Condition none Example Performing a gain calibration Confarrvolt 100,4.8,DEF,@1 CALibrationchanSECureCODE CALibrationchan SECureSTATe mode ,code enables or disables CALibrationchanSECureSTATe CALibrationchanSTORe CALibrationchan STOReAUTO mode selects whether or not CALibrationchanSTOReAUTOVALue Example Turn automatic storage of calibration values off CALibrationchanVALue ∙ Related commands CALibrationGAINNumeric 101.80 to Volts CALibrationchanZERO Example Setting the calibration valueZero CAL1ZERO DEF,DEF,ALL CONFigurechanARRayVOLTageDC size,expected CONFigurechanARRayVOLTageDC CONFigurechanARRayVOLTageDC Maximum Voltage Resolution Range Volts Value CONFARRayVOLT 20,1.5,@3 DIAGnostic CALibrationchan CONVerge? CALibrationchan ZEROSENSitivity? DIAGnosticCALibrationchan GAINSENSitivity?CHANnelchan LABel ∙ Coupled Command No ∙ Related Commands ABORt, FETCh? DIAGnosticFETCh?Example 1 Tagging the data with channel number Example 2 Reading back PACKed data HP Basic program DIAGnosticMEMorychan Fill numsegments, count sets up DIAGnosticMEMorychanFILLMEMorychanADDResses? PEEK? DIAGnosticPEEK?Thru Ffffff None DIAGnosticPOKE Example Examining the setting of the traffic registerExample Changing the contents of the traffic register Poke DIAGnosticSGET? SGET?Sput TEST? Command Reference FETChchan Subsystem FETChchan FETChchan Subsystem Command Reference FETChchanCOUNt? FETC1COUN? FETChchanRECover? ∙ *RST Condition none Example Recovering readings in memory FORMat Subsystem FORMat Example 1 Setting the data format to 64 bit reals ∙ Related Commands READ?, FETCh?FORMatDATA INITiate IMMediate INITiateIMMediate Example Placing the HP E1429A in the wait-for-arm state INPutport Subsystem INPutport INPutportFILTerLPASsSTATe mode enables or disables INPutportFILTerLPASsSTATeIMPedance Example Enabling the 10 MHz low-pass filter INPutportSTATe Example Setting 75 Ω input impedanceSTATe Example Disabling input port ARRayVOLTageDC? MEASurechanMEASurechanARRayVOLTageDC size,expected MEASurechanARRayVOLTageDC? Maximum Voltage Resolution MEAS1ARRayVOLT? 20,1.5,@3 BATTerySTATe Example Enable memory to be non-volatileMEMory ∙ *RST Condition not affected MEMoryBATTeryCHARge? ∙ *RST Condition none Example Check the battery charge OUTPut ECLTrgnFEED Example Setting the ECLTrg0 sync pulse source OUTPutECLTrgnSTATeECLTrgnSTATe ∙ *RST Condition Parameter Range Default Name Type Values Units OUTPutEXTernal1FEEDEXTernal1FEED Boolean ARMSTARtSEQuence1 None RFTRigger SENSe12ROSCillator TRIGgerSTARtSEQuence1 Example Setting the sync pulse source OUTPutEXTernal1STATeEXTernal1STATe TTLTrgnFEED OUTPutTTLTrgnFEED Numeric Through NoneARMSTARtSEQuence1 None Example Enabling sync pulse for READy on TTLTrg5 OUTPutTTLTrgnSTATe Example Enabling sync pulse output to TTLTRG0* and TTLTRG5 READchan Subsystem Command Reference READchan Command Reference READchan Subsystem SENSe SENSechanFUNCtion SENSechanFUNCtion SENSechanFUNCtion SENSechanFUNCtion Example Selecting the single ended input on channel SENSechanROSCillator EXTernalFREQuency SENSechanROSCillatorSOURce SOURce Example Setting the Reference Oscillator Source SENSechan SWEep OFFSetPOINts count SENSechan SWEepOFFSetPOINts countNumber Maximum Number Memory Segments Example Setting 50 pre-arm readings on channel 1, input port SENSechan SWEepPOINts count MINimum selects 1 reading Example Setting 500 readings RANGe SENSechanVOLTageDCSENSechan VOLTageDCRANGe range selects the range for Comments ∙ Executable when initiated Yes Range Measurement Resolution Allowable Setting Volts PortsSENSechanVOLTageDC RANGe RESolution? SENSechanVOLTageDC RESolution?Example Selecting the 102.35 Volt range on channel STATus Operation Status Register STATusOPCINITiate Subsystem Syntax Questionable Signal Status RegisterOPCINITiate STATusOPERationQUEStionableCONDition? OPERationQUEStionableENABleOPERationQUEStionableCONDition? Example Setting the Operation register enable mask STATusOPERationQUEStionableEVENt?OPERationQUEStionableEVENt? Through +32767 None Non-decimal Numeric STATusOPERationQUEStionableNTRansition OPERationQUEStionablePTRansition STATusPRESet PRESet ERRor? Example Reading the error queueSYSTem VERSion? Command Reference TRIGger Subsystem TRIGger TRIGger Subsystem Command Reference TRIGgerSTARtCOUNt Example Taking 20 readings 8 pre-arm and 12 post-arm TRIGgerSTARtIMMediate STARtSOURce TRIGgerSTARtSOURce Bushold TRIGgerSTARtTIMer1 STARtTIMer1Example Setting the start trigger source Reference period to TRIGgerSTARtTIMer1 STARtTIMer2 Period Value Table∙ *RST Condition 5.0E-8 seconds Multiple Period TRIGgerSTARtTIMer2 ∙ *RST Condition 1.0E-7 seconds VINStrument Local Bus transfers VME VXI data transfer Bus transfers Data voltagelist VINStrument CONFigureLBUSFEED VINStrumentCONFigureLBUSMEMoryINITiate CONFigureLBUSMEMoryINITiate VINStrumentCONFigureLBUSMODE CONFigureLBUSMODE VINStrumentCONFigureLBUSRESet CONFigureLBUSRESetExample Setting the Local Bus operation mode APPendGENerate None INSertOFF PIPeline VINStrumentCONFigureLBUSSENDPOINts CONFigureLBUSSENDPOINts CONFigureLBUSSENDPOINtsAUTO VINStrumentCONFigureLBUSSENDPOINtsAUTOBoolean On OFF None CONFigureTESTDATA VINStrumentCONFigureTESTDATAVINStrumentCONFigureTESTDATA voltagelist configures ∙ *RST Condition none Example Testing Local Bus operation VINStrumentCONFigureVMEFEED VINStrumentCONFigureVMEMEMoryINITiate CONFigureVMEMEMoryINITiate VINStrumentCONFigureVMEMODE CONFigureVMEMODE VINStrumentCONFigureVMESENDADDRessDATA? CONFigureVMESENDADDRessDATA?Example Setting the VXIbus data transfer bus operation mode GENerateOFF None VINStrumentIDENtity? HEWLETT-PACKARD Virtual INSTRUMENT,ANY ATOD,0,A.01.00 IEEE-488.2 Common Commands Category Command Title CLS ∙ Executable when initiated YesDMC ESE and *ESE? EMC and *EMC?Example Define macro to start measurement Example Enable all error events ESR?GMC? String IDN? LMC?Example Query macro definition HEWLETT-PACKARD,E1429,0,A.01.00 LRN? OPC PMC OPC?PUD and *PUD? RCL Block Through 63 characters None Data String RMC RST SAV SRE and *SRE? STB? TRG TST? WAI Command Quick Reference Chapter Chapter Command Quick Reference Unmask VINStrument Scpi Confirmed Commands Scpi Conformance Information Chapter Scpi Conformance Information Scpi Conformance Information Chapter Specifications Appendix Contents Read-Out To VME BusTo Local Bus E1429B only Number of Partitions Amplitude Characteristics Signal Conditioning Total Readings per Partition Signal-to-Noise Ratio Output FormatsGain and Offset 4.3.1, note Filtering Converter Supplemental Characteristics Single-ended inputs Connector BNCWord Error Rate 4.15 qualified error level word error rate Integral Nonlinearity 4.4.3, Note Single-ended inputs, supplemental characteristics Analog Bandwidth 4.6.1 filter offEffective bits on different ranges Crosstalk between channels Appendix a Specifications Differential Inputs, supplemental characteristics Effective bits, relative to 1V single-ended range Trigger Sample Clock Subsystem Frequency Sample Rate Characteristics Internal TimerCrosstalk Timebase and Trigger additional supplemental characteristics Bus Access and Connectors General Characteristics EMC Specifications Appendix a Useful Tables ERRORCHK.C IDN.C HP BASIC, CSLFTST.C RSTCLS.C LOCALAD.C LBUS2PST.CLBUSAUTO.C STATUS.C Mode OFF EMCCalstorauto CAL1VAL DEL SourSLOP1 POS Table B-3. HP E1429A/B Error Messages Code Description Appendix B Useful Tables Useful Tables Appendix B Appendix B Useful Tables Local bus test data size not System Configuration Register Programming Reading and Writing to the Registers Register reads and writes are 8-bits Addressing the Registers Figure C-1. HP E1429A/B A24 Address Space Determining the A24 Base Address Appendix C Register Programming A24READ.C Register Descriptions A24 Register Table See Base + Input Configuration Registers A/D Status RegisterA/D Serial Register Base +0316 A/D Shift Register A/D Parallel Strobe RegisterBase +0B16 Bit Name Function Arm and Trigger Configuration Registers Abort and Arm Immediate RegisterArm Status Register Base + Timebase Initiation Registerbase + Arm Internal Bus Registerbase + Arm Source Register Power-on/Reset SettingsArm Source Register Arm Control Register Arm Control Register Power-on/Reset SettingsBase + 4B16 Trigger Source Register Trigger Source Register Power-on/Reset SettingsBase + 4D16 Register Programming Appendix C Reference Oscillator Register Reference Oscillator Register Power-on/Reset SettingsBase + 4F16 Arm Count Register Base + 5516 and base + Arm delay Register Base + 5116 and base +5316Arm Count Latch Register Trigger Immediate Registerbase + 5D16 Decade Division RegisterBinary Division Register Base +6116 Pre-Arm Reading Count Register power-On/Reset Settings Post-Arm Reading Count Register power-On/Reset SettingsPre-Arm Reading Count Registers Base + 7316 and base + Traffic Register Power-on/Reset Settings Memory Control RegistersTraffic Register Base +0216 Channel ID Register Pulse RegisterData Register Memory Control Register Memory Control Register Power-on/Reset SettingsBase +2116 Memory Address Registers Base +2316 to base +2716 Terminal Address Register Base Address RegistersBase +2B16 Base +2D16 and base +2F16 Using the A/D Shift Register Figure C-2. Accessing the A/D Shift Register Bit Name Setting Setting Measurement Range Setting the Input ImpedanceProcedure Enabling the 10 MHz Filter Input Post 14 dB Attenuator Bits Bits 34 Bits 35 37,45 38,46 Checking the Idle State Setting the Digitizer Configuration Setting the Arm Sources Setting the Arm Count Setting the Arm Delay Setting the Reference Source Setting the Trigger Source Sending an Arm Immediate Signal Sending a Trigger Immediate Signal Aborting Measurements Re-initiating the Digitizer Initializing Digitizer Memory Appendix C Register Programming Initializing Initiating Timebase Processor MSB LSB Timebase reset Trigger countSample rate Data source Count is 1 and the post-arm count is y-3 Midsb LSB Register Programming Appendix C Retrieving Data from Memory Initializing Digitizer Memory to Retrieve Data Register Programming Appendix C MSB LSB Example Program Appendix C Register Programming REGPROG.C IOOUTPUTSADDR, READ? On Next On Next On Next On Next On Next On Next On Next On Next On Next On Next On Next Void checkerrorchar *function Char Into161 Length = Register Programming Appendix C Local Bus Interleaved Transfers Interleaved Transfers Setting Interleaved Transfer Mode Local Bus Interleaved Transfers Appendix D Procedure LBUSINTR.C Trigstarsour ECLT0 Trigstarsour TIMTrigstartim 1E-6 OUTPECLT0FEED ’TRIG’ Tracdef SET1 Store readings 80 bytes in SET1 IOOUTPUTSADDRG, Abor IOOUTPUTSADDRMEM, *OPC?IOOUTPUTSADDRI, Abor Local Bus Interleaved Transfers Appendix D Appendix D Local Bus Interleaved Transfers Local Bus Interleaved Transfers Appendix D Index HP E1429A/B User’s Manual Index Index HP E1429A/B User’s Manual HP E1429A/B User’s Manual Index Index HP E1429A/B User’s Manual Scpi Index HP E1429A/B User’s Manual