GW Instek GDS-1000A Series Owner's manual

Digital Storage Oscilloscope
GDS-1000A Series
PROGRAMMING MANUAL
GW INSTEK PART NO. 82DS-1102AI01
ISO-9001 CERTIFIED MANUFACTURER
May 2009 edition
This manual contains proprietary information which is protected by
copyright. All rights are reserved. No part of this manual may be
photocopied, reproduced or translated to another language without
prior written consent of Good Will Corporation.
The information in this manual was correct at the time of printing.
However, Good Will continues to improve products and reserves the
right to change specifications, equipment, and maintenance
procedures at any time without notice.
Windows is a registered trademark of Microsoft Corporation in the United States and other countries.
Good Will Instrument Co., Ltd.
No. 7-1, Jhongsing Rd., Tucheng City, Taipei County 236, Taiwan.

TABLE OF CONTENTS
3
Table of Contents
INTERFACE OVERVIEW ..................................................... 4
Rear Panel Overview .................................. 4
Configuring the USB Interface ................... 5
COMMAND OVERVIEW .................................................... 6
Command Syntax ....................................... 6
List of Command in Functional Order ........ 7
List of Command in Alphabetical Order ... 11
COMMAND DETAILS ...................................................... 13
System command .................................... 14
Acquisition Command.............................. 17
Autoset Command ................................... 22
Channel / Math Command....................... 23
Cursor Command..................................... 28
Display Command.................................... 32
Measure command .................................. 35
Save/Recall Command ............................. 45
Time (Horizontal) command ................... 50
Trigger command..................................... 53
GDS-1000 Programming Manual
4
INTERFACE OVERVIEW
This manual describes how to use the GDS-
1000A’s remote command functionality and lists
the command details. The Overview chapter
describes how to configure the GDS-1000A USB
remote control interface.
Rear Panel Overview

INTERFACE OVERVIEW
5
Configuring the USB Interface
USB connection PC side connector Type A, host
GDS-1000A side
connector
Type B, slave
Speed
1.1/2.0 (full speed)
Panel operation 1. Connect the USB cable to
the USB slave port on the
rear.
2. When the PC asks for the USB driver, select
dso_cdc_1000.inf which is downloadable from
the GW Instek website, www.gwinstek.com, in
the GDS-1000A downloads section.
3. On the PC, activate a terminal application such
as MTTTY (Multi-Threaded TTY). To check the
COM port No., see the Device Manager in the
PC. For WindowsXP, select Control panel →
System →Hardware tab.
4. Run this query command via the terminal
application.
*idn?
This command should return the manufacturer,
model number, serial number, and firmware
version in the following format.
GW, GDS-1002A, 000000001, V1.00
5. Configuring the command interface is
completed. Refer to the other chapters for more
details.
Page6: list of commands and command syntax
Page13: details of each command
GDS-1000 Programming Manual
6
COMMAND OVERVIEW
The Command overview chapter lists all GDS-
1000A commands in functional order as well as
alphabetical order. The command syntax section
shows you the basic syntax rules you have to
apply when using commands.
Command Syntax
Compatible
standard
USB CDC_ACM compatible
SCPI, 1994 (partially compatible)
Command format trig:del:mod <NR1>LF
1234
1: command header
2: single space
3: parameter
4: message terminator
Parameter Type Description Example
<Boolean>
boolean logic 0, 1
<NR1>
Integers 0, 1, 2, 3
<NR2>
decimal numbers 0.1, 3.14, 8.5
<NR3>
floating point 4.5e-1, 8.25e+1
<NRf>
any of NR1, 2, 3 1, 1.5, 4.5e-1
Message
terminator
LF^END line feed code (hexadecimal 0A)
with END message
LF
line feed code
<dab>^END
last data byte with END message
Note Commands are non-case sensitive.

