MDO3000 Programmer Manual.pdf - 第36页

Command Syntax Cursor Position Mnemonics When cursors ar e displayed, commands may specify which cursor of the pair to use. T able 2-5: Channel Mnemonics Symbol Meaning CH<x> A channel speci ﬁ er; <x> is 1 th…

Command Syntax

If the header is

off:

FULL;1

1. Set commands and queries may be concatenated in the same message. For

example,

ACQuire:MODe SAMple;NUM AVg?;STATE?

is a valid message that sets the acquisition mode to sample. The message then

queries the number of acquisitions for averaging and the acquisition state.

Concatenated commands and queries are executed in the order received.

Here are some invalid concatenations:

DISPlay:STYle:DOTsonly OFF;ACQuire:NUMAVg 8 (no colon before

ACQuire)

DISPlay:GRAticule FULL;:STYle:DOTSONLY OFF (extra colon before

STYle.

DISPlay:GRAticule FULL;:*TRG (colon before a star (*) command)

MATH:HORizontal:SCAle 1.0e-1;HORizontal:POSition 5.0el

(levels of the mnemonics are different; either remove the second use of

HORizontal: or place :MATH in front of HORizontal:POSition)

Terminating

This documentation uses <EOM> (End of Message) to represent a message

terminator.

Table 2-4: End of Message Terminator

Sym

bol

Mea

ning

OM>

Message terminator

The end-of-message terminator must be the END message (EOI asserted

concurrently with the last data byte). The last data byte may be an ASCII line

feed (LF) character.

This oscilloscope does not support ASCII LF only message termination. The

oscilloscope always terminates outgoing messages with LF and EOI.

Constructed Mnemonics

Some header mnemonics specify one of a range of mnemonics. For example, a

channel mnemonic can be CH1, CH2, CH3, or CH4. You use these mnemonics

in the command just as you do any other mnemonic. For example, there is a

CH1:POSition command, and there is also a CH2:POSi tion command. In the

command descriptions, this list of choices is abbreviated as CH<x>.

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

Command Syntax

Cursor Position

Mnemonics

When cursors ar

e displayed, commands may specify which cursor of the pair to

use.

Table 2-5: Channel Mnemonics

Symbol Meaning

CH<x> A channel speciﬁer; <x> is 1 through 4.

Table 2-6: Cursor Mnemonics

Symbol Meaning

CURSOR<x>

A cursor selector; <x> is either 1 or 2.

POSITION<x>

A cursor selector; <x> is either 1 or 2.

HPOS<x>

A cursor selector; <x> is either 1 or 2.

Math Spe

ciﬁer Mnemonics

Commands can specify the mathematical waveform to use as a mnemonic in

the header.

Table 2-7: Math S peciﬁer Mnemonics

Symbol Meaning

Math<x>

A math waveform speciﬁer; <x> is 1.

Measurement Spec iﬁer

Mnemonics

Commands can specify which measurement to set or query as a mnemonic in the

header. Up to eight automated measurements may be displayed.

Table 2-8: Measurement Speciﬁer Mnemonics

Symbol Meaning

MEAS<x> A measurement speciﬁer; <x> is 1 through 8.

hannel Mnemonics

Commands specify the channel to use as a mnemonic in the header.

Reference Waveform

Mnemonics

Commands can specify the reference waveform to use as a mnemonic in the

header.

Table 2-9: Reference Waveform Mnemonics

Symbol Meaning

REF<x>

A reference waveform speciﬁer; <x> is 1, 2, 3, or 4 for 4-channel

oscilloscopes and 1 or 2 for 2-channel oscilloscopes.

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

Command Syntax

Argument Types

Commands use arguments such as enumeration, numeric, quoted string and block.

Each of these arguments are listed in detail below.

Enumeration

Enter these arguments as unquoted text words. Like key words, enumeration

arguments follow the same convention where the portion indicated in uppercase is

required and that in lowercase is optional.

For example:

SAVe:WAVEform:FILEFormat INTERNal

Numeric

Many osci

lloscope commands require numeric arguments. The syntax shows

the format that the oscilloscope returns in response to a query. This is alsothe

preferred format when sending the command to the oscilloscope, though any of

the formats will be accepted. This documentation represents these arguments as

described below.

Table 2-10: Numeric Arguments

Symbol Meaning

<NR1>

Signed integer value

<NR2> Floating point value w ithout an exponent

<NR3> Floating point value w ith an exponent

<bin>

Signed or unsigned integer in binary format

Most numeric arguments will be automatically forced to a valid setting, by either

rounding or truncating, when an invalid number is input, unless otherwise noted

the command description.

Quoted String

Some commands accept or return data in the form of a quoted string, which is

simply a group of ASCII characters enclosed by a single quote (') or double quote

(

"). The following is an example of a quoted string:

"This i s a quote d

string"

. This documentation represents these arguments as follows:

Table 2-11: Quoted String Argument

Symbol Meaning

<QString> Quoted string of ASCII text

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