Good Will Instrument GDS-1000B PROGRAMMING MANUAL

Digital Storage Oscilloscope

GDS-1000B Series

PROGRAMMING MANUAL

ISO-9001 CERTIFIED MANUFACTURER

March 2020

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

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

USB Delay Command ........................................ 161

APPENDX ..................................................................... 162

Error messages ................................................. 162

INDEX .......................................................................... 166

INTERFACE OVERVIEW

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

Press the Utility key.

Utility

Press I/O from the bottom menu.

Press USB Device Port from the side

3. menu and select Computer.

Connect the USB cable to the rear

4. panel device port.

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

GDS-1000B Programming Manual

When the PC asks for the USB driver, select the

5. 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

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

USB Functionality Check

GDS-1000B Programming Manual

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

Connect the Ethernet cable to the

1. LAN port on the rear panel.

Press the Utility key.

Utility

Press I/O from the bottom menu.

Press Ethernet from the side menu.

Set DHCP/BOOTP to On or Off

5. 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.

Configure the Ethernet Interface

INTERFACE OVERVIEW

Use the Up and Down arrows on

6. 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.

Use the Variable knob to highlight a

7. character and use the Select key to choose a character.

Select

VARIABLE

GDS-1000B Programming Manual

Press Backspace to delete a character.

Press Save Now to save the configuration. Complete will be displayed when successful.

Configure Socket Server

Configure the IP address for the

1. GDS-1000B.

Page 8

Press the Utility key.

Utility

Press I/O from the bottom menu.

Press Socket Server from the side

4. menu.

Press Select Port and choose the

5. port number with the Variable knob.

Range

1024~65535

Press Set Port to confirm the port

6. number.

The Current Port icon will update

7. to the new port number.

Configure Socket Server

The GDS-1000B supports socket server functionality for direct twoway communication with a client PC or device over LAN. By default, the Socket Server is off.

INTERFACE OVERVIEW

Press Server and turn the socket

8. server On.

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

Configure the IP address for the

1. GDS-1000B.

Page 8

Configure the socket port.

Page 10

Start the NI Measurement and

3. Automation Explorer (MAX) program. Using Windows, press:

Start>All Programs>National Instruments>Measurement & Automation

From the Configuration panel access;

My System>Devices and Interfaces>Network Devices

Socket Server Functionality Check

GDS-1000B Programming Manual

Right click Network Devices and select Create

5. New Visa TCP/IP Resource…

Select Manual Entry of Raw Socket from the

6. popup window.

Click Next.

INTERFACE OVERVIEW

Enter the GDS-1000B’s IP address and socket

8. port number.

Click Validate.

A popup will appear to tell you if a VISA socket

10. session was successfully created.

Click Next.

11.

Choose an alias for the socket connection if you

12. like.

Click Finish to finish the configuration.

13.

The GDS-1000B will now appear under

14. Network Devices in the Configuration Panel.

GDS-1000B Programming Manual

Functionality Check

Click the Open Visa Test Panel to send a remote

15. command to the GDS-1000B.

Click on the Configuration icon.

16.

Select the I/O Settings tab.

17.

Mark the Enable Termination Character checkbox.

18. Make sure the termination character is a line feed (/n, value: xA).

Click Apply Changes.

19.

Click the Input/Output icon.

20.

Make sure *IDN? query is selected in the Select

21. or Enter Command drop box.

Click on Query.

22.

The manufacturer, model number, serial

23. number and firmware version will be displayed in the buffer. For example: GW,GDS-1102B,PXXXXXX,V1.00

INTERFACE OVERVIEW

GDS-1000B Programming Manual

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 lowercase, 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

The Command overview chapter lists all GDS1000B 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

COMMAND OVERVIEW

SHORT

:TIM:SCAL?

Command format

1: command header

2: single space

3: parameter

4: message terminator

Parameter

Type

Description

Example

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

line feed code

Note

Commands are non-case sensitive.

:TIMebase:SCALe <NR3>LF

1 2 3 4

GDS-1000B Programming Manual

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

List of Commands in Functional Order

COMMAND OVERVIEW

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

: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

COMMAND OVERVIEW

Hardcopy

:HARDcopy:START ......................................................73

:HARDcopy:MODe ......................................................73

