What this Manual Contains, About this Manual | Fluke PM-3394B

ABOUT THIS MANUAL

1 - 1

1 ABOUT THIS MANUAL

The SCPI Programming Manual for the CombiScope™ instruments describes how to program your CombiScope™ instrument via the IEEE bus using SCPI commands.

1.1 What this Manual Contains

A complete table of contents is given at the beginning of the manual.

Chapter 1 ABOUT THIS MANUAL

Explains what the SCPI programming manual for the CombiScopes instruments contains.

Chapter 2 GETTING STARTED WITH SCPI PROGRAMMING

Tells you how to get started quickly with your CombiScope instrument. You can execute the program examples per (sub)section or from the beginning until the end.

Chapter 3 USING THE COMBISCOPE INSTRUMENTS

Explains how SCPI works for your CombiScope instrument from the functional point of view. Section 3.1 is an introduction and section 3.2 explains the fundamental programming concepts. The other sections and subsections represent the functional use of your CombiScope instrument.

Chapter 4 COMMAND REFERENCE

Is a complete alphabetical reference of all implemented SCPI commands. In the beginning a command summary is given to provide you with a quick reference.

Image 8

Fluke PM-3394B, PM-3380B, PM-3390B, PM-3370B, PM-3384B user manual What this Manual Contains, About this Manual

Contents

