Management and Maintenance of Programs, Gpib | Fluke PM6685, PM6681

Introduction to SCPI

Management and Maintenance of Programs

SCPI simplifies maintenance and man- agement of the programs. Today changes and additions in a good working program are hardly possible because of the great diversity in program messages and instru- ments. Programs are difficult to under- stand for anyone other than the original programmer. After some time even the programmer may be unable to understand them.

A programmer with SCPI experience, however, will understand the meaning and reasons of a SCPI program, because of his knowledge of the standard. Changes, extensions, and additions are much easier to make in an existing appli- cation program. SCPI is a step towards portability of instrument programming software and, as a consequence, it allows the exchange of instruments.

Response

Messages

Output Queue

Response

Messages

Response

Formatter

Response Data

GPIB

GPIB

Interface

Message

Exchange

Control

Instrument Functions

Program

Messages

Input Buffer

Program

Messages

Parser

Parsed

Messages

Execution

Control

Executable

Messages

Figure 3-3Overview of the firmware in a SCPI instrument.

What is SCPI? 3-3

Image 23

Fluke PM6681R, PM6685R manual Management and Maintenance of Programs, Gpib

Contents

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