1. Catalogs
  2. Siglent Technologies Co., Ltd
  3. Programming Guide For SDS1000X-E Serie

Programming Guide For SDS1000X-E Serie

Programming Guide For SDS1000X-E Serie
1 / 181 PagesView full catalog

Programming Guide For SDS1000X-E Serie

Product catalog summary
Programming Overview
This section introduces the remote communication capabilities between SIGLENT digital oscilloscopes and computers, focusing on establishing a remote control link via a communication bus.
Build Communication
To start programming, install the National Instruments NI-VISA library. The full version includes device drivers and NI MAX, while the Run-Time Engine is smaller. Installation involves downloading, unzipping, and following setup prompts, including accepting license agreements and potentially installing .NET Framework 4.
Connect the Instrument
Oscilloscopes can connect to a PC via USB or LAN. The guide uses USB as an example. Connect the USB interfaces of the oscilloscope and PC, turn on the oscilloscope, and allow the PC to automatically install the device driver.
How To Remote Control
Users can control the oscilloscope using SCPI commands, either through user-defined programming or by sending commands via NI-VISA software.
About Commands & Queries
This section details the remote control commands and queries, which can be executed in local or remote states. Commands are listed alphabetically by their long form, with descriptions including syntax and usage. Commands apply to all Siglent Digital Oscilloscope Series models, with some specific to SPO models.
Command Notation
Notation includes angular brackets for placeholders, colons for value descriptions, braces for choices, square brackets for optional items, and ellipses for repetition. An example command is provided for setting vertical input sensitivity.
Table of Commands & Queries
This table lists commands and queries by short and long forms, subsystems, and their functions, such as acquisition mode, status reading, calibration, and more. Each command is associated with specific functions like acquisition, system settings, and display adjustments.
Specifications:
  • Acquisition Commands: Commands like ACQUIRE_WAY, ARM_ACQUISITION, and AUTO_SETUP are used to control the acquisition mode, enable signal acquisition, and automatically adjust controls for waveform display.
  • Status Queries: Commands such as ALL_STATUS? and CMR? provide comprehensive status information and error details.
  • Channel Settings: Commands like ATTENUATION and BANDWIDTH_LIMIT adjust the vertical attenuation and bandwidth filtering of the channels.
  • System Calibration: AUTO_CALIBRATE and *CAL? commands manage quick and full calibration processes.
  • Communication Settings: COMM_HEADER and COMM_NET commands control response formats and network settings.
Procedures:
  • Saving and Recalling: Commands like *SAV and STPN allow saving and recalling of device states and setups.
  • Trigger Settings: Commands such as TRIG_LEVEL and TRIG_MODE adjust trigger levels and modes for signal acquisition.
Norms and Recommendations:
  • Use the *RST command to reset the device to its default state.
  • Regularly perform self-calibration using the *CAL? command to ensure accurate measurements.
Key Data and Functions:
  • Screen Functions: SCDP and SCSV manage screen dumps and screen saver settings.
  • Miscellaneous Functions: BUZZER command controls sound settings, and COMM_NET manages network configurations.
Critical Information:
  • Ensure correct syntax and parameters when issuing commands to avoid errors.
  • Refer to the Command Error Status Register Structure for troubleshooting syntax errors.
Function Counter (COUNTER, COUN)
Description: The COUNTER command controls the display of the cymometer on the instrument screen. The COUNTER? query checks if the cymometer is displayed.
Acquisition Coupling (COUPLING, CPL)
Description: The COUPLING command sets the coupling mode for a specified input channel. The COUPLING? query returns the current mode.
Cursor Auto Mode (CURSOR_AUTO, CRAU)
Description: Changes the cursor mode to auto.
Cursor Measure Mode (CURSOR_MEASURE, CRMS)
Description: Specifies the cursor or parameter measurement mode.
Cursor Set (CURSOR_SET, CRST)
Description: Positions cursors on the screen.
Cursor Value Query (CURSOR_VALUE?, CRVA?)
Description: Returns measured values by specified cursors.
Cursor Type (CURSOR_TYPE, CRTY)
Description: Specifies the type of cursor to display.
CSV Save (CSV_SAVE, CSVS)
Description: Selects options for storing waveform in CSV format.
Cymometer Query (CYMOMETER?, CYMT?)
Description: Returns the cymometer value displayed on the instrument.
System Date (DATE)
Description: Changes the oscilloscope's internal clock date/time.
Status DDR Query (DDR?)
Description: Reads and clears the Device Dependent Error Register.
Function Define (DEFINE, DEF)
Description: Specifies a mathematical expression for a function.
Display Dot Join (DOT_JOIN, DTJN)
Description: Controls interpolation lines between data points.
Status ESE (*ESE)
Description: Sets the Standard Event Status Enable register.
Status ESR Query (*ESR?)
Description: Reads and clears the Event Status Register.
Digital Oscilloscopes Series Overview

