TRACePOINts | Fluke PM-3394B, PM-3380B, PM-3390B, PM-3370B, PM-3384B

COMMAND REFERENCE

4 - 113

TRACe:POINts

Syntax: TRACe:POINts <source_trace> [,<acquisition_length>]

Alias: DATA:POINts <source_trace> [,<acquisition_length>]

<source_trace>	CHn Mi_n
	n = 1 .. 4
	i = 1 .. 8 (standard memory)
	i = 1 .. 50 (extended memory)
<acquisition_length>	<NRf> MINimum MAXimum
<NRf>	512 2048 4096 8192
	(standard memory)
	512 8192 16384 32768
	(extended memory)
	Notes: - 512 is the default value.
MINimum	Length becomes 512 points.
MAXimum	Length becomes 8192, if no extended
	memory is available.
	Length becomes 32768, if extended
	memory is available.

Query form: TRACe:POINts? <source_trace> [,MINimum MAXimum]

<source_trace>	CHn Mi_n
	n = 1 .. 4
	i = 1	.. 8 (standard memory)
	i = 1	.. 50 (extended memory)

If MINimum was specified, the minimum possible trace length is returned.

If MAXimum was specified, the maximum possible trace length is returned.

Response: <acquisition_length>

Page 213

Image 213

Fluke PM-3394B, PM-3380B, PM-3390B, PM-3370B, PM-3384B user manual TRACePOINts

Contents

