Introduction

Using the Subsystems

Although SCPI is intended to be self ex- planatory, we feel that some hints and tips on how to use the different subsys- tems may be useful. This chapter does

not explain each and every command, but only those for which we believe extra explanations are necessary.

6-2

Page 70

Image 70

Fluke PM6685R, PM6681R manual Introduction

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 Manual 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, PP0 Bus Commands for the Benchtop User INPLEVlevel Error CodeINPATT110 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 Reason for Scpi What is SCPI?What is 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? 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 Syntax of Response Messages Notation Habit in Command SyntaxResponses 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 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 Read the Error/Event Queue Error ReportingDetecting Errors in the Queue Standardized Error Numbers Device-specific Error Execution ErrorQuery 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 ‘ 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 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 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 SENSe Measurement Function BlockINPut CALCulate Other Subsystems Order of Execution MEASure? CONFigure READ?MEASurement Function MEASurement Function Versatility of Measurement Com- mands CONFigure INITiateFETCh?READ? Using the Subsystems Introduction Limit Monitoring MathematicsStatistics 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 SEND→ MEASureFREQ? CONFigure READ?MEASure? 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 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 Erate SRQ Selecting Summary Message to GenIc e 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 Summary, Operation Status Operation Status GroupReporting Status Group Questionable Data/SignalData/Signal Status Reporting 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 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 Subsystem Rough TriggerDescription 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 Header syntax Error Code -273 toMacro label was already defined see 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 an Array of Results FETCh ARRay?«fetch array sizeMAX» 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 INPut«12» COUPling INPut«12» ATTenuationAC/DC 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? 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 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 MEASure 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+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 Time-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 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 Average Samples AVERage COUNt«Decimal dataMIN MAX» 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 STATusOPERation? 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 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 No. of Triggerings on each Ext Arm start TRIGgerCOUNtSend Trigcoun 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 Event 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 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 Decimal data = a number between 1 SaveSend *SAV 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 STATusOPERationCONDition? SENSeFREQuencyRANGeLOWerSTATusQUEStionableCONDition? 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 TestTime out For measurement TIO · · · · · · · 6-24Timebase See Also Command *TRG Upper Limit