This page is intentionally left blank | Fluke PM6681R, PM6685R

This page is intentionally left blank.

9-78 Command Reference

Image 208

Fluke PM6681R, PM6685R manual This page is intentionally left blank

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 Manual Conventions Syntax Specification FormMnemonic Conventions Setting the Gpib Address Setting Up InstrumentExample 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 Systpres or *RST These commands are from the Sense subsystemACQHOFFTIMEtime FUNCfunctionchannel,channel ACQAPERtime SAVmemory location*RCLmemory location Calcavertypemaxminsdevmean Selects statistical functionMemory 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 Message Exchange Control protocol How does Scpi Work in the Instrument?How 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 Syntax of Response Messages Notation Habit in Command SyntaxResponses 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 Deleting Macros How to Execute a MacroEnabling and Disabling Macros Retrieve a Macro GMC? Get Macro Contents QueryLMC? Learn Macro Query Introduction Status Reporting SystemStatus Reporting System Error Reporting Detecting Errors in the QueueRead the Error/Event Queue Standardized Error Numbers Device-specific Error Execution 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 ‘ PRINT#1, STR$ARMDELAY, LEFT$MSG$, INSTRMSG$, CHR$10 270 WRT$ = Armdel + STR$ARMDELAY Call IBWRTCNT%, WRT$Call 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 File 16 ‘C’ for National Instruments PC-IIA, Frequency ProfilingOfp 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 Versatility of Measurement Com- mands CONFigure INITiateFETCh?READ? Using the Subsystems Introduction Mathematics StatisticsLimit Monitoring Calculate Subsystem PM6681 PM6680B, PM6685Calibration 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 SEND→ READ? CONFigureINITiateFETCh?Versatility of measurement com Mands Scaling Factor Output Subsystem Resolution Same exponent, opposite sign Sense Command Subsystem SwitchboxPrescaling 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 Erate SRQ Selecting Summary Message to GenIc 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 Summary, Operation Status Operation Status GroupReporting Questionable Data/Signal Data/Signal Status ReportingStatus Group Summary Questionable Error Queue Device-defined Status Structure Preset the Status Reporting Structure Power-on Status ClearSummary, Device-defined Status Reporting Instrument Action ARM-TRIG Trigger ConfigurationTrigger/Arming Subsystem Structure of an Event-detection Layer Structure of the Idle and Initiated StatesForward 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 Subsystem Rough TriggerDescription 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 Header syntax Error Code -273 toMacro 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 an Array of Results FETCh ARRay?«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» COUPling INPut«12» ATTenuationAC/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? INPut2COMMon INPut«124» SLOPeTrigger 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 MEASure FREQuency BURSt? Expected value,resolution ,@«1234567»Burst Carrier Frequency Pulse Repetition Frequency MEASure FREQuency PRF?Exp. 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 Time-Interval MEASure TINTerval?@«124»,@«124» Totalize X gated by Y, accumulated MEASure TOTalize ACCumulated?Time 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 Samples AVERage COUNt«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 STATusOPERation? STATusPRESet valuesRead 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 No. of Triggerings on each Ext Arm start TRIGgerCOUNtSend 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 Event Status Enable Register 1 = enable Standard Event Status EnableOperation Complete Event Status Register Get Macro DefinitionMacro label PM6680B/81/85 Send *GMC? ‘AMPLITUDE?’ Identification query Learn MacroMain READAUTOFILT,AMPLITUDE? Operation Complete Learn Device SetupSend 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 Decimal data = a number between 1 SaveSend *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 STATusOPERationCONDition? SENSeFREQuencyRANGeLOWerSTATusQUEStionableCONDition? 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 Time TestTime out For measurement TIO · · · · · · · 6-24Timebase See Also Command *TRG Upper Limit