FORMat Subsystem, FORMatDATA ASCii Real | HP 53131A, 132A specification

Chapter 4 Command Reference

Introduction

:FORMat Subsystem

This subsystem sets the data format for transferring numeric information. This data format is used for response data by those commands that are specifically designated to be affected by the :FORMat subsystem.

:FORMat[:DATA] ASCii REAL

Query Response

Comments

Sets or queries the data format type. Valid types are ASCii and REAL.

When ASCii type is selected, numeric response data is transferred as ASCII bytes in <NR3> format. The numbers are separated by commas as specified in IEEE

488.2.To indicate that no response data exists, Not a Number 9.91E37 is returned.

When REAL type is selected, response data is transferred in a

<definite length block> as a 64-bit IEEE 754 floating point number. To indicate that no response data exists, Not a Number 9.91E37 is returned in the <definite length block>.

A sequence of ASCII-encoded bytes: ASC or REAL

∙*RST: ASCii

∙This command affects the response format of the following commands:

:CALCulate:DATA?

:CALCulate3:DATA?

:FETCh? :MEASure query :READ? [:SENSe]:DATA? :TRACe[:DATA] query

Programming Guide

4-41

Image 207

HP 53131A, 132A manual FORMat Subsystem, FORMatDATA ASCii Real

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 What You Should Understand How to Use This GuideGetting Started New Users 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 CALibration CONFigureDIAGnostic Keyword/Syntax Parameter Form Std Comments New CALCulate3 FORMat Keyword/Syntax Parameter Form Std Comments New DIAGnosticDISPlay FETCh MEASure Keyword/Syntax Parameter Form Std Comments New INITiateINPut12 INPut3 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 Prefix below 53132A with S/N ARM commandsARM HP 53131A See -2A on HP 53132A with 2-38 for HP STATus Keyword/Syntax Parameter Form Std Comments New SYSTem TRACeTRIGger Estart Stop HP 53131A /132A *RST State Command Header Parameter StateRST Response RST Response 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 Elements of Scpi Commands Where to Find HP Basic Programming ExamplesWhere to Find QuickBASIC Programming Examples Where to Find Turbo C Programming Examples 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 Suffix Elements Parameter SeparatorQuery Parameters Suffixes Command Terminator Suffix MultipliersSuffix Multipliers Program Message Syntax Using Multiple CommandsUsing Multiple Commands Program Messages Inpcoup AC Inpimp Inpcoup Acinpimp Overview of Response Message Formats Overview of Response Message FormatsResponse Messages Response Message Syntax 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 How to Program the Counter to Display Results Commands for Displaying Scaled/Offset ResultsCommands for Displaying the Limit Graph Commands for Displaying Statistics Results Dispenable Commands for Enabling and Disabling the Display How to Program the Counter to Synchronize Measurements How to Program the Counter to Synchronize MeasurementsResetting the Counter and Clearing the HP-IB Interface Using the *WAI Command 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 To Send a Single-Quoted String Using HP BasicProgramming Examples To Send a Double-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 Comments Related Front-Panel Keys ABORt CommandABORt Command ABORt CALCulate Subsystems CALCulate Subsystems CALCulate1DATA? CALCulate1 Subsystem Query Response Comments CALCulate1FEED SENSe1CALCulate1IMMediate CALCulate1 Subsystem 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? CALibration Subsystem CALibration SubsystemCALibrationALL? CALibrationCOUNt? Front-Panel Key CALibrationDATA arbitrary block CALibrationSECurityCODE NRf NRf Range NRf Resolution CommentsNRf Range NRf Resolution Query Response CALibrationSECurity Subtree Comments Related Front-Panel Keys CONFigure Subsystem CONFigure Subsystem Device Clear Device Clear Auto Once OFF DIAGnostic SubsystemDIAGnosticCALibrationINPut12GAIN DIAGnostic Subsystem 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 INITiate Subsystem INITiate SubsystemINITiateAUTO Boolean INITiateCONTinuous Boolean Introduction Related Run Front-Panel Keys INITiateIMMediate Stop/Single INPut12FILTerLPASsSTATe Boolean INPut12 SubsystemINPut12ATTenuation 1 INPut12COUPling AC DC INPut12IMPedance numericvalue OHM Numericvalue Range Query Response CommentsRelated 50Ω /1MΩ Front-Panel Keys INPut3 Subsystem INPut3 SubsystemINPut3COUPling? INPut3IMPedance? 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? Description Range for Ch1 , Ch1 Resolution DefaultRange for Ch1 , Ch1 Range for Ch2 , Ch3 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 MEMoryNSTates? MEMory SubsystemMEMoryDELeteMACRostring MEMoryFREEMACRo? SENSe Subsystem SENSe SubsystemSENSeDATA? SENSe1 SENSeEVENt12 Subtree Prior Firmware Revisions 3317, 3335, SENSeEVENt2FEED INPut1 INPut2SENSeEVENt12HYSTeresisRELative numericvalue PCT Current Firmware Revision SENSeEVENt12LEVelABSolute numericvalue Numericvalue Range Resolution Query Response Comments Range Resolution SENSeEVENt12LEVelABSoluteAUTO BooleanSENSeEVENt12LEVelRELative numericvalue PCT SENSeEVENt12SLOPe POSitive NEGative SENSeEVENt3 SubtreeSENSeEVENt3LEVelABSolute? SENSeFREQuencyARM Subtree SENSeEVENt3SLOPe?SENSeFREQuency Subtree SENSeFREQuencyARMSTARtSLOPe POSitive NEGative 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 Numeric-value SENSeTINTervalARMSTARtSOURce IMMediate EXTernalSENSeTINTervalARMSTOPSOURce IMMediate TIMer SENSeTINTervalARMSTOPTIMer numericvalue S Query Response Comments Related Front-Panel Keys HP 53132A With S/N Prefix 3646 and Above SENSeTINTervalARMESTART and Estop Subtrees Front-Panel Arming Setting Resolution Query Response SENSeTINTervalARMESTARTLAYer2SLOPe POSitive NEGativeSENSeTINTervalARMESTARTLAYer2SOURce IMMediate EXTernal SENSeTINTervalARMESTARTLAYer1ECOunt numericvalue 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? Range Query Response Comments STATusOPERationENABle non-decimal numeric NRfSTATusOPERationEVENt? STATus Subsystem 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 SYSTem Subsystem SYSTem SubsystemSYSTemCOMMunicate Subtree SYSTemCOMMunicateSERialCONTrolDTR IBFull on LIMit SYSTemCOMMunicateSERialTRANsmitPACE XON None SYSTemCOMMunicateSERialTRANsmitBAUD numericvalue SYSTemKEY numericvalue SYSTemERRor?SYSTemCOMMunicateSERialTRANsmitPARityTYPE Even ODD None 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 EMC NRf EMC NRf Enable Macro CommandEnable Macro Query EMC NRf Enable Macro Command ESE NRf ESE NRf Standard Event Status Enable CommandStandard Event Status Enable Query NRf Range NRf Resolution Query Response Comments 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 SRE? SRE NRf Service Request Enable CommandService Request Enable Query SRE NRf 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 Error Types Error TypesNo Error Command Error 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