MDO3000 Programmer Manual.pdf - 第629页

Commands Listed in Alphabetical Order Menu->save wav eform menu. The type of ﬁle saved is dependent upon the SA V e:W A VEform:FILEFormat command. For instrumen ts with the arbitrary waveform fea ture, the source can …

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

Commands Listed in Alphabetical Order

from the instru

ment. Please reference the MAT-File Format document for detailed

information about the ﬁle header and data elements.

The 128-byte header is comprised of the following ﬁelds:

Descriptive Text (116 bytes):

MATLAB 5.0 MAT-ﬁle, Platform: <ID>, Created on: <date>

where:

<ID> is the instrument ID string of the form:

TEK/MSO4104B/SN C0

01023/FV v2.97061

<date> is the date/time of the form:

Tue Aug 6 18:30:28 2013

This 116-byte ﬁeld is padded at the end with spaces.

Subsystem Data Offset (8 bytes):

This is always written as 8 ASCII spaces (0x20).

Version (2 bytes):

This is the MATLAB ﬁle format version number and is always written as

0x0100.

How this is read is determined by the next ﬁeld.

Endian Indicator (2 bytes):

This is written as a 16-bit value of ('M' << 8) | 'I' and is used by the reader to

determine whether byte swapping is needed. If it reads as MI, then no byte

swapping is needed.

The pertinent instrument set

tings, comprised of center frequency, span and sample

rate are written as miMATRIX elements. Each of these elements have an ASCII

name and the values are miDOUBLE:

CenterFreq is the center frequency in hertz.

Span is the frequency span in hertz.

SampleRate is the sampling rate in samples per second.

Each of these is written as an miMATRIX element, a complex record of the

following format:

Array Type (4 bytes) = miMATRIX (14)

Array Size (4 bytes) = 56 + nameLen + padding

nameLen is the string length of the name

padding = (8 - (nameLen % 8)) % 8

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