COMMAND OVERVIEW
7
List of Command in Functional Order
System *IDN..............................................................................14
*LRN..............................................................................14
*RST ..............................................................................15
:SYSTem:ERRor.............................................................15
:SYSTem:VERSion ........................................................16
Acquisition :ACQuire:AVERage .......................................................17
:ACQuire:HDELay.........................................................18
:ACQuire:MODe ...........................................................18
:ACQuire<X>:LMEMory ...............................................19
:ACQuire<X>:MEMory .................................................20
Autoset :AUToset........................................................................22
Channel / Math :CHANnel<X>:BWLimit ...............................................23
:CHANnel<X>:COUPling .............................................23
:CHANnel<X>:DISPlay ................................................. 24
:CHANnel<X>:EXPand .................................................24
:CHANnel<X>:INVert...................................................25
:CHANnel<X>:MATH...................................................25
:CHANnel<X>:OFFSet .................................................26
:CHANnel<X>:PROBe .................................................. 26
:CHANnel<X>:SCALe ...................................................27
Cursor :CURSor:X<X>Position.................................................28
:CURSor:Y<X>Position.................................................29
:CURSor:<X>DELta.......................................................29
:CURSor:<X>DISplay....................................................30
:CURSor:SOURce..........................................................31
GDS-1000 Programming Manual
8
Display :DISPlay:ACCumulate...................................................32
:DISPlay:CONTrast.......................................................32
:DISPlay:GRATicule ......................................................33
:DISPlay:WAVeform......................................................33
:REFResh .......................................................................34
Measure :MEASure:FALL.............................................................35
:MEASure:FOVShoot....................................................36
:MEASure:FPReshoot ...................................................36
:MEASure:FREQuency..................................................37
:MEASure:NWIDth .......................................................37
:MEASure:PDUTy..........................................................37
:MEASure:PERiod .........................................................38
:MEASure:PWIDth ........................................................ 38
:MEASure:RISe..............................................................39
:MEASure:ROVShoot....................................................39
:MEASure:RPReshoot...................................................40
:MEASure:SOURce .......................................................40
:MEASure:VAMPlitude .................................................40
:MEASure:VAVerage .....................................................41
:MEASure:VHI...............................................................41
:MEASure:VLO..............................................................42
:MEASure:VMAX...........................................................42
:MEASure:VMIN ...........................................................43
:MEASure:VPP ..............................................................43
:MEASure:VRMS...........................................................44

COMMAND OVERVIEW
9
Save/Recall :MEMory<X>:RECall:SETup.........................................45
:MEMory<X>:RECall:WAVeform..................................45
:MEMory<X>:SAVe:SETup...........................................46
:MEMory<X>:SAVe:WAVeform....................................46
*RCL ..............................................................................47
:REF<X>:DISPlay...........................................................47
:REF<X>:LOCate...........................................................48
:REF<X>:SAVe...............................................................48
*SAV ..............................................................................49
Time
(Horizontal)
:TIMebase:DELay..........................................................50
:TIMebase:SCALe .........................................................50
:TIMebase:SWEep ........................................................51
:TIMebase:WINDow:DELay .........................................51
:TIMebase:WINDow:SCALe.........................................52
(Continued on next page)
GDS-1000 Programming Manual
10
Trigger :FORCe ..........................................................................53
:RUN..............................................................................54
:SINGle..........................................................................54
:STOP ............................................................................54
*TRG..............................................................................54
:TRIGger:COUPle..........................................................54
:TRIGger:FREQuency....................................................55
:TRIGger:LEVel..............................................................55
:TRIGger:MODe............................................................55
:TRIGger:NREJ ..............................................................56
:TRIGger:PULSe:MODe................................................57
:TRIGger:PULSe:TIMe ..................................................57
:TRIGger:REJect ............................................................58
:TRIGger:SLOP..............................................................58
:TRIGger:STATe ............................................................59
:TRIGger:SOURce.........................................................59
:TRIGger:TYPe...............................................................60
:TRIGger:VIDeo:FIELd..................................................60
:TRIGger:VIDeo:LINe ...................................................61
:TRIGger:VIDeo:POLarity ............................................. 61
:TRIGger:VIDeo:TYPe ...................................................62

