GW Instek GDS-1000B Series Owner's manual

Digital Storage Oscilloscope
GDS-1000B Series
PROGRAMMING MANUAL
GW INSTEK PART NO. Version 1.10, June 2015
ISO-9001 CERTIFIED MANUFACTURER

June 2015
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 Dist., New Taipei City 236, Taiwan.

TABLE OF CONTENTS
3
Table of Contents
INTERFACE OVERVIEW ..................................................... 5
Interface Configuration .............................. 5
COMMAND OVERVIEW .................................................. 16
Command Syntax ..................................... 16
List of Commands in Functional Order .... 18
COMMAND DETAILS ...................................................... 27
Common Commands ............................... 29
Acquisition Commands ............................ 35
Autoscale Commands .............................. 42
Vertical Commands .................................. 43
Math Commands ..................................... 49
Cursor Commands ................................... 58
Display Commands .................................. 69
Hardcopy Commands .............................. 73
Measure Commands ................................ 76
Measurement Commands .......................101
Reference Commands .............................109
Run Command ........................................112
Stop Command .......................................112
Single Command.....................................112
Force Command......................................113
Timebase Commands..............................114
Trigger Commands..................................117
System Commands .................................134
Save/Recall Commands ..........................135
Ethernet Commands ...............................140
Label Commands ....................................141
DVM Commands.....................................145
Go_NoGo Commands .............................148

GDS-1000B Programming Manual
Data Logging Commands ....................... 154
Remote Disk Commands ........................ 158
APPENDX.......................................................................161
Error messages ...................................... 161
INDEX............................................................................165

INTERFACE OVERVIEW
5
INTERFACE OVERVIEW
This manual describes how to use the
GDS-1000B’s remote command functionality and
lists the command details. The Overview chapter
describes how to configure the GDS-1000B USB
and Ethernet remote control interface.
Interface Configuration
Configure USB Interface
USB
Configuration
PC side connector
Type A, host
GDS-1000B side
connector
Type B, device
Speed
1.1/2.0
USB Class
CDC (communications device
class)
Panel Operation
1. Press the Utility key.
Utility
2. Press I/O from the bottom menu.
3. Press USB Device Port from the side
menu and select Computer.
4. Connect the USB cable to the rear
panel device port.

GDS-1000B Programming Manual
6
5. When the PC asks for the USB driver, select the
USB driver included on the accompanying User
Manual CD or download the driver from the
GW Instek website, www.gwinstek.com, in the
GDS-1000B Download section. The driver
automatically sets the GDS-1000B as a serial
COM port (Shown as VPO in the PORTS node).

INTERFACE OVERVIEW
7
USB Functionality Check
Terminal
Application
Invoke a terminal application such as RealTerm.
Set the COM port, baud rate, stop bit, data bit, and
parity accordingly.
To check the COM port number and associated
port settings, see the Device Manager in the PC.
For Windows 7:
Control panel → Hardware and Sound→ Device
Manager
Example: Configuring RealTerm:
Functionality
Check
Key in this query command via the terminal
application.
*idn?
This should return the Manufacturer, Model
number, Serial number, and Firmware version in
the following format.
GW,GDS-1102B,PXXXXXX,V1.00

GDS-1000B Programming Manual
8
Configure the Ethernet Interface
Ethernet
Configuration
MAC Address
Domain Name
Instrument Name
DNS IP Address
User Password
Gateway IP Address
Instrument IP
Address
Subnet Mask
HTTP Port 80 (fixed)
Background
The Ethernet interface is used for remote control
using a socket server connection. For details,
please see the Socket Server section on page 10.
Panel Operation
1. Connect the Ethernet cable to the
LAN port on the rear panel.
2. Press the Utility key.
Utility
3. Press I/O from the bottom menu.
4. Press Ethernet from the side menu.
5. Set DHCP/BOOTP to On or Off
from the side menu.
Note
IP addresses will automatically be assigned with
DHCP/BOOTP set to on. For Static IP Addresses,
DHCP/BOOTP should be set to off.

INTERFACE OVERVIEW
9
6. Use the Up and Down arrows on
the side menu to navigate to each
Ethernet configuration item.
Items
MAC Address, Instrument Name,
User Password, Instrument IP
Address, Domain Name, DNS IP
Address, Gateway IP Address,
Subnet Mask
Note: HTTP Port is fixed at 80.
7. Use the Variable knob to highlight a
character and use the Select key to
choose a character.
Select
VARIABLE

