MDO3000 Programmer Manual.pdf - 第628页

Commands Listed in A lphabetical Order NOTE. External ﬁ l es t r u c t u r ei sa sf o l l o w s : E: is the USB memory device plugged into the ﬁ rst USB port o n the fro nt of the oscilloscope . F: is the USB memory devi…

Commands Listed in Alphabetical Order

Arguments

LANdscape spec

iﬁes that screen images are saved in landscape format.

PORTRait speciﬁes that screen images are saved in portrait format.

SAVe:MASK (No Query Form)

This command saves the current mask deﬁnition to the ﬁle speciﬁed with a quoted

string, into the current working directory. You can recall the mask from theﬁleby

using the command RECAll:MASK

NOTE. If you would like to save the mask deﬁnition plus the rest of the scope

settings to the current working directory, use the command

SAVE:SETUP .

A series of examples showing how to use mask commands for typical tasks

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

Example

s.)

Conditions

This command requires a DPO4LMT application module.

Group

Mask

Syntax

SAVe:MASK <QString>

Related Commands

RECAll:MASK

Arguments

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

the current working directory.

Examples

:SAVE:MASK ”FOO.MSK” will save a copy of the mask “FOO” to the current

working directory.

SAVe:SETUp (No Query Form)

Stores the state of the oscilloscope to a speciﬁed memory location. You can later

use the *RCL command to restore the oscilloscope to this saved state.

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

Commands Listed in Alphabetical Order

NOTE. External

ﬁlestructureisasfollows:

E: is the USB memory device plugged into the ﬁrst USB port o n the front of the

oscilloscope

F: is the USB memory device plugged into the second USB port on the front of the

oscillosco

pe. (Not available for MDO3000.)

G: and H: are the USB memory device plugged into the USB ports on the rear o f

the oscillo

scope. (Not available for MDO3000 models.)

I: – Z are the network storage.

Group

Save and Recall

Syntax

SAVe:SETUp {<file path>|<NR1>}

Related Commands

*RCL, RECAll:SETUp,

*SAV

Arguments

<file p ath> is the target location for storing the 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>/<ﬁlename>. <extension> and one or <dir>s are optional.

If you do not specify them, the oscilloscope will store the ﬁle in the current

working directory. <ﬁlename> stands for a ﬁlename. (Use of wildcard characters

in ﬁlenames is not supported.) Filename extensions are not required but arehighly

recommended. For setups, use the extension ".SET".

<NR1> speciﬁes a location for saving the current front-panel setup. The

front-panel setup value ranges from 1 to 10. Using an out-of-range value causes

an execution error. Any settings that have been stored previously at this location

will be overwritten.

Examples

SAVE:SETUP 5 saves the current oscilloscope setup in memory location 5.

SAVE:SETUP "TEK00000.SET" saves the current oscilloscope setup in the ﬁle

TEK00000.SET in the current working directory.

SAVe:WAVEform (No Query Form)

This command saves the speciﬁed waveform to the speciﬁed destination

reference memory slot, or saves the speciﬁed waveform(s) to the speciﬁed

destination ﬁle. The same function can be accomplished from the front panel

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

Commands Listed in Alphabetical Order

Menu->save wav

eform menu. The type of ﬁle saved is dependent upon the

SAVe:WAVEform:FILEFormat command.

For instrumen

ts with the arbitrary waveform feature, the source can be arbitrary

waveform edit memory (EMEM) or one of the internal arbitrary waveform

locations (ARB1 - ARB4).

Specifying ALL saves all displayed waveforms, depending upon the speciﬁed

SAVe:WAVEform:FILEFormat, to the speciﬁed destination path. ALL can onlybe

used to save all waveforms to a single CSV ﬁle (SAVe:WAVEform:FILEFormat

SPREADSheet) or to individual ISF ﬁles with the path and ﬁle name preﬁx

speciﬁed by <ﬁle path> (SAVe:WAVEform:FILEFormat INTERNal). It cannot be

used to sa

ve to a reference memory slot.

With the INTERNal format, all displayed waveforms, excluding digital

wavefor

ms (D0-15) are saved to ﬁles in the speciﬁed destination path named as

<ﬁle path>_<wfm>.isf.

Arbitr

ary waveforms EMEM, ARB1 - ARB4 are not saved with the

:SAVe:WAVEform ALL, <ﬁle> command.

For ex

ample: With CH1,CH2 and MATH only displayed, the command

:SAVE:WAVEFORM ALL,"E:/MyWaveforms/Test1"

saves

CH1 to E:/MyWaveforms/Test1_CH1.isf

CH2 to E:/MyWaveforms/Test1_CH2.isf

MATH to E:/MyWaveforms/Test1_MATH.isf

r SPREADSheet format, the displayed waveforms are saved to a single CSV

ﬁle.

tempting to save a waveform to itself, such as: :

SAVe:WAVEform REF1,REF1

:SAVe:WAVEform ARB1,ARB1

results in an error event: 100,"Command error; Source and destination are the

same; ..

The MATLAB Level 5 ﬁle format description is as follows:

The RF_BB_IQ data can be exported to a ﬁle in a format that is readable by

MATLAB when RF_BB_IQ is saved with the MATLAB ﬁle format, which

is speciﬁed using :SAVe:WAVEform:FILEFormat:RF_BB_IQ MATLAB.

The MATLAB ﬁle format is the Level 5 format described in the "MAT-File

Format R2013a" document available from the MathWorks web site at

http://www.mathworks.com/help/pdf_doc/matlab/matﬁle_format.pdf. This

section describes our use of the Level 5 format for the export of RF_BB_IQ data

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