COMMAND OVERVIEW
11
List of Command in Alphabetical Order
Command Pa
g
e Command
Pa
g
e
A L
:ACQuire:AVERage 17 *LRN 14
:ACQuire:HDELay 18 M
:ACQuire:MODe 18 :MEASure:FALL 35
:ACQuire<X>:LMEMor
y
19 :MEASure:FOVShoot
36
:ACQuire<X>:MEMor
y
20 :MEASure:FPReshoot
36
:AUToset 22 :MEASure:FREQuenc
y
37
C :MEASure:NWIDth 37
:CHANnel<X>:BWLimit 23 :MEASure:PDUTy 37
:CHANnel<X>:COUPling 23 :MEASure:PERiod 38
:CHANnel<X>:DISPla
y
24 :MEASure:PWIDth
38
:CHANnel<X>:EXPand 24 :MEASure:RISe
39
:CHANnel<X>:INVert 25 :MEASure:ROVShoot
39
:CHANnel<X>:MATH 25 :MEASure:RPReshoot 40
:CHANnel<X>:OFFSet 26 :MEASure:SOURce 40
:CHANnel<X>:PROBe 26 :MEASure:VAMPlitude 40
:CHANnel<X>:SCALe 27 :MEASure:VAVera
g
e
41
:CURSor:SOURce 31 :MEASure:VHI
41
:CURSor:X1Position 28 :MEASure:VLO
42
:CURSor:X2Position 28 :MEASure:VMAX 42
:CURSor:XDELta 29 :MEASure:VMIN 43
:CURSor:XDISplay 30 :MEASure:VPP 43
:CURSor:Y1Position 29 :MEASure:VRMS
44
:CURSor:Y2Position 29 :MEMor
y
<X>:RECall:SETup
45
:CURSor:YDELta 29 :MEMor
y
<X>:RECall:WAVeform
45
:CURSor:YDISplay 30 :MEMory<X>:SAVe:SETup 46
D :MEMory<X>:SAVe:WAVeform 46
:DISPlay:ACCumulate 32 R
:DISPla
y
:CONTrast 32 *RCL 47
:DISPla
y
:GRATicule 33 :REF<X>:DISPla
y
47
:DISPla
y
:WAVeform 33 :REF<X>:LOCate
48
F :REF<X>:SAVe 48
:FORCe 53 :REFResh 34
I *RST 15
*IDN 14 :RUN 54
GDS-1000 Programming Manual
12
Command Page Command Page
S :TRIGger:LEVel 55
*SAV
49
:TRIG
g
er:MODe
55
:SINGle
54
:TRIG
g
er:NREJ
56
:STOP
54
:TRIG
g
er:PULSe:MODe
57
:SYSTem:ERRor 15 :TRIGger:PULSe:TIMe 57
:SYSTem:VERSion 16 :TRIGger:REJect 58
T :TRIGger:SLOP 58
:TIMebase:DELa
y
50
:TRIG
g
er:SOURce
59
:TIMebase:SCALe 50
:TRIG
g
er:STATe
59
:TIMebase:SWEep 51
:TRIG
g
er:TYPe
60
:TIMebase:WINDow:DELay
51 :TRIGger:VIDeo:FIELd 60
:TIMebase:WINDow:SCALe
52 :TRIGger:VIDeo:LINe 61
*TRG 54 :TRIGger:VIDeo:POLarity 61
:TRIG
g
er:COUPle 54
:TRIG
g
er:VIDeo:TYPe
62
:TRIG
g
er:FREQuenc
y
55

COMMAND DETAILS
13
COMMAND DETAILS
The Command details chapter shows the detailed
syntax, equivalent panel operation, and example
for each command. For the list of all commands,
see page7.
System command .................................... 14
Acquisition Command.............................. 17
Autoset Command ................................... 22
Channel / Math Command....................... 23
Cursor Command..................................... 28
Display Command.................................... 32
Measure command .................................. 35
Save/Recall Command ............................. 45
Time (Horizontal) command ................... 50
Trigger command..................................... 53
GDS-1000 Programming Manual
14
System command
*IDN..............................................................................14
*LRN..............................................................................14
*RST ..............................................................................15
:SYSTem:ERRor.............................................................15
:SYSTem:VERSion.........................................................16
*IDN Query
Description Returns the oscilloscope ID: manufacturer, model
name, serial number, and firmware version.
Same as: Utility key →F4
Syntax :idn?
Example :idn?
GW, GDS-1102A, P930116,
V1.00
Returns the ID for a
GDS-1102A.
*LRN Query
Description Returns the oscilloscope settings as a data string.
Syntax :lrn?

COMMAND DETAILS
15
Example :lrn?
:DISPlay:WAVeform 0;ACCumulate 0;CONTrast 0;GRATicule
0;:CHANnel1:DISPlay 1;BWLimit 0;COUPling 0;INVert
0;OFFSet 2.000e+00;PROBe 3;SCALe
2.000e+00;:CHANnel2:DISPlay 1;BWLimit 0;COUPling
0;INVert 0;OFFSet 2.000e+00;PROBe 3;SCALe
2.000e+00;:CHANnel1:MATH 0;:TIMebase:SWEep 0;SCALe
2.500e-06;DELay 0.000e+00;WINDow:SCALe 2.50000e-
07;DELay 0.00000e+00;:ACQuire:MODe 0;AVERage
0;:TRIGger:TYPe 0;SOURce 0;MODe 1;SLOP 0;COUPle 1;REJect
0;NREJ 0;LEVel 0.00000e+00;PULSe:MODe: 0;TIMe
0.00000e+00;:VIDeo:TYPe 1;POLarity 0;FIELd 0;LINe
0;:CURSor:SOURce 1;XDISPlay 0;X1Position 75;X2Position
175;YDISPlay 0;Y1Position 54;Y2Position 154;:REF1:DISPlay
0;LOCate 50;:REF2:DISPlay 0;LOCate -50;:RUN
*RST Set
Description Resets the GDS-1000A (recalls the default panel
settings).
Same as: Save/Recall key →F1
Syntax *rst
:SYSTem:ERRor Query
Description Returns the oscilloscope system error message, if
there is any.
Syntax < Long > < Short >
:system:error? :syst:err?
Parameter ID Contents ID Contents
-100 command error -102 syntax error
-220 parameter error -221 settings conflict
-222 data out of range -223 too much data
-224 illegal parameter -232 invalid format
Example :system:error?
-102
Indicates that the
command syntax is
wrong
GDS-1000 Programming Manual
16
:SYSTem:VERSion Query
Description Returns the oscilloscope firmware version.
Same as: Utility key →F4 (only the firmware
version)
Syntax < Long > < Short >
:system:version? :syst:vers?
Note For retrieving all system information including the
firmware version, use the *idn? command.