GDS-1000B Programming Manual
10
Press Backspace to delete a
character.
Press Save Now to save the
configuration. Complete will be
displayed when successful.
Configure Socket Server
The GDS-1000B supports socket server functionality for direct two-
way communication with a client PC or device over LAN. By default,
the Socket Server is off.
Configure Socket
Server
1. Configure the IP address for the
GDS-1000B.
Page 8
2. Press the Utility key.
Utility
3. Press I/O from the bottom menu.
4. Press Socket Server from the side
menu.
5. Press Select Port and choose the
port number with the Variable
knob.
Range
1024~65535
6. Press Set Port to confirm the port
number.
7. The Current Port icon will update
to the new port number.

INTERFACE OVERVIEW
11
8. Press Server and turn the socket
server On.
Socket Server Functionality Check
NI Measurement
and Automation
Explorer
To test the socket server functionality, National
Instruments Measurement and Automation
Explorer can be used. This program is available on
the NI website, www.ni.com.
Operation
1. Configure the IP address for the
GDS-1000B.
Page 8
2. Configure the socket port.
Page 10
3. Start the NI Measurement and
Automation Explorer (MAX)
program. Using Windows, press:
Start>All Programs>National
Instruments>Measurement & Automation
4. From the Configuration panel access;
My System>Devices and Interfaces>Network
Devices

GDS-1000B Programming Manual
12
5. Right click Network Devices and select Create
New Visa TCP/IP Resource…
45
6. Select Manual Entry of Raw Socket from the
popup window.
7. Click Next.
6
7

INTERFACE OVERVIEW
13
8. Enter the GDS-1000B’s IP address and socket
port number.
9. Click Validate.
10. A popup will appear to tell you if a VISA socket
session was successfully created.
11. Click Next.
10
11
89
12. Choose an alias for the socket connection if you
like.
13. Click Finish to finish the configuration.
12
13
14. The GDS-1000B will now appear under
Network Devices in the Configuration Panel.

GDS-1000B Programming Manual
14
Functionality
Check
15. Click the Open Visa Test Panel to send a remote
command to the GDS-1000B.
14
15
16. Click on the Configuration icon.
17. Select the I/O Settings tab.
18. Mark the Enable Termination Character checkbox.
Make sure the termination character is a line
feed (/n, value: xA).
19. Click Apply Changes.
16 17
18
19

INTERFACE OVERVIEW
15
20. Click the Input/Output icon.
21. Make sure *IDN? query is selected in the Select
or Enter Command drop box.
22. Click on Query.
23. The manufacturer, model number, serial
number and firmware version will be displayed
in the buffer. For example:
GW,GDS-1102B,PXXXXXX,V1.00
20
21 22
23

GDS-1000B Programming Manual
16
COMMAND OVERVIEW
The Command overview chapter lists all GDS-
1000B 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 forms
Commands and queries have two different forms,
long and short. The command syntax is written
with the short form of the command in capitals
and the remainder (long form) in lower case.
The commands can be written in capitals or lower-
case, just so long as the short or long forms are
complete. An incomplete command will not be
recognized.
Below are examples of correctly written
commands.
LONG
:TIMebase:SCALe?
:TIMEBASE:SCALE?
:timebase:scale?
:TIMebase:SCALe?
Short
Long
Short

COMMAND OVERVIEW
17
SHORT
:TIM:SCAL?
:TIM:SCAL?
Command format
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>
floating point
0.1, 3.14, 8.5
<NR3>
floating point
with an exponent
4.5e-1, 8.25e+1
<NRf>
any of NR1, 2, 3
1, 1.5, 4.5e-1
Message
terminator
LF
line feed code
Note
Commands are non-case sensitive.
:TIMebase:SCALe <NR3>LF
1 2 3 4