1. Execution Error Register (EXR)
  • Description: The EXR? query reads and clears the contents of the Execution Error Register, indicating the type of the last error detected during execution.

2. History Frame Commands
  • FRAME_PARAM (FPAR?): Retrieves frame parameters including descriptor name and product name.

3. Function Filter Commands
  • FILTER: Enables or disables the filter of a specified trace.

4. Math FFT Commands
  • FFT_WINDOW: Selects the window for FFT.

5. Display and Zoom Commands
  • GRID_DISPLAY: Selects the type of grid for display.

6. System Identification
  • *IDN?: Used for identification purposes, providing information on the manufacturer, model, serial number, and firmware revision level.
Identification Request
This section describes how to issue an identification request to the oscilloscope using the command *IDN?. The response provides the model and version details of the device.
Display Intensity
The INTENSITY command adjusts the intensity level of the grid or trace on the oscilloscope, expressed as a percentage.
Status INR Query
The INR? query reads and clears the internal state change register, which records the completion of various operations.
Channel Invert Set
The INVERTSET command inverts specified traces or math waveforms.
Display Menu
The MENU command enables or disables the display menu.
Math Vertical Position
The MATH_VERT_POS command controls the vertical position of the math waveform.
Math Vertical Division
The MATH_VERT_DIV command adjusts the vertical sensitivity of the math waveform.
Memory Size
The MEMORY_SIZE command sets the maximum memory depth.
Measure Delay
The MEASURE_DELAY command selects the type of delay measure between channels.
Channel Offset
The OFFSET command adjusts the vertical offset of a specified input channel.
Status Operation Complete
The *OPC command sets the OPC bit in the Event Status Register.
Pass/Fail Parameter Clear
The PARAMETER_CLR command resets the pass/fail test counter.
Measure Parameter Custom
The PARAMETER_CUSTOM command controls customizable measurement parameters.
Measure Parameter Value
The PARAMETER_VALUE? query returns measurement values for specified parameters.
Display Persistence Setup
The PERSIST_SETUP command sets the persistence duration of the display.
Save/Recall Panel Setup
The PANEL_SETUP command archives panel setups on external storage.
Pass/Fail Display
The PF_DISPLAY command enables or disables the pass/fail test display.
Pass/Fail Save/Load
The PF_SAVELOAD command saves or recalls mask settings.
Pass/Fail Commands Overview

PF_SET Command: Sets the X and Y masks for pass/fail options.
PF_CONTROL Command: Manages pass/fail control options like operate, output, and stop on output.
PF_SOURCE Command: Controls the source of pass/fail.
PF_BUFFER Command: Controls the output option for pass/fail.
PF_OPERATION Command: Controls the operate option for pass/fail.
PF_FAIL_STOP Command: Controls the stop on fail option.
PF_CREATEM Command: Creates the mask for pass/fail.
PF_DATADIS Query: Returns the number of fails, passes, and total displayed.
Save/Recall Commands Overview

*RCL Command: Recalls a panel setup.
RECALL Command: Recalls a waveform file.
RECALL_PANEL Command: Recalls a front-panel setup.
*RST Command: Resets the device to default setup.
Function Commands Overview