COMMAND DETAILS
17
Acquisition Command
:ACQuire:AVERage .......................................................17
:ACQuire:HDELay.........................................................18
:ACQuire:MODe ...........................................................18
:ACQuire<X>:LMEMory ...............................................19
:ACQuire<X>:MEMory .................................................20
:ACQuire:AVERage
Set
Query
Description Selects or returns the average number of waveform
acquisition in the average acquisition mode.
Same as: Acquire key →F2
Syntax < Long > < Short >
:acquire:average <NR1>
:acquire:average?
:acq:aver <NR1>
:acq:aver?
Parameter <NR1> Average No. <NR1> Average No.
1 2 5 32
2 4 6 64
3 8 7 128
4 16 8 256
Note Before using this command, select the average
acquisition mode. See the example below.
Example :acquire:mode 2
:acquire:average 2
Selects the average
acquisition mode, and
select the average
number 4
GDS-1000 Programming Manual
18
:ACQuire:HDELay
Set
Query
Description Set or query Delay On or Delay Off.
Same as: Acquire key →F4
Syntax < Long > < Short >
:acquire:hdelay <Boolean>
:acquire:hdelay?
:acq:hdel <Boolean>
:acq:hdel?
Parameter <NR1> Delay
0 Off
1 On
Example :acquire:hdelay 1
:acquire:hdelay?
1
Turns Delay On. Returns
the Delay as On.
:ACQuire:MODe
Set
Query
Description Selects or returns the acquisition mode.
Same as: Acquire key →F1 ~ F3
Syntax < Long > < Short >
:acquire:mode <NR1>
:acquire:mode?
:acq:mod <NR1>
:acq:mod?
Parameter <NR1> Mode <NR1> Mode
0 Normal 2 Average
1 Peak detect
Example :acquire:mode 2
:acquire:average 2
Selects the average
acquisition mode, and
select the average
number 4

COMMAND DETAILS
19
:ACQuire<X>:LMEMory Query
Description Returns the total waveform data in the acquisition
memory for long memory.
Syntax < Long > < Short >
:acquire<X>:lmemory? :acq<X>:lmem?
Parameter <X> Channel
1/2 Channel1/2
Note Please note that the number of points is limited to
4000 when the scope is running.
You can get the full memory depth when the
“Single” key is pressed with a triggered signal.
You can also get the full memory depth when the
“STOP” key is pressed,
However, the long memory may not fully fill up if
a slow time base is used with a fast sample rate
Also note that there are several time base settings
that don’t result in 100% of available memory, due
to a limited number of available sample rates.
Example :acquire1:lmemory?
Returns the channel 1
long memory waveform
data
If both channels are
active up to 1M points
are returned. If only CH1
is active then up to 2M
points are returned.
Data format Six data elements are concatenated to form one
data string.
GDS-1000 Programming Manual
20
#
A B C D E F
A: Data size digit B: Data size
C: Time interval D: Channel indicator
E: Reserved data F: Waveform data
Data size digit
Indicates the number of digits used for the data
string that follows. The data size digit is 4 for 4000
points, 7 for 1M or 2M points.
Data size
Indicates the data size. The data size varies from
8008 (4000 points), 2000008 (1M points) or 4000008
(2M points).
Time interval
Indicates the time interval between two adjacent
sampling points in the floating point format,
compatible with IEEE 754 standards.
Note: The data is sorted in the little-endian format.
Channel indicator
Indicates the channel, 1 or 2.
Reserved data
An unused data block, 3 bytes.
W
aveform data
The waveform data comprised of 2M data points.
Each point is made up of 2 bytes (16 bits), high
byte (MSB) first.
:ACQuire<X>:MEMory Query
Description Returns the total waveform data in the acquisition
memory.
Syntax < Long > < Short >
:acquire<X>:memory? :acq<X>:mem?

COMMAND DETAILS
21
Parameter <X> Channel
1/2 Channel1/2
Example :acquire1:memory?
Returns the channel 1
waveform data
Data format Six data elements are concatenated to form one
data string.
# A B C D E F
A: Data size digit B: Data size
C: Time interval D: Channel indicator
E: Reserved data F: Waveform data
Data size digit
Indicates the number of digits used for the data
string that follows. The data size digit is always 4.
Data size
Indicates the data size. The data size is always 8008
(4000 points per channel).
Time interval
Indicates the time interval between two adjacent
sampling points in the floating point format,
compatible with IEEE 754 standards.
Note: The data is sorted in the little-endian format.
Channel indicator
Indicates the channel, 1 or 2.
Reserved data
An unused data block, 3 bytes.
W
aveform data
The waveform data comprised of 8000 data points.
Each point is made up of 2 bytes (16 bits), high
byte (MSB) first.
GDS-1000 Programming Manual
22
Autoset Command
:AUToset Set
Description Runs the Autoset function to automatically
configure the horizontal scale, vertical scale, and
trigger according to the input signal.
Same as: Auto Set key
Syntax < Long > < Short >
:autoset :aut

