22 ‘C’ for National Instruments PC-IIA | Fluke PM6685R, PM6681R

Programming Examples

This side is intentionally left blank.

4-22 ‘C’ for National Instruments PC-IIA

Image 62

Fluke PM6685R, PM6681R manual 22 ‘C’ for National Instruments PC-IIA, This side is intentionally left blank

Contents

Timer/Counter/ Analyzers Pendulum Instruments AB Sweden Table of Contents Abort Configure FunctionDiagnostics Subsystem Arming Subsystem Memory Subsystem Sense Command SubsystemCommon Commands Output Subsystem Index Getting Started Sections Index Mnemonic Conventions Syntax Specification FormManual Conventions Example Language Setting Up InstrumentSetting the Gpib Address Interface Functions Power-onTesting the Bus What can I do with the Bus? Remote/Local, RL1 Service Request, SR1Listener Function, L4 Parallel Poll, PP0 Bus Commands for the Benchtop User INPLEVlevel Error CodeINPATT110 INP2ATT110 ACQHOFFTIMEtime These commands are from the Sense subsystemSystpres or *RST FUNCfunctionchannel,channel ACQAPERtime Memory location can be any No. between 0 Calcavertypemaxminsdevmean Selects statistical functionSAVmemory location*RCLmemory location 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 Reason for Scpi What is SCPI?What is SCPI? Compatibility Management and Maintenance of Programs Gpib How does Scpi Work in the Instrument? How does Scpi Work in the Instrument?Message Exchange Control protocol Protocol Requirements Deferred CommandsSequential and Overlapped Commands Order of Execution Remote Local Protocol Definitions Syntax of Program Messages Program and Response MessagesSyntax and Style Program and Response MessagesPage Responses Notation Habit in Command SyntaxSyntax of Response Messages Example Moving down the Command TreeCommand Tree SEND→ Inputfilteron Boolean Data ParametersNumeric Data Keywords SEND→ Systtouton or SYSTTOUT1 Expression DataSummary Other Data Types #218INPIMP50SENS10 Macro Names Define Macro CommandMacros Data Types within Macros Enabling and Disabling Macros How to Execute a MacroDeleting Macros LMC? Learn Macro Query GMC? Get Macro Contents QueryRetrieve a Macro Status Reporting System Status Reporting SystemIntroduction Read the Error/Event Queue Error ReportingDetecting Errors in the Queue Standardized Error Numbers Query Error Execution ErrorDevice-specific Error Bus Initialization Initialization and ResettingReset Strategy Message Exchange Initialization *RST Command *CLS Command Programming Examples Introduction Introduction Setting up the interface GW-Basic for National Instruments PC-IIA Limit Testing Frequency Profiling 90 ‘ 100 ‘ 110 ‘ -- Enable arming, etc180 ‘ Armdelay = 50 ‘ Call IBRDCNT%, MSG$ 270 WRT$ = Armdel + STR$ARMDELAY Call IBWRTCNT%, WRT$PRINT#1, STR$ARMDELAY, LEFT$MSG$, INSTRMSG$, CHR$10 Fast Sampling Call Ibwait CNT%, Mask 510 MSG$ = SPACE$255 600 ‘ Close 620 END 260 ‘ -- Enter Command String and Send to Counter 130 ‘ -- SET Event Status Enable180 ‘ -- SET Service Request Enable Status Reporting Lfpos 650 ‘ -- Read Error Messages410 ‘ -- Check Message Available BIT While SPR% 520 ‘ -- Check Event Status BIT 330 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-IIA 14 ‘C’ for National Instruments PC-IIA, Limit Testing Real Data Format ‘C’ for National Instruments PC-IIA, Real Data Format Ofp 16 ‘C’ for National Instruments PC-IIA, Frequency ProfilingFile 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 SENSe Measurement Function BlockINPut CALCulate Other Subsystems Order of Execution MEASure? CONFigure READ?MEASurement Function MEASurement Function READ? CONFigure INITiateFETCh?Versatility of Measurement Com- mands Using the Subsystems Introduction Limit Monitoring MathematicsStatistics Calculate Subsystem Calibration Subsystem PM6680B, PM6685PM6681 Configure Function Configure Function Time Stamp Readout Format Format Subsystem PM6685 Input Subsystems 2Summary of PM6680B / PM6681 input amplifier settings PM6680B/PM6681 SEND→ MEASureFREQ? CONFigure READ?MEASure? SEND→ MEASureFREQ?20MHz,1 Versatility of measurement com Mands CONFigureINITiateFETCh?SEND→ READ? Scaling Factor Output Subsystem Resolution Same exponent, opposite sign Prescaling SwitchboxSense Command Subsystem Status Structure Using the RegistersStatus Reporting Model Status Subsystem 7654 3210 Status of the Error Message Queue EAV Clearing/Setting all bitsUsing the Queues Using the Status Byte Ic e Selecting Summary Message to GenErate SRQ Status Byte Setting up the Counter to Report StatusReading and Clearing Status Status Event Registers Status Condition Registers Why Two Types of Registers?Set up Check & Action A t u s B y t e Standard Status RegistersG ic a G i s t e r Standard Event Status Register Summary, Standard Event Status Reporting SCPI-defined Status Registers Reporting Operation Status GroupSummary, Operation Status Status Group Questionable Data/SignalData/Signal Status Reporting Summary Questionable Error Queue Device-defined Status Structure Summary, Device-defined Status Reporting Power-on Status ClearPreset the Status Reporting Structure Trigger/Arming Subsystem ARM-TRIG Trigger ConfigurationInstrument Action Forward Traversing an Event-detection Layer Structure of the Idle and Initiated StatesStructure of an Event-detection Layer Triggering TRG Trigger CommandWhen to use *TRG and GET 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 Start Controller SynchronizationMeasurement Cycle Synchronization Stop Description Rough TriggerSubsystem Some Basic Commands Data Format CommandMEASFREQ? MEASMEM1? MEASMEM?1 RCL 1READ? Basic Measurement Method Individually Synchronized MeasurementsInitcont and GET ARMSTARTLAY2SOURceBUS READARRay? General Speed ImprovementsBlock Synchronized Measurements Init + GET + FETCHARRay? Gpib Data Format Time Measurement ResolutionDisplay Control Automatic Interpolator Calibration PM6680B/85 Block Measurements MeasureMents/second Real Time Calculation Optimal Method Supervising a ProcessObvious Method Supervising a Process Dead Time Between Measurements Including Speed SummarySpeed Summary 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 Dead Time Between Measurements Block Synchronized MeasurementsSpeed Improvement Actions 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 SEND→ SYSTemERRor? READ← -100, Command Error Read the Error/Event QueueError Code 0 to Command Errors Error Code -105 to -120 Detect a more specific error Error Code -121 toMore 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 message is used when the counter cannot de Error Code -222 toExecution errors Tect the more specific errors described for errors Error Code -241 to -272 Macro label was already defined see Error Code -273 toHeader syntax Error Code -300 to -350 Error Code -400 to Query errors Unsupported auto Command Error Code 1100 to -1139Unsupported enu Merated command Unsupported single Shot command Output Read, but the waiting was broken by the operator Error Code 1150 toReset during bus 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 PM6680B/81/85 ABORtAbort Measurement Aborts all previous measurements if *WAI is not used Arming Subsystem «Numeric valueMINMAX» PM6680B/81/85 ARM COUNtNo. of Measurements on each Bus arm Send ARMCOUN100 ARM ECOunt ARM DELayDelay after External Start Arming External Events before Start Arming Bus Arming Override ARM LAYer2ARM LAYer2 SOURce Bus Arming On/Off External Arming Start Slope ARM SLOPeARM SOURce External Arming Start Source ARM Stop ECOunt ARM Stop DELayDelay after External Stop Arming External Events before Stop Arming External Stop Arming Slope ARM Stop SLOPeARM Stop SOURce External Stop Arming Source This page is intentionally left blank Calculate Subsystem CALCulate AVERage STATe Enable StatisticsCALCulate AVERage COUNt Sample Size for Statistics Fetch calculated data CALCulate AVERage TypeStatistical Type Send Calcmathstat Oncalcmath X 10.7E6INIT *OPC CALCulate LIMit Enable Monitoring of Parameter LimitsCALCulate IMMediate Recalculate Data Limit Fail CALCulate LIMit FAIL?CALCulate LIMit LOWer Set Low Limit CALCulate LIMit UPPer Set Upper LimitCALCulate LIMit LOWer STATe Check Against Lower Limit CALCulate LIMit UPPer STATe Check Against Upper Limit Expression CALCulate MathSelect Mathematical Expression Sendcalcmath X 10.7E6MATHSTATE ONREAD? CALCulate Math STATe Enable MathematicsThis example switches on mathematics No calculation CALCulate STATe Enable CalculationSwitches on Post Processing Send Calcstat Calibration Subsystem Calibration of Interpolator ‘How to Measure Fast’CALibration INTerpolator Auto Boolean Once Configure Function Set up Instrument for Measurement Parameters,channels CONFigure Measuring FunctionConfigure the counter for a single measurement Send CONFFREQRAT@3,@1 Send 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 B Display Subsystem See also , ‘How to Measure Fast’ DISPlay ENABleWhere Boolean = 1 / on 0 / OFF Display State Fetch Function FETCh? Fetch One Result «fetch array sizeMAX» FETCh ARRay?Fetch an Array of Results Returned format data,data Format Subsystem FORMat Response Data Type Response Data Format FORMat FIXedFORMat SREGister Data Type for Status Messages FORMat TINFormation Timestamping On/Off TimestampingOn/Off Initiate Subsystem Initiate Measurement INITiateINITiate CONTinuous Continuously Initiated Input Subsystems Input B Not PM6685 AC/DC Coupling INPut«12» ATTenuationINPut«12» COUPling Low Pass Filter INPut FILTerINPut HYSTeresis Sensitivity «BooleanONCE» INPut HYSTeresis AutoAuto Sensitivity Send Inphystauto OFF Input Impedance INPut«12» IMPedanceINPut«12» LEVel Fixed Trigger Level «Decimal dataMAXMIN» PM6685 INPut LEVelWaveform compensation Send Inplev 3.75LEVAUTO Send Inplevauto OFF INPut LEVel AutoAutotrigger Send INP2LEVAUTO on Autotrigger INPutAUTO? Trigger Slope INPut«124» SLOPeINPut2COMMon This page is intentionally left blank Set up the Instrument, Perform Measurement, and Read Data Measurement Function RISETIME? Tion, @1@3@4@5@6 Parameters ,channels PM6680B/81/85 MEASure Measuring Function?Make one measurement Send MEASFREQ? @3 Read 1.78112526833E+009 Send MEASARRFREQ? MEASure ARRay Measuring Function?Make an array of measurements Ten measuring results will be returned MEASureMEMory? Data Format CommandMEASureMEMoryN? Memory Recall, Measure and Fetch Result Send MEASPDUT? MEASure«DCYCle/PDUTycycle»Positive Duty Cycle Read +5.097555E-001 Frequency Expected value,resolution ,@«1234567» PM6680B/81/85MEASure FREQuency? This example measures the frequency at input C Burst Carrier Frequency Expected value,resolution ,@«1234567»MEASure FREQuency BURSt? Exp. val.,res.,@«1234567» PM6680B/81/85 MEASure FREQuency PRF?Pulse Repetition Frequency Frequency Ratio MEASure FREQuency RATio?Fall-time Send MEASFREQRAT? @1,@3 Read 2.345625764333E+000 Positive Peak Voltage MEASure Volt MAXimum?MEASure Volt MINimum? Negative Peak Voltage Negative Pulse Width MEASure NWIDth?MEASure PWIDth? Positive Pulse Width Positive duty cycle Duty Factor MEASure«PDUTycycle/ DCYCle»?MEASure«NDUTycycle»? Negative duty cycle Duty Factor MEASure PERiod? MEASure PHASe?Phase Period Peak-to-Peak Voltage MEASure Volt PTPeak?MEASure Rise TIME? Rise-time @«124»,@«124» MEASure TINTerval?Time-Interval Time for gate open,@«12456» ,@«12456» PM6680B PM6681 MEASure TOTalize ACCumulated?Totalize X gated by Y, accumulated @«1246»,@«1246» PM6680B/81/85CONFigure TOTalize CONTinuousTotalize Manually Send CONFTOTINPSLOPe neg Totalize X gated by Y MEASure TOTalize GATed?MEASure TOTalize SSTop? Totalize X start/stop by Y Time for gate open ,@«124»,@«124» Totalize X-Y During a Preset TimeMEASure TOTalize TIMed? Send MEASTOTTIM? 1,@1,@1 This page is intentionally left blank Related Common Commands Memory Subsystem Delete one Macro MEMory DELete MACRoMEMory Free SENSe? Memory Free for results Bytes available, Bytes used Memory Free for MacrosMemory States Number of states available This page is intentionally left blank Output Subsystem OUTPut SCALe Enable Analog OutOUTPut Scaling Factor, Analog Output Read Function Perform Measurement and Read Data Read 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 PM6681 Sense Subsystem command tree for PM6685 «Decimal value MINMAX» ACQuisition APERtureSet the Measurement Time Decimal value 10 ms Hold Off On/Off ACQuisition HoffACQuisition Hoff ECOunt Hold Off, set event counter ACQuisition Hoff Time ACQuisition Hoff ModeHold Off Mode Hold Off Time ACQuisition RESolution «Decimal dataMIN MAX» AVERage COUNtAverage Samples Average or Single? AVERage STATeFREQuency RANGe LOWer High Speed Voltage Measurements Functions and channels in PM6685 FUNCtionSelect Measuring Function Input channels PM6685 Functions and channels in PM6680B and PM6681 Input channels PM6680B and PM6681 Number of Results INTernal FORMatInternal Format Buffer ROSCillator SOURce SDELayBURST/PRF Synchronization Delay Select Reference Oscillator Gate On/Off TOTalize GateVOLTageGATedSTATe Gated Voltage Measurement This page is intentionally left blank Related Common Commands Status Subsystem Bit No Weight Condition STATus DREGister0 ENABleEnable Device Status Reporting STATus DREGister0? STATus OPERation CONDition? Read Operation Status Condition Register Send Statoperenab STATus OPERation ENABleEnable Operation Status Reporting 288 Read Operation Status, Event STATusPRESet valuesSTATusOPERation? 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 Subsystem Set Gpib Address SYSTem ERRor?SYSTem COMMunicate Gpib ADDRess Send Systcommgpibaddr Signal Detection SYSTem PRESetPreset See also Default settings on SYSTem Time ELAPsed? Read or Send SettingsSYSTem SET Read On-time SYSTem Tout Timeout On/OffTimeout, Set SYSTem Tout Time Unprotect SYSTem UNPRotectSYSTem VERSion? System Version Test Subsystem Test SELect Select Check signalTESTCHECk Select Self-tests Trigger Subsystem Send Trigcoun TRIGgerCOUNtNo. of Triggerings on each Ext Arm start Common Commands Clear Status Command Send *CLS Read +3.46125461E-001+3.64852399E-001 Define MacroSend AMPLITUDE? Send Autofilt OFF Decimal data PM6680B/81/85 Enable MacrosEnables macro expansion and execution SEND*EMC Operation Complete Standard Event Status EnableEvent Status Enable Register 1 = enable Macro label PM6680B/81/85 Event Status RegisterGet Macro Definition Send *GMC? ‘AMPLITUDE?’ Main Identification queryLearn Macro READAUTOFILT,AMPLITUDE? Send INIT*OPC Learn Device SetupOperation Complete Example 6 is Chapter Operation Complete QueryOption Identification Bus option,Prescaler option Purge Macros Power-on Status ClearThis example enables automatic power-on clearing Removes all macro definitions Protected User Data Recall Default settings on ResetThis command removes an individual MACRo PM6680B/81/85 ‘Macro name’ is the name of the macro you want to delete Send *SAV SaveDecimal data = a number between 1 Service Request Enable Service Request Enable Register 1 = enable Send ARMSTARTLAY2SOURCE BUS Send Initcont on Status Byte QueryARMSTARtLAYer2IMM *WAIFETCh? Read +3.2770536E+004 Wait-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 Calculate CONFigureTOTalizeACCumulated ARMSEQuence1LAYer1ECOunt STATusQUEStionableCONDition? SENSeFREQuencyRANGeLOWerSTATusOPERationCONDition? Device Status Register DelayDevice dependent Error DDE Display External Events before Start Arming EventsExecution Fail Limit · · · · · · · · · · · · · · · · · · · · · · · Hysteresis · · · · · · · · · · · · · · · · · · · · Initiated state · · · · · · · · · · · · · · · · · 6-28Input Lower Limit Measuring Monitor Operation Status Response PulseQUE · · · · · · · · · · · · · · · · · 9-130 9-131Query Result Stop arming · · · · · · · · · · · · · · · · · 9-11Source SettingsSet Speed Time out For measurement TIO · · · · · · · 6-24Timebase TestTime See Also Command *TRG Upper Limit