:HARDcopy:PRINTINKSaver .......................................74

:HARDcopy:SAVEINKSaver .........................................74

:HARDcopy:SAVEFORMat ..........................................74

:HARDcopy:ASSIGN ....................................................75

Measure

:MEASure:GATing ........................................................77

:MEASure:SOURce ......................................................77

:MEASure:METHod .....................................................78

:MEASUrement:REFLevel:PERCent:HIGH..................78

:MEASUrement:REFLevel:PERCent:LOW ...................79

:MEASUrement:REFLevel:PERCent:MID ....................79

:MEASUrement:REFLevel:PERCent:MID2 ..................79

:MEASure:FALL ............................................................80

:MEASure:FOVShoot ...................................................80

:MEASure:FPReshoot ..................................................81

:MEASure:FREQuency .................................................81

:MEASure:NWIDth ......................................................82

:MEASure:PDUTy .........................................................82

:MEASure:PERiod ........................................................83

:MEASure:PWIDth .......................................................83

:MEASure:RISe .............................................................84

:MEASure:ROVShoot ...................................................84

:MEASure:RPReshoot ..................................................85

:MEASure:PPULSE .......................................................86

:MEASure:NPULSE ......................................................86

:MEASure:PEDGE ........................................................87

:MEASure:NEDGE .......................................................87

:MEASure:AMPlitude ...................................................88

:MEASure:MEAN .........................................................88

:MEASure:CMEan ........................................................89

:MEASure:HIGH ..........................................................90

:MEASure:LOW ............................................................90

:MEASure:MAX ............................................................91

GDS-1000B Programming Manual

:MEASure:MIN ............................................................ 91

:MEASure:PK2PK ......................................................... 92

:MEASure:RMS ............................................................ 92

:MEASure:CRMS .......................................................... 93

:MEASure:AREa ........................................................... 94

:MEASure:CARea ......................................................... 94

:MEASure:FRRDelay .................................................... 95

:MEASure:FRFDelay .................................................... 95

:MEASure:FFRDelay .................................................... 96

:MEASure:FFFDelay ..................................................... 97

:MEASure:LRRDelay .................................................... 97

:MEASure:LRFDelay..................................................... 98

:MEASure:LFRDelay..................................................... 98

:MEASure:LFFDelay ..................................................... 99

:MEASure:PHAse ....................................................... 100

Measurement

:MEASUrement:MEAS<X>:SOURCE<X> .................. 101

:MEASUrement:MEAS<X>:TYPe ............................... 102

:MEASUrement:MEAS<X>:STATE ............................ 102

:MEASUrement:MEAS<X>:VALue ............................ 103

:MEASUrement:MEAS<X>:MAXimum ..................... 104

:MEASUrement:MEAS<X>:MEAN ............................ 105

:MEASUrement:MEAS<X>:MINImum ..................... 105

:MEASUrement:MEAS<X>:STDdev .......................... 106

:MEASUrement:STATIstics:MODe ........................... 107

:MEASUrement:STATIstics:WEIghting ..................... 107

:MEASUrement:STATIstics ....................................... 108

Reference

:REF<X>:DISPlay ....................................................... 109

:REF<X>:TIMebase:POSition .................................... 109

:REF<X>:TIMebase:SCALe ........................................ 110

:REF<X>:OFFSet ........................................................ 110

:REF<x>:SCALe .......................................................... 111

Run

:RUN .......................................................................... 112

COMMAND OVERVIEW

Stop

:STOP .........................................................................112

Single

:SINGle .......................................................................112

Force

:FORCe .......................................................................113

Timebase

:TIMebase:EXPand ....................................................114

:TIMebase:POSition ..................................................114

:TIMebase:SCALe .......................................................114

:TIMebase:MODe ......................................................115

:TIMebase:WINDow:POSition ..................................115

:TIMebase:WINDow:SCALe ......................................116

Trigger

:TRIGger:FREQuency .................................................118

:TRIGger:TYPe............................................................118

:TRIGger:SOURce ......................................................119

:TRIGger:COUPle .......................................................119

:TRIGger:NREJ ...........................................................119

:TRIGger:MODe .........................................................120

:TRIGger:HOLDoff .....................................................120

:TRIGger:LEVel ...........................................................120

:TRIGger:HLEVel ........................................................121