REF_CLOSE Command: Closes the reference function.
REF_DISPLAY Command: Enables/disables reference channel display.
REF_LOCATION Command: Sets the current reference channel.
REF_POSITION Command: Sets vertical offset of reference channel.
REF_SAVE Command: Saves waveform source to reference channel.
REF_SCALE Command: Sets vertical scale of reference channel.
REF_SOURCE Command: Sets reference waveform source.
REF_SET Command: Sets reference waveform and options.
*SAV Command: Stores current state of the instrument.
SCREEN_DUMP Command: Obtains screen information in image format.
Screen Saver Control
The SCREEN_SAVE command manages the automatic screen saver for the internal color monitor, which can be set to turn off after a specified time.
Service Request Enable
The *SRE command configures the Service Request Enable register, allowing specific summary message bits in the STB register to trigger a service request.
Status Byte Register
The *STB? query reads the status register, providing the values of bits 0 to 5 and 7, and the Master Summary Status (MSS).
Acquisition Control
The STOP command halts signal acquisition immediately.
Save/Recall Panel Setup
The STORE_PANEL command saves the current front-panel setup to a file on a USB device.
Acquisition Status and Sample Rate
The SAST? query checks the acquisition status, while the SARA? query returns the sample rate.
Trigger Settings
The SET50 command sets the trigger level to the center of the signal amplitude.
Waveform and Channel Management
The TEMPLATE? query provides a detailed description of a waveform's structure.
Trigger Level and Source
The trigger level can be set from -4.5DIV to 4.5DIV volts/div.
Trigger Mode
The TRIG_MODE command specifies the trigger mode, which can be AUTO, NORM, SINGLE, or STOP.
Trigger Select
The TRIG_SELECT command selects the condition for waveform acquisition.
Trigger Slope
The TRIG_SLOPE command sets the trigger slope, which can be NEG, POS, or WINDOW.
Trigger Window
The TRIG_WINDOW command sets the relative height of the trigger window.
Trigger Pattern
The TRIG_PATTERN command sets the condition of the pattern trigger.
Channel Unit
The UNIT command sets the unit of the specified trace, either V or A.
Vertical Position
The VERT_POSITION command adjusts the vertical position of the FFT trace.
Voltage Division
The VOLT_DIV command sets the vertical sensitivity in Volts/div.
Waveform Transfer
The WAVEFORM? query transfers a waveform from the oscilloscope to the controller.
Waveform Setup
The WAVEFORM_SETUP command specifies the amount of data in a waveform to be transmitted.
Command and Query Syntax
The document provides command and query syntax for digital oscilloscopes, specifically focusing on the XY_DISPLAY command.
Programming Examples
The document includes programming examples for controlling devices using NI-VISA library through various programming environments such as VC++, VB, MATLAB, LabVIEW, and C#.
VC++ Example
The VC++ example outlines steps to create a project using Visual Studio and NI-VISA library.
VB Example
The VB example provides a similar setup for using NI-VISA with Visual Basic 6.0.
MATLAB Example:
  • Environment: Win7 32bit, MATLAB R2010b
  • Function: Demonstrates synchronous read and write commands to a USBTMC instrument using NI-VISA.
LabVIEW Example:
  • Environment: Win7 32bit, LabVIEW 2011
  • Function: Control devices using USBTMC and TCP/IP access.
C# Example:
  • Environment: Win7 32bit, Visual Studio
  • Function: Use NI-VISA to control devices via USBTMC or TCP/IP.
C Example:
  • Function: Demonstrates socket communication for device control.
Command Index: The document includes an extensive index of commands and queries for digital oscilloscopes, detailing their syntax and usage.
See more

Catalog excerpts

Programming Guide For SDS1000X-E Serie-1

Digital Oscilloscopes Series Programming Guide Digital Oscilloscopes Series

 Open the catalog to page 1
Programming Guide For SDS1000X-E Serie-2

Digital Oscilloscopes Series

 Open the catalog to page 2
Programming Guide For SDS1000X-E Serie-3

Digital Oscilloscopes Series

 Open the catalog to page 3
Programming Guide For SDS1000X-E Serie-4

Digital Oscilloscopes Series Programming Overview This chapter introduces how to execute remote communications between a SIGLENT digital oscilloscope and the computer. It also introduces how to establish a remote control link over a communication bus. Build communication Install NI-VISA Before programming, you need to install National Instruments NI-VISA library, which you can download from the National Instruments web-site. Currently, NI-VISA is packaged in two versions: a full version and a Run-Time Engine version. The full version includes the NI device drivers and a tool named NI MAX that...

 Open the catalog to page 4
Programming Guide For SDS1000X-E Serie-5

Digital Oscilloscopes Series a.Double click the visa540_full.exe, dialog shown as below: b.Click Unzip, the installation process will automatically launch after unzipping files. If your computer needs to install .NET Framework 4, its Setup process will auto start. c.The NI-VISA installing dialog is shown above. Click Next to

 Open the catalog to page 5
Programming Guide For SDS1000X-E Serie-6

Digital Oscilloscopes Series start the installation process. Set the install path, default path is ―C:\Program Files\National Instruments\‖, you can change it. Click Next, dialog shown as above. d.Click Next twice, in the License Agreement dialog, select the

 Open the catalog to page 6
Programming Guide For SDS1000X-E Serie-7

Digital Oscilloscopes Series ―I accept the above 2 License Agreement(s).‖,and click Next, dialog shown as below: e.Click Next to run installation. Now the installation is complete, reboot your PC.

 Open the catalog to page 7
Programming Guide For SDS1000X-E Serie-8

Digital Oscilloscopes Series Connect the instrument Depending on your specific model your oscilloscope may be able to communicate with a PC through the USB or LAN interface. This manual takes the USB as an example. (For instructions to communicate with a PC through the LAN interface see the User Manual.) a.Connect the USB Device interface at the rear panel of the oscilloscope and the USB Host interface of the PC using a USB cable. Assuming your PC is already turned on, turn on your oscilloscope and your PC will display the ―Device Setup‖ screen as it automatically installs the device driver as...

 Open the catalog to page 8