Qvwuxphqw Trademarks III About this Manual What this Manual ContainsInitializing the CombiScope Instrument Measuring Signal Characteristics Readout of measurement data 15.4.2 Error-reporting using the SRQ mechanism15.1.1 15.1.2 Application Program Examples . . . . . . . . . . . . . A-1 Command Reference VII About this Manual What this Manual Contains About this Manual Preparations for Scpi Programming System setupGetting Started with Scpi Programming Programming environment Commands CommandAddresslist Constant -1 Ffff hex Programming Note Program Example How to identify the CombiScope instrument How to reset the CombiScope instrumentHow to switch between digital and analog mode Initializing the CombiScope Instrument ’Requests for error Error Reporting Channels and memory registers Example Send -- FORMat INT,16 Acquiring TracesFormat of the trace response data is as follows Example How to acquire a single shot trace PreparationsThis string data Connect a probe from the Probe Adjust signal to channel How to acquire repetitive traces CONFigure + READ? Measuring Signal CharacteristicsMEASure? INITiate + FETCh? How to make repeated measurements How to make a single shot measurement Introduction Using the Combiscope Instruments Using the Combiscope Instruments TRACe? CH1 Fundamental Programming ConceptsSAV RCL DISPlayMENU TRIGger SYSTemKEYMeasurement instructions Explanation of the Instrument Model Single function programming using the instrument model Read ← blockdata Instrument setup Instrument setup Front panel simulation MEASureAC? MEASure? query Benefits of using parameters Voltageparameters = expectedvoltage,resolutionGeneric form of a measurement instruction is as follows MEASureAMPLitude? ExamplesMEASureVOLTageAMPLitude? 10, @2 MEASureVOLTageFREQuency? 10E6, @3 Waveform measurements Pulse characteristics MEASureRISETIME? 20,80 MEASureFALLTIME? @3Measurefunctionmeasureparameters FTIMe = alias for Falltime RTIMe = alias for Risetime CONFigureAC Customizing settingsSENSeAVERage on SENSeAVERageCOUNT CONFigureRISETIME READRISEOVERshoot?Multiple measurements READFREQuency? Multiple characteristics from a single acquisitionStarts Acquisition Returns Starts a Next acquisition Returns New Frequency result TRIGgerSOURce BUS Trigger control via GpibINITiate FETChAC? M12,CH2 Fetching characteristics from memory traces Acquisition control Acquisition Using the Combiscope Instruments Trigger Type TriggeringTrigger Source Trigger Level Trigger Coupling Trigger Slope DC Coupling 0 Hz cutoff frequency DC CouplingAC Coupling 10 Hz cutoff frequency LF-REJECT 30 KHz cutoff frequency HF-REJECT 30 KHz cutoff frequencyVideo triggering Lines per frame NtscPAL Secam OFF Trigger modesLine BUS State Description Commands Trace Pre- and post-triggering External triggering 10 The trace acquisition flow Reading trace acquisitions Repetitive acquisitions Single-shot acquisition 11 Relation between screen position and trace value Conversion of trace data ’Array of 512 integers Byte1 = ASCMID$response$, J Ps = Ts For 8-bit sample tracesPs = Ts / 25600 * 100 = Ts ’1-byte samples Using the Combiscope Instruments Program Example AVGn = ∑X1 + .. + Xn ⁄ n Averaging Acquisition Data 13 The Trigger Model during acquisition averaging Programming tip Channel Selection 1 AC/DC/ground coupling Signal Conditioning Input impedance Input filteringInput polarity Vertical range and offset Vs = Ts / 200 * PTPeak OFFSet Autoranging attenuatorsLimitation Number of samples Time Base ControlTime base speed MTB = 50 * SENSeSWEepTIME / TRACePOINts Real time acquisition Ts = sampleindex * SENSeSWEepTIME / TRACePOINts Autoranging time base 16 Definition of a signal period Post Processing How to do post processingSelect the source for the post processing function Send → CALCulateFEED M21 ’M21 = source for CALC1 Mathematical calculations Standard AvailableMath Optional Check the result of the post processing function Example Send → TRACe? M21Read ← tracebuffer ’Reads M21 trace Differentiating and integrating traces Mathematical calculations Frequency domain transformations Relative FFTAbsolute FFT Trace Point Values For 16-bit samples Ps = Ts 25600Trace data This can be calculated as a signal level Example for attenuator setting 0.5 V/divVrms offset calculation DBm 600Ω offset calculation DBm 50Ω offset calculationDBμV offset calculation DBμV = 1 μV 1.0E-6 V at 50Ω impedance Setting Trace Point FrequenciesFs = sampleindex * 1250 / TRACePOINts * MTB Program Example Histogram functions Amplitude belt = peak-to-peak rangeFrequency filtering 20 Trace memory control Trace Memory PM33x0B 512 +EXT Channels Memory Registers StandardExtended Trace formatting Copying traces to memory Send → TRACe? CH3 Writing data to trace memory’Queries for CH3 trace Read ← trace block Reading data from trace memory Brightness control Screen/Display FunctionsDisplay functions Menu MEAS1/MEAS2 Data Measurement ValueMeastype,measvalue,suffixunit Description Cursors Data Type Unit DescriptionMath FFT Data Call Send0, 8, DISPlayMENU MEASure Display of user-defined text Program Example 2 text as block dataSelection of softkey menus Device Type Print/Plot FunctionsHpgl Hplaser 22 Hardcopy of screen on printer/plotter Auto Calibration Real-Time Clock = okay Status data for the CombiScope instruments Status Reporting Operation status data Digital modeCALibrating RANGing Questionable status data TEMPeratureVOLTage CALibration Status Register Data Structure Preset Value How to reset the status data Program example using the status byte STB How to enable status reporting ’Defines SRQ-routine Error-reporting routine How to report errors ’Sends error query How to restore initial settings Saving/Restoring Instrument SetupsHow to save/restore a setup via instrument memory How to save/restore a setup via the Gpib controller Front Panel Simulation How to simulate the pressing of a front panel keyRow 201 Row 801 Autoset Simulation How to simulate the operation of a softkey menu Envelope Functions not Directly ProgrammableDISPlayMENU ACQuireSYSTemKEY 3 toggles on/off MULTiple-shot Meta symbols Syntax specification notationsNon-terminal symbols Terminal symbols Not contain the message element DefaultBetween the square brackets, without MEASureVOLTageDC? is the same Data types An explicit decimal point and may or may not bePreceded by a sign, e.g Double quotes Bit codesExamples This is a string ’This also’ Command Summary Gate Feed Menu Name Command Reference ParametersState DATA? Read Auto TYPE? RTS DTRBaud Bits Type PAL Secam Ntsc Hdtv ALL Timeresolution Expectedvoltage ,resolutionMeasurefunction Measureparameters Referencelow ,referencehigh,expectedtime Command Descriptions Errors Front panel complianceSpecifies the compliance with front panel operations Syntax *CAL? Response 0 CAL? CALibrationCalibration okay Calibration not okay Limitation Clear Status 16COMMAND Reference Byte Register. Alternative commands *ESE #B10001 Event Status EnableAtion Complete bits to be summarized in the Status *ESE #H11 Event Status Register 18COMMAND ReferenceResponse Integer Description PON URQ CME EXE DDE QYE RQC OPC ESR Syntax *IDN? IDN? Identification Operation Complete 20COMMAND ReferenceQuery form *OPC? Response Description Restrictions Ieee EXT EM MP OPT? Option identification Recall instrument setup 22COMMAND ReferenceSyntax RCL numericdata Description RST Reset Function Default SettingsSyntax *RST Description Measure 1 Beeper Hardcopy Print & Plot Plotter Hpgl Pass/Fail testingMath 1 Cursors Syntax SAV numericdata Description Save instrument setup Service Request Enable 26COMMAND ReferenceRequest Enable Register Syntax STB? Response Integer Description STB? Status Byte Syntax *TRG Description TRG Trigger TST? Self-test Syntax *TST? Response 0Self-test okay Self-test not okay Command Reference ABORt Configures for AC-RMS valueSyntax ABORt Description Aborts the current acquisition Switches the differentiate CALCulatenDERivativePOINts CALCulatenDERivativeSTATeFunction on CALCulatenFEED Filter function turned off Filter function turned on Integrate function turned off Integrate function turned on CALCulatenINTegralSTATe CALCulatenMATHEXPRession Switches MATH2 function on CALCulatenMATHSTATe Switches MATH1 function on Response ABS REL Query form CALCulatenTRANsformFREQuencyTYPE? Switches MATH2-FFT on Selects relative MATH2-FFT calculationSelects MATH2-FFT-HANNing window Switches CALCulatenTRANsformHISTogramSTATeHistogram function turned off Histogram function turned on CALibrationALL Syntax CALibrationALL Query form CALibrationALL?Response 0 Description Starts auto calibration Reads condition registerConditions CONFigure Syntax CONFigureVOLTagemeasurefunctionSyntax elements are specified with the MEASure? query Expected voltage 600 mV Signal on channelChannel 2 AC coupled Initiates + fetches AC-RMS Query form DISPlayBRIGhtness? MINimum MAXimum DISPlayBRIGhtnessResponse NR3 NR30.00E00 .. .00E00 DISPlayMENUNAME Switches TB Mode menu display on DISPlayMENUSTATeDisplay turned off Display turned on DISPlayWINDow1TEXTnDATA? Type Analog Mode Digital ModeSyntax DISPlayWINDow1TEXTnDATA? Response is peak-peak value of 608.4 mV MEAS1 Display on Clears all user text DISPlayWINDow2TEXT1CLEar As text DISPlayWINDow2TEXT1DATASends 25 decimal Character byte Command Reference DISPlayWINDow2TEXT1STATe FETCh? 54COMMAND ReferenceFETChVOLTagemeasurefunction? Voltageparameters, measureparameters Restrictions Acquisition INT,8 FORMatDATA HCOPyDATA? HCOPyDEVice Response 1 INITiateCONTinuous Syntax INITiateIMMediate INITiateIMMediateTrigger level becomes Single shot acquisition INPutnCOUPling Response 2.00E+07 INPutnFILTerLPASsSTATe INPutnFILTerLPASsFREQuency?Query form INPutnFILTerLPASsSTATe? Common low pass filter off Common low pass filter on After a *RST command, the impedance is 1 MΩ INPutnIMPedanceSyntax INPutnIMPedance NRf MINimum MAXimum 1E6 Response Norm INV Description INPutnPOLarity Response DIG Anal INSTrumentNSELect INSTrumentSELectDIG Anal MEASure? Channellist =Measurefunction measureparameters High Falltime First falling edge equals the REFerence MIDDle until Signal. The peak to peak value is the difference betweenPDUTycycle Referencemiddle Ratio percentage of the positive width PWIDth Measureparameters Risetime Frequencyresolution = NRf DEFault Executed. The unit of timeresolution is secondReferencemiddle is volt Expectedperiod = NRf DEFault Periodresolution = NRf DEFault Limitations Description Syntax READVOLTagemeasurefunction? 74COMMAND Reference Example SENSeAVERageSTATe Syntax SENSeAVERageCOUNt NRf 8 16 SENSeAVERageTYPE? SENSeAVERageCOUNt SENSeAVERageTYPE?Response Scal Initiates trace averaging Addition of channel i+j is off Addition of channel i+j is on SENSeFUNCtionOFF SENSeFUNCtionON SENSeFUNCtionSTATe? Limitations SENSeSWEepOFFSetTIME SENSeSWEepPDETectionSTATe SENSeSWEepREALtimeSTATe Real-time mode switched off Real-time mode switched onSlope = either pos. or neg Reads AC-RMS SENSeSWEepTIME MTB values in the digital modeQuery form SENSeSWEepTIME? MINimum MAXimum Base range is limited to 10 μs non-alternating time base Requests sweep time Coupled valuesReads sweep time Requests nr of trace points SENSeSWEepTIMEAUTO Autoranging MTB switched off Autoranging MTB switched onSets trigger source CH1 Sets autoranging MTB on Switches CH2 on Switches CH1 onSENSeVOLTagenDCRANGeAUTO Autoranging CH2 Channel SENSeVOLTagenDCRANGeOFFSet Query form SENSeVOLTagenDCRANGePTPeak? MINimum MAXimum SENSeVOLTagenDCRANGePTPeak Sensitivity = 0.8 / 8 = Peak-to-peak =100 mV/div Trigger source = Response NR1 Description BIT Decimal Meaning Number Value Syntax STATusPRESet STATusPRESetFollowing table defines the effect of STATusPRESet Status Register Filter / Enable Preset Value Response NR1 Description Returned value 16 equals bit 4 set temperature too high/low TEMPerature too high or too lowEnables report of TEMPerature too high/low 0 Enables report of TEMPerature within allowed limits 1 Error number is -222 and the meaning is Data out of range No errorSTATusQUEueNEXT? 350,Queue overflow Reads the error queue Beeper disabled Beeper enabledBeeps on error SYSTemBEEPer SYSTemBEEPerSTATe Wire control Response on StanStan None XONEven ODD None Response 7 No X-on/X-off handshaking Response XON None1200 Becomes Sets the system date to Nov 7 SYSTemDATE SYSTemERRor? Response NR1 SYSTemKEY Front Panel KEY Returns the last key simulation Enables Utility softkey menu SYSTemSET Nodenr nodelength firstbyte ... lastbyte SYSTemTIME SYSTemVERSion? *RST command doesn’t change the current Scpi versionSyntax SYSTemVERSion? Response YYYY.V TRACeCOPY Response definiteblock TRACeDATA Initiates single acquisition Reads channel 1 trace Requests channel 1 traceQueries peak-to-peak Reads peak-to-peak TRACePOINts Number of trace points for all Requests M23 traceReads M23 trace Sets high-pass filter off Pass BooleanSets high-pass filter on Low-pass filter active High-pass filter active HF-reject Filter Frequency LOW-PASS on HIGH-PASS on Automatically switchesDC coupling HF-reject AC coupling KHz LF-reject Low-Pass filter off TRIGgerSEQuence1FILTerLPASsSTATe Boolean TRIGgerSEQuence1FILTerLPASsFREQuency NRfTRIGgerSTARtFILTerLPASsFREQuency NRf TRIGgerSTARtFILTerLPASsSTATe Boolean Filter Frequency LOW-PASS on HIGH-PASS onSets cutoff frequency = 30 KHz TRIGgerSEQuence1HOLDoff TRIGgerSTARtHOLDoff TRIGgerSEQuence1LEVelAUTO Boolean TRIGgerSEQuence1LEVel NRf MINimum MAXimumTRIGgerSTARtLEVel NRf MINimum MAXimum TRIGgerSTARtLEVelAUTO Boolean Channel Continuous initiation Trigger source BecomesDiv. sensitivity Trigger level becomes 0.2 TRIGgerSEQuence1SLOPe TRIGgerSTARtSLOPe After a *RST command, the trigger slope is POSitivePOS NEG Sets real-time mode on Configures AC-RMS CH2Triggering is done at positive Rising and negative falling TRIGgerSEQuence1SOURce TRIGgerSTARtSOURce IMMEXT Input channel 1 becomes Configures AC-RMS CH1Trigger source Single initiation TRIGgerSEQuence1TYPE TRIGgerSTARtTYPE EdgeSelects edge triggering Numb Selects lines triggering Selects TV video Linenr = linenr + 625/2 linenr = linenr 625/2Selects video lines Selects video line Scam Secam Secam Ntsc Hdtv Scam Lines/frame Selects SelectsLines/frame Selects Secam Lines/frame Selects Hdtv Response POS NEG Positive video signal polarity selected PAL or Secam From 1 to 123 Selects Negative Video Signal polarity Making a Hardcopy of the Screen Pass/Fail Testing Error reporting is invoked as follows Call errorcheckApplication Program Examples Application summary Making automatic measurementsFETChNWIDth? Application program ’Termination Receive on EOI Making programmed measurements Reading measurement values Acquiring Waveform Traces Save/recall settings to/from internal memory Saving/Recalling Instrument Setups Application summary Application program Making a Hardcopy of the Screen CombiScope InstrumentIeee Saving a pass/fail test setup Pass/Fail Testing Application program Restoring a pass/fail test setup DISPlayMENU MEASure Running a pass/fail test Cross Reference Front Panel Keys / Commands Cross ReferencesChannel 4 is external trigger input for PM33x0B Page Acquire menu Cross Reference Softkey Menus / Commands Cursors menu Programmable with the *SAV/*RCL and Systset commands Ext instead of ch4 for PM33x0B Display menu Other functions with RCL/SAV and Systset Mathplus Math menu Yes no Page DTB DEL’D TB menu Measure menu SAVE/RECALL menu Setups menu Systset RCL/SAV TB Mode menu Trigger menu Analog Mode Logic Utility menu Wire Ieee Inpfilt Onoff INP1IMP INP2IMP INP3IMP INP4IMP Vertical menu Cross Reference Functions / Commands Average Function + KEYS/MENUS Related Scpi Commands AutosetBW Limit Calibration Autocal Delay Measurement DelayDelayed Timebase DEL’D TB Differentiate Mathplus Histogram Mathplus FFT ON/OFFHold OFF CH1 Logic Trigger Integrate MathplusMagnify Horizontal Main Time Base Pass Fail Testing Mathplus SAV, *RCL Function + KEYS/MENUS Related Scpi Commands MathematicsPower Supply Measure Menu Remote Setup Remote Control IEEE-488.2Remote Control RS-232 Probe Utilities Status Screen Function + KEYS/MENUS Related Scpi CommandsSubtract Mathematics Text OFF Single TrigMulti Roll Trigger DEL’D TB Trigger CouplingTrigger Level Trigger Main TB User Text Util MenuUtil Screen & Sound DISPlayWINDow1TEXT12DATA? Abbreviations Used IDN IDYIEC IFC REN Manual Conventions RAMRQC RQS Glossary of Symbols Used List of Tables4MANUAL Conventions List of Figures Documents Referenced Scpi Conformance Information TRIGgerSEQuence1 STARtVIDeoFORMatTYPE type command PurposeStandards Information Or abbreviation, e.g., type = Hdtv List of Implemented IEEE-488.2 Syntactical Elements Standards Information Program Message Unit Separator Command Program HeaderProgram Data Separator Program Header Separator Channel 1/2/3/4 settings End node settingsProbe scale settings Common vertical settings Event trigger delay settings Delayed timebase settingsCursor settings Cursor autosearch settings Display settings MATH1/2 settingsTrace intensity settings Display trace position settings Index Numerics Index Index Index Index Index Index Index Index Index Index Index