IEEE-488.2 Common Commands, Category Command Title | HP E1429A

IEEE-488.2 Common Commands

This section describes the IEEE-488.2 Common Commands implemented in the HP E1429. The table below shows the commands listed by functional group; however, commands are listed alphabetically in the reference. Examples are shown in the reference when the command has parameters or returns a non-trivial response; otherwise, the command string is as shown in the table. For additional information, refer to IEEE Standard 488.2-1987.

Category	Command	Title

System Data	*IDN?	Identification Query
	*PUD <data>	Protected User Data Command
	*PUD?	Protected User Data Query

Internal Operations	*LRN?	Learn Device Setup Query
	*RST	Reset Command
	*TST?	Self Test Query

Synchronization	*OPC	Operation Complete Command
	*OPC?	Operation Complete Command
	*WAI	Wait-to-Continue Command

Macro	*DMC <name>,<data>	Define Macro Command
	*EMC <enable>	Enable Macro Command
	*EMC?	Enable Macro Query
	*GMC? <name>	Get Macro Contents Query
	*LMC?	Learn Macro Query
	*PMC	Purge Macros Command
	*RMC <name>	Remove Individual Macro Command

Status & Event	*CLS	Clear Status Command
	*ESE <mask>	Standard Event Status Enable Command
	*ESE?	Standard Event Status Enable Query
	*ESR?	Standard Event Status Register Query
	*SRE	Service Request Enable Command
	*SRE?	Service Request Enable Query
	*STB?	Read Status Byte Query

Trigger	*TRG	Trigger Command

Stored Settings	*RCL	Recall Command
	*SAV	Save Command

Chapter 4

Command Reference 298

Image 298