COMMAND DETAILS
23
Channel / Math Command
:CHANnel<X>:BWLimit ...............................................23
:CHANnel<X>:COUPling .............................................23
:CHANnel<X>:DISPlay ................................................. 24
:CHANnel<X>:EXPand .................................................24
:CHANnel<X>:INVert...................................................25
:CHANnel<X>:MATH...................................................25
:CHANnel<X>:OFFSet .................................................26
:CHANnel<X>:PROBe .................................................. 26
:CHANnel<X>:SCALe ...................................................27
:CHANnel<X>:BWLimit
Set
Query
Description Selects or returns the bandwidth limit on/off.
Same as: Channel key →F3
Syntax < Long > < Short >
:channel<X>:bwlimit <Boolean>
:channel<X>:bwlimit?
:chan<X>:bwl
<Boolean>
:chan:bwl?
Parameter <X> Channel <NR1> Limit
1/2 CH1/2 0 Off
1 On
Example :channel1:bwlimit 1
Turns on the bandwidth
limit for Channel 1
:CHANnel<X>:COUPling
Set
Query
Description Selects or returns the coupling mode.
Same as: Channel key →F1
Syntax < Long > < Short >
GDS-1000 Programming Manual
24
:channel<X>:coupling <NR1>
:channel<X>:coupling?
:chan<X>:coup <NR1>
:chan:coup?
Parameter <X> Channel <NR1> Coupling mode
1/2 CH1/2 0 AC coupling
1 DC coupling
2 Ground coupling
Example :channel1:coupling 1
Selects the DC coupling
for Channel 1
:CHANnel<X>:DISPlay
Set
Query
Description Turns a channel on/off or returns its status.
Same as: Channel key
Syntax < Long > < Short >
:channel<X>:display <Boolean>
:channel<X>:display?
:chan<X>:disp
<Boolean>
:chan<X>:disp?
Parameter <X> Channel <NR1> Channel on/off
1/2 CH1/2 0 Off
1 On
Example :channel1:display 1
Turns on Channel 1
:CHANnel<X>:EXPand
Set
Query
Description Sets Expand from ground or from center for a
channel. Queries the Expand status of a channel.
Same as: Channel keyExpand
Syntax < Long > < Short >
:channel<X>:expand <Boolean>
:channel<X>:expand?
:chan<X>:exp
<Boolean>
:chan<X>:exp?

COMMAND DETAILS
25
Parameter <X> Channel <NR1> Expand
1/2 CH1/2 0 Ground
1 Center
Example :channel1:expand 1
:channel1:expand?
1
Sets Channel 1 to
Expand from Center.
Returns expand from
center (1) as channel 1’s
Expand status.
:CHANnel<X>:INVert
Set
Query
Description Inverts a channel or returns its status.
Same as: Channel key →F2
Syntax < Long > < Short >
:channel<X>:invert <Boolean>
:channel<X>:invert?
:chan<X>:inv
<Boolean>
:chan<X>:inv?
Parameter <X> Channel <NR1> Channel invert
1/2 CH1/2 0 off
1 on
Example :channel1:invert 1
Inverts Channel 1
:CHANnel<X>:MATH
Set
Query
Description Selects or returns the math operation type.
Same as: Math key →F1
Syntax < Long > < Short >
:channel<X>:math <NR1>
:channel<X>:math?
:chan<X>:math <NR1>
:chan<X>:math?
Parameter <X> Channel <NR1> Math operation
1/2 CH1 or CH2 0 Math off
GDS-1000 Programming Manual
26
1 Add
2 Subtract
3 Multiply
4 FFT
5 FFTrms
Example1 :channel1:math 2 Channel 1 – Channel 2
Example2 :channel2:math 2 Channel 2 – Channel 1
Example3 :channel2:math 4 Runs FFT on Channel 2
:CHANnel<X>:OFFSet
Set
Query
Description Sets or returns the offset level for a channel. The
offset level range depends on the vertical scale.
Syntax < Long > < Short >
:channel<X>:offset <NR3>
:channel<X>:offset?
:chan<X>:offs <NR3>
:chan<X>:offs?
Parameter <X> Channel <NR3> Offset level
1/2 CH1/2 ±0.5~
±5
±0.5V ~ ±5V
(2mV/div~50mV/div)
±5.0~
±50
±5.0V ~ ±50V
(100mV/div~500mV/div)
±50.0~
±300
±50.0V ~ ±300V
(1V/div ~ 10V/div)
Example :channel1:scale 1.00e–2
:channel1:offset 2.00e–2
Sets the Channel 1
scale to 10mV/div
Sets the Channel 1
offset to 20mV
:CHANnel<X>:PROBe
Set
Query

