GW-Basic for National Instruments PC-IIA

Programming Examples

GW-Basic for National

Instruments PC-IIA

Setting up the interface

All these programs start with a declaration containing three lines of setup information for the interface. This declaration must be merged with the programs prior to running them. The declaration is printed below, but it is also available as a file on the diskettes delivered with your interface. The file name is DECL.BAS.

20 CLEAR ,60000! : IBINIT1=60000! : IBINIT2=IBINIT1+3 : BLOAD “bib.m”,IBINIT1

30CALL IBINIT1(IBFIND,IBTRG,IBCLR,IBPCT,IBSIC,IBLOC,IBPPC,IBBNA, IBONL,IBRSC,IBSRE,IBRSV,IBPAD,IBSAD,IBIST,IBDMA,IBEOS,IBTMO,IBEO T, IBRDF,IBWRTF,IBTRAP,IBDEV,IBLN)

40CALL IBINIT2(IBGTS,IBCAC,IBWAIT,IBPOKE,IBWRT,IBWRTA,IBCMD,IBCMDA, IBRD,IBRDA,IBSTOP,IBRPP,IBRSP,IBDIAG,IBXTRC,IBRDI,IBWRTI,IBRDIA, IBWRTIA,IBSTA%,IBERR%,IBCNT%)

GW-Basic for National Instruments PC-IIA, Setting Up the Interface 4-3

Page 43

Image 43

Fluke PM6681R, PM6685R manual GW-Basic for National Instruments PC-IIA, Setting up the interface

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 Manual Conventions Syntax Specification FormMnemonic Conventions Setting the Gpib Address Setting Up InstrumentExample Language 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 Systpres or *RST These commands are from the Sense subsystemACQHOFFTIMEtime ACQAPERtime FUNCfunctionchannel,channel SAVmemory location*RCLmemory location Calcavertypemaxminsdevmean Selects statistical functionMemory location can be any No. between 0 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 Message Exchange Control protocol How does Scpi Work in the Instrument?How does Scpi Work in the Instrument? 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 Syntax of Response Messages Notation Habit in Command SyntaxResponses 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 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 Standardized Error Numbers Error ReportingDetecting Errors in the Queue Read the Error/Event Queue Device-specific Error Execution ErrorQuery 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 PRINT#1, STR$ARMDELAY, LEFT$MSG$, INSTRMSG$, CHR$10 270 WRT$ = Armdel + STR$ARMDELAY Call IBWRTCNT%, WRT$Call IBRDCNT%, MSG$ 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 File 16 ‘C’ for National Instruments PC-IIA, Frequency ProfilingOfp 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? Versatility of Measurement Com- mands CONFigure INITiateFETCh?READ? Using the Subsystems Introduction Calculate Subsystem MathematicsStatistics Limit Monitoring PM6681 PM6680B, PM6685Calibration Subsystem 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? SEND→ READ? CONFigureINITiateFETCh?Versatility of measurement com Mands Output Subsystem Scaling Factor Same exponent, opposite sign Resolution Sense Command Subsystem SwitchboxPrescaling 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 Erate SRQ Selecting Summary Message to GenIc e 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 Summary, Operation Status Operation Status GroupReporting Summary Questionable Questionable Data/SignalData/Signal Status Reporting Status Group Device-defined Status Structure Error Queue 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 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 Subsystem Rough TriggerDescription 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 Header syntax Error Code -273 toMacro label was already defined see 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 an Array of Results FETCh ARRay?«fetch array sizeMAX» 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 INPut«12» COUPling INPut«12» ATTenuationAC/DC 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? INPut2COMMon INPut«124» SLOPeTrigger Slope 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 MEASure FREQuency BURSt? Expected value,resolution ,@«1234567»Burst Carrier Frequency Pulse Repetition Frequency MEASure FREQuency PRF?Exp. val.,res.,@«1234567» PM6680B/81/85 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 Time-Interval MEASure TINTerval?@«124»,@«124» Totalize X gated by Y, accumulated MEASure TOTalize ACCumulated?Time for gate open,@«12456» ,@«12456» PM6680B PM6681 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 Average Samples AVERage COUNt«Decimal dataMIN MAX» 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 STATusOPERation? STATusPRESet valuesRead Operation Status, Event 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 No. of Triggerings on each Ext Arm start TRIGgerCOUNtSend Trigcoun 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 Event Status Enable Register 1 = enable Standard Event Status EnableOperation Complete Send *GMC? ‘AMPLITUDE?’ Event Status RegisterGet Macro Definition Macro label PM6680B/81/85 READAUTOFILT,AMPLITUDE? Identification queryLearn Macro Main Operation Complete Learn Device SetupSend INIT*OPC 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 Decimal data = a number between 1 SaveSend *SAV 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 STATusOPERationCONDition? SENSeFREQuencyRANGeLOWerSTATusQUEStionableCONDition? 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 TestTime out For measurement TIO · · · · · · · 6-24Timebase Upper Limit See Also Command *TRG