HP E1429A manual IEEE-488.2 Common Commands, Category Command Title

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? IOOUTPUTSADDR, SYSTERR? Resetting Clearing DigitizerIOOUTPUTSADDR, *TST? IOOUTPUTSADDR, DIAGTEST? Subend IOOUTPUTSADDR, *RST*CLS Integer Querying Digitizer ConfigurationLRN? Repeat LRN.C Chapter Getting Started Instrument and Programming Languages TRIGSTARTIM1 10E-6 OUTPEXT1STAT Ontrigsour EXT1OUTPEXT1STAT OFF Language Programs ∙ Microsoft QuickC Command Line CompilingMicrosoft QuickC clhpib.lib ∙ 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 ARMSOUR1 IMM Specifying a Sample RateSAMPLE.C Trigsour TIM ARMSLOP1 POS Dual Rate SamplingDUALSAMP.C 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 Vinslbusfeed ’CONVBOTH’ VinslbusresVinslbusmode GEN 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 READ? Retrieving Readings UsingRetrieving Readings Using FETCh? 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 Lbus Digitizer Local Bus CommandsLocal Bus Transfer Configurations 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? PON Standard Event Status GroupStandard Event Status Register CME EXE DDE QYE ESR? Standard Event Status Enable RegisterReading the Standard Event Status Register ESE? Status Byte Register Status Byte Status GroupOper RQS ESB MAV Ques Reading the Status Byte Register Presetting the Enable Register and Transition FilterService Request Enable 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 ARM Scpi Command FormatAbbreviated Commands Armlevneg Implied Optional Keywords Variable Command Syntax Scpi Command ParametersParameter Types Explanations, Examples OUTPECLT0FEED ’EXT’ OUTPECLT0FEED \EXT\ Optional Parameters Scpi Command ExecutionQuerying Parameter Settings 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 ABORt ∙ Executable when initiated Yes ∙ Coupled Command NoABORt Example Aborting a measurement ARM Syntax ARMSTARtCOUNtSTARtCOUNt Subsystem Parameter Range Default Name Type Values Parameters ARMSTARtCOUNt Parameter Range Default Name Type Values ARMSTARtDELaySTARtDELay MINimumMAXimum STARtIMMediate Example Setting the arming delayARMSTARtIMMediate ∙ *RST Condition none Example Arming for measurement ARMSTARtLEVelchanNEGative voltageSTARtLEVelchanNEGative voltage 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 Subsystem Syntax CALibrationchanCOUNt? 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 VALue CALibrationchan STOReAUTO mode selects whether or notCALibrationchanSTOReAUTO 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 Example Changing the contents of the traffic register DIAGnosticPOKEExample Examining the setting of the traffic register Poke Sput DIAGnosticSGET?SGET? 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 IMPedance INPutportFILTerLPASsSTATe mode enables or disablesINPutportFILTerLPASsSTATe 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 MEMory BATTerySTATeExample Enable memory to be non-volatile ∙ *RST Condition not affected MEMoryBATTeryCHARge? ∙ *RST Condition none Example Check the battery charge OUTPut ECLTrgnFEED ECLTrgnSTATe Example Setting the ECLTrg0 sync pulse sourceOUTPutECLTrgnSTATe ∙ *RST Condition EXTernal1FEED Parameter Range Default Name Type Values UnitsOUTPutEXTernal1FEED Boolean ARMSTARtSEQuence1 None RFTRigger SENSe12ROSCillator TRIGgerSTARtSEQuence1 EXTernal1STATe Example Setting the sync pulse sourceOUTPutEXTernal1STATe TTLTrgnFEED ARMSTARtSEQuence1 None OUTPutTTLTrgnFEEDNumeric Through 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? OPERationQUEStionableEVENt? Example Setting the Operation register enable maskSTATusOPERationQUEStionableEVENt? Through +32767 None Non-decimal Numeric STATusOPERationQUEStionableNTRansition OPERationQUEStionablePTRansition STATusPRESet PRESet SYSTem ERRor?Example Reading the error queue 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 Example Setting the start trigger source TRIGgerSTARtTIMer1STARtTIMer1 Reference period to TRIGgerSTARtTIMer1 ∙ *RST Condition 5.0E-8 seconds STARtTIMer2Period Value Table 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 Example Setting the Local Bus operation mode VINStrumentCONFigureLBUSRESetCONFigureLBUSRESet 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 Example Setting the VXIbus data transfer bus operation mode VINStrumentCONFigureVMESENDADDRessDATA?CONFigureVMESENDADDRessDATA? 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 GMC? Example Enable all error eventsESR? String Example Query macro definition IDN?LMC? 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 To Local Bus E1429B only Read-OutTo VME Bus Number of Partitions Amplitude Characteristics Signal Conditioning Total Readings per Partition Gain and Offset 4.3.1, note Signal-to-Noise RatioOutput Formats Filtering Word Error Rate 4.15 qualified error level word error rate Converter Supplemental CharacteristicsSingle-ended inputs Connector BNC Integral Nonlinearity 4.4.3, Note Effective bits on different ranges Single-ended inputs, supplemental characteristicsAnalog Bandwidth 4.6.1 filter off 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 SLFTST.C ERRORCHK.CIDN.C HP BASIC, C RSTCLS.C LBUSAUTO.C LOCALAD.CLBUS2PST.C STATUS.C Calstorauto Mode OFFEMC CAL1VAL SLOP1 DELSour 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 + A/D Serial Register Input Configuration RegistersA/D Status Register Base +0316 A/D Shift Register A/D Parallel Strobe RegisterBase +0B16 Bit Name Function Arm Status Register Arm and Trigger Configuration RegistersAbort and Arm Immediate 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 Binary Division Register Trigger Immediate Registerbase + 5D16Decade Division Register Base +6116 Pre-Arm Reading Count Registers Pre-Arm Reading Count Register power-On/Reset SettingsPost-Arm Reading Count Register power-On/Reset Settings Base + 7316 and base + Traffic Register Traffic Register Power-on/Reset SettingsMemory Control Registers 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 Base +2B16 Terminal Address RegisterBase Address Registers Base +2D16 and base +2F16 Using the A/D Shift Register Figure C-2. Accessing the A/D Shift Register Bit Name Setting Procedure Setting Measurement RangeSetting the Input Impedance 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 Sample rate Timebase resetTrigger count 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 Trigstartim 1E-6 Trigstarsour ECLT0Trigstarsour TIM 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