Programming Guide For SDS1000X-E Serie-9

Digital Oscilloscopes Series How To Remote Control a. User-defined Programming Users can use SCPI commands to program and control the digital oscilloscope. For details, refer to the introductions in "Programming Examples". b .Send SCPI Commands via NI-VISA You can control the oscilloscope remotely by sending SCPI commands via NI-VISA software.

 Open the catalog to page 9
Programming Guide For SDS1000X-E Serie-10

Digital Oscilloscopes Series About these Commands & Queries This section lists 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 are...

 Open the catalog to page 10
Programming Guide For SDS1000X-E Serie-11

Digital Oscilloscopes Series Applicable to the following models SDS1000CML/CML+ SDS1000DL/DL+ SDS1000CNL/CNL+ SDS1000/1000X/1000X-S/1000X+/1000X-E SDS2000/SDS2000X Certain commands are only applicable to SPO oscilloscopes models and are described accordingly. SPO oscilloscopes models are in the table below. SPO models SDS1000X/1000X+/SDS1000X-E SDS2000/2000X What is an SPO model? SPO model uses Siglent-innovated waveform acquisition and graphics processing engine which supports high capture rate, multilevel intensity grading and color temperature display, with deep memory storage and the use...

 Open the catalog to page 11
Programming Guide For SDS1000X-E Serie-12

Digital Oscilloscopes Series 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...

 Open the catalog to page 12
Programming Guide For SDS1000X-E Serie-13

Digital Oscilloscopes Series

 Open the catalog to page 13
Programming Guide For SDS1000X-E Serie-15

Digital Oscilloscopes Series

 Open the catalog to page 15
Programming Guide For SDS1000X-E Serie-16

Digital Oscilloscopes Series

 Open the catalog to page 16
Programming Guide For SDS1000X-E Serie-17

Digital Oscilloscopes Series

 Open the catalog to page 17
Programming Guide For SDS1000X-E Serie-18

Digital Oscilloscopes Series

 Open the catalog to page 18
Programming Guide For SDS1000X-E Serie-19

Digital Oscilloscopes Series

 Open the catalog to page 19
Programming Guide For SDS1000X-E Serie-20

Digital Oscilloscopes Series

 Open the catalog to page 20
Programming Guide For SDS1000X-E Serie-21

Digital Oscilloscopes Series

 Open the catalog to page 21
Programming Guide For SDS1000X-E Serie-22

Digital Oscilloscopes Series

 Open the catalog to page 22
Programming Guide For SDS1000X-E Serie-23

Digital Oscilloscopes Series Digital Oscilloscopes Series CHANNEL DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE ATTENUATION, ATTN Command /Query 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. <channel>: ATTeNuation <attenuation> <channel> : = {C1, C2, C3, C4} <attenuation>: = {0.1, 0.2, 0.5, 1, 2, 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000, 10000} <channel>: ATTeNuation? <channel>: ATTeNuation <attenuation> The...

 Open the catalog to page 23
Programming Guide For SDS1000X-E Serie-24

Digital Oscilloscopes Series

 Open the catalog to page 24
Programming Guide For SDS1000X-E Serie-25

Digital Oscilloscopes Series

 Open the catalog to page 25
Programming Guide For SDS1000X-E Serie-26

Digital Oscilloscopes Series

 Open the catalog to page 26
Programming Guide For SDS1000X-E Serie-27

Digital Oscilloscopes Series Digital Oscilloscopes Series ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE AVERAGE_ACQUIRE, AVGA Command /Query The AVERAGE_ACQUIRE command selects the average times of average acquisition. The response to the AVERAGE_ACQUIRE query indicates the times of average acquisition. AVERAGE_ACQUIRE <time> <time> : = {4, 16, 32, 64,128,256,etc} Note: The <time> parameter’s options vary with model. AVERAGE_ACQUIRE? AVERAGE_ACQUIRE <time> The following turns the average times of average acquisition 16: Command message: AVGA 16

 Open the catalog to page 27
Programming Guide For SDS1000X-E Serie-28

Digital Oscilloscopes Series Digital Oscilloscopes Series ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE BAN DWIDTH_LIMIT, BWL Command /Query 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. BandWidth_Limit...

 Open the catalog to page 28

All Siglent Technologies Co., Ltd catalogs and technical brochures

  1. SDS6000A Series

    21  Pages

  2. SDL1000X Series

    10  Pages

  3. SSM5000A Series

    15  Pages

*Prices are pre-tax. They exclude delivery charges and customs duties and do not include additional charges for installation or activation options. Prices are indicative only and may vary by country, with changes to the cost of raw materials and exchange rates.