MDO3000 Programmer Manual.pdf - 第570页

Commands Listed in A lphabetical Order use of wildcard characters in ﬁlenames is not supp orted. Filename extensions are not required, but highly recommended. Examples RECALL:SETUP FAC TORY recalls (and makes current) th…

Commands Listed in Alphabetical Order

Aseriesofexam

ples showing how to use mask commands for typical tasks

is included in an appendix. (See page E-1, Mask/Limit Command Sequence

Examples.)

Conditions

This command requires a DPO4LMT application module.

Group

Mask

Syntax

RECAll:MASK <QString>

Related C

ommands

SAVe:MASK

Arguments

QString is a quoted string that is the name of the mask deﬁnition being recalled

from the current working directory.

Examples

:RECall:MASK ”FOO.MSK” will recall a copy of the mask “FOO” from the

current working directory.

RECAll:SETUp (No Query Form)

Restores the state of the oscilloscope from a copy of the settings stored in memory.

The settings are stored using the

*SAV command.

Group

Save and Recall

Syntax

RECAll:SETUp {FACtory|< NR1>|<file path>}

Related Commands

FACtory, *RCL, *RST, *SAV, SAVe:SETUp, FILESystem:CWD

Arguments

FACtory restores the factory setup.

<NR1> is a value in the range from 1 to 10, which speciﬁes a saved setup storage

location.

<file p ath> speciﬁes a location for an oscilloscope setup ﬁle. <ﬁle path> is

a quoted string that deﬁnes the ﬁle name and path. Input the ﬁle path using the

form

<drive>:/<dir>/<filename>.<extension> and one or <dir>s are

optional. If you do not specify them, the oscilloscope will read the ﬁle fromthe

default directory (see FILESystem:CWD). <ﬁlename> stands for a ﬁlename; the

MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-539

Commands Listed in Alphabetical Order

use of wildcard

characters in ﬁlenames is not supported. Filename extensions are

not required, but highly recommended.

Examples

RECALL:SETUP FACTORY recalls (and makes current) the oscilloscope setup

to its factory defaults.

RECALL:SETUP 2 recalls the oscilloscope setup from setup storage location 2.

RECALL:SETUP "TEK00000.SET" recalls the setup from the ﬁle TEK00000.SET

in the current working directory.

RECAll:SETUp:DEMO<x> (No Query Form)

This command recalls one of up to 22 built-in demonstration setups of oscilloscope

functionality. <x> varies by model.

Conditions

MDO only.

Group

Save and Recall

Syntax

RECAll:SETUp:DEMO<x>

Examples

RECAll:SETUp:DEMO4 recalls the Demonstration #4 setup.

RECAll:WAVEform (No Query Form)

This command (no query form) recalls a stored waveform to a reference memory

location, and, for instruments with the arbitrary waveform feature, to arbitrary

waveform edit memory (EMEM). Only the ﬁrst waveform in a .CSV ﬁle is

recalled for multiple waveform .CSV ﬁles. Recall of digital waveforms (D0

through D15) is not supported.

NOTE. For MDO3000 series models, a saved ARB waveform c annot be recalled

toareferencelocation.ItcanonlyberecalledtoanEMEMlocation.However,

an AFG waveform can be recalled into either a reference or EMEM location.

Group

Save and Recall

Syntax

RECAll:WAVEform <Source>, <Destina tion>

2-540 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual

Commands Listed in Alphabetical Order

Related Commands

SAVe:WAVEform

, FILESystem:CWD, FILESystem?

Arguments

<Source> is one of:

Speciﬁes an ISF (internal save format) or CSV (comma separated values) ﬁle.

For CSV ﬁles containing multiple waveforms (created using :SAVe:WAVEform

ALL), only the ﬁrst waveform column is recalled. Recalling digital waveforms to

reference memory is not supported and attempting to recall a CSV ﬁle with only

digital waveforms to REF1-4 results in an error event.

The instrument with the arbitrary waveform feature, supports recalling CSV or

ISF ﬁles from time domain waveforms to EMEM. The list of supported time

domain waveforms include CH1-4, D0-D15, Math and REF and ARB. Recalling

CSV ﬁles which contain data from an RF frequency domain is not supported and

results in an error event. Similarly, recalling ISF ﬁles with RF frequency domain

waveforms to EMEM is not supported.

ARB1-ARB4 -

For instruments with the arbitrary waveform feature, the internal arbitrary

waveform memory locations ARB1-ARB4 can be recalled to edit memory

(EMEM). These sources cannot be recalled to reference memory locations.

<QString> is a quoted string that speciﬁes a location for an

oscilloscope ﬁle. The ﬁle name and path should be input using the form

<drive>:/<dir>/<filename>.<extension>.

<Destination> is one of:

REF1-REF4 - Speciﬁes a reference memory location to receive the saved ISF or

CSV data. ARB1-ARB4 cannot be recalled to reference memory locations and

attempting to do so on an instrument with the arbitrary waveform feature results

in an error event.

EMEM - For instruments with the arbitrary waveform feature, speciﬁes arbitrary

waveform edit memory (EMEM). If the source is a ﬁle, the ﬁle can be either an

ISF or CSV ﬁle with the following restrictions:

The source waveform must be a time domain waveform. MATH FFT and

REF waveforms saved from RF frequency domain sources are not supported

and will result in an error event.

Waveform ﬁles containing more that 131072 points are decimated in order to

ﬁt into the 131072 point edit memory.

Examples

RECALL:WAVEFORM "TEK00000.ISF",REF1 recalls the waveform stored in the

ﬁle named TEK00000.ISF from the current directory to the reference location 1.

MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-541