Qvwuxphqw Trademarks Initializing the CombiScope Instrument IIIAbout this Manual What this Manual Contains Measuring Signal Characteristics 15.4.2 Error-reporting using the SRQ mechanism Readout of measurement data15.1.1 15.1.2 Command Reference Application Program Examples . . . . . . . . . . . . . A-1 VII What this Manual Contains About this Manual About this Manual System setup Preparations for Scpi ProgrammingGetting Started with Scpi Programming Programming environment Command CommandsAddresslist Constant -1 Ffff hex Program Example Programming Note How to reset the CombiScope instrument How to identify the CombiScope instrumentHow to switch between digital and analog mode Initializing the CombiScope Instrument Error Reporting ’Requests for error Acquiring Traces Channels and memory registers Example Send -- FORMat INT,16Format of the trace response data is as follows Example This string data How to acquire a single shot tracePreparations How to acquire repetitive traces Connect a probe from the Probe Adjust signal to channel Measuring Signal Characteristics CONFigure + READ?MEASure? INITiate + FETCh? How to make a single shot measurement How to make repeated measurements Using the Combiscope Instruments Introduction Using the Combiscope Instruments Fundamental Programming Concepts TRACe? CH1SAV RCL Measurement instructions DISPlayMENU TRIGgerSYSTemKEY Single function programming using the instrument model Explanation of the Instrument Model Instrument setup Read ← blockdata Instrument setup Front panel simulation MEASure? query MEASureAC? Generic form of a measurement instruction is as follows Benefits of using parametersVoltageparameters = expectedvoltage,resolution Examples MEASureAMPLitude?MEASureVOLTageAMPLitude? 10, @2 MEASureVOLTageFREQuency? 10E6, @3 Pulse characteristics Waveform measurements MEASureFALLTIME? @3 MEASureRISETIME? 20,80Measurefunctionmeasureparameters FTIMe = alias for Falltime RTIMe = alias for Risetime Customizing settings CONFigureACSENSeAVERage on SENSeAVERageCOUNT Multiple measurements CONFigureRISETIMEREADRISEOVERshoot? Multiple characteristics from a single acquisition READFREQuency?Starts Acquisition Returns Starts a Next acquisition Returns New Frequency result Trigger control via Gpib TRIGgerSOURce BUSINITiate FETChAC? Fetching characteristics from memory traces M12,CH2 Acquisition Acquisition control Using the Combiscope Instruments Triggering Trigger TypeTrigger Source Trigger Level Trigger Slope Trigger Coupling AC Coupling 10 Hz cutoff frequency DC Coupling 0 Hz cutoff frequencyDC Coupling Video triggering LF-REJECT 30 KHz cutoff frequencyHF-REJECT 30 KHz cutoff frequency Ntsc Lines per framePAL Secam Trigger modes OFFLine BUS Commands State Description Pre- and post-triggering Trace External triggering Reading trace acquisitions 10 The trace acquisition flow Single-shot acquisition Repetitive acquisitions Conversion of trace data 11 Relation between screen position and trace value ’Array of 512 integers Byte1 = ASCMID$response$, J Ps = Ts / 25600 * 100 = Ts Ps = TsFor 8-bit sample traces Using the Combiscope Instruments Program Example ’1-byte samples Averaging Acquisition Data AVGn = ∑X1 + .. + Xn ⁄ n 13 The Trigger Model during acquisition averaging Channel Selection Programming tip Signal Conditioning 1 AC/DC/ground coupling Input filtering Input impedanceInput polarity Vertical range and offset Limitation Vs = Ts / 200 * PTPeak OFFSetAutoranging attenuators Time Base Control Number of samplesTime base speed MTB = 50 * SENSeSWEepTIME / TRACePOINts Ts = sampleindex * SENSeSWEepTIME / TRACePOINts Real time acquisition 16 Definition of a signal period Autoranging time base How to do post processing Post ProcessingSelect the source for the post processing function Send → CALCulateFEED M21 ’M21 = source for CALC1 Standard Available Mathematical calculationsMath Optional Read ← tracebuffer ’Reads M21 trace Check the result of the post processing functionExample Send → TRACe? M21 Mathematical calculations Differentiating and integrating traces Absolute FFT Frequency domain transformationsRelative FFT Trace data Trace Point ValuesFor 16-bit samples Ps = Ts 25600 Vrms offset calculation This can be calculated as a signal levelExample for attenuator setting 0.5 V/div DBm 50Ω offset calculation DBm 600Ω offset calculationDBμV offset calculation DBμV = 1 μV 1.0E-6 V at 50Ω impedance Fs = sampleindex * 1250 / TRACePOINts * MTB SettingTrace Point Frequencies Program Example Frequency filtering Histogram functionsAmplitude belt = peak-to-peak range Trace Memory 20 Trace memory control Channels Memory Registers Standard PM33x0B 512 +EXTExtended Trace formatting Copying traces to memory Writing data to trace memory Send → TRACe? CH3’Queries for CH3 trace Read ← trace block Reading data from trace memory Screen/Display Functions Brightness controlDisplay functions Menu Measurement Value MEAS1/MEAS2 DataMeastype,measvalue,suffixunit Description Math FFT Data Cursors DataType Unit Description Call Send0, 8, DISPlayMENU MEASure Selection of softkey menus Display of user-defined textProgram Example 2 text as block data Print/Plot Functions Device TypeHpgl Hplaser 22 Hardcopy of screen on printer/plotter Real-Time Clock Auto Calibration = okay Status Reporting Status data for the CombiScope instruments Digital mode Operation status dataCALibrating RANGing TEMPerature Questionable status dataVOLTage CALibration How to reset the status data Status Register Data Structure Preset Value How to enable status reporting Program example using the status byte STB ’Defines SRQ-routine How to report errors Error-reporting routine ’Sends error query Saving/Restoring Instrument Setups How to restore initial settingsHow to save/restore a setup via instrument memory How to save/restore a setup via the Gpib controller How to simulate the pressing of a front panel key Front Panel SimulationRow 201 Row 801 How to simulate the operation of a softkey menu Autoset Simulation Functions not Directly Programmable EnvelopeDISPlayMENU ACQuireSYSTemKEY 3 toggles on/off MULTiple-shot Syntax specification notations Meta symbolsNon-terminal symbols Terminal symbols Default Not contain the message elementBetween the square brackets, without MEASureVOLTageDC? is the same Preceded by a sign, e.g Data typesAn explicit decimal point and may or may not be Bit codes Double quotesExamples This is a string ’This also’ Command Summary Feed Gate Command Reference Parameters Menu NameState DATA? Read TYPE? Auto DTR RTSBaud Bits ALL Type PAL Secam Ntsc Hdtv Expectedvoltage ,resolution TimeresolutionMeasurefunction Measureparameters Referencelow ,referencehigh,expectedtime Command Descriptions Specifies the compliance with front panel operations ErrorsFront panel compliance CAL? CALibration Syntax *CAL? Response 0Calibration okay Calibration not okay Limitation 16COMMAND Reference Clear Status Event Status Enable Byte Register. Alternative commands *ESE #B10001Ation Complete bits to be summarized in the Status *ESE #H11 18COMMAND Reference Event Status RegisterResponse Integer Description PON URQ CME EXE DDE QYE RQC OPC ESR IDN? Identification Syntax *IDN? 20COMMAND Reference Operation CompleteQuery form *OPC? Response Description Restrictions OPT? Option identification Ieee EXT EM MP Syntax RCL numericdata Description Recall instrument setup22COMMAND Reference Syntax *RST Description RST ResetFunction Default Settings Beeper Hardcopy Print & Plot Plotter Hpgl Pass/Fail testing Measure 1Math 1 Cursors Save instrument setup Syntax SAV numericdata Description Request Enable Register Service Request Enable26COMMAND Reference STB? Status Byte Syntax STB? Response Integer Description TRG Trigger Syntax *TRG Description Self-test okay Self-test not okay TST? Self-testSyntax *TST? Response 0 Command Reference Configures for AC-RMS value ABORtSyntax ABORt Description Aborts the current acquisition Function on Switches the differentiateCALCulatenDERivativePOINts CALCulatenDERivativeSTATe CALCulatenFEED Filter function turned off Filter function turned on CALCulatenINTegralSTATe Integrate function turned off Integrate function turned on Switches MATH2 function on CALCulatenMATHEXPRession Switches MATH1 function on CALCulatenMATHSTATe Query form CALCulatenTRANsformFREQuencyTYPE? Response ABS REL Selects MATH2-FFT-HANNing window Switches MATH2-FFT onSelects relative MATH2-FFT calculation Histogram function turned off Histogram function turned on SwitchesCALCulatenTRANsformHISTogramSTATe Response 0 Description CALibrationALLSyntax CALibrationALL Query form CALibrationALL? Conditions Starts auto calibrationReads condition register Syntax elements are specified with the MEASure? query CONFigureSyntax CONFigureVOLTagemeasurefunction Signal on channel Expected voltage 600 mVChannel 2 AC coupled Initiates + fetches AC-RMS DISPlayBRIGhtness Query form DISPlayBRIGhtness? MINimum MAXimumResponse NR3 NR30.00E00 .. .00E00 DISPlayMENUNAME Display turned off Display turned on Switches TB Mode menu display onDISPlayMENUSTATe Type Analog Mode Digital Mode DISPlayWINDow1TEXTnDATA?Syntax DISPlayWINDow1TEXTnDATA? Response is peak-peak value of 608.4 mV MEAS1 Display on DISPlayWINDow2TEXT1CLEar Clears all user text DISPlayWINDow2TEXT1DATA As textSends 25 decimal Character byte Command Reference DISPlayWINDow2TEXT1STATe 54COMMAND Reference FETCh?FETChVOLTagemeasurefunction? Voltageparameters, measureparameters Restrictions Acquisition FORMatDATA INT,8 HCOPyDATA? HCOPyDEVice INITiateCONTinuous Response 1 INITiateIMMediate Syntax INITiateIMMediateTrigger level becomes Single shot acquisition INPutnCOUPling INPutnFILTerLPASsSTATe INPutnFILTerLPASsFREQuency? Response 2.00E+07Query form INPutnFILTerLPASsSTATe? Common low pass filter off Common low pass filter on Syntax INPutnIMPedance NRf MINimum MAXimum 1E6 After a *RST command, the impedance is 1 MΩINPutnIMPedance INPutnPOLarity Response Norm INV Description INSTrumentNSELect INSTrumentSELect Response DIG AnalDIG Anal Measurefunction measureparameters MEASure?Channellist = Falltime High Signal. The peak to peak value is the difference between First falling edge equals the REFerence MIDDle untilPDUTycycle Referencemiddle Ratio percentage of the positive width PWIDth Risetime Measureparameters Executed. The unit of timeresolution is second Frequencyresolution = NRf DEFaultReferencemiddle is volt Expectedperiod = NRf DEFault Periodresolution = NRf DEFault Limitations Description 74COMMAND Reference Syntax READVOLTagemeasurefunction? Example SENSeAVERageSTATe SENSeAVERageCOUNt SENSeAVERageTYPE? Syntax SENSeAVERageCOUNt NRf 8 16 SENSeAVERageTYPE?Response Scal Initiates trace averaging SENSeFUNCtionOFF SENSeFUNCtionON SENSeFUNCtionSTATe? Addition of channel i+j is off Addition of channel i+j is on Limitations SENSeSWEepOFFSetTIME SENSeSWEepPDETectionSTATe Real-time mode switched off Real-time mode switched on SENSeSWEepREALtimeSTATeSlope = either pos. or neg Reads AC-RMS MTB values in the digital mode SENSeSWEepTIMEQuery form SENSeSWEepTIME? MINimum MAXimum Base range is limited to 10 μs non-alternating time base Coupled values Requests sweep timeReads sweep time Requests nr of trace points Autoranging MTB switched off Autoranging MTB switched on SENSeSWEepTIMEAUTOSets trigger source CH1 Sets autoranging MTB on Switches CH1 on Switches CH2 onSENSeVOLTagenDCRANGeAUTO Autoranging CH2 SENSeVOLTagenDCRANGeOFFSet Channel SENSeVOLTagenDCRANGePTPeak Query form SENSeVOLTagenDCRANGePTPeak? MINimum MAXimum Peak-to-peak = Sensitivity = 0.8 / 8 =100 mV/div Trigger source = Response NR1 Description BIT Decimal Meaning Number Value STATusPRESet Syntax STATusPRESetFollowing table defines the effect of STATusPRESet Status Register Filter / Enable Preset Value Response NR1 Description TEMPerature too high or too low Returned value 16 equals bit 4 set temperature too high/lowEnables report of TEMPerature too high/low 0 Enables report of TEMPerature within allowed limits 1 No error Error number is -222 and the meaning is Data out of rangeSTATusQUEueNEXT? 350,Queue overflow Beeper disabled Beeper enabled Reads the error queueBeeps on error SYSTemBEEPer SYSTemBEEPerSTATe Stan Wire controlResponse on Stan XON NoneEven ODD None Response 7 Response XON None No X-on/X-off handshaking1200 Becomes SYSTemDATE Sets the system date to Nov 7 SYSTemERRor? SYSTemKEY Response NR1 Front Panel KEY Enables Utility softkey menu Returns the last key simulation SYSTemSET Nodenr nodelength firstbyte ... lastbyte SYSTemTIME *RST command doesn’t change the current Scpi version SYSTemVERSion?Syntax SYSTemVERSion? Response YYYY.V TRACeCOPY TRACeDATA Response definiteblock Initiates single acquisition Requests channel 1 trace Reads channel 1 traceQueries peak-to-peak Reads peak-to-peak TRACePOINts Reads M23 trace Number of trace points for allRequests M23 trace Pass Boolean Sets high-pass filter offSets high-pass filter on Low-pass filter active High-pass filter active HF-reject Automatically switches Filter Frequency LOW-PASS on HIGH-PASS onDC coupling HF-reject AC coupling KHz LF-reject Low-Pass filter off TRIGgerSEQuence1FILTerLPASsFREQuency NRf TRIGgerSEQuence1FILTerLPASsSTATe BooleanTRIGgerSTARtFILTerLPASsFREQuency NRf TRIGgerSTARtFILTerLPASsSTATe Boolean Sets cutoff frequency = 30 KHz FilterFrequency LOW-PASS on HIGH-PASS on TRIGgerSEQuence1HOLDoff TRIGgerSTARtHOLDoff TRIGgerSEQuence1LEVel NRf MINimum MAXimum TRIGgerSEQuence1LEVelAUTO BooleanTRIGgerSTARtLEVel NRf MINimum MAXimum TRIGgerSTARtLEVelAUTO Boolean Trigger source Becomes Channel Continuous initiationDiv. sensitivity Trigger level becomes 0.2 After a *RST command, the trigger slope is POSitive TRIGgerSEQuence1SLOPe TRIGgerSTARtSLOPePOS NEG Configures AC-RMS CH2 Sets real-time mode onTriggering is done at positive Rising and negative falling EXT TRIGgerSEQuence1SOURce TRIGgerSTARtSOURceIMM Configures AC-RMS CH1 Input channel 1 becomesTrigger source Single initiation Selects edge triggering TRIGgerSEQuence1TYPE TRIGgerSTARtTYPEEdge Selects lines triggering Numb Linenr = linenr + 625/2 linenr = linenr 625/2 Selects TV videoSelects video lines Selects video line Secam Ntsc Hdtv Scam Secam Scam Selects Lines/frame SelectsLines/frame Selects Secam Lines/frame Selects Hdtv Positive video signal polarity selected Response POS NEG 123 Selects Negative Video Signal polarity PAL or Secam From 1 to Application Program Examples Making a Hardcopy of the Screen Pass/Fail TestingError reporting is invoked as follows Call errorcheck Making automatic measurements Application summaryFETChNWIDth? Application program ’Termination Receive on EOI Making programmed measurements Acquiring Waveform Traces Reading measurement values Saving/Recalling Instrument Setups Save/recall settings to/from internal memory Application summary Application program Ieee Making a Hardcopy of the ScreenCombiScope Instrument Pass/Fail Testing Saving a pass/fail test setup Application program Restoring a pass/fail test setup Running a pass/fail test DISPlayMENU MEASure Channel 4 is external trigger input for PM33x0B Cross Reference Front Panel Keys / CommandsCross References Page Cross Reference Softkey Menus / Commands Acquire menu Programmable with the *SAV/*RCL and Systset commands Cursors menu Display menu Ext instead of ch4 for PM33x0B Mathplus Math menu Other functions with RCL/SAV and Systset Yes no Page Measure menu DTB DEL’D TB menu Setups menu SAVE/RECALL menu TB Mode menu Systset RCL/SAV Analog Mode Trigger menu Logic Wire Utility menu Ieee Vertical menu Inpfilt Onoff INP1IMP INP2IMP INP3IMP INP4IMP Cross Reference Functions / Commands Function + KEYS/MENUS Related Scpi Commands Autoset AverageBW Limit Calibration Autocal Delay Delay MeasurementDelayed Timebase DEL’D TB Differentiate Mathplus FFT ON/OFF Histogram MathplusHold OFF CH1 Integrate Mathplus Logic TriggerMagnify Horizontal Main Time Base Function + KEYS/MENUS Related Scpi Commands Mathematics Pass Fail Testing Mathplus SAV, *RCLPower Supply Measure Menu Remote Control IEEE-488.2 Remote SetupRemote Control RS-232 Probe Utilities Function + KEYS/MENUS Related Scpi Commands Status ScreenSubtract Mathematics Text OFF Trig SingleMulti Roll Trigger Coupling Trigger DEL’D TBTrigger Level Trigger Main TB Util Screen & Sound User TextUtil Menu DISPlayWINDow1TEXT12DATA? Abbreviations Used IDY IDNIEC IFC Manual Conventions RAM RENRQC RQS 4MANUAL Conventions Glossary of Symbols UsedList of Tables List of Figures Documents Referenced TRIGgerSEQuence1 STARtVIDeoFORMatTYPE type command Purpose Scpi Conformance InformationStandards Information Or abbreviation, e.g., type = Hdtv List of Implemented IEEE-488.2 Syntactical Elements Command Program Header Standards Information Program Message Unit SeparatorProgram Data Separator Program Header Separator End node settings Channel 1/2/3/4 settingsProbe scale settings Common vertical settings Delayed timebase settings Event trigger delay settingsCursor settings Cursor autosearch settings MATH1/2 settings Display settingsTrace intensity settings Display trace position settings Numerics Index Index Index Index Index Index Index Index Index Index Index Index