:TRIGger:LLEVel .........................................................121

:TRIGger:EDGe:SLOP ................................................122

:TRIGger:DELay:SLOP ...............................................122

:TRIGger:DELay:TYPe ................................................123

:TRIGger:DELay:TIMe ................................................123

:TRIGger:DELay:EVENt ..............................................123

:TRIGger:DELay:LEVel ...............................................124

:TRIGger:PULSEWidth:POLarity ................................124

:TRIGger:RUNT:POLarity ..........................................125

:TRIGger:RUNT:WHEn ..............................................125

:TRIGger:RUNT:TIMe ................................................126

:TRIGger:RISEFall:SLOP ............................................126

:TRIGger:RISEFall:WHEn...........................................126

GDS-1000B Programming Manual

:TRIGger:RISEFall:TIMe ............................................ 127

:TRIGger:VIDeo:TYPe ................................................ 127

:TRIGger:VIDeo:FIELd ............................................... 128

:TRIGger:VIDeo:LINe ................................................ 129

:TRIGger:VIDeo:POLarity .......................................... 129

:TRIGger:PULSe:WHEn ............................................. 129

:TRIGger:PULSe:TIMe ............................................... 130

:TRIGger:TIMEOut:WHEn ......................................... 130

:TRIGger:TIMEOut:TIMER ........................................ 131

:TRIGger:ALTernate ................................................... 131

:TRIGger:STATe ......................................................... 131

:TRIGger:EXTERnal:PROBe:TYPe .............................. 132

:TRIGger:EXTERnal:PROBe:RATio ............................ 133

System commands

:SYSTem:LOCK .......................................................... 134

:SYSTem:ERRor ......................................................... 134

Save/Recall

:RECAll:SETUp ........................................................... 135

:RECAll:WAVEform .................................................... 135

:SAVe:IMAGe ............................................................. 136

:SAVe:IMAGe:FILEFormat ......................................... 136

:SAVe:IMAGe:INKSaver ............................................. 137

:SAVe:SETUp ............................................................. 137

:SAVe:WAVEform ....................................................... 138

:SAVe:WAVEform:FILEFormat .................................. 139

Ethernet Commands

:ETHERnet:DHCP ...................................................... 140

Label Commands

:CHANnel<X>:LABel.................................................. 141

:CHANnel<X>:LABel:DISPlay .................................... 142

:REF<X>:LABel ........................................................... 142

:REF<X>:LABel:DISPlay ............................................. 143

:SET<X>:LABel ........................................................... 144

COMMAND OVERVIEW

DVM Commands

:DVM:STATE ..............................................................145

:DVM:SOURce ...........................................................145

:DVM:MODe ..............................................................146

:DVM:VALue ..............................................................146

Go-NoGo Commands

:GONogo:CLEar .........................................................148

:GONogo:EXECute ....................................................148

:GONogo:FUNCtion ..................................................149

:GONogo:NGCount ...................................................149

:GONogo:NGDefine ..................................................149

:GONogo:SOURce .....................................................150

:GONogo:VIOLation ..................................................150

:GONogo:SCRipt .......................................................150

:TEMPlate:MODe ......................................................151

:TEMPlate:MAXimum ................................................151

:TEMPlate:MINimum ................................................151

:TEMPlate:POSition:MAXimum ................................152

:TEMPlate:POSition:MINimum ................................152

:TEMPlate:SAVe:MAXimum ......................................152

:TEMPlate:SAVe:MINimum ......................................153

:TEMPlate:TOLerance ................................................153

:TEMPlate:SAVe:AUTo ...............................................153

Data Logging Commands

:DATALOG:STATE .....................................................154

:DATALOG:SOURce ..................................................155

:DATALOG:SAVe .......................................................155

:DATALOG:INTerval ..................................................156

:DATALOG:DURation ................................................157

Remote Disk Commands

:REMOTEDisk:IPADDress .........................................158

:REMOTEDisk:PATHName .......................................158

:REMOTEDisk:USERName .......................................159

:REMOTEDisk:PASSWord .........................................159

:REMOTEDisk:MOUNT.............................................159

:REMOTEDisk:AUTOMount......................................160

GDS-1000B Programming Manual

USB Delay command

:USBDelay .................................................................. 161

COMMAND DETAILS