COMMAND DETAILS
27
Description Sets or returns the probe attenuation factor.
Same as: Channel key →F4
Syntax < Long > < Short >
:channel<X>:probe <NR3>
:channel<X>:probe?
:chan<X>:prob <NR1>
:chan<X>:prob?
Parameter <X> Channel <NR1> Probe attenuation factor
1/2 CH1/2 0 1x
1 10x
2 100x
Example :channel1:probe 1 Sets the Channel 1
probe attenuation
factor to 10x
:CHANnel<X>:SCALe
Set
Query
Description Sets or returns the vertical scale. The scale depends
on the probe attenuation factor.
Same as: Volts/Div knob
Syntax < Long > < Short >
:channel<X>:scale <NR3>
:channel<X>:scale?
:chan<X>:scal <NR3>
:chan<X>:scal?
Parameter <X> Channel <NR3> Vertical scale
1/2 CH1/2 2e–3 ~ 5e+0 2mV ~ 10V
(Probe x1)
2e–2 ~ 1e+2 20mV ~ 100V
(Probe x10)
2e–1 ~ 1e+3 200mV ~ 1000V
(Probe x100)
Example :channel1:probe 0
:channel1:scale 2.00e–3
Sets the Channel 1 probe
attenuation factor to x1
Sets the Channel 1
vertical scale to 2mV/div
GDS-1000 Programming Manual
28
Cursor Command
:CURSor:X<X>Position.................................................28
:CURSor:Y<X>Position.................................................29
:CURSor:<X>DELta.......................................................29
:CURSor:<X>DISplay....................................................30
:CURSor:SOURce..........................................................31
:CURSor:X<X>Position
Set
Query
Description Sets or returns the horizontal (X axis) cursor
position.
Same as: Cursor key →F5 (X-Y) →F2 (X1) or F3
(X2) + Variable knob
Syntax < Long > < Short >
:cursor:x<X>position <NR1>
:cursor:x<X>position?
:curs:x<X>p <NR1>
:curs:x<X>p?
Parameter <X> Cursor 1 or 2
<NR1> Cursor position
1 Cursor X1 1 ~ 249 1 ~ 249 point
2 Cursor X2
Note When in the query mode, the returned data format
is <NR3> as follows.
CH1, CH2, Math (CH1±CH2): time (s)
Math (FFT): frequency (Hz)
Example :cursor:xdisplay 1
:cursor:x1position 100
Puts the horizontal
cursor X1 on the 100
point position
:channel:math 3
:cursor:xdisplay 1
:cursor:x1position?
→2.500E+03
Returns the X1 cursor
position as 2500Hz in
the Math FFT mode

COMMAND DETAILS
29
:CURSor:Y<X>Position
Set
Query
Description Selects or returns the vertical (Y axis) cursor
position.
Same as: Cursor key →F5 (X-Y) →F2(Y1) or F3(Y2)
+Vertical knob
Syntax < Long > < Short >
:cursor:y<X>position <NR1>
:cursor:y<X>position?
:curs:y<X>p <NR1>
:curs:y<X>p?
Parameter <X> Cursor 1 or 2 <NR1> Cursor position
1 Cursor Y1 1 ~ 199 1 ~ 199 point
2 Cursor Y2
Note When in the query mode, the returned data format
is <NR3> as follows.
CH1, CH2, Math (CH1±CH2): voltage (V)
Math (FFT): decibel (dB)
Example :cursor:ydisplay 1
:cursor:y1position 100
Puts the vertical
cursor Y1 on the 100
point position
:channel:math 3
:cursor:ydisplay 1
:cursor:y1position?
→2.500E+00
Returns the Y1 cursor
position as 2.5dB in
the Math FFT mode
:CURSor:<X>DELta Query
Description Returns the distance between two horizontal (X
axis) or vertical (Y axis) cursors.
Same as: Cursor key →F5 (X-Y) →F4
Syntax < Long > < Short >
GDS-1000 Programming Manual
30
:cursor:<X>delta? :curs:<X>del?
Parameter <X> Horizontal or vertical cursor
x Horizontal cursor (X axis)
y Vertical cursor (Y axis)
Note The returned data format is <NR3> as follows.
CH1, CH2, Math (CH1±CH2): time (s) for
horizontal cursor, voltage (V) for vertical cursor
Math (FFT): frequency (Hz) for horizontal cursor,
decibel (dB) for vertical cursor
Example :channel:math 3
:cursor:xdisplay 1
:cursor:xdelta?
→2.500E+03
Returns the frequency
(2500Hz) between the
two horizontal cursors
in the Math FFT mode
:channel:math 3
:cursor:ydisplay 1
:cursor:ydelta?
→2.500E+00
Returns the decibel
(2.5dB) between the
two vertical cursors in
the Math FFT mode
:CURSor:<X>DISplay Set
Description Turns the horizontal or vertical cursors on/off.
Same as: Cursor key
Syntax < Long > < Short >
:cursor:y<X>display <Boolean>
:curs:y<X>dis
<Boolean>
Parameter <X> X or Y cursor
<NR1> Cursor on/off
x X (horizontal) 0 off
y Y (vertical) 1 on
Example :cursor:ydisplay 1 Turn Y cursor on

