B&K Precision 2552, 2559 Programming Manual
PROGRAMMING MANUAL
Digital Storage Oscilloscope
MODEL: 2550 Series (2552, 2553, 2554, 2555, 2556, 2557,
2558, 2559)
TABLE OF CONTENTS
Using Status Registers ................................................... 3
About these Commands & Queries ................................ 3
How they are listed? ................................................................................................. 3
How they are described? ........................................................................................... 3
Command Notation .......................................................... 4
Table of Commands & Queries ....................................... 5
Commands & Queries ................................................... 11
Index ............................................................................. 131
2
Using Status Registers
A wide range of status registers allows the oscilloscope’s internal processing status to be
determined quickly at any time. These registers and the instrument’s status reporting system are
designed to comply with IEEE 488.2 recommendations. Following an overview, starting this
page, each of the registers and their roles are described.
Related functions are grouped together in common status registers. Some, such as the Status
Byte Register (STB) or the Standard Event Status Register (ESR), are required by the IEEE
488.2 Standard. Other registers are device-specific, and include the Command Error Register
(CMR) and Execution Error Register (EXR). Those commands associated with IEEE 488.2
mandatory status registers are preceded by an asterisk <*>.
About these Commands & Queries
This section lists and describes the remote control commands and queries recognized by the
instrument. All commands and queries can be executed in either local or remote state.
The description for each command or query, with syntax and other information, begins on a new
page. The name (header) is given in both long and short form at the top of the page, and the
subject is indicated as a command or query or both. Queries perform actions such as obtaining
information, and are recognized by the question mark (?) following the header.
How they are listed?
The descriptions are listed in alphabetical order according to their long form. Thus the
description of ATTENUATION, whose short form is ATTN, is listed before that of AUTO
SETUP, whose short form is ASET.
How they are described?
In the descriptions themselves, a brief explanation of the function performed is given. This is
3
followed by a presentation of the formal syntax, with the header given in Upper-and-LowerCase characters and the short form derived from it in ALL UPPER-CASE characters. Where
applicable, the syntax of the query is given with the format of its response.
sd
Command Notation
The following notation is used in the commands:
< > Angular brackets enclose words that are used as placeholders, of
which there are two types: the header path and the data parameter
of a command.
: = A colon followed by an equals sign separates a placeholder from
the description of the type and range of values that may be used in
a command instead of the placeholder.
{} Braces enclose a list of choices, one of which one must be made.
[ ] Square brackets enclose optional items.
… An ellipsis indicates that the items both to its left and right may be
repeated a number of times.
As an example, consider the syntax notation for the command to set the vertical input sensitivity:
<channel>:VOLT_DIV <v_gain>
<channel> : = {C1, C2, C3, C4}
<v_gain>: = 2 mV to 5 V
The first line shows the formal appearance of the command, with <channel> denoting the
placeholder for the header path and <v_gain> the placeholder for the data parameter specifying
the desired vertical gain value. The second line indicates that one of four channels must be
chosen for the header path. And the third explains that the actual vertical gain can be set to any
value between 2 mV and 5 V.
4
Short Form
Long Form
Subsystem
What the Command or
Query Does
ALST?
ALL_STATUS?
STATUS
Reads and clears
the contents of all
status registers.
ARM
ARM_ACQUISITION
ACQUISITION
Changes acquisition state
from “stopped” to
“single”.
ATTN
ATTENUATION
ACQUISITION
Selects the vertical
attenuation factor of the
probe
ACAL
AUTO_CALIBRATE
MISCELLANEOUS
Enables or disables
automatic calibration.
ASET
AUTO_SETUP
ACQUISITION
Adjusts vertical, time base
and trigger parameters.
AUTTS
AUTO_TYPESET
ACQUISITION
Selects the display type of
automatic setup.
AVGA
AVERAGE_ACQUIRE
ACQUISITION
Selects the average times
of average acquisition.
BWL
BANDWIDTH_LIMIT
ACQUISITION
Enables/disables the
bandwidth-limiting lowpass filter.
BUZZ
BUZZER
MISCELLANEOUS
Controls the built-in
piezo-electric buzzer.
*CAL?
*CAL?
MISCELLANEOUS
Performs complete
internal calibration of the
instrument.
CHDR
COMM_HEADER
COMMUNICATION
Controls formatting of
query responses.
*CLS
*CLS
STATUS
Clears all status data
registers.
CMR?
CMR?
STATUS
Reads and clears the
Command error Register
(CMR).
CONET
COMM_NET
COMMUNICATION
Specifies network
addresses of scope and
printers.
CPL
COUPLING
ACQUISITION
Selects the specified input
channel’s coupling mode.
CRMS
CURSOR_MEASURE
CURSOR
Specifies the type of
cursor/parameter
measurement.
Table of Commands & Queries
5
CRST?
CURSOR_SET?
CURSOR
Allows positioning of any
one of eight cursors.
CRVA?
CURSOR_VALUE?
CURSOR
Returns trace values
measured by specified
cursors.
CRAU
CURSOR_AUTO
CURSOR
Changes the cursor mode
to auto mode.
CSVS
CSV_SAVE
SAVE/RECALL
Saves specified waveform
data of CSV format to
USB device.
COUN
COUNTER
FUNCTION
Enables or disables the
cymometer to display on
the screen.
CYMT
CYMOMETER
FUNCTION
Returns the current
cymometer value which
displaying on the screen.
DATE
DATE
MISCELLANEOUS
Changes the date/time of
the internal real-time
clock.
DDR?
DDR?
STATUS
Clears the Device
Dependent Register
(DDR).
DEF
DEFINE?
FUNCTION
Specifies math expression
for function evaluation.
DELF
DELETE_FILE
MASS STORAGE
Deletes files from mass
storage.
DIR
DIRECTORY
MASS STORAGE
Creates and deletes file
directories.
DTJN
DOT_JOIN
DISPLAY
Controls the interpolation
lines between data points.
*ESE
*ESE
STATUS
Sets the Standard Event
Status Enable register
(ESE).
*ESR?
*ESR?
STATUS
Reads, clears the Event
Status Register (ESR).
EXR?
EXR?
STATUS
Reads, clears the
Execution error Register
(EXR).
FLNM
FILENAME
MASS STORAGE
Changes default
filenames.
FRTR
FORCE_TRIGGER
ACQUISITION
Forces the instrument to
make one acquisition.
FVDISK
FORMAT_VDISK
MASS STORAGE
Reads the capability of the
USB device.
FILT
FILTER
FUNCTION
Enables or disables the
filter of specified source.
6
FILTS
FILT_SET
FUNCTION
Selects the type of filter,
and sets the limit value of
filter.
FFTW
FFT_WINDOW
FUNCTION
Selects the window of
FFT.
FFTZ
FFT_ZOOM
FUNCTION
Selects the zoom in/out
times of FFT trace.
FFTS
FFT_SCALE
FUNCTION
Selects the vertical scale
of FFT trace.
FFTF
FFT_FULLSCREEN
FUNCTION
Enables or disables to
display the FFT trace full
screen.
GRDS
GRID_DISPLAY
DISPLAY
Selects the type of grid
GCSV
GET_CSV
WAVEFORMTRANS
Specifies waveform data
of format to controller.
HMAG
HOR_MAGNIFY
DISPLAY
Horizontally expands the
selected expansion trace.
HPOS
HOR_POSITION
DISPLAY
Horizontally positions
intensified zone’s center.
HCSU
HARDCOPY_SETUP
HARD COPY
Configures the hard-copy
driver.
*IDN?
*IDN?
MISCELLANEOUS
For identification
purposes.
INTS
INTENSITY
DISPLAY
Sets the grid or trace/text
intensity level.
ILVD
INTERLEAVED
ACQUISITION
Enables/disables random
interleaved sampling
(RIS).
INR?
INR?
STATUS
Reads, clears INternal
state change Register
(INR).
INVS
INVERT_SET
DISPLAY
Invert the trace or the
math waveform of
specified source.
LOCK
LOCK
MISCELLANEOUS
Lock keyboard
MENU
MENU
DISPLAY
Enables or disables to
display the current menu.
MTVP
MATH_VERT_POS
ACQUISITION
Controls the vertical
position of math
waveform of specified
source.
MTVD
MATH_VERT_DIV
ACQUISITION
Controls the vertical
sensitivity of math
waveform of specified
source.
MEAD
MEASURE_DELY
FUNCTION
Selects the type of delay
7
measure.
OFST
OFFSET
ACQUISITION
Allows output channel
vertical offset adjustment.
*OPC
*OPC
STATUS
Sets the OPC bit in the
Event Status Register
(ESR).
*OPT?
*OPT?
MISCELLANEOUS
Identifies oscilloscope
options.
PACL
PARAMETER_CLR
CURSOR
Clears all current
parameters in Custom,
Pass/Fail.
PACU
PARAMETER_CUSTO
M
CURSOR
Controls parameters with
customizable qualifiers.
PAVA?
PARAMETER_VALU
E?
CURSOR
Returns current parameter,
mask test values.
PDET
PEAK_DETECT
ACQUISITION
Switches the peak detector
ON and OFF.
PERS
PERSIST
DISPLAY
Enables or disables the
persistence display mode.
PESU
PERSIST_SETUP
DISPLAY
Selects display persistence
duration.
PNSU
PANEL_SETUP
SAVE/RECALL
Complements the
*SAV/*RST commands.
PFDS
PF_DISPLAY
FUNCTION
Enables or disables to
display the test and the
message options of
pass/fail.
PFST
PF_SET
FUNCTION
Sets the X mask and the Y
mask.
PFSL
PF_SAVELOAD
SAVE/RECALL
Saves or recalls the
created mask setting.
PFCT
PF_CONTROL
FUNCTION
Selects the “operate”,
“output” and the “stop on
output” which are the
options of pass/fail.
PFCM
PF_CREATEM
FUNCTION
Creates the mask of the
pass/fail.
PFDD
PF_DATEDIS
FUNCTION
Return the number of the
pass/fail monitor which
can be displayed on the
screen.
*RCL
*RCL
SAVE/RECALL
Recalls one of five nonvolatile panel setups.
REC
RECALL
WAVEFORMTRANS
Recalls a file from mass
storage to internal
memory.
8
RCPN
RECALL_PANEL
SAVE/RECALL
Recalls a front-panel setup
from mass storage.
*RST
*RST
SAVE/RECALL
The *RST command
initiates a device reset.
REFS
REF_SET
FUNCTION
Sets the reference
waveform and its options.
*SAV
*SAV
SAVE/RECALL
Stores current state in nonvolatile internal memory.
SCDP
SCREEN_DUMP
HARD COPY
Causes a screen dump to
controller.
SCSV
SCREEN_SAVE
DISPLAY
Controls the automatic
screen saver.
*SRE
*SRE
STATUS
Sets the Service Request
Enable register (SRE).
*STB?
*STB?
STATUS
Reads the contents of
IEEE 488.
STOP
STOP
ACQUISITION
Immediately stops signal
acquisition.
STO
STORE
WAVEFORMTRANS
Stores a trace in internal
memory or mass storage.
STPN
STORE_PANEL
SAVE/RECALL
Stores front-panel setup to
mass storage.
STST
STORE_SETUP
WAVEFORMTRANS
Controls the way in which
traces are stored.
SAST
SAMPLE_STATUS
ACQUISITION
Return the acquisition
status of the scope
SARA
SAMPLE_RATE
ACQUISITION
Return the sample rate of
the scope
SANU
SAMPLE_NUM
ACQUISITION
Return the number of
sampled points available
from last acquisition and
the trigger position
SKEW
SKEW
ACQUISITION
Sets the skew of specified
trace.
SET50
SETTO%50
FUNCTION
Sets the trigger level of the
trigger source to the centre
of the signal amplitude.
SXSA
SINXX_SAMPLE
ACQUISITION
Sets the type of the
interpolation.
TDIV
TIME_DIV
ACQUISITION
Modifies the time base
setting.
TMPL
TEMPLATE
WAVEFORM
TRANSFER
Produces a complete
waveform template copy.
TRA
TRACE
DISPLAY
Enables or disables the
display of a trace.
*TRG
*TRG
ACQUISITION
Executes an ARM
9
command.
TRCP
TRIG_COUPLING
ACQUISITION
Sets the coupling mode of
the specified trigger
source.
TRDL
TRIG_DELAY
ACQUISITION
Sets the time at which the
trigger is to occur.
TRLV
TRIG_LEVEL
ACQUISITION
Adjusts the trigger level of
the specified trigger
source.
TRMD
TRIG_MODE
ACQUISITION
the trigger mode.
TRSE
TRIG_SELECT
ACQUISITION
Selects the condition that
will trigger acquisition.
TRSL
TRIG_SLOPE
ACQUISITION
Sets the trigger slope of
the specified trigger
source.
UNIT
UNIT
ACQUISITION
Sets the unit of specified
trace.
VPOS
VERT_POSITION
DISPLAY
Adjusts the vertical
position of the FFT trace.
VDIV
VOLT_DIV
ACQUISITION
Sets the vertical
sensitivity.
VTCL
VERTICAL
ACQUISITION
Controls the vertical
position of the slope
trigger line.
WF
WAVEFORM
WAVEFORMTRANS
Gets the waveform from
the instrument.
WFSU
WAVEFORM_SETUP
WAVEFORMTRANS
Specifies amount of
waveform data to go to
controller.
WAIT
WAIT
ACQUISITION
Prevents new analysis
until current has been
completed.
XYDS
XY_DISPLAY
DISPLAY
Enables or disables to
display the XY format
10
STATUS
ALL_STATUS?, ALST?
Query
Commands & Queries
DESCRIPTION The ALL_STATUS? Query reads and clears the
QUERY SYNTAX ALl_STatus?
RESPONSE FORMAT ALl_STatus
EXAMPLE The following instruction reads the contents of all the
ALST?
RELATED COMMANDS *CLS, CMR? , DDR? ,*ESR? , EXR? , *STB? , URR?
contents of all status registers: STB, ESR, INR,
DDR, CMR, EXR and URR except for the
MAV bit (bit 6) of the STB register. For an
interpretation of the contents of each register,
refer to the appropriate status register.
The ALL_STATUS? Query is useful in a complete
overview of the state of the instrument.
STB,<value>,ESR,<value>,INR,<value>,DDR,<valu
e>,CMR,<value>,EXR,<value>,URR,<value>
<value> : = 0 to 65535
status registers:
Command message:
Response message:
ALST STB, 0, ESR, 52, INR, 5, DDR, 0, CMR, 4,
EXR, 24, URR, 0
11
ACQUISITION
ARM_ACQUISITION, ARM
Command
DESCRIPTION The ARM_ACQUISITION command enables the
signal acquisition process by changing the
acquisition state (trigger mode) from “stopped” to
“single”.
COMMAND SYNTAX ARM acquisition
EXAMPLE The following command enables signal acquisition:
Command message:
ARM
RELATED COMMANDS STOP, *TRG, TRIG_MODE, WAIT
12
ACQUISITION
ATTENUATION, ATTN
Command /Query
DESCRIPTION The ATTENUATION command selects the vertical
attenuation factor of the probe. Values of 1, 5, 10, 50,
100, 500, and 1000 may be specified.
The ATTENUATION? Query returns the
attenuation factor of the specified channel.
COMMAND SYNTAX <channel>: ATTeNuation <attenuation>
<channel> : = {C1, C2, C3, C4}
<attenuation>: = {1, 5, 10, 50, 100, 500, 1000}
QUERY SYNTAX <channel>: ATTeNuation?
RESPONSE FORMAT <channel>: ATTeNuation <attenuation>
EXAMPLE The following command sets to 100 the
attenuation factor of Channel 1:
Command message:
C1:ATTN 100
13
AUTO_CALIBRATE, ACAL
Command /Query
DESCRIPTION The AUTO_CALIBRATE command is used to enable
or disable the quick calibration of the instrument.
The quick calibration may be disabled by issuing the
command ACAL OFF. Whenever it is convenient, a
*CAL? Query may be issued to fully calibrate the
oscilloscope.
The response to the AUTO_CALIBRATE?
Query indicates whether quick -calibration is enabled.
The command is only used in the CFL series
instrument.
COMMAND SYNTAX Auto_CALibrate <state>
<state> : = {ON, OFF}
QUERY SYNTAX Auto_CALibrate?
RESPONSE FORMAT Auto_CALibrate <state>
EXAMPLE The following instruction disables quick-calibration:
Command message:
ACAL OFF
RELATED COMMANDS *CAL?
14
ACQUISITION
AUTO_SETUP, ASET
Command
DESCRIPTION The AUTO_SETUP command attempts to identify
the waveform type and automatically adjusts controls
to produce a usable display of the input signal.
COMMAND SYNTAX AUTO_SETUP
EXAMPLE The following command instructs the oscilloscope
to perform an auto-setup:
Command message:
ASET
RELATED COMMANDS AUTTS
15
ACQUISITION
AUTO_TYPESET, AUTTS
Command /Query
DESCRIPTION The AUTO_TYPESET command selects the
specified type of automatically adjusting which is
used to display.
COMMAND SYNTAX AUTO_TYPESET <type>
<type> : = {SP,MP,RS,DRP,RC}
SP means only one period to be displayed, MP means
multiple periods to be displayed, RS means the
waveform is triggered on the rise side, DRP means
the waveform is triggered on the drop side, and RC
means to go back to the state before auto set.
QUERY SYNTAX AUTO_TYPESET?
RESPONSE FORMAT AUTO_TYPESET <type>
EXAMPLE The following command sets the type of automatic
adjustment to multiple periods:
Command message:
AUTTS MP
RELATED COMMANDS ASET
16
ACQUISITION
AVERAGE_ACQUIRE, AVGA
Command /Query
DESCRIPTION The AVERAGE_ACQUIRE command selects the
average times of average acquisition.
The response to the AVERAGE_ACQUIRE query
indicates the times of average acquisition.
COMMAND SYNTAX AVERAGE_ACQUIRE <time>
<time> : = {4, 16, 32, 64,128,256}
QUERY SYNTAX AVERAGE_ACQUIRE?
RESPONSE FORMAT AVERAGE_ACQUIRE <time>
EXAMPLE The following turns the average times of average
acquisition 16:
Command message:
AVGA 16
17
ACQUISITION
BANDWIDTH_LIMIT, BWL
Command /Query
DESCRIPTION BANDWIDTH_LIMIT enables or disables the
bandwidth-limiting low-pass filter. If the bandwidth
filters are on, it will limit the bandwidth to reduce
display noise. When you turn Bandwidth Limit ON,
the Bandwidth Limit value is set to 20 MHz. It also
filters the signal to reduce noise and other unwanted
high frequency components.
The response to the BANDWIDTH_LIMIT? Query
indicates whether the bandwidth filters are on or off.
COMMAND SYNTAX BandWidth_Limit <channel>, <mode>
[, <channel>, <mode> [, <channel>, <mode>
[, <channel>, <mode>]]]
<channel> : = {C1, C2, C3, C4}
<mode> : = {ON, OFF}
QUERY SYNTAX BandWidth_Limit?
RESPONSE FORMAT BandWidth_Limit <channel>, <mode> [, <channel>,
<mode> [, <channel>, <mode> [, <channel>,
<mode>]]]
EXAMPLE The following turns on the bandwidth filter for all
channels, when Global_BWL is on (as it is by default
The following turns the bandwidth filter on for
Channel 1only:
Command message:
BWL C1, ON
18
MISCELLANEOUS
BUZZER, BUZZ
Command /Query
DESCRIPTION The BUZZER command enables or disables sound
switch.
The response to the BUZZER? query indicates
whether the sound switch is enabled.
COMMAND SYNTAX BUZZer <state>
<state> : = {ON, OFF}
QUERY SYNTAX BUZZER?
RESPONSE FORMAT BUZZER <state>
EXAMPLE Sending the following code will let the oscilloscope
turn on the sound switch.
Command message:
BUZZ ON
19
MISCELLANEOUS
*CAL?
Query
DESCRIPTION The *CAL? query cause the oscilloscope to perform
an internal self-calibration and generates a response.
QUERY SYNTAX *CAL?
RESPONSE FORMAT *CAL <diagnostics>
<diagnostics> : = 0
0 = Calibration successful
EXAMPLE The following instruction forces a self-calibration:
Command message:
*CAL?
Response message:
*CAL 0
RELATED COMMANDS AUTO_CALIBRATE
20
COMM_HEADER, CHDR
Command/ Query
DESCRIPTION The COMM_HEADER command controls the way
the oscilloscope formats responses to queries. There
are three response formats: LONG, in which
responses start with the long form of the header word;
SHORT, where responses start with the short form of
the header word; and OFF, for which headers are
omitted from the response and units in numbers are
suppressed.
Unless you request otherwise, the SHORT response
format is used.
This command does not affect the interpretation of
messages sent to the oscilloscope. Headers can be
sent in their long or short form regardless of the
COMM_HEADER setting.
Querying the vertical sensitivity of Channel 1 may
result in one of the following responses:
COMM_HEADER RESPONSE
LONG C1:VOLT_DIV 200E-3 V
SHORT C1:VDIV 200E-3 V
OFF 200E-3
COMMAND SYNTAX Comm_HeaDeR <mode>
<mode> : = {SHORT, LONG, OFF}
QUERY SYNTAX Comm_HeaDeR?
RESPONSE FORMAT Comm_HeaDeR <mode>
EXAMPLE The following code sets the response header format
to SHORT:
Command message:
CHDR SHORT
21
*CLS
Command
DESCRIPTION The *CLS command clears all the status data
registers.
COMMAND SYNTAX *CLS
EXAMPLE The following command causes all the status data
registers to be cleared:
Command message:
*CLS
RELATED COMMANDS ALL_STATUS, CMR, DDR, *ESR, EXR, *STB, URR
22
CMR?
Query
DESCRIPTION The CMR? Query reads and clears the contents of
the Command error Register (CMR) see table
next page---which specifies the last syntax error
type detected by the instrument.
QUERY SYNTAX CMR?
RESPONSE FORMAT CMR <value>
<value> : = 0 to 14
EXAMPLE The following instruction reads the contents of
the CMR register:
Command message:
CMR?
Response message:
CMR 0
RELATED COMMANDS ALL_STATUS? ,*CLS
23
Command Error Status Register Structure (CMR)
Value
Description
1
Unrecognized command/query header
2
Invalid character
3
Invalid separator
4
Missing parameter
5
Unrecognized keyword
6
String error
7
Parameter cannot allowed
8
Command String Too Long
9
Query cannot allowed
10
Missing Query mask
11
Invalid parameter
12
Parameter syntax error
13
Filename too long
ADDITIONAL INFORMATION
Command Error Status Register Structure (CMR)
24
MISCELLANEOUS
COMM_NET, CONET
Command /Query
DESCRIPTION The COMM_NET command changes the IP
address of the oscilloscope’s internal network
interface.
The COMM_NET? query returns the IP address
of the oscilloscope’s internal network interface.
COMMAND SYNTAX COMM_NET <ip_add0>, <ip_add1>,
<ip_add2>, <ip_add3>
< ip_add >:= 0 to 255
QUERY SYNTAX COMM_NET?
RESPONSE FORMAT COMM_NET <ip_add0>, <ip_add1>,
<ip_add2>, <ip_add3>
EXAMPLE This instruction will change the IP address to
10.11.0.230:
Command message:
CONET 10,11,0,230
25
ACQUISITION
COUPLING, CPL
Command /Query
DESCRIPTION The COUPLING command selects the
coupling mode of the specified input channel.
The COUPLING? query returns the coupling
mode of the specified channel.
COMMAND SYNTAX <channel>: CouPLing <coupling>
<channel> : = {C1, C2, C3, C4}
<coupling> : = {A1M, A50, D1M, D50, GND}
The A of the <coupling> is alternating current.
The D of the <coupling> is direct current.1M
and 50 is the impedance of input. Some series
(CML) couldn’t have the set of input
impedance.
QUERY SYNTAX <channel>: CouPLing?
RESPONSE FORMAT <channel>: CouPLing <coupling>
EXAMPLE The following command sets the coupling of
Channel 2 to 50 ΩDC:
Command message:
C2: CPL D50
26
Notation
HREL
Selected tract-cursor mode
VREL
Selected manual-cursor mode and set to voltage type
AUTO
Selected auto mode
OFF
Cursors and parameters off
CURSOR_MEASURE, CRMS
Command /Query
DESCRIPTION The CURSOR_MEASURE command
specifies the type of cursor or parameter
measurement to be displayed
The CURSOR_MEASURE? query indicates
which cursors or parameter measurements are
currently displayed.
COMMAND SYNTAX CuRsor_MeaSure <mode>
<mode>={ OFF,HREL,VREL,AUTO}
QUERY SYNTAX CuRsor_MeaSure?
RESPONSE FORMAT CuRsor_MeaSure <mode>
EXAMPLE The following command determines cursor
function is turned off:
Command message:
CRMS OFF
RELATED COMMANDS CURSOR_VALUE, PARAMETER_VALUE
27
Notation
HREF
The time value of curA under Track cursor mode
HDIF
The time value of curB under Track cursor mode
VREF
The volt-value of curA under manual cursor mode
VDIF
The volt -value of curB under manual cursor mode
TREF
The time value of curA under manual cursor mode
TDIF
The time value of curB under manual cursor mode
CURSOR
CURSOR_SET, CRST
Command /Query
DESCRIPTION The CURSOR_SET command allows the user
to position any one of the eight independent
cursors at a given screen location. The
positions of the cursors can be modified or
queried even if the required cursor is not
currently displayed on the screen. When
setting a cursor position, a trace must be
specified, relative to which the cursor will
be positioned.
The CURSOR_SET? Query indicates the
current position of the cursor(s). The values
returned depend on the grid type selected.
COMMANDSYNTAX
<trace>:CuRsor_SeT<cursor>,<position>[,<c
ursor>,<position>,<cursor> ,<position>]
< trace > : = {C1, C2, C3, C4}
<cursor> :
={HREF,HDIF,VREF,VDIF,TREF,TDIF}
<position> ： = 0.1 to 11.9(or 17.9) DIV
(horizontal of track, the range of the
value is related to the size of the
screen)
<position>：= -4 to 4 DIV (vertical)
<position>：= -6(or -9) to 6 DIV (horizontal
of manual, the range of the value is
related to the size of the screen)
QUERY SYNTAX <trace>: CuRsor_SeT? [<cursor>, …<cursor>]
28
<cursor> :={ HREF, HDIF, VREF, VDIF,
TREF, TDIF}
RESPONSE FORMAT <trace>:CuRsor_SeT <cursor>, <position> [,
<cursor>, <position>, <cursor>, <position>]
EXAMPLE The following command positions the VREF
and VDIF cursors at +3 DIV and −1 DIV
respectively, using C1 as a reference:
Command message:
C1: CRST VREF, 3DIV, VDIF, −1DIV
RELATED COMMANDS CURSOR_MEASURE, CURSOR_VALUE,
PARAMETER_VALUE
29
Notation
HREL
the cursor value under track cursor mode
VREL
the dalta volt-value under manual cursor mode
CURSOR
CURSOR_VALUE?, CRVA?
Query
DESCRIPTION The CURSOR_VALUE? Query returns the
values measured by the specified cursors for a
given trace. (The PARAMETER_VALUE?
query is used to obtain measured waveform
parameter values.)
QUERY SYNTAX <trace>: CuRsor_Value? [<mode>,…<mode>]
<trace> : = { C1, C2, C3, C4}
<mode> : = { HREL, VREL }
RESPONSE FORMAT <trace> : CuRsor_Value HREL,
<B->T - A->T>,<B->V - A->V>,<A->T>,
<B->T>,
<(B->V - A->V)/(B->T - A->T)>
<trace> : CuRsor_Value VREL,<delta_vert>
EXAMPLE The following query reads the dalta volt value
under manual cursor mode (VREL) on
Channel 2:
Command message:
C2:CRVA? VREL
Response message:
C2:CuRsor_Value VREL 1.00V
RELATED COMMANDS CURSOR_SET, PARAMETER_VALUE
30
Loading...