Elements of Scpi Commands | HP 53131A, 132A manual

Chapter 3 Programming Your Universal Counter for Remote Operation

Elements of SCPI Commands

Table 3-9 lists the typical performance for three different computers. The “To Optimize Throughput” sample programs on pages 3- 73 , 3-86, and 3-96 were used to generate the numbers in the table. The actual examples listed in this guide show the Frequency Auto Arming function, but the technique is the same for the other two functions (Frequency Time Arming .001 and Time Interval 1 to 2). You only have to change the function in the program to generate the numbers in the table.

Table 3-9. Typical Optimizing Throughput Results in Measurements per Second

	IBM PC Compatible	HP 82324A	HP 9000 Series 300
	486/25 MHz	Basic Language	Model 360
Function	HP 82335A Card	Processor

Time Interval 1 to 2
Auto Arming	235	225	230

Frequency
Auto Arming	200	190	195

Frequency
Time Arming .001	155	155	160

Programming Guide

3-37

Image 105

HP 53131A, 132A manual Elements of Scpi Commands

Contents

HP 53131A/132A 225 MHz Universal Counter Page Programming Guide Certification Warranty Contents Remote Status Reporting How to Program the Counter to Display Results Programming Guide Vii Command Reference STATus Subsystem Errors Before You Start Introduction Introduction Programming Guide Contents HP 53131A Containing Firmware Revisions 3317, 3335, orCalibrations HP-IB Commands MeasurementsStatistics HP 53132A Time Interval De lay Arming Getting Started How to Use This GuideNew Users What You Should Understand Learning to Program the Counter Experienced Programmers Applications How to Use This Guide Assumptions Programming Guide Contents Related Documentation Related Documentation Programming Guide Contents Related Documentation Command Summary Chapter Summary Front Panel to Scpi Command Maps Front Panel to Scpi Command MapsSome Scpi Syntax Conventions Input Channels Conditioning Keys to Scpi Command Map Part 1 Input Channels Conditioning Keys to Scpi Command Map Input Channels Conditioning Keys to Scpi Command Map Part 2 Front Panel to Scpi Command Maps RCL Nrf Measure Keys to Scpi Command Map Part 1 Measure Keys to Scpi Command Map Measure Keys to Scpi Command Map Part 2 Gate & ExtArm Key to Scpi Command Map Part 1 Gate & ExtArm Key to Scpi Command Map Freq, Period, Ratio Phase Rise Time, Fall Time, +/- Pulse Width, Dutycycle Totalize Gate & ExtArm Key to Scpi Command Map Part 4 Gate & ExtArm Key to Scpi Command Map Part 5 Gate & ExtArm Key to Scpi Command Map Part 6 Limits and Math Keys to Scpi Command Map Part 1 Limits and Math Keys to Scpi Command Map Limits and Math Keys to Scpi Command Map Part 2 Calibration Menu to Scpi Command Map Part 1 Calibration Menu to Scpi Command Map Calibration Menu to Scpi Command Map Part 2 HP 53131A/132A Command Summary HP 53131A/132A Command SummaryScpi Conformance Information Ieee 488.2 Common Commands Mnemonic Command Name Function HP 53131A/132A Command Summary Ieee 488.2 Common Commands RCL Front Panel to Scpi Command Maps Ieee 488.2 Common Commands HP 53131A/132A Scpi Subsystem Commands Std/New ColumnParameter Form Column Keyword/Syntax Parameter Form Std Comments New ABORt CALCulate1CALCulate2 CALCulate3 Keyword/Syntax Parameter Form Std Comments New CALCulate2 DIAGnostic CONFigureKeyword/Syntax Parameter Form Std Comments New CALCulate3 CALibration DISPlay Keyword/Syntax Parameter Form Std Comments New DIAGnosticFETCh FORMat INPut12 Keyword/Syntax Parameter Form Std Comments New INITiateINPut3 MEASure CONFigure? Function Parameters Sourcelist Std New SENSe Keyword/Syntax Parameter Form Std Comments New MEMory ARM Keyword/Syntax Parameter Form Std Comments New SENSe On OFF Once ARM HP 53131A See -2A on ARM commandsHP 53132A with 2-38 for HP Prefix below 53132A with S/N STATus Keyword/Syntax Parameter Form Std Comments New SYSTem TRACeTRIGger Estart Stop RST Response Command Header Parameter StateRST Response HP 53131A /132A *RST State 1E6 OHM Front Panel to Scpi Command Maps HP 53131A/132A *RST State 3B. HP 53132A S/N 3646 and above Time Interval *RST State ESE OPC? SRE Front Panel to Scpi Command Maps Unaffected by *RST RST Response Programming Your Universal Counter for Remote Operation Where to Find Some Specific Information Where to Find QuickBASIC Programming Examples Where to Find HP Basic Programming ExamplesWhere to Find Turbo C Programming Examples Elements of Scpi Commands Configuring the HP-IB To Set the HP-IB Mode and AddressConfiguring the HP-IB HP-IB Remote/Local Operation To Connect the Counter to a Computer Overview of Command Types and Formats Common Command FormatScpi Command and Query Format Elements of Scpi Commands Subsystem Command SyntaxCommon Command Syntax Abbreviated Commands Keyword SeparatorOptional Keyword ARM Stop Implied Channel Optional Numeric Keyword Suffix Parameter Types Command and Query Parameter Types Query Parameters Parameter SeparatorSuffixes Suffix Elements Command Terminator Suffix MultipliersSuffix Multipliers Using Multiple Commands Using Multiple CommandsProgram Messages Program Message Syntax Inpcoup AC Inpimp Inpcoup Acinpimp Response Messages Overview of Response Message FormatsResponse Message Syntax Overview of Response Message Formats Response Message Data Types Response Message Data TypesType Description Overview of Response Message Formats Status Reporting Status Reporting Status Byte Register Status Byte Register and Service Request Enable Register Status Reporting Status Byte Register BIT Weigh Symbol Description Service Request Enable Register Standard Event Status Register Group Standard Event Status RegisterStandard Event Status Register Elements of Scpi Commands Standard Event Status Enable Register Operation and Questionable Status Reporting Model Condition Register Transition FilterTransition Filter Definition Event Register Event Enable Register Operation Status Register Operation Status Register Group Elements of Scpi Commands Questionable Data/Signal Status Register Questionable Data/Signal Status Register Group Elements of Scpi Commands Status Reporting Commands to Set Counter for Optimal Throughput Command Settings for Optimizing Throughput SENSeROSCillatorEXTernalCHECk OFF See Note below Command Settings for Optimizing Throughput Elements of Scpi Commands How to Program the Counter for Status Reporting How to Program the Counter for Status ReportingDetermining the Condition of the Counter Event Status Register Operation Status Register Questionable Data Status Register 10. Status Reporting Flowchart 1 10. Status Reporting Flowchart 2 How to Program the Counter to Display Results Configuring the Counter ’s DisplayCommands for Displaying Non-Scaled/Offset Results Commands for Displaying the Limit Graph Commands for Displaying Scaled/Offset ResultsCommands for Displaying Statistics Results How to Program the Counter to Display Results Dispenable Commands for Enabling and Disabling the Display Resetting the Counter and Clearing the HP-IB Interface How to Program the Counter to Synchronize MeasurementsUsing the *WAI Command How to Program the Counter to Synchronize Measurements Using the *OPC Command to Assert SRQ Using the *OPC? Command Trigcountauto on *ESE Updating Math and Limit Results Over HP-IB How to Program the Counter for Math/Limit Operations How to Program the Counter for Math/Limit Operations Using the Scale and Offset Over HP-IB TRACE? Scale How to Program the Counter to Define Macros How to Program the Counter to Define Macros DMC ‘setimp’,#212INP1IMP $1 Dispmenu 0TEXTFEED ‘CALC2’CALC2LIMSTAT 1DISP Grap Calcimm Writing Scpi Programs Writing Scpi Programs 11. Scpi Programming Flowchart Sheet 1 11. Scpi Programming Flowchart Sheet 2 Programming Examples Using HP BasicTo Send a Double-Quoted String To Send a Single-Quoted String Using QuickBASIC Using Turbo CList of the Programming Examples Integer Easiest Way to Make a Measurement HP Basic Enter @CountFreq$ Clear Screen To Make a Frequency Measurement HP Basic Enable Intr To Perform Limit Testing HP Basic 50 ! Trigcountauto on To Measure the Statistics of 50 Measurements HP Basic Output @CountINIT*OPC Basic To Use Limits to Filter Data Before Measuring Stats HP To Use Limits to Filter Data Before Measuring Stats HP Basic To Read and Store Calibration Information HP Basic 120 ! Program Shows To Perform a Time Interval Calibration HP Basic END While Return Output Else Roscextcheck OFF To Optimize Throughput HP Basic Output @CountINITCONT on Put counter in Run mode User Keys On KEY To Use Macros HP Basic SUB Definemacro To Make a Frequency Measurement QuickBASIC REM $INCLUDE QBSETUP.BAS To Perform Limit Testing QuickBASIC PEN on To Measure the Statistics of 50 Measurements QuickBASIC On PEN Gosub statsready Wait for interrupt Programming Examples Statistics Print Minimum Period PUT #1, 1, Caldata Close #1 To Read and Store Calibration Data QuickBASIC See the program comments for details To Optimize Throughput QuickBASIC Send the expected frequency To Use Macros QuickBASIC Displaymacro END if Return To Make a Frequency Measurement Turbo C Linefeed can be removed HP-IB library constant declarations This is the bit from the Operation SendhpCALC3AVERAGETYPE MAXCALC3DATA? To Optimize Throughput Turbo C Need to be sent for every Variables used by function Command Reference Command Reference Programming Guide ABORt Command ABORt CommandABORt Comments Related Front-Panel Keys CALCulate Subsystems CALCulate Subsystems CALCulate1DATA? CALCulate1 Subsystem CALCulate1IMMediate CALCulate1FEED SENSe1CALCulate1 Subsystem Query Response Comments CALCulate1IMMediateAUTO Boolean CALCulate1MATH SubtreeCALCulate1MATHEXPRessionCATalog? CALCulate1MATHEXPRessionDEFine? CALCulate1MATHSTATe BooleanFront-Panel Keys CALCulate2 Subsystem CALCulate2FEED CALCulate1CALCulate2IMMediate CALCulate2IMMediateAUTO Boolean CALCulate2LIMit SubtreeCALCulate2 Subsystem CALCulate2LIMitCLEarIMMediate CALCulate2LIMitCLEarAUTO Boolean CALCulate2LIMitFAIL? CALCulate2LIMitDISPlay GRAPh NUMBer CALCulate2LIMitFCOuntLOWer? CALCulate2LIMitFCOuntTOTal?CALCulate2LIMitFCOuntUPPer? CALCulate2LIMitLOWerDATA numericvalue HZ S DEG CALCulate2LIMitPCOuntTOTal? CALCulate2LIMitSTATe BooleanQuery Response Comments Related Front-Panel Keys CALCulate2LIMitUPPerDATA numericvalue HZ S DEG CALCulate3 Subsystem CALCulate3AVERage SubtreeCALCulate3AVERageALL? CALCulate3AVERageCLEar CALCulate3AVERageCOUNt numericvalueCALCulate3 Subsystem CALCulate3AVERageSTATe Boolean CALCulate3AVERageCOUNtCURRent? ∙ *RST Mean CALCulate3DATA? CALCulate3FEED CALCulate1 CALCulate3LFILter SubtreeCALCulate3LFILterLOWerDATA numericvalue HZ S DEG CALCulate3LFILterUPPerDATA numericvalue HZ S DEG CALCulate3LFILterSTATe Boolean CALCulate3PATH? CALibrationALL? CALibration SubsystemCALibrationCOUNt? CALibration Subsystem Front-Panel Key CALibrationDATA arbitrary block NRf Range NRf Resolution Query Response NRf Range NRf Resolution CommentsCALibrationSECurity Subtree CALibrationSECurityCODE NRf Comments Related Front-Panel Keys CONFigure Subsystem CONFigure Subsystem Device Clear Device Clear DIAGnosticCALibrationINPut12GAIN DIAGnostic SubsystemDIAGnostic Subsystem Auto Once OFF DIAGnosticCALibrationINTerpolatorAUTO Once OFF on DIAGnosticCALibrationINPut12OFFSet DIAGnosticCALibrationSTATus? DIAGnosticCALibrationROSCillatorAUTO Once OFF DIAGnosticCALibrationTINTervalFINE1234 DIAGnosticCALibrationTINTervalQUICk DISPlayENABle Boolean DISPlay SubsystemDISPlayMENUSTATe OFF DISPlay Subsystem DISPlayWINDowTEXTFEED CALCulate2 CALCulate3 DISPlayWINDowTEXTRADix COMMa DPOint FETCh Subsystem FETCh Subsystem FORMatDATA ASCii Real FORMat Subsystem Group Execute Trigger Group Execute Trigger GET HCOPyCONTinuous Boolean HCOPy Subsystem INITiateAUTO Boolean INITiate SubsystemINITiateCONTinuous Boolean INITiate Subsystem Introduction Related Run Front-Panel Keys INITiateIMMediate Stop/Single INPut12ATTenuation 1 INPut12 SubsystemINPut12COUPling AC DC INPut12FILTerLPASsSTATe Boolean INPut12IMPedance numericvalue OHM Numericvalue Range Query Response CommentsRelated 50Ω /1MΩ Front-Panel Keys INPut3COUPling? INPut3 SubsystemINPut3IMPedance? INPut3 Subsystem MEASure Subsystem Measurement Instructions CONFigure Measurement Instructions CONFigure, FETCh, MEASure, ReadFETCh, MEASure, Read CONFigureSCALarfunction parameters ,sourcelist CONFigure? FETChSCALarfunction? MEASureSCALarfunction? parameters ,sourcelist READSCALarfunction? Measurement Instructions CONFigure, FETCh, MEASure, Read Function Parameters Sourcelist Descriptions of the Measurement Functions- function Commands that required work-around commands are MEASureSCALarVOLTageDCYCle? reference,@1 Lowerreference MEASureSCALarVOLTageFALLTIME? Range@1 Default@1 MEASureSCALarVOLTageFREQuency? Range for Ch1 , Ch1 Resolution DefaultRange for Ch2 , Ch3 Description Range for Ch1 , Ch1 MEASureSCALarVOLTageFREQuencyRATio? MEASureSCALarVOLTageMAXimum? @1@2MEASureSCALarVOLTageMINimum? @1@2 MEASureSCALarVOLTageNWIDth? reference,@1 MEASureSCALarVOLTagePERiod? expectedvalue,resolution, @1@2@3 MEASureSCALarVOLTagePERiod? MEASureSCALarVOLTagePHASe? @1,@2 MEASureSCALarVOLTagePTPeak? @1@2MEASureSCALarVOLTagePWIDth? reference,@1 Percent range MEASureSCALarVOLTageRISETIME? MEASureSCALarVOLTageTINTerval? @1,@2 CONFigureSCALarVOLTageTOTalizeCONTinuous @1 MEASureSCALarVOLTageTOTalizeTIMed? gatetime,@1 Using MEAsure How to Use the Measurement Instruction Commands Conffreq 5 MHZ, 1HZ Using CONFigure with INITiate and FETCh? Firmware Revision Work-Around Commands Init *WAI MEMoryDELeteMACRostring MEMory SubsystemMEMoryFREEMACRo? MEMoryNSTates? SENSeDATA? SENSe1 SENSe SubsystemSENSeEVENt12 Subtree SENSe Subsystem SENSeEVENt12HYSTeresisRELative numericvalue PCT SENSeEVENt2FEED INPut1 INPut2Current Firmware Revision Prior Firmware Revisions 3317, 3335, SENSeEVENt12LEVelABSolute numericvalue Numericvalue Range Resolution Query Response Comments Range Resolution SENSeEVENt12LEVelABSoluteAUTO BooleanSENSeEVENt12LEVelRELative numericvalue PCT SENSeEVENt12SLOPe POSitive NEGative SENSeEVENt3 SubtreeSENSeEVENt3LEVelABSolute? SENSeFREQuency Subtree SENSeEVENt3SLOPe?SENSeFREQuencyARMSTARtSLOPe POSitive NEGative SENSeFREQuencyARM Subtree SENSeFREQuencyARMSTARtSOURce IMMediate EXTernal SENSeFREQuencyARMSTOPDIGits numericvalueSENSeFREQuencyARMSTOPSLOPe POSitive NEGative SENSeFREQuencyARMSTOPTIMer numericvalue S SENSeFREQuencyARMSTOPSOURce IMMediate EXTernal TIMer DIGits SENSeFREQuencyEXPected123AUTO on SENSeFREQuencyEXPected123 numericvalue HZ Comments ∙ *RST on SENSeFUNCtionON sensorfunction Query Response Comments SENSePHASe Subtree SENSePHASeARMSTARtSLOPe POSitive NEGativeSENSePHASeARM Subtree SENSePHASeARMSTARtSOURce IMMediate EXTernal SENSeROSCillator SubtreeSENSeROSCillatorEXTernalCHECk on OFF Once SENSeROSCillatorSOURce INTernal EXTernal SENSeROSCillatorEXTernalFREQuency? SENSeROSCillatorSOURceAUTO Boolean SENSeTINTervalARM Subtree HP 53131A and HP 53132A SENSeTINTervalARMSTARtSLOPe POSitive NEGative SENSeTINTervalARMSTOPSOURce IMMediate TIMer SENSeTINTervalARMSTARtSOURce IMMediate EXTernalSENSeTINTervalARMSTOPTIMer numericvalue S Numeric-value Query Response Comments Related Front-Panel Keys HP 53132A With S/N Prefix 3646 and Above SENSeTINTervalARMESTART and Estop Subtrees Front-Panel Arming Setting SENSeTINTervalARMESTARTLAYer2SOURce IMMediate EXTernal SENSeTINTervalARMESTARTLAYer2SLOPe POSitive NEGativeSENSeTINTervalARMESTARTLAYer1ECOunt numericvalue Resolution Query Response Related Front-Panel Keys SENSeTINTervalARMESTARTLAYer1TIMer numericvalue S SENSeTINTervalARMESTOPLAYer2SLOPe POSitive NEGative SENSeTINTervalARMESTOPLAYer2SOURce IMMediate EXTernalSENSeTINTervalARMESTOPLAYer1ECOunt numericvalue SENSeTINTervalARMESTOPLAYer1TIMer numericvalue S SENSeTINTervalARMESTOPLAYer1SOURce IMMediate TIMer INTernal2 SENSeTOTalize Subtree SENSeTOTalizeARMSTARtSLOPe POSitive NEGativeSENSeTOTalizeARM Subtree SENSeTOTalizeARMSTOPSLOPe POSitive NEGative SENSeTOTalizeARMSTARtSOURce IMMediate EXTernal SENSeTOTalizeARMSTOPTIMer numericvalue S SENSeTOTalizeARMSTOPSOURce IMMediate EXTernal TIMer STATus Subsystem STATusOPERation SubtreeSTATusOPERationCONDition? STATusOPERationEVENt? STATusOPERationENABle non-decimal numeric NRfSTATus Subsystem Range Query Response Comments STATusOPERationPTRansition non-decimal numeric NRf STATusOPERationNTRansition non-decimal numeric NRf STATusQUEStionable Subtree STATusPRESet STATusQUEStionableCONDition? STATusQUEStionableENABle non-decimal numeric NRf STATusQUEStionableNTRansition non-decimal numeric NRf STATusQUEStionableEVENt? STATusQUEStionablePTRansition non-decimal numeric NRf SYSTemCOMMunicate Subtree SYSTem SubsystemSYSTemCOMMunicateSERialCONTrolDTR IBFull on LIMit SYSTem Subsystem SYSTemCOMMunicateSERialTRANsmitPACE XON None SYSTemCOMMunicateSERialTRANsmitBAUD numericvalue SYSTemCOMMunicateSERialTRANsmitPARityTYPE Even SYSTemERRor?ODD None SYSTemKEY numericvalue Key Key Code Numericvalue Range Query Response SYSTemVERSion? SYSTemKEYLOG? Offset TRACe Subsystem TRACe Subsystem Scale TRIGgerCOUNtAUTO Boolean TRIGger Subsystem CAL? Calibration Query CAL?Calibration Query CLS Clear Status Command DDT arbitrary block Define Device Trigger Command DDT arbitrary block Define Device Trigger CommandDDT arbitrary block DMC string, arbitrary block DMC string, arbitrary block Define Macro Command Enable Macro Query EMC NRf Enable Macro CommandEMC NRf Enable Macro Command EMC NRf Standard Event Status Enable Query ESE NRf Standard Event Status Enable CommandNRf Range NRf Resolution Query Response Comments ESE NRf Event Status Register Query ESR?Event Status Register Query GMC? string Get Macro Contents Query IDN? Identification Query IDN?Identification Query LMC? Learn Macro Query Operation Complete Command Operation Complete CommandOPC OPC? Operation Complete Query Option Identification Query OPT?Option Identification Query PMC Purge Macro Command RCL NRf Recall Command RCL NRf Recall CommandRCL NRf RST Reset Command SAV NRf Save Command SAV NRf Save CommandSAV NRf Service Request Enable Query SRE NRf Service Request Enable CommandSRE NRf SRE? Status Byte Query STB?Status Byte Query TRG Trigger Command TST? Self-Test Query TST?Self-Test Query WAI WAI Wait-to-Continue Command Wait-to-Continue Command Errors Displaying Errors Reading an Error113, Undefined header Error Queue Error Queue No Error Error TypesCommand Error Error Types Device- or Counter-Specific Error Execution Error Query Error Number Error String Cause Error Queue Errors Error Types Errors Error Queue Errors During Index Index Index Scpi INPut12OFFSetAUTO TRACe\DATA Scale 120 Asia Pacific From front matter Page Manual Part Number