COMMAND DETAILS
31
:CURSor:SOURce
Set
Query
Description Selects or returns the cursor source channel.
Same as: Cursor key →F1 (Source)
Syntax < Long > < Short >
:cursor:source <NR1>
:cursor:source?
:curs:sour <NR1>
:curs:sour?
Parameter <NR1> Cursor source channel
1/2 Channel ½
3 Math result
Example :cursor:source 2 Selects Channel 2 as
the cursor source
GDS-1000 Programming Manual
32
Display Command
:DISPlay:ACCumulate...................................................32
:DISPlay:CONTrast.......................................................32
:DISPlay:GRATicule ......................................................33
:DISPlay:WAVeform......................................................33
:REFResh .......................................................................34
:DISPlay:ACCumulate
Set
Query
Description Turns the display accumulate mode on/off or
returns its status.
Same as: Display key →F2
Syntax < Long > < Short >
:display:accumulate <Boolean>
:display:accumulate?
:disp:acc <Boolean>
:disp:acc?
Parameter <NR1> Display accumulation
0 off
1 on
Example :display:accumulate 1
Turns on the
accumulation
:DISPlay:CONTrast
Set
Query
Description Sets or returns the display contrast level.
Same as: Display key →F4
Syntax < Long > < Short >
:display:contrast <NR1>
:display:contrast?
:disp:cont <NR1>
:disp:cont?

COMMAND DETAILS
33
Parameter <NR1> Display contrast
–10 ~ 10 Lowest (–10) to the Highest (+10)
Example :display:contrast 0 Sets the display
contrast to the middle
(±0)
:DISPlay:GRATicule
Set
Query
Description Sets or returns the display grid type.
Same as: Display key →F5
Syntax < Long > < Short >
:display:graticule <NR1>
:display:graticule?
:disp:grat <NR1>
:disp:grat?
Parameter <NR1> Grid type <NR1> Grid type
0 Full mode 2 Frame mode
1 Cross mode
Example :display:graticule 0 Selects the full grid
:DISPlay:WAVeform
Set
Query
Description Sets or returns the display waveform type.
Same as: Display key →F1
Syntax < Long > < Short >
:display:waveform <NR1>
:display:waveform?
:disp:wav <NR1>
:disp:wav?
Parameter <NR1> Display waveform type
0 Vectors
1 Dots
Example :display:waveform 0 Selects the vectors
waveform
GDS-1000 Programming Manual
34
:REFResh Set
Description Erases the existing waveform and draws a new
one.
Same as: Display key →F3
Syntax < Long > < Short >
:refresh :refr

COMMAND DETAILS
35
Measure command
:MEASure:FALL.............................................................35
:MEASure:FOVShoot....................................................36
:MEASure:FPReshoot ...................................................36
:MEASure:FREQuency..................................................37
:MEASure:NWIDth .......................................................37
:MEASure:PDUTy .........................................................37
:MEASure:PERiod .........................................................38
:MEASure:PWIDth........................................................38
:MEASure:RISe..............................................................39
:MEASure:ROVShoot ...................................................39
:MEASure:RPReshoot...................................................40
:MEASure:SOURce .......................................................40
:MEASure:VAMPlitude .................................................40
:MEASure:VAVerage.....................................................41
:MEASure:VHI...............................................................41
:MEASure:VLO..............................................................42
:MEASure:VMAX...........................................................42
:MEASure:VMIN ........................................................... 43
:MEASure:VPP ..............................................................43
:MEASure:VRMS...........................................................44
:MEASure:FALL Query
Description Returns the falltime measurement result.
Same as: Measure key →F1~F5 →F3 (Fall Time)
Syntax < Long > < Short >
:measure:fall? :meas:fall?
Returns <NR3>
Note Before using this command, select the
measurement channel. See the example below.
GDS-1000 Programming Manual
36
Example :measure:source 1
:measure:fall?
Selects Channel 1, and
then measures the fall
time.
:MEASure:FOVShoot Query
Description Returns the fall overshoot amplitude.
Same as: Measure key →F1~F5 →F3 (FOVShoot)
Syntax < Long > < Short >
:measure:fovshoot? :meas:fovs?
Returns <NR2> with % sign
Note Before using this command, select the
measurement channel. See the example below.
Example :measure:source 1
:measure:fall?
Selects Channel 1, and
then measures the fall
overshoot.
:MEASure:FPReshoot Query
Description Returns fall preshoot amplitude.
Same as: Measure key →F1~F5 →F3 (FPREShoot)
Syntax < Long > < Short >
:measure:fovshoot? :meas:fovs?
Returns <NR2> with % sign
Note Before using this command, select the
measurement channel. See the example below.
Example :measure:source 1
:measure:fall?
Selects Channel 1, and
then measures the fall
preshoot.