GDS-1000B Programming Manual
18
List of Commands in Functional Order
Common
*IDN?...........................................................................29
*LRN?...........................................................................29
*SAV.............................................................................30
*RCL.............................................................................31
*RST.............................................................................31
*CLS.............................................................................31
*ESE .............................................................................31
*ESR.............................................................................32
*OPC............................................................................33
*SRE.............................................................................33
*STB.............................................................................34
Acquisition
:ACQuire:AVERage ......................................................35
:ACQuire:MODe ..........................................................36
:ACQuire<X>:MEMory?...............................................36
:ACQuire:FILTer:SOURce............................................38
:ACQuire:FILTer...........................................................39
:ACQuire:FILTer:FREQuency.......................................39
:ACQuire:FILTer:TRACking..........................................40
:ACQuire<X>:STATe? ..................................................40
:ACQuire:RECOrdlength..............................................40
:HEADer.......................................................................41
Autoscale
:AUTOSet.....................................................................42
:AUTORSET:MODe .....................................................42

COMMAND OVERVIEW
19
Vertical Scale
:CHANnel<X>:BWLimit.............................................. 43
:CHANnel<X>:COUPling............................................ 44
:CHANnel<X>:DESKew .............................................. 44
:CHANnel<X>:DISPlay ............................................... 44
:CHANnel<X>:EXPand ............................................... 45
:CHANnel<X>:IMPedance?........................................ 45
:CHANnel<X>:INVert ................................................. 46
:CHANnel<X>:POSition ............................................. 46
:CHANnel<X>:PROBe:RATio ..................................... 47
:CHANnel<X>:PROBe:TYPe....................................... 47
:CHANnel<X>:SCALe ................................................. 47
Math
:MATH:DISP ............................................................... 49
:MATH:TYPe ............................................................... 50
:MATH:DUAL:SOURce<X> ........................................ 50
:MATH:DUAL:OPERator ............................................ 50
:MATH:DUAL:POSition...............................................51
:MATH:DUAL:SCALe...................................................51
:MATH:FFT:SOURce .................................................. 52
:MATH:FFT:MAG........................................................ 52
:MATH:FFT:WINDow ................................................. 52
:MATH:FFT:POSition ................................................. 53
:MATH:FFT:SCALe...................................................... 53
:MATH:FFT:HORizontal:SCALe ................................. 54
MATH:FFT:HORizontal:POSition.............................. 54
:MATH:DEFine ........................................................... 54
MATHVAR?................................................................. 55
MATHVAR:VAR<X>.................................................... 56
:MATH:ADVanced:POSition ...................................... 56
:MATH:ADVanced:SCALe........................................... 56
Cursor
:CURSor:MODe .......................................................... 58
:CURSor:SOURce........................................................ 59
:CURSor:HUNI ........................................................... 59
:CURSor:HUSE ........................................................... 60
:CURSor:VUNI ............................................................ 60

GDS-1000B Programming Manual
20
:CURSor:VUSE .............................................................61
:CURSor:DDT...............................................................61
:CURSor:H1Position....................................................61
:CURSor:H2Position....................................................62
:CURSor:HDELta .........................................................62
:CURSor:V1Position.....................................................62
:CURSor:V2Position.....................................................63
:CURSor:VDELta ..........................................................63
:CURSor:XY:RECTangular:X:POSition<X>..................63
:CURSor:XY:RECTangular:X:DELta .............................64
:CURSor:XY:RECTangular:Y:POSition<X>..................64
:CURSor:XY:RECTangular:Y:DELta .............................65
:CURSor:XY:POLar:RADIUS:POSition<X> .................65
:CURSor:XY:POLar:RADIUS:DELta.............................65
:CURSor:XY:POLar:THETA:POSition<X> ...................66
:CURSor:XY:POLar:THETA:DELta...............................66
:CURSor:XY:PRODuct:POSition<X>...........................66
:CURSor:XY:PRODuct:DELta ......................................67
:CURSor:XY:RATio:POSition<X>.................................67
:CURSor:XY:RATio:DELta............................................67
Display
:DISPlay:INTensity:WAVEform....................................69
:DISPlay:INTensity:GRATicule ....................................69
:DISPlay:INTensity:BACKLight ....................................70
:DISPlay:INTensity:BACKLight:AUTODim:ENAble ....70
DISplay:INTENSITy:BACKLight:AUTODim:TIMe ......70
:DISPlay:PERSistence ..................................................71
:DISPlay:GRATicule .....................................................71
:DISPlay:WAVEform ....................................................72
:DISPlay:OUTPut .........................................................72