Event Status Register, Get Macro Definition

∗ESR?

PM6680B/81/85

Event Status Register

Reads out the contents of the standard event status register. Reading the Stan- dard Event Status Register clears the register.

Returned Format:

<dec.data> = the sum (between 0 and 255) of all bits that are true. See table on page 9-121.

Complies to standards:	IEEE 488.2 1987.

*GMC?

< macro label>

PM6680B/81/85

Get Macro Definition

This command makes the counter respond with the current definition of the given macro label.

Parameters:

<Macro label> = the label of the macro for which you want to see the definition. (String data must be surrounded by “ ” or ‘ ‘ as in the example below.)

Returned Format: <Block data>

Example:

SEND *GMC? ‘AMPLITUDE?’

Gives a block data response, for instance:

READ

#255:FUNC ‘FREQ 1’;:INP:HYST:AUTO ONCE;:INP:HYST?;INP:LEV?

Complies to standards:

IEEE 488.2 1987.

9-122 Command Reference

Page 252

Image 252

Fluke PM6681R, PM6685R Event Status Register, Get Macro Definition, Macro label PM6680B/81/85, Send *GMC? ‘AMPLITUDE?’

Contents

Timer/Counter/ Analyzers Pendulum Instruments AB Sweden Table of Contents Configure Function Diagnostics SubsystemAbort Arming Subsystem Sense Command Subsystem Common CommandsMemory Subsystem Output Subsystem Index Getting Started Sections Index Syntax Specification Form Manual ConventionsMnemonic Conventions Setting Up Instrument Setting the Gpib AddressExample Language Power-on Testing the BusInterface Functions What can I do with the Bus? Service Request, SR1 Listener Function, L4Remote/Local, RL1 Parallel Poll, PP0 Bus Commands for the Benchtop User Error Code INPATT110INPLEVlevel INP2ATT110 These commands are from the Sense subsystem Systpres or *RSTACQHOFFTIMEtime FUNCfunctionchannel,channel ACQAPERtime Calcavertypemaxminsdevmean Selects statistical function SAVmemory location*RCLmemory locationMemory location can be any No. between 0 All commands on this page are from the Sense subsystem FUNCTOT1,2 This command is from the Sense subsystem OUTPSCALscaling factor SYSTCOMMGPIBADDRAddress Default settings after *RST Default settings after *RST Introduction to Scpi What is SCPI? What is SCPI?Reason for Scpi Compatibility Management and Maintenance of Programs Gpib How does Scpi Work in the Instrument? Message Exchange Control protocolHow does Scpi Work in the Instrument? Deferred Commands Sequential and Overlapped CommandsProtocol Requirements Order of Execution Remote Local Protocol Definitions Program and Response Messages Syntax and StyleSyntax of Program Messages Program and Response MessagesPage Notation Habit in Command Syntax Syntax of Response MessagesResponses Moving down the Command Tree Command TreeExample SEND→ Inputfilteron Parameters Numeric DataBoolean Data Keywords Expression Data Summary Other Data TypesSEND→ Systtouton or SYSTTOUT1 #218INPIMP50SENS10 Define Macro Command MacrosMacro Names Data Types within Macros How to Execute a Macro Deleting MacrosEnabling and Disabling Macros GMC? Get Macro Contents Query Retrieve a MacroLMC? Learn Macro Query Status Reporting System IntroductionStatus Reporting System Error Reporting Detecting Errors in the QueueRead the Error/Event Queue Standardized Error Numbers Execution Error Device-specific ErrorQuery Error Initialization and Resetting Reset StrategyBus Initialization Message Exchange Initialization *RST Command *CLS Command Programming Examples Introduction Introduction Setting up the interface GW-Basic for National Instruments PC-IIA Limit Testing 90 ‘ 100 ‘ 110 ‘ -- Enable arming, etc 180 ‘ Armdelay =Frequency Profiling 50 ‘ 270 WRT$ = Armdel + STR$ARMDELAY Call IBWRTCNT%, WRT$ PRINT#1, STR$ARMDELAY, LEFT$MSG$, INSTRMSG$, CHR$10Call IBRDCNT%, MSG$ Fast Sampling Call Ibwait CNT%, Mask 510 MSG$ = SPACE$255 600 ‘ Close 620 END 130 ‘ -- SET Event Status Enable 180 ‘ -- SET Service Request Enable260 ‘ -- Enter Command String and Send to Counter Status Reporting 650 ‘ -- Read Error Messages 410 ‘ -- Check Message Available BIT While SPR%Lfpos 520 ‘ -- Check Event Status BIT Statistics Print Waiting for Measurement to GET Ready330 WRT$ = Calcavertype MAX CALCIMM? Call Ibwrt CNT%, WRT$ Call Ibrd CNT%, MSG$ Print Maximum = LEFT$MSG$, IBCNT% Call Ibrd CNT%, MSG$ Print Minimum = LEFT$MSG$, IBCNT% 470 WRT$ = Calcavertype Mean CALCIMM? Call Ibwrt CNT%, WRT$Call Ibrd CNT%, MSG$ Print Mean = LEFT$MSG$, IBCNT% 540 WRT$ = Calcavertype Sdev CALCIMM? Call Ibwrt CNT%, WRT$ ‘C’ for National Instruments ‘C’ for National Instruments PC-IIA 14 ‘C’ for National Instruments PC-IIA, Limit Testing Real Data Format ‘C’ for National Instruments PC-IIA, Real Data Format 16 ‘C’ for National Instruments PC-IIA, Frequency Profiling FileOfp 17 ‘C’ for National Instruments PC-IIA, Frequency Profiling Capture Profile 18 ‘C’ for National Instruments PC-IIA, Fast Sampling ‘C’ for National Instruments PC-IIA, Fast Sampliing 20 ‘C’ for National Instruments PC-IIA, Statistics ‘C’ for National Instruments PC-IIA, Statistics 22 ‘C’ for National Instruments PC-IIA This side is intentionally left blank Instrument Model Function Instrument Examples Type Measurement Function Block INPutSENSe CALCulate Other Subsystems Order of Execution CONFigure READ? MEASurement FunctionMEASure? MEASurement Function CONFigure INITiateFETCh? Versatility of Measurement Com- mandsREAD? Using the Subsystems Introduction Mathematics StatisticsLimit Monitoring Calculate Subsystem PM6680B, PM6685 PM6681Calibration Subsystem Configure Function Configure Function Time Stamp Readout Format Format Subsystem PM6685 Input Subsystems 2Summary of PM6680B / PM6681 input amplifier settings PM6680B/PM6681 CONFigure READ? MEASure?SEND→ MEASureFREQ? SEND→ MEASureFREQ?20MHz,1 CONFigureINITiateFETCh? SEND→ READ?Versatility of measurement com Mands Scaling Factor Output Subsystem Resolution Same exponent, opposite sign Switchbox Sense Command SubsystemPrescaling Using the Registers Status Reporting ModelStatus Structure Status Subsystem 7654 3210 Clearing/Setting all bits Using the QueuesStatus of the Error Message Queue EAV Using the Status Byte Selecting Summary Message to Gen Erate SRQIc e Setting up the Counter to Report Status Reading and Clearing StatusStatus Byte Status Event Registers Why Two Types of Registers? Set upStatus Condition Registers Check & Action Standard Status Registers G ic aA t u s B y t e G i s t e r Standard Event Status Register Summary, Standard Event Status Reporting SCPI-defined Status Registers Operation Status Group Summary, Operation StatusReporting Questionable Data/Signal Data/Signal Status ReportingStatus Group Summary Questionable Error Queue Device-defined Status Structure Power-on Status Clear Preset the Status Reporting StructureSummary, Device-defined Status Reporting ARM-TRIG Trigger Configuration Instrument ActionTrigger/Arming Subsystem Structure of the Idle and Initiated States Structure of an Event-detection LayerForward Traversing an Event-detection Layer TRG Trigger Command When to use *TRG and GETTriggering Backward Traversing an Event-detection Layer E n t d e t e c t i o n l a y e r E n t d e t e c t i o n l oa ny e er a c h a r m How to Measure Fast Controller Synchronization Measurement Cycle SynchronizationStart Stop Rough Trigger SubsystemDescription Some Basic Commands Command MEASFREQ?Data Format MEASMEM1? MEASMEM?1 RCL 1READ? Individually Synchronized Measurements Initcont and GETBasic Measurement Method ARMSTARTLAY2SOURceBUS General Speed Improvements Block Synchronized MeasurementsREADARRay? Init + GET + FETCHARRay? Time Measurement Resolution Display ControlGpib Data Format Automatic Interpolator Calibration PM6680B/85 Measure Ments/secondBlock Measurements Real Time Calculation Supervising a Process Obvious MethodOptimal Method Supervising a Process Speed Summary Speed SummaryDead Time Between Measurements Including Transfer to Controller Ascii Data Format Real Data Format E e d D i v i d u a l l y s y n c . m e a s Block Synchronized Measurements Speed Improvement ActionsDead Time Between Measurements PM6680B PM6681 PM6685 Calculating the Measurement Speed Timesaving Com Time Gain in ms Sacrifice Mands Freq Single Speed Switch Command for PM6680B/85 Single Speed Switch Command for PM6681 Error Messages Read the Error/Event Queue Error Code 0 toSEND→ SYSTemERRor? READ← -100, Command Error Command Errors Error Code -105 to -120 Error Code -121 to More specific errorDetect a more specific error Ular error message is used when the counter cannot Error Code -151 to -170 Error Code -171 to Error Code -200 to -221 Error Code -222 to Execution errorsError message is used when the counter cannot de Tect the more specific errors described for errors Error Code -241 to -272 Error Code -273 to Header syntaxMacro label was already defined see Error Code -300 to -350 Error Code -400 to Query errors Error Code 1100 to -1139 Unsupported enu Merated commandUnsupported auto Command Unsupported single Shot command Error Code 1150 to Reset during busOutput Read, but the waiting was broken by the operator Some PC controller cards has been known to do Error Code 1214 to -1240 Parser error Generic error in the parser This page is intentionally left blank Command Reference Command Reference Abort ABORt Abort MeasurementPM6680B/81/85 Aborts all previous measurements if *WAI is not used Arming Subsystem ARM COUNt No. of Measurements on each Bus arm«Numeric valueMINMAX» PM6680B/81/85 Send ARMCOUN100 ARM DELay Delay after External Start ArmingARM ECOunt External Events before Start Arming ARM LAYer2 ARM LAYer2 SOURceBus Arming Override Bus Arming On/Off ARM SLOPe ARM SOURceExternal Arming Start Slope External Arming Start Source ARM Stop DELay Delay after External Stop ArmingARM Stop ECOunt External Events before Stop Arming ARM Stop SLOPe ARM Stop SOURceExternal Stop Arming Slope External Stop Arming Source This page is intentionally left blank Calculate Subsystem Enable Statistics CALCulate AVERage COUNtCALCulate AVERage STATe Sample Size for Statistics CALCulate AVERage Type Statistical TypeFetch calculated data Send Calcmathstat Oncalcmath X 10.7E6INIT *OPC Enable Monitoring of Parameter Limits CALCulate IMMediateCALCulate LIMit Recalculate Data CALCulate LIMit FAIL? CALCulate LIMit LOWerLimit Fail Set Low Limit Set Upper Limit CALCulate LIMit LOWer STATeCALCulate LIMit UPPer Check Against Lower Limit CALCulate LIMit UPPer STATe Check Against Upper Limit CALCulate Math Select Mathematical ExpressionExpression Sendcalcmath X 10.7E6MATHSTATE ONREAD? Enable Mathematics This example switches on mathematicsCALCulate Math STATe No calculation Enable Calculation Switches on Post ProcessingCALCulate STATe Send Calcstat Calibration Subsystem ‘How to Measure Fast’ CALibration INTerpolator AutoCalibration of Interpolator Boolean Once Configure Function Set up Instrument for Measurement CONFigure Measuring Function Configure the counter for a single measurementParameters,channels Send CONFFREQRAT@3,@1 CONFigure ARRay Measuring Function Configure the counter for an array of measurementsSend Confarrper 7,5E-3,1E-6,@4 Send READARR? This page is intentionally left blank Diagnostics Subsystem DIAGnosticCALibrationINPut12HYSTeresis Input comparator hysteresis calibrationSend Diagcalinphyst Once This string calibrates both input a and input B Display Subsystem DISPlay ENABle Where Boolean = 1 / on 0 / OFFSee also , ‘How to Measure Fast’ Display State Fetch Function FETCh? Fetch One Result FETCh ARRay? Fetch an Array of Results«fetch array sizeMAX» Returned format data,data Format Subsystem FORMat Response Data Type FORMat FIXed FORMat SREGisterResponse Data Format Data Type for Status Messages FORMat TINFormation Timestamping On/Off TimestampingOn/Off Initiate Subsystem INITiate INITiate CONTinuousInitiate Measurement Continuously Initiated Input Subsystems Input B Not PM6685 INPut«12» ATTenuation INPut«12» COUPlingAC/DC Coupling INPut FILTer INPut HYSTeresisLow Pass Filter Sensitivity INPut HYSTeresis Auto Auto Sensitivity«BooleanONCE» Send Inphystauto OFF INPut«12» IMPedance INPut«12» LEVelInput Impedance Fixed Trigger Level INPut LEVel Waveform compensation«Decimal dataMAXMIN» PM6685 Send Inplev 3.75LEVAUTO INPut LEVel Auto AutotriggerSend Inplevauto OFF Send INP2LEVAUTO on Autotrigger INPutAUTO? INPut«124» SLOPe INPut2COMMonTrigger Slope This page is intentionally left blank Set up the Instrument, Perform Measurement, and Read Data Measurement Function RISETIME? Tion, @1@3@4@5@6 MEASure Measuring Function? Make one measurementParameters ,channels PM6680B/81/85 Send MEASFREQ? @3 Read 1.78112526833E+009 MEASure ARRay Measuring Function? Make an array of measurementsSend MEASARRFREQ? Ten measuring results will be returned Data Format Command MEASureMEMoryN?MEASureMEMory? Memory Recall, Measure and Fetch Result MEASure«DCYCle/PDUTycycle» Positive Duty CycleSend MEASPDUT? Read +5.097555E-001 Expected value,resolution ,@«1234567» PM6680B/81/85 MEASure FREQuency?Frequency This example measures the frequency at input C Expected value,resolution ,@«1234567» MEASure FREQuency BURSt?Burst Carrier Frequency MEASure FREQuency PRF? Pulse Repetition FrequencyExp. val.,res.,@«1234567» PM6680B/81/85 MEASure FREQuency RATio? Fall-timeFrequency Ratio Send MEASFREQRAT? @1,@3 Read 2.345625764333E+000 MEASure Volt MAXimum? MEASure Volt MINimum?Positive Peak Voltage Negative Peak Voltage MEASure NWIDth? MEASure PWIDth?Negative Pulse Width Positive Pulse Width MEASure«PDUTycycle/ DCYCle»? MEASure«NDUTycycle»?Positive duty cycle Duty Factor Negative duty cycle Duty Factor MEASure PHASe? PhaseMEASure PERiod? Period MEASure Volt PTPeak? MEASure Rise TIME?Peak-to-Peak Voltage Rise-time MEASure TINTerval? Time-Interval@«124»,@«124» MEASure TOTalize ACCumulated? Totalize X gated by Y, accumulatedTime for gate open,@«12456» ,@«12456» PM6680B PM6681 PM6680B/81/85CONFigure TOTalize CONTinuous Totalize Manually@«1246»,@«1246» Send CONFTOTINPSLOPe neg MEASure TOTalize GATed? MEASure TOTalize SSTop?Totalize X gated by Y Totalize X start/stop by Y Totalize X-Y During a Preset Time MEASure TOTalize TIMed?Time for gate open ,@«124»,@«124» Send MEASTOTTIM? 1,@1,@1 This page is intentionally left blank Related Common Commands Memory Subsystem MEMory DELete MACRo MEMory Free SENSe?Delete one Macro Memory Free for results Memory Free for Macros Memory StatesBytes available, Bytes used Number of states available This page is intentionally left blank Output Subsystem Enable Analog Out OUTPutOUTPut SCALe Scaling Factor, Analog Output Read Function Perform Measurement and Read Data Read one Result Send Conffreqinpfilt ONREAD? READARRay? Read an array of results«array size for FETChMAX» Send Armcoun 10READARR? This page is intentionally left blank Sense Command Subsystem Sense Subsystem command tree for PM6680B and PM6681 Sense Subsystem command tree for PM6685 ACQuisition APERture Set the Measurement Time«Decimal value MINMAX» Decimal value 10 ms ACQuisition Hoff ACQuisition Hoff ECOuntHold Off On/Off Hold Off, set event counter ACQuisition Hoff Mode Hold Off ModeACQuisition Hoff Time Hold Off Time ACQuisition RESolution AVERage COUNt Average Samples«Decimal dataMIN MAX» AVERage STATe FREQuency RANGe LOWerAverage or Single? High Speed Voltage Measurements FUNCtion Select Measuring FunctionFunctions and channels in PM6685 Input channels PM6685 Functions and channels in PM6680B and PM6681 Input channels PM6680B and PM6681 INTernal FORMat Internal FormatNumber of Results Buffer SDELay BURST/PRF Synchronization DelayROSCillator SOURce Select Reference Oscillator TOTalize Gate VOLTageGATedSTATeGate On/Off Gated Voltage Measurement This page is intentionally left blank Related Common Commands Status Subsystem STATus DREGister0 ENABle Enable Device Status ReportingBit No Weight Condition STATus DREGister0? STATus OPERation CONDition? Read Operation Status Condition Register STATus OPERation ENABle Enable Operation Status ReportingSend Statoperenab 288 STATusPRESet values STATusOPERation?Read Operation Status, Event Read Questionable Data/Signal Condition Register STATus QUEStionable CONDition? STATus QUEStionable ENABle Enable Questionable Data/Signal Status ReportingRead Questionable Data/Signal Event Register STATus QUEStionable? This page is intentionally left blank Related common command System Subsystem SYSTem ERRor? SYSTem COMMunicate Gpib ADDRessSet Gpib Address Send Systcommgpibaddr SYSTem PRESet PresetSignal Detection See also Default settings on Read or Send Settings SYSTem SETSYSTem Time ELAPsed? Read On-time Timeout On/Off Timeout, SetSYSTem Tout SYSTem Tout Time SYSTem UNPRotect SYSTem VERSion?Unprotect System Version Test Subsystem Select Check signal TESTCHECkTest SELect Select Self-tests Trigger Subsystem TRIGgerCOUNt No. of Triggerings on each Ext Arm startSend Trigcoun Common Commands Clear Status Command Send *CLS Define Macro Send AMPLITUDE?Read +3.46125461E-001+3.64852399E-001 Send Autofilt OFF Enable Macros Enables macro expansion and executionDecimal data PM6680B/81/85 SEND*EMC Standard Event Status Enable Event Status Enable Register 1 = enableOperation Complete Event Status Register Get Macro DefinitionMacro label PM6680B/81/85 Send *GMC? ‘AMPLITUDE?’ Identification query Learn MacroMain READAUTOFILT,AMPLITUDE? Learn Device Setup Operation CompleteSend INIT*OPC Operation Complete Query Option IdentificationExample 6 is Chapter Bus option,Prescaler option Power-on Status Clear This example enables automatic power-on clearingPurge Macros Removes all macro definitions Protected User Data Recall Reset This command removes an individual MACRo PM6680B/81/85Default settings on ‘Macro name’ is the name of the macro you want to delete Save Decimal data = a number between 1Send *SAV Service Request Enable Service Request Enable Register 1 = enable Status Byte Query ARMSTARtLAYer2IMM *WAIFETCh?Send ARMSTARTLAY2SOURCE BUS Send Initcont on Read +3.2770536E+004 Integer = PM6680B Error PM6681, PM6685 Er Ror Self TestWait-to-continue SENDMEASFREQ? *WAIMEASPDUT? Index Address AutoAuto calibration on/off· · · · · · · · · · · 9-24Average Average or Single? · · · · · · · · · · · · · Command Error CME BurstBus Calculate CONFigureTOTalizeACCumulated ARMSEQuence1LAYer1ECOunt SENSeFREQuencyRANGeLOWer STATusOPERationCONDition?STATusQUEStionableCONDition? Delay Device dependent Error DDEDevice Status Register Display Events ExecutionExternal Events before Start Arming Fail Limit · · · · · · · · · · · · · · · · · · · · · · · Hysteresis · · · · · · · · · · · · · · · · · · · · Initiated state · · · · · · · · · · · · · · · · · 6-28Input Lower Limit Measuring Monitor Operation Status Pulse QUE · · · · · · · · · · · · · · · · · 9-130 9-131QueryResponse Result Settings SetStop arming · · · · · · · · · · · · · · · · · 9-11Source Speed Test TimeTime out For measurement TIO · · · · · · · 6-24Timebase See Also Command *TRG Upper Limit

∗ESR?

PM6680B/81/85

Event Status Register

*GMC?

￿< macro label>

PM6680B/81/85

Get Macro Definition

SEND￿ *GMC? ￿ ‘AMPLITUDE?’

Gives a block data response, for instance:

9-122 Command Reference

< macro label>

SEND *GMC? ‘AMPLITUDE?’