COMMAND DETAILS
37
:MEASure:FREQuency Query
Description Returns the frequency value.
Same as: Measure key →F1~F5 →F3 (Frequency)
Syntax < Long > < Short >
:measure:frequency? :meas:freq?
Returns <NR3>
Note Before using this command, select the
measurement channel. See the example below.
Example :measure:source 1
:measure:frequency?
Selects Channel 1, and
then measures the
frequency.
:MEASure:NWIDth Query
Description Returns the first negative pulse width timing.
Same as: Measure key →F1~F5 →F3 (–Width)
Syntax < Long > < Short >
:measure:nwidth? :meas:nwid?
Returns <NR3>
Note Before using this command, select the
measurement channel. See the example below.
Example :measure:source 1
:measure:nwidth?
Selects Channel 1, and
then measures the
negative pulse width.
:MEASure:PDUTy Query
Description Returns the positive duty cycle ratio.
Same as: Measure key →F1~F5 →F3 (DutyCycle)
Syntax < Long > < Short >
GDS-1000 Programming Manual
38
:measure:pduty? :meas:pdut?
Returns <NR2> as the percentage
Note Before using this command, select the
measurement channel. See the example below.
Example :measure:source 1
:measure:pduty?
Selects Channel 1, and
then measures the
positive duty cycle.
:MEASure:PERiod Query
Description Returns the period.
Same as: Measure key →F1~F5 →F3 (Period)
Syntax < Long > < Short >
:measure:period? :meas:per?
Returns <NR3>
Note Before using this command, select the
measurement channel. See the example below.
Example :measure:source 1
:measure:period?
Selects Channel 1, and
then measures the
period.
:MEASure:PWIDth Query
Description Returns the first positive pulse width.
Same as: Measure key →F1~F5 →F3 (+Width)
Syntax < Long > < Short >
:measure:period? :meas:per?
Returns <NR3>
Note Before using this command, select the
measurement channel. See the example below.

COMMAND DETAILS
39
Example :measure:source 1
:measure:pwidth?
Selects Channel 1, and
then measures the
positive pulse width.
:MEASure:RISe Query
Description Returns the first pulse rising edge timing.
Same as: Measure key →F1~F5 →F3 (RiseTime)
Syntax < Long > < Short >
:measure:rise? :meas:ris?
Returns <NR3>
Note Before using this command, select the
measurement channel. See the example below.
Example :measure:source 1
:measure:rise?
Selects Channel 1, and
then measures the
rising edge timing.
:MEASure:ROVShoot Query
Description Returns rise overshoot amplitude in percentage.
Same as: Measure key →F1~F5 →F3 (ROVShoot)
Syntax < Long > < Short >
:measure:rovshoot? :meas:rovs?
Returns <NR2> with % sign
Note Before using this command, select the
measurement channel. See the example below.
Example :measure:source 1
:measure:rovshoot?
Selects Channel 1, and
then measures the rise
overshoot.
GDS-1000 Programming Manual
40
:MEASure:RPReshoot Query
Description Returns rise overshoot amplitude in percentage.
Same as: Measure key →F1~F5 →F3 (RPReshoot)
Syntax < Long > < Short >
:measure:rpreshoot? :meas:rpr?
Returns <NR2> with % sign
Note Before using this command, select the
measurement channel. See the example below.
Example :measure:source 1
:measure:rpreshoot?
Selects Channel 1, and
then measures the rise
preshoot.
:MEASure:SOURce
Set
Query
Description Selects the measurement channel.
Same as: Measure key →F1~F5 →F1, F2
Syntax < Long > < Short >
:measure:source <NR1>
:measure:source?
:meas:sour <NR1>
:meas:sour?
Parameter <NR1>
1 ~ 2 Channel1 ~ 2
Example :measure:source 1
:measure:rprshoot?
Selects Channel 1, and
then measures the rise
preshoot.
:MEASure:VAMPlitude Query
Description Returns the voltage difference between positive
and negative peak.
Same as: Measure key →F1~F5 →F3 (Vamp)