Fluke PM6685R MEASure FREQuency?, Frequency, Expected value,resolution ,@«1234567» PM6680B/81/85

Page 190

:MEASure :FREQuency?

[ [<expected value>[,<resolution>]] [,<(@«1234567»)>]]

PM6680B/81/85

Frequency

Traditional frequency measurements. The counter uses the <expected value> and <resolution> to calculate the Measurement Time (:SENSe:ACQuisition:APER- ture).

Example:

SEND :MEAS:FREQ? (@3)

READ 1.78112526833E+009

This example measures the frequency at input C.

The channel is expression data and it must be in parentheses ( ).

Parameters:

<expected value> is the expected frequency,

<resolution> is the required resolution.

<(@«134567»)> is the channel to measure on: (@1) means input A1

(@2) means input B (Only PM6680B and PM6681)

(@3) means input C (HF-input option)

(@4) means input E (Rear panel arming input)

(@5) means input A prescaled by 2

(@6) means the internal reference

@7) means input A with the variable hysteresis mode (Only PM6680B and PM6681)

If you omit the channel, the instrument measures on input A (@1).

1The A input is always prescaled by 2 when measuring Frequency A and prescaled by 1 for all other functions.

Complies to standards:

SCPI 1991.0, confirmed.

9-60 Command Reference

Image 190

Contents Timer/Counter/ Analyzers Pendulum Instruments AB Sweden Table of Contents Abort Configure FunctionDiagnostics Subsystem Arming SubsystemMemory Subsystem Sense Command SubsystemCommon Commands Output SubsystemIndex Getting Started Sections IndexManual Conventions Syntax Specification FormMnemonic Conventions Setting the Gpib Address Setting Up InstrumentExample Language Interface Functions Power-onTesting the Bus What can I do with the Bus?Remote/Local, RL1 Service Request, SR1Listener Function, L4 Parallel Poll, PP0Bus Commands for the Benchtop User INPLEVlevel Error CodeINPATT110 INP2ATT110Systpres or *RST These commands are from the Sense subsystemACQHOFFTIMEtime FUNCfunctionchannel,channel ACQAPERtimeSAVmemory 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,2This command is from the Sense subsystem OUTPSCALscaling factor SYSTCOMMGPIBADDRAddressDefault settings after *RST Default settings after *RSTIntroduction to Scpi Reason for Scpi What is SCPI?What is SCPI? CompatibilityManagement and Maintenance of Programs GpibMessage Exchange Control protocol How does Scpi Work in the Instrument?How does Scpi Work in the Instrument? Protocol Requirements Deferred CommandsSequential and Overlapped Commands Order of ExecutionRemote Local Protocol DefinitionsSyntax of Program Messages Program and Response MessagesSyntax and Style Program and Response MessagesPage Syntax of Response Messages Notation Habit in Command SyntaxResponses Example Moving down the Command TreeCommand Tree SEND→ InputfilteronBoolean Data ParametersNumeric Data KeywordsSEND→ Systtouton or SYSTTOUT1 Expression DataSummary Other Data Types #218INPIMP50SENS10Macro Names Define Macro CommandMacros Data Types within MacrosDeleting 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 Read the Error/Event Queue Error ReportingDetecting Errors in the Queue Standardized Error NumbersDevice-specific Error Execution ErrorQuery Error Bus Initialization Initialization and ResettingReset Strategy Message Exchange Initialization*RST Command *CLS CommandProgramming Examples Introduction IntroductionSetting up the interface GW-Basic for National Instruments PC-IIALimit Testing Frequency Profiling 90 ‘ 100 ‘ 110 ‘ -- Enable arming, etc180 ‘ Armdelay = 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%, Mask510 MSG$ = SPACE$255 600 ‘ Close 620 END260 ‘ -- Enter Command String and Send to Counter 130 ‘ -- SET Event Status Enable180 ‘ -- SET Service Request Enable Status ReportingLfpos 650 ‘ -- Read Error Messages410 ‘ -- Check Message Available BIT While SPR% 520 ‘ -- Check Event Status BIT330 WRT$ = Calcavertype MAX CALCIMM? Call Ibwrt CNT%, WRT$ StatisticsPrint Waiting for Measurement to GET Ready Call Ibrd CNT%, MSG$ Print Maximum = LEFT$MSG$, IBCNT%Call Ibrd CNT%, MSG$ Print Mean = LEFT$MSG$, IBCNT% Call Ibrd CNT%, MSG$ Print Minimum = LEFT$MSG$, IBCNT%470 WRT$ = Calcavertype Mean CALCIMM? Call Ibwrt CNT%, WRT$ 540 WRT$ = Calcavertype Sdev CALCIMM? Call Ibwrt CNT%, WRT$‘C’ for National Instruments ‘C’ for National Instruments PC-IIA14 ‘C’ for National Instruments PC-IIA, Limit Testing Real Data Format ‘C’ for National Instruments PC-IIA, Real Data FormatFile 16 ‘C’ for National Instruments PC-IIA, Frequency ProfilingOfp 17 ‘C’ for National Instruments PC-IIA, Frequency Profiling Capture Profile18 ‘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 blankInstrument Model Function Instrument Examples Type SENSe Measurement Function BlockINPut CALCulateOther Subsystems Order of ExecutionMEASure? CONFigure READ?MEASurement Function MEASurement FunctionVersatility of Measurement Com- mands CONFigure INITiateFETCh?READ? Using the Subsystems Introduction Limit Monitoring MathematicsStatistics Calculate SubsystemPM6681 PM6680B, PM6685Calibration Subsystem Configure Function Configure FunctionTime Stamp Readout Format Format SubsystemPM6685 Input Subsystems2Summary of PM6680B / PM6681 input amplifier settings PM6680B/PM6681SEND→ MEASureFREQ? CONFigure READ?MEASure? SEND→ MEASureFREQ?20MHz,1SEND→ READ? CONFigureINITiateFETCh?Versatility of measurement com Mands Scaling Factor Output SubsystemResolution Same exponent, opposite signSense Command Subsystem SwitchboxPrescaling Status Structure Using the RegistersStatus Reporting Model Status Subsystem7654 3210 Status of the Error Message Queue EAV Clearing/Setting all bitsUsing the Queues Using the Status ByteErate SRQ Selecting Summary Message to GenIc e Status Byte Setting up the Counter to Report StatusReading and Clearing Status Status Event RegistersStatus Condition Registers Why Two Types of Registers?Set up Check & ActionA t u s B y t e Standard Status RegistersG ic a G i s t e rStandard Event Status Register Summary, Standard Event Status ReportingSCPI-defined Status Registers Summary, Operation Status Operation Status GroupReporting Status Group Questionable Data/SignalData/Signal Status Reporting Summary QuestionableError Queue Device-defined Status StructurePreset 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 Triggering TRG Trigger CommandWhen to use *TRG and GET Backward Traversing an Event-detection LayerE 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 mHow to Measure Fast Start Controller SynchronizationMeasurement Cycle Synchronization StopSubsystem Rough TriggerDescription Some Basic Commands Data Format CommandMEASFREQ? MEASMEM1? MEASMEM?1 RCL 1READ?Basic Measurement Method Individually Synchronized MeasurementsInitcont and GET ARMSTARTLAY2SOURceBUSREADARRay? General Speed ImprovementsBlock Synchronized Measurements Init + GET + FETCHARRay?Gpib Data Format Time Measurement ResolutionDisplay Control Automatic Interpolator Calibration PM6680B/85Block Measurements MeasureMents/second Real Time CalculationOptimal Method Supervising a ProcessObvious Method Supervising a ProcessDead Time Between Measurements Including Speed SummarySpeed Summary Transfer to Controller Ascii Data Format Real Data FormatE e d D i v i d u a l l y s y n c . m e a s Dead Time Between Measurements Block Synchronized MeasurementsSpeed Improvement Actions PM6680B PM6681 PM6685Calculating the Measurement SpeedTimesaving Com Time Gain in ms Sacrifice Mands FreqSingle Speed Switch Command for PM6680B/85 Single Speed Switch Command for PM6681Error Messages SEND→ SYSTemERRor? READ← -100, Command Error Read the Error/Event QueueError Code 0 to Command ErrorsError Code -105 to -120 Detect a more specific error Error Code -121 toMore specific error Ular error message is used when the counter cannotError Code -151 to -170 Error Code -171 to Error Code -200 to -221 Error message is used when the counter cannot de Error Code -222 toExecution errors Tect the more specific errors described for errorsError 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 errorsUnsupported auto Command Error Code 1100 to -1139Unsupported enu Merated command Unsupported single Shot commandOutput Read, but the waiting was broken by the operator Error Code 1150 toReset during bus Some PC controller cards has been known to doError Code 1214 to -1240 Parser error Generic error in the parserThis page is intentionally left blank Command Reference Command Reference Abort PM6680B/81/85 ABORtAbort Measurement Aborts all previous measurements if *WAI is not usedArming Subsystem «Numeric valueMINMAX» PM6680B/81/85 ARM COUNtNo. of Measurements on each Bus arm Send ARMCOUN100ARM ECOunt ARM DELayDelay after External Start Arming External Events before Start ArmingBus Arming Override ARM LAYer2ARM LAYer2 SOURce Bus Arming On/OffExternal Arming Start Slope ARM SLOPeARM SOURce External Arming Start SourceARM Stop ECOunt ARM Stop DELayDelay after External Stop Arming External Events before Stop ArmingExternal Stop Arming Slope ARM Stop SLOPeARM Stop SOURce External Stop Arming SourceThis page is intentionally left blank Calculate Subsystem CALCulate AVERage STATe Enable StatisticsCALCulate AVERage COUNt Sample Size for StatisticsFetch calculated data CALCulate AVERage TypeStatistical Type Send Calcmathstat Oncalcmath X 10.7E6INIT *OPCCALCulate LIMit Enable Monitoring of Parameter LimitsCALCulate IMMediate Recalculate DataLimit Fail CALCulate LIMit FAIL?CALCulate LIMit LOWer Set Low LimitCALCulate LIMit UPPer Set Upper LimitCALCulate LIMit LOWer STATe Check Against Lower LimitCALCulate LIMit UPPer STATe Check Against Upper LimitExpression CALCulate MathSelect Mathematical Expression Sendcalcmath X 10.7E6MATHSTATE ONREAD?CALCulate Math STATe Enable MathematicsThis example switches on mathematics No calculationCALCulate STATe Enable CalculationSwitches on Post Processing Send CalcstatCalibration Subsystem Calibration of Interpolator ‘How to Measure Fast’CALibration INTerpolator Auto Boolean OnceConfigure Function Set up Instrument for MeasurementParameters,channels CONFigure Measuring FunctionConfigure the counter for a single measurement Send CONFFREQRAT@3,@1Send Confarrper 7,5E-3,1E-6,@4 CONFigure ARRay Measuring FunctionConfigure the counter for an array of measurements Send READARR?This page is intentionally left blank Diagnostics Subsystem Send Diagcalinphyst Once DIAGnosticCALibrationINPut12HYSTeresisInput comparator hysteresis calibration This string calibrates both input a and input BDisplay Subsystem See also , ‘How to Measure Fast’ DISPlay ENABleWhere Boolean = 1 / on 0 / OFF Display StateFetch Function FETCh? Fetch One ResultFetch an Array of Results FETCh ARRay?«fetch array sizeMAX» Returned format data,data Format Subsystem FORMat Response Data TypeResponse Data Format FORMat FIXedFORMat SREGister Data Type for Status MessagesFORMat TINFormation Timestamping On/Off TimestampingOn/OffInitiate Subsystem Initiate Measurement INITiateINITiate CONTinuous Continuously InitiatedInput Subsystems Input B Not PM6685INPut«12» COUPling INPut«12» ATTenuationAC/DC Coupling Low Pass Filter INPut FILTerINPut HYSTeresis Sensitivity«BooleanONCE» INPut HYSTeresis AutoAuto Sensitivity Send Inphystauto OFFInput Impedance INPut«12» IMPedanceINPut«12» LEVel Fixed Trigger Level«Decimal dataMAXMIN» PM6685 INPut LEVelWaveform compensation Send Inplev 3.75LEVAUTOSend Inplevauto OFF INPut LEVel AutoAutotrigger Send INP2LEVAUTO onAutotrigger INPutAUTO? INPut2COMMon INPut«124» SLOPeTrigger Slope This page is intentionally left blank Set up the Instrument, Perform Measurement, and Read Data Measurement FunctionRISETIME? Tion, @1@3@4@5@6 Parameters ,channels PM6680B/81/85 MEASure Measuring Function?Make one measurement Send MEASFREQ? @3 Read 1.78112526833E+009Send MEASARRFREQ? MEASure ARRay Measuring Function?Make an array of measurements Ten measuring results will be returnedMEASureMEMory? Data Format CommandMEASureMEMoryN? Memory Recall, Measure and Fetch ResultSend MEASPDUT? MEASure«DCYCle/PDUTycycle»Positive Duty Cycle Read +5.097555E-001Frequency Expected value,resolution ,@«1234567» PM6680B/81/85MEASure FREQuency? This example measures the frequency at input CMEASure FREQuency BURSt? Expected value,resolution ,@«1234567»Burst Carrier Frequency Pulse Repetition Frequency MEASure FREQuency PRF?Exp. val.,res.,@«1234567» PM6680B/81/85 Frequency Ratio MEASure FREQuency RATio?Fall-time Send MEASFREQRAT? @1,@3 Read 2.345625764333E+000Positive Peak Voltage MEASure Volt MAXimum?MEASure Volt MINimum? Negative Peak VoltageNegative Pulse Width MEASure NWIDth?MEASure PWIDth? Positive Pulse WidthPositive duty cycle Duty Factor MEASure«PDUTycycle/ DCYCle»?MEASure«NDUTycycle»? Negative duty cycle Duty FactorMEASure PERiod? MEASure PHASe?Phase PeriodPeak-to-Peak Voltage MEASure Volt PTPeak?MEASure Rise TIME? Rise-timeTime-Interval MEASure TINTerval?@«124»,@«124» Totalize X gated by Y, accumulated MEASure TOTalize ACCumulated?Time for gate open,@«12456» ,@«12456» PM6680B PM6681 @«1246»,@«1246» PM6680B/81/85CONFigure TOTalize CONTinuousTotalize Manually Send CONFTOTINPSLOPe negTotalize X gated by Y MEASure TOTalize GATed?MEASure TOTalize SSTop? Totalize X start/stop by YTime for gate open ,@«124»,@«124» Totalize X-Y During a Preset TimeMEASure TOTalize TIMed? Send MEASTOTTIM? 1,@1,@1This page is intentionally left blank Related Common Commands Memory SubsystemDelete one Macro MEMory DELete MACRoMEMory Free SENSe? Memory Free for resultsBytes available, Bytes used Memory Free for MacrosMemory States Number of states availableThis page is intentionally left blank Output Subsystem OUTPut SCALe Enable Analog OutOUTPut Scaling Factor, Analog OutputRead Function Perform Measurement and Read DataRead one Result Send Conffreqinpfilt ONREAD?«array size for FETChMAX» READARRay?Read an array of results Send Armcoun 10READARR?This page is intentionally left blank Sense Command Subsystem Sense Subsystem command tree for PM6680B and PM6681Sense Subsystem command tree for PM6685 «Decimal value MINMAX» ACQuisition APERtureSet the Measurement Time Decimal value 10 msHold Off On/Off ACQuisition HoffACQuisition Hoff ECOunt Hold Off, set event counterACQuisition Hoff Time ACQuisition Hoff ModeHold Off Mode Hold Off TimeACQuisition RESolution Average Samples AVERage COUNt«Decimal dataMIN MAX» Average or Single? AVERage STATeFREQuency RANGe LOWer High Speed Voltage MeasurementsFunctions and channels in PM6685 FUNCtionSelect Measuring Function Input channels PM6685Functions and channels in PM6680B and PM6681 Input channels PM6680B and PM6681Number of Results INTernal FORMatInternal Format BufferROSCillator SOURce SDELayBURST/PRF Synchronization Delay Select Reference OscillatorGate On/Off TOTalize GateVOLTageGATedSTATe Gated Voltage MeasurementThis page is intentionally left blank Related Common Commands Status SubsystemBit No Weight Condition STATus DREGister0 ENABleEnable Device Status Reporting STATus DREGister0?STATus OPERation CONDition? Read Operation Status Condition RegisterSend Statoperenab STATus OPERation ENABleEnable Operation Status Reporting 288STATusOPERation? STATusPRESet valuesRead Operation Status, Event Read Questionable Data/Signal Condition Register STATus QUEStionable CONDition?Read Questionable Data/Signal Event Register STATus QUEStionable ENABleEnable Questionable Data/Signal Status Reporting STATus QUEStionable?This page is intentionally left blank Related common command System SubsystemSet Gpib Address SYSTem ERRor?SYSTem COMMunicate Gpib ADDRess Send SystcommgpibaddrSignal Detection SYSTem PRESetPreset See also Default settings onSYSTem Time ELAPsed? Read or Send SettingsSYSTem SET Read On-timeSYSTem Tout Timeout On/OffTimeout, Set SYSTem Tout TimeUnprotect SYSTem UNPRotectSYSTem VERSion? System VersionTest Subsystem Test SELect Select Check signalTESTCHECk Select Self-testsTrigger Subsystem No. of Triggerings on each Ext Arm start TRIGgerCOUNtSend Trigcoun Common Commands Clear Status Command Send *CLSRead +3.46125461E-001+3.64852399E-001 Define MacroSend AMPLITUDE? Send Autofilt OFFDecimal data PM6680B/81/85 Enable MacrosEnables macro expansion and execution SEND*EMCEvent Status Enable Register 1 = enable Standard Event Status EnableOperation Complete Macro label PM6680B/81/85 Event Status RegisterGet Macro Definition Send *GMC? ‘AMPLITUDE?’Main Identification queryLearn Macro READAUTOFILT,AMPLITUDE?Operation Complete Learn Device SetupSend INIT*OPC Example 6 is Chapter Operation Complete QueryOption Identification Bus option,Prescaler optionPurge Macros Power-on Status ClearThis example enables automatic power-on clearing Removes all macro definitionsProtected User Data RecallDefault settings on ResetThis command removes an individual MACRo PM6680B/81/85 ‘Macro name’ is the name of the macro you want to deleteDecimal data = a number between 1 SaveSend *SAV Service Request Enable Service Request Enable Register 1 = enableSend ARMSTARTLAY2SOURCE BUS Send Initcont on Status Byte QueryARMSTARtLAYer2IMM *WAIFETCh? Read +3.2770536E+004Wait-to-continue Integer = PM6680B Error PM6681, PM6685 Er RorSelf Test SENDMEASFREQ? *WAIMEASPDUT?Index Auto calibration on/off· · · · · · · · · · · 9-24Average AddressAuto Average or Single? · · · · · · · · · · · · ·Bus Command Error CMEBurst CalculateCONFigureTOTalizeACCumulated ARMSEQuence1LAYer1ECOuntSTATusOPERationCONDition? SENSeFREQuencyRANGeLOWerSTATusQUEStionableCONDition? Device Status Register DelayDevice dependent Error DDE DisplayExternal Events before Start Arming EventsExecution Fail Limit · · · · · · · · · · · · · · · · · · · · · · ·Hysteresis · · · · · · · · · · · · · · · · · · · · Initiated state · · · · · · · · · · · · · · · · · 6-28InputLower Limit MeasuringMonitor Operation StatusResponse PulseQUE · · · · · · · · · · · · · · · · · 9-130 9-131Query ResultStop arming · · · · · · · · · · · · · · · · · 9-11Source SettingsSet SpeedTime TestTime out For measurement TIO · · · · · · · 6-24Timebase See Also Command *TRG Upper Limit