Siglent SSG3021X Programming guide

Download

Programming Guide

SSG3000X Series Signal Generator

PG0803X-E01A

2018 SIGLENT TECHNOLOGIES CO., LTD

SIGLENT

Contents

1. Programming Overview ........................................................... 4

1.1 Build Communication ............................................................................ 4

1.1.1 Build Communication Using VISA ....................................................................... 4

1.1.2 Build Communication Using Sockets ................................................................... 7

1.1.3 Connecting the signal generator via the USB Host port ...................................... 7

1.2 Remote Control Capabilities ................................................................. 7

1.2.1 User-defined Programming .................................................................................. 7

1.2.2 Send SCPI Commands via NI-MAX .................................................................... 7

2. SCPI Overview ........................................................................ 11

2.1 Command Format................................................................................. 11

2.2 Symbol Instruction ............................................................................... 11

2.3 Parameter Type ..................................................................................... 11

2.4 Command Abbreviation ....................................................................... 12

3. System Commands ................................................................ 13

3.1 IEEE Common Commands .................................................................. 13

3.1.1 Identification Query (*IDN) ................................................................................. 13

3.1.2 Reset (*RST) ...................................................................................................... 13

3.1.3 Clear Status (*CLS) ............................................................................................ 13

3.1.4 Standard Event Status Enable (*ESE) ............................................................... 14

3.1.5 Standard Event Status Register Query (*ESR).................................................. 14

3.1.6 Operation Complete Query (*OPC) ................................................................... 14

3.1.7 Service Request Enable (*SRE) ........................................................................ 14

3.1.8 Status Byte Query (*STB) .................................................................................. 14

3.1.9 Wait-to-Continue (*WAI) ..................................................................................... 15

3.1.10 Self Test Query (*TST) ....................................................................................... 15

3.2 System Subsystem .............................................................................. 15

3.2.1 System Time (:SYSTem:TIME) .......................................................................... 15

3.2.2 System Date (:SYSTem:DATE) ......................................................................... 15

3.2.3 IP Address (:SYSTem:COMMunicate:LAN:IPADdress) ..................................... 16

3.2.4 Gateway (:SYSTem:COMMunicate:LAN:GATeway) .......................................... 16

3.2.5 Subnet Mask (:SYSTem:COMMunicate:LAN:SMASk) ...................................... 16

3.2.6 IP Config (:SYSTem:COMMunicate:LAN:TYPE) ............................................... 17

3.2.7 Power On Type (:SYSTem:PON:TYPE) ............................................................ 17

3.3 Preset Subsystem ................................................................................ 17

3.3.1 Preset (:SOURce:PRESet) ................................................................................ 17

3.3.1 System Preset (:SYSTem:PRESet) ................................................................... 17

3.3.2 Preset Save (:SYSTem:PRESet:SAVE) ............................................................ 18

3.3.3 Preset Path (:SYSTem:PRESet:PATH) .............................................................. 18

3.3.4 Preset Type (:SYSTem:PRESet:TYPE) ............................................................. 18

3.3.5 Factory Reset (:SYSTem:FDEFault) .................................................................. 18

3.4 Output Subsystem ............................................................................... 19

3.4.1 RF Output (:OUTPut[:STATe]) ............................................................................ 19

3.5 Source Subsystem ............................................................................... 19

3.5.1 [:SOURce]:FREQuency Subsystem .................................................................. 19

3.5.2 [:SOURce]:POWer Subsystem .......................................................................... 21

3.5.3 [:SOURce]:SWEep Subsystem .......................................................................... 25

2 SSG3000X Programming Guide

SIGLENT

3.5.4 [:SOURce]:MODulation Subsystem ................................................................... 32

3.5.5 [:SOURce]:AM Subsystem ................................................................................ 33

3.5.6 [:SOURce]:FM Subsystem ................................................................................. 34

3.5.7 [:SOURce]:PM Subsystem ................................................................................ 36

3.5.8 [:SOURce]:PULM Subsystem ............................................................................ 38

3.5.9 [:SOURce]:LFOutput Subsystem ....................................................................... 45

3.5.10 [:SOURce]:LFOutput:SWEep Subsystem ......................................................... 46

3.6 Sense Subsystem................................................................................. 50

3.6.1 Sensor Info (:SENSe[:POWer]:TYPE) ............................................................... 50

3.6.2 Sensor State (:SENSe[:POWer]:STATus) .......................................................... 50

3.6.3 Measurement (:SENSe[:POWer]:VALue) .......................................................... 50

3.6.4 Statistics State (:SENSe[:POWer]:STATIStics:STATe) ...................................... 50

3.6.5 Statistics Value (:READ[:POWer])...................................................................... 51

3.6.6 Statistics Max Value (:SENSe[:POWer]:STATIStics:MAX?) .............................. 51

3.6.7 Statistics Min Value (:SENSe[:POWer]:STATIStics:MIN?) ................................. 51

3.6.8 Statistics Mean Value (:SENSe[:POWer]:STATIStics:AVG?)............................. 52

3.6.9 Statistics Count (:SENSe[:POWer]:STATIStics:COUNt?) .................................. 52

3.6.10 Statistics Clear (:SENSe[:POWer]:STATIStics:CLEAr?) .................................... 52

3.6.11 Auto Zero (:CALibration:ZERO:TYPE) .............................................................. 52

3.6.12 Zeroing (:SENSe[:POWer]:ZERO) ..................................................................... 53

3.6.13 Frequency Type (:SENSe[:POWer]:SOURce) ................................................... 53

3.6.14 Frequency (:SENSe[:POWer]:FREQuency) ...................................................... 53

3.6.15 Level Offset State (:SENSe[:POWer]:OFFSet:STATe) ...................................... 54

3.6.16 Level Offset (:SENSe[:POWer]:OFFSet) ........................................................... 54

3.6.17 Average Type (:SENSe[:POWer]:FILTer:TYPE) ................................................ 54

3.6.18 Average Times (:SENSe[:POWer]:FILTer:LENGth) ........................................... 54

3.6.19 Internal Noise (:SENSe[:POWer]:FILTer:NSRatio) ............................................ 55

3.6.20 Logging (:SENSe[:POWer]:LOGGing:STATe) ................................................... 55

4. Programming Examples ........................................................ 56

4.1 Examples of Using VISA ...................................................................... 56

4.1.1 Example of VC++ ............................................................................................... 56

4.1.2 Example of VB ................................................................................................... 60

4.1.3 Example of MATLAB .......................................................................................... 63

4.1.4 Example of LabVIEW ......................................................................................... 64

4.2 Examples of Using Socket .................................................................. 66

4.2.1 Example of Python ............................................................................................. 66

4.2.2 Example of Telnet............................................................................................... 68

SSG3000X Programming Guide 3

SIGLENT

1.Programming Overview

SSG3000X support both USB and LAN interfaces. By using these interfaces, in combination

with NI-VISA and programming languages, users can remotely control the signal generator. Through LAN interface, VXI-11, Sockets and Telnet protocols can be used to communicate with the signal generator. This chapter introduces how to build communication between the signal generator and the PC. It also introduces the remote control capabilities.

1.1 Build Communication

1.1.1 Build Communication Using VISA

1、 Install NI-VISA

Before programming, you need to install NI-VISA, which you can download from the NI-VISA web site. About NI-VISA, there are full version and Run-Time Engine version. The full version includes the NI device driver and a tool named NI MAX that is a user interface to control the device. The Run-Time Engine version which is much smaller than the full version only include NI device driver. For example, you can get NI-VISA 5.4 full version from: http://www.ni.com/download/ni-visa-

5.4/4230/en/. You can also download NI-VISA Run-Time Engine 5.4 to your PC and install it as default selection. Its installation process is similar with the full version. After you downloaded the file you can follow the steps below to install it: 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.

4 SSG3000X Programming Guide

SIGLENT

c. The NI-VISA installing dialog is shown above. Click Next to 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 “ I accept the above 2 License Agreement(s).” ,and click Next, dialog shown as below:

SSG3000X Programming Guide 5

SIGLENT

e. Click Next to run installation.

Now the installation is complete, reboot your PC.

2、 Connect the Instrument

Depending on your specific model your signal generator 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 signal generator and the USB Host interface of the PC using a USB cable. Assuming your PC is already turned on, turn on your signal generator and your PC will display the “Device Setup” screen as it automatically installs the device driver as shown below.

b. Wait for the installation to complete and then proceed to the next step.

6 SSG3000X Programming Guide

SIGLENT

1.1.2 Build Communication Using Sockets

Sockets LAN is a method used to communicate with the signal generator over the LAN interface using the Transmission Control Protocol/Internet Protocol (TCP/IP). A socket is a fundamental technology used for computer networking and allows applications to communicate using standard mechanisms built into network hardware and operating systems. The method accesses a port on the signal generator from which bidirectional communication with a network computer can be established. Before you can use sockets LAN, you must select the signal generator’s sockets port number to use:

 Standard mode. Available on port 5025. Use this port for simple programming.  Telnet mode. The telnet SCPI service is available on port 5024.

1.1.3 Connecting the signal generator via the USB Host port

Refer to the following steps to finish the connection via USB:

1. Install NI-VISA on your PC for GPIB driver.

2. Connect the signal generator USB Host port to a PC’s GPIB card port, with SIGLENT USB-GPIB adaptor.

3. Switch on the signal generator

4. Press button on the front panel System→Interface→GPIB to enter the GPIB number.

The signal generator will be detected automatically as a new GPIB point.

1.2 Remote Control Capabilities

1.2.1 User-defined Programming

Users can use SCPI commands to program and control the signal generator. For details, refer to the introductions in “Programming Examples”.

1.2.2 Send SCPI Commands via NI-MAX

Users can control the signal generator remotely by sending SCPI commands via NI-MAX software.

1.2.2.1 Using USB

Run NI MAX software. 1, Click “Device and interface” at the upper left corner of the software; 2, Find the “USBTMC” device symbol;

SSG3000X Programming Guide 7

SIGLENT

3, Click “Open VISA Test Panel” option button, then the following interface will appear;

4, Click the “Input/Output” option button and click the “Query” option button in order to view

the operation information.

NOTE: The *IDN? command (known as the Identification Query) returns the instrument manufacturer, instrument model, serial number, and other identification information.

1.2.2.2 Using LAN

Add Network Device, and select VISA TCP/IP Resource as shown:. Run NI MAX software.

1, Click “Device and interface” at the upper left corner of the software; 2, Find the “Network Devices” symbol, click “Add Network Devices”;

8 SSG3000X Programming Guide

SIGLENT

3. Select Manual Entry of LAN instrument, select Next, and enter the IP address as shown. Click Finish to establish the connection:

NOTE: Leave the LAN Device Name BLANK or the connection will fail.

4. After a brief scan, the connection should be shown under Network Devices:

SSG3000X Programming Guide 9

SIGLENT

5. Right-click on the product and select Open NI-VISA Test Panel:

6. Click “Input/Output” option button and click “Query” option button. If everything is OK,

you will see the Read operation information returned as shown below.

10 SSG3000X Programming Guide

SIGLENT

2.SCPI Overview

2.1 Command Format

SCPI commands present a hierarchical tree structure containing multiple subsystems, each of the subsystems is made up of a root keyword and several sub keywords. The command string usually starts with “:”, the keywords are separated by “:” and the followed parameter settings are separated by space. Query commands add “?” at the end of the string. For example: :SOURce:FREQuency <freq> :SOURce:FREQuency? SOURce is the root key of the command, FREQuency is second. The command begins with “:”, and separates the keywords at the same time, <freq> separated by space and represents the parameter available for setting; “?” represents a query.

2.2 Symbol Instruction

The following four symbols are not the content of SCPI commands and can not be sent with the commands, but are usually used in the commands.

1, Triangle Brackets < >

The parameter in the triangle brackets must be replaced by an effective value. For example: Send the “CALibration:SPC:TARGet <power>” command in “CALibration:SPC:TARGet 0”.

2, Square Brackets [ ]

The content in the square brackets can be ignored. When the parameter is ignored, the instrument will set the parameter to its default. For example, In the “[:SOURce]:POWer?” command, sending any of the four commands below can generate the same effect: :SOURce:POWer? :POWer?

3, Vertical Bar |

The vertical bar is used to separate multiple parameters and when sending the command, you can choose one of the parameters. For example, In the “[:SOURce]:AM:STATe OFF|ON|0|1” command, the parameters available are “OFF”, “ON”, “0” or “1”.

4, Braces { }

The parameters in the braces are optional which can be ignored or set for one or more times.

2.3 Parameter Type

The parameters in the commands introduced in this manual include 6 types: boolean, enumeration, integer, float and string.

1, Boolean

SSG3000X Programming Guide 11

SIGLENT

The parameters in the commands could be “OFF”, “ON”, “0” or “1”. For example: [:SOURce]:FM:STATe OFF|ON|0|1

2, Enumeration

The parameter could be any of the values listed. For example: [:SOURce]:SWEep:STATe OFF|FREQuency|LEVel|LEV_FREQ The parameter is “OFF”, “FREQuency”, “LEVel” or LEV_FREQ.

3, Integer

Except other notes, the parameter can be any integer within the effective value range. For example: [:SOURce]:SWEep:STEP:POINts <value> The parameter <value> can be set to any integer between 2 and 65535.

4, Float

The parameter could be any value within the effective value range according to the accuracy requirement (the default accuracy contains up to 9 digits after the decimal points). For example: [:SOURce]:POWer:OFFSet <value> The parameter <value> can be set to any real number between -100 and 100.

5, String

The parameter should be the combinations of ASCII characters. For example: :SYSTem:COMMunicate:LAN:IPADdress <“xxx.xxx.xxx.xxx”> The parameter can be set as “192.168.1.12” string.

2.4 Command Abbreviation

All of the commands are not case sensitive, so you can use any of them. But if abbreviation is used, all the capital letters in the command must be written completely. For example: :CORRection:FLATness:COUNt? Can be abbreviated to: :CORR:FLAT:COUN?

12 SSG3000X Programming Guide

SIGLENT

Command Format

:OUTPut[:STATe] ON|OFF|1|0 :OUTPut[:STATe]?

Instruction

Activate/Deactivate the RF output. Get the RF state.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0

Return

Boolean

Default

Example

:OUTPut ON

Command Format

*IDN?

Instruction

Returns an instrument identification information string. The string will contain the manufacturer, model number, serial number, software number, FPGA number and CPLD number.

None

Example

*IDN? Return: Siglent Technologies,SSG3032X,1234567890, 03.01.16r2

Command Format

*RST

Instruction

This command presets the instrument to a factory defined condition that is appropriate for remote programming operation. *RST is equivalent to performing

3.System Commands

This chapter introduces the Siglent Technologies SSG3000XSCPI commands, include:

IEEE Common Commands 0 System Subsystem 3.2 Preset Subsystem 错误!未找到引用源。 Output Subsystem 3.4 Output Subsystem

3.1.1 RF Output (:OUTPut[:STATe])

Source Subsystem 3.5 Sense Subsystem 3.6

3.2 IEEE Common Commands

3.2.1 Identification Query (*IDN)

3.2.2 Reset (*RST)

SSG3000X Programming Guide 13

SIGLENT

the two commands :SOURce:PRESet and *CLS. This command always performs a factory preset.

None

Example

*RST

Command Format

*CLS

Instruction

Clears the status byte register. It does this by emptying the error queue and clearing all bits in all of the event registers. The status byte register summarizes the states of the other registers. It is also responsible for generating service requests.

None

Example

*CLS

Command Format

*ESE <number> *ESE?

Instruction

Set the bits in the standard event status enable register. This register monitors I/O errors and synchronization conditions such as operation complete, request control, query error, device dependent error, execution error, command error and power on. A summary bit is generated on execution of the command. The query returns the state of the standard event status enable register.

None

Example

*ESE 16

Command Format

*ESR?

Instruction

Queries and clears the standard event status event register. (This is a destructive read.) The value returned reflects the current state (0/1) of all the bits in the register.

None

Example

*ESR?

Command Format

*OPC *OPC?

Instruction

Set bit 0 in the standard event status register to “1” when all pending operations

have finished. The query stops any new commands from being processed until the current processing is complete. Then it returns a “1”, and the program continues. This query can be used to synchronize events of other instruments on the external bus.

Returns a “1” if the last processing is complete. Use this query when there’s a

need to monitor the command execution status, such as a sweep execution.

None

Example

*OPC?

3.2.3 Clear Status (*CLS)

3.2.4 Standard Event Status Enable (*ESE)

3.2.5 Standard Event Status Register Query (*ESR)

3.2.6 Operation Complete Query (*OPC)

14 SSG3000X Programming Guide

3.2.7 Service Request Enable (*SRE)

Command Format

*SRE <integer> *SRE?

Instruction

This command enables the desired bits of the service request enable register. The query returns the value of the register, indicating which bits are currently enabled.

None

Example

*SRE 1

Command Format

*STB

Instruction

This query is used by some instruments for a self test.

None

Example

*STB

Command Format

*WAI

Instruction

This command causes the instrument to wait until all pending commands are completed before executing any additional commands. There is no query form to the command.

None

Example

*WAI

Command Format

*TST?

Instruction

This query is used by some instruments for a self test.

None

Example

*TST?

Command Format

:SYSTem:TIME <hhmmss> :SYSTem:TIME?

Instruction

Set System time. Get System time.

Parameter Type

String

Parameter Range

hour(0 ~ 23), minute(0 ~ 59), second(0 ~ 59)

Return

String

Default

None

Utility > Setting > Time Setting

Example

Set System time:

3.2.8 Status Byte Query (*STB)

3.2.9 Wait-to-Continue (*WAI)

SIGLENT

3.2.10 Self Test Query (*TST)

3.3 System Subsystem

3.3.1 System Time (:SYSTem:TIME)

SSG3000X Programming Guide 15

SIGLENT

:SYSTem:TIME 182559 Get System time: :SYSTem:TIME?

Command Format

:SYSTem:DATE <yyyymmdd> :SYSTem:DATE?

Instruction

Set system date. Get system date.

Parameter Type

String

Parameter Range

year(four digits), month(1 ~ 12), date(1 ~ 31)

Return

String

Default

None

Utility > Setting > Time Setting

Example

Set System date: :SYSTem:DATE 20050101 Get System date: :SYSTem:DATE?

Command Format

:SYSTem:COMMunicate:LAN:IPADdress <“xxx.xxx.xxx.xxx”> :SYSTem:COMMunicate:LAN:IPADdress?

Instruction

Set a host name for the signal generator in network. Get IP address.

Parameter Type

String

Parameter Range

Conform to the IP Sets standard(0-255:0-255:0-255:0-255)

Return

IP address string

Default

None

Utility > Interface > LAN Setting > IP Address

Example

:SYSTem:COMMunicate:LAN:IPADdress “192.168.1.12” :SYSTem:COMMunicate:LAN:IPADdress?

Command Format

:SYSTem:COMMunicate:LAN:GATeway <“xxx.xxx.xxx.xxx”> :SYSTem:COMMunicate:LAN:GATeway?

Instruction

Set the gateway for the signal generator in the network. The gateway will be fetched automatically if the IP assignment is set to DHCP. Get gateway.

Parameter Type

String

Parameter Range

Conform to the IP standard (0~255.0~255.0~255.0~255)

Return

Gateway string.

Default

None

Utility > Interface > LAN Setting > Gateway

3.3.2 System Date (:SYSTem:DATE)

3.3.3 IP Address (:SYSTem:COMMunicate:LAN:IPADdress)

3.3.4 Gateway (:SYSTem:COMMunicate:LAN:GATeway)

16 SSG3000X Programming Guide

SIGLENT

Example

:SYSTem:COMMunicate:LAN:GATeway “192.168.1.1” :SYSTem:COMMunicate:LAN:GATeway?

Command Format

:SYSTem:COMMunicate:LAN:SMASk <“xxx.xxx.xxx.xxx”> :SYSTem:COMMunicate:LAN:SMASk?

Instruction

Set the subnet mask according to the PC network Settings. The subnet mask will be set automatically if the IP assignment is set to DHCP.

Parameter Type

String

Parameter Range

Conform to the IP standard (0-255:0-255:0-255:0-255) Return

Subnet mask string

Default

None

Utility > Interface > LAN Setting > Subnet Mask

Example

:SYSTem:COMMunicate:LAN:SMASk?

Command Format

:SYSTem:COMMunicate:LAN:TYPE STATIC|DHCP :SYSTem:COMMunicate:LAN:TYPE?

Instruction

Toggles the IP assignment Setting between static (manual) and DHCP (dynamic assignment) mode. Get IP config.

Parameter Type

Enumeration

Parameter Range

STATIC|DHCP

Return

Enumeration

Default

None

Utility > Interface > LAN Setting > DHCP State

Example

:SYSTem:COMMunicate:LAN:TYPE DHCP :SYSTem:COMMunicate:LAN:TYPE?

Command Format

:SYSTem:PON:TYPE DFT|LAST :SYSTem:PON:TYPE?

Instruction

Uses command to set signal generator to power on in default, last. Get power on type.

Parameter Type

Enumeration

Parameter Range

DFT|LAST DFT: Default LAST: Last

Return

Enumeration

Default

DFT

Utility > Setting > Power On

Example

SYSTem:PON:TYPE DFT

3.3.5 Subnet Mask (:SYSTem:COMMunicate:LAN:SMASk)

3.3.6 IP Config (:SYSTem:COMMunicate:LAN:TYPE)

3.3.7 Power On Type (:SYSTem:PON:TYPE)

SSG3000X Programming Guide 17

SIGLENT

Command Format

:SOURce:PRESet Instruction

Presets all parameters which are related to the selected signal path.

Parameter Type

None Return

None

Default

None

Example

SOUR:PRES

Command Format

:SYSTem:PRESet Instruction

Presets all parameters.

Parameter Type

None Return

None

Default

None

Utility > Preset

Example

SYSTem:PRES

Command Format

:SYSTem:PRESet:SAVE Instruction

Save status for preset when preset type is user.

Parameter Type

None Return

None

Default

None

Utility > Preset

Example

:SYSTem:PRESet:SAVE

Command Format

:SYSTem:PRESet:PATH <path> Instruction

Set preset file when preset type is user.

Parameter Type

String Return

None

Default

None

Utility > Preset

Example

:SYSTem:PRESet:PATH test.xml

3.4 Preset Subsystem

3.4.1 Preset (:SOURce:PRESet)

3.4.1 System Preset (:SYSTem:PRESet)

3.4.2 Preset Save (:SYSTem:PRESet:SAVE)

3.4.3 Preset Path (:SYSTem:PRESet:PATH)

18 SSG3000X Programming Guide

3.4.4 Preset Type (:SYSTem:PRESet:TYPE)

Command Format

:SYSTem:PRESet:TYPE DFT|USER :SYSTem:PRESet:TYPE?

Instruction

Uses this command to preset the signal generator to default, user. Get preset type.

Parameter Type

Enumeration

Parameter Range

DFT: Default USER: Custom Configuration

Return

Enumeration

Default

DFT

Utility > Setting > Preset Type

Example

:SYSTem:PRESet:TYPE DFT

Command Format

:SYSTem:FDEFault

Instruction

Set both the measure and setting parameters to factory preset parameters.

Parameter Type

None

Parameter Range

None Return

None

Default

None

Example

:SYSTem:FDEFault

Command Format

:OUTPut[:STATe] ON|OFF|1|0 :OUTPut[:STATe]?

Instruction

Activate/Deactivate the RF output. Get the RF state.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0 Return

Boolean

Default

Example

:OUTPut ON

3.4.5 Factory Reset (:SYSTem:FDEFault)

SIGLENT

3.5 Output Subsystem

3.5.1 RF Output (:OUTPut[:STATe])

SSG3000X Programming Guide 19

SIGLENT

Command Format

[:SOURce]:FREQuency:DISPlay <freq> [:SOURce]:FREQuency:DISPlay?

Instruction

Set the frequency display on parameter bar. Get the frequency display on parameter bar.

Parameter Type

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter Range

Frequency offset + Full frequency range

Return

Float, unit: Hz

Default

Maximum frequency

Freq

Example

FREQuency:DISPlay 2 MHz

Command Format

[:SOURce]:FREQuency[:FIX] <freq> [:SOURce]:FREQuency[:FIX]?

Instruction

Set the frequency of the RF output signal. Get the frequency of the RF output signal.

Parameter Type

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter Range

Full frequency range

Return

Float, unit: Hz

Default

Maximum frequency

FREQ > Frequency

Example

FREQuency 2 MHz

Command Format

[:SOURce]:FREQuency:OFFSet <freq> [:SOURce]:FREQuency:OFFSet?

Instruction

Set the frequency offset of a downstream instrument. Get the frequency offset of a downstream instrument.

Parameter Type

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter Range

-200 GHz ~ 200 GHz Return

Float, unit: Hz

Default

0 Hz

FREQ > Freq Offset

Example

FREQuency:OFFSet 2 MHz

3.6 Source Subsystem

3.6.1 [:SOURce]:FREQuency Subsystem

3.6.1.1 Frequency Display ([:SOURce]:FREQuency:DISPlay)

3.6.1.2 Frequency ([:SOURce]:FREQuency[:FIX])

3.6.1.3 Frequency Offset ([:SOURce]:FREQuency:OFFSet)

20 SSG3000X Programming Guide

SIGLENT

Command Format

[:SOURce]:PHASe <phase> [:SOURce]:PHASe?

Instruction

Set the phase of the RF output signal. Get the phase of the RF output signal.

Parameter Type

Float, unit: deg

Parameter Range

-360 deg ~ 360 deg Return

Float, unit: deg

Default

0 deg

FREQ > Phase Offset

Example

PHASe 20

Command Format

[:SOURce]:PHASe:RESet [:SOURce]:PHASe:REF

Instruction

Set the current phase to relatively zero.

Parameter Type

None

Parameter Range

None

Return

None

Default

None

FREQ > Reset phase delta display

Example

:PHASe:RESet

Command Format

[:SOURce]:POWer:POWer <power> [:SOURce]:POWer:POWer?

Instruction

Set the RF level display on parameter bar. Get the RF level display on parameter bar.

Parameter Type

Float, unit: dBm, dBmV, dBuV, V, W, Default: dBm

Parameter Range

Level Offset + Full power range

Return

Float, unit: dBm

Default

-110 dBm

Level

Example

POWer:POWer 2

Command Format

[:SOURce]:POWer <power> [:SOURce]:POWer?

3.6.1.4 Phase Offset ([:SOURce]:PHASe)

3.6.1.5 Phase Reset ([:SOURce]:PHASe:RESet [:SOURce]:PHASe:REF)

3.6.2 [:SOURce]:POWer Subsystem

3.6.2.1 Level Display ([:SOURce]:POWer:POWer)

3.6.2.2 Level ([:SOURce]:POWer)

SSG3000X Programming Guide 21

SIGLENT

Instruction

Set the RF output level. Get the RF output level.

Parameter Type

Float, unit: dBm, dBmV, dBuV, V, W

Parameter Range

When IQ switched on: -100 dBm ~ 10 dBm Frequency between 9 kHz ~ 100 kHz: -110 dBm ~ 9 dBm Frequency between 100 kHz ~ 1 MHz: -110 dBm ~ 15 dBm Frequency above 1 MHz: -110 dBm ~ 20 dBm

Return

Float, unit: dBm

Default

-110 dBm

LEVEL > Level

Example

POWer 2

Command Format

[:SOURce]:POWer:OFFSet <power> [:SOURce]:POWer:OFFSet?

Instruction

Set the RF offset level of the RF output connector. Get the RF offset level of the RF output connector.

Parameter Type

Float

Parameter Range

-100 dB ~ 100 dB Return

Float, unit: dB

Default

0 dB

LEVEL > Level Offset

Example

POWer:OFFSet 2

Command Format

[:SOURce]:POWer:ALC ON|OFF|AUTO [:SOURce]:POWer:ALC?

Instruction

Activate/deactivate automatic level control. Query ALC state.

Parameter Type

Enumeration

Parameter Range

ON|OFF|AUTO ON Internal level control is permanently activated. OFF Internal level control is deactivated; Sample & Hold mode is activated. AUTO Internal level control is activated/deactivated automatically depending on the operating state.

Return

Enumeration

Default

AUTO

LEVEL > ALC State

Example

POWer:ALC ON

Command Format

[:SOURce]:CORRection[:FLATness] ON|OFF|1|0 [:SOURce]:CORRection[:FLATness]?

3.6.2.3 Level Offset ([:SOURce]:POWer:OFFSet)

3.6.2.4 ALC State ([:SOURce]:POWer:ALC)

3.6.2.5 Flatness List State ([:SOURce]:CORRection[:FLATness])

22 SSG3000X Programming Guide

Instruction

Activate/deactivate flatness.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0

Return

Boolean

Default

LEVEL > Flatness

Example

CORRection:FLATness ON

3.6.2.6 Flatness List Add Row

Command Format

[:SOURce]:CORRection:FLATness:PAIR <freq>,<power> Instruction

Insert a new row.

Parameter Type

Float, Float

Parameter Range

Freq: Full freq range Power: Full power range

Return

None

Default

None

LEVEL > Flatness > [+]

Example

CORRection:FLATness:PAIR 1 MHz,1

Command Format

[:SOURce]:CORRection:FLATness:DELete <row>

Instruction

Delete the selected row.

Parameter Type

Integer

Parameter Range

Less than the total count of the flatness.

Return

None

Default

None

LEVEL > Flatness > [-]

Example

CORRection:FLATness:DELete 0

Command Format

[:SOURce]:CORRection:FLATness:COUNt? Instruction

Indicates the total count of the flatness.

Parameter Type

None

Parameter Range

None Return

Integer

([:SOURce]:CORRection:FLATness:PAIR)

SIGLENT

3.6.2.7 Flatness List Delete Row ([:SOURce]:CORRection:FLATness:DELete)

3.6.2.8 Flatness List Count ([:SOURce]:CORRection:FLATness:COUNt?)

SSG3000X Programming Guide 23

SIGLENT

Default

LEVEL > Flatness

Example

CORRection:FLATness:COUNt?

Command Format

[:SOURce]:CORRection:STORe <file_name>

Instruction

Save the correction data in the list.

Parameter Type

String

Parameter Range

None

Return

None

Default

None

LEVEL > Flatness > Store

Example

:CORRection:STORe test.uflt

Command Format

[:SOURce]:CORRection:LOAD <file_name>

Instruction

Load existing flatness correction files.

Parameter Type

String

Parameter Range

None

Return

None

Default

None

LEVEL > Flatness > Load

Example

:CORRection:LOAD test.uflt

Command Format

[:SOURce]:CORRection:FLATness:PRESet

Instruction

Clear flatness correction list.

Parameter Type

None

Parameter Range

None

Default

None

LEVEL > Flatness > Clear

Example

:CORRection:FLATness:PRESet

Command Format

[:SOURce]:POWer:SPC:STATe ON|OFF|1|0 [:SOURce]:POWer:SPC:STATe?

Instruction

Activate/Deactivate power control using the sensor.

3.6.2.9 Flatness List Store ([:SOURce]:CORRection:STORe)

3.6.2.10 Flatness List Load ([:SOURce]:CORRection:LOAD)

3.6.2.11 Flatness List Clear ([:SOURce]:CORRection:FLATness:PRESet)

3.6.2.12 Level Control ([:SOURce]:POWer:SPC:STATe)

24 SSG3000X Programming Guide

Get level control state.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0

Return

Boolean

Default

SENSOR > Level Control

Example

POWer:SPC:STATe ON

3.6.2.13 Target Level ([:SOURce]:POWer:SPC:TARGet)

Command Format

[:SOURce]:POWer:SPC:TARGet <power> [:SOURce]:POWer:SPC:TARGet?

Instruction

Set the nominal level expected at the input of the sensor. Get the nominal level expected at the input of the sensor.

Parameter Type

Float, unit: dBm, dBmV, dBuV, V, W, Default: dBm

Parameter Range

-120 dBm ~ 20 dBm Return

Float, unit: dBm

Default

0 dBm

SENSOR > Level Control > Target Level

Example

POWer:SPC:TARGet 0

Command Format

[:SOURce]:POWer:LIMit <power> [:SOURce]:POWer:LIMit?

Instruction

Set an upper limit for the RF output power. Get an upper limit for the RF output power.

Parameter Type

Float, unit: dBm, dBmV, dBuV, V, W, Default: dBm

Parameter Range

-110 dBm ~ 20 dBm Return

Float, unit: dBm

Default

0 dBm

SENSOR > Level Control > Level Limit

Example

POWer:LIMit 1

Command Format

[SOURce]:POWer:SPC:CRANge <power> [SOURce]:POWer:SPC:CRANge?

Instruction

Set the capture range of the control system. Get the capture range of the control system.

Parameter Type

Float

Parameter Range

0 dB ~ 50 dB

Return

Float, unit: dB

Default

0 dB

SIGLENT

3.6.2.14 Level Limit ([:SOURce]:POWer:LIMit)

3.6.2.15 Catch Range ([:SOURce]:POWer:SPC:CRANge)

SSG3000X Programming Guide 25

SIGLENT

SENSOR > Level Control > Catch Range

Example

:POWer:SPC:CRANge 5

Command Format

[:SOURce]:SWEep:STATe OFF|FREQuency|LEVel|LEV_FREQ [:SOURce]:SWEep:STATe?

Instruction

Activate frequency or/and level sweep.

Parameter Type

Enumeration

Parameter Range

OFF|FREQuency|LEVel|LEV_FREQ Return

Enumeration

Default

OFF

SWEEP > Sweep State

Example

:SWEep:STATe OFF

Command Format

[:SOURce]:SWEep:TYPE LIST|STEP [:SOURce]:SWEep:TYPE?

Instruction

Set sweep type. Get sweep type.

Parameter Type

Enumeration

Parameter Range

LIST|STEP

Return

Enumeration

Default

STEP

SWEEP > Step Sweep / List Sweep

Example

:SWEep:TYPE STEP

Command Format

[:SOURce]:SWEep:STEP:STARt:FREQuency <freq> [:SOURce]:SWEep:STEP:STARt:FREQuency?

Instruction

Set the start frequency for the sweep mode. Get the start frequency for the sweep mode.

Parameter Type

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter Range

Full frequency range.

Return

Float, unit: Hz

Default

Maximum frequency

SWEEP > Step Sweep > Start Freq

Example

:SWEep:STEP:STARt:FREQuency 1 GHz

3.6.3 [:SOURce]:SWEep Subsystem

3.6.3.1 Sweep State ([:SOURce]:SWEep:STATe)

3.6.3.2 Sweep Type ([:SOURce]:SWEep:TYPE)

3.6.3.3 Start Frequency ([:SOURce]:SWEep:STEP:STARt:FREQuency)

26 SSG3000X Programming Guide

SIGLENT

Command Format

[:SOURce]:SWEep:STEP:STOP:FREQuency <freq> [:SOURce]:SWEep:STEP:STOP:FREQuency?

Instruction

Set the stop frequency for the sweep mode. Get the stop frequency for the sweep mode.

Parameter Type

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter Range

Full frequency range. Return

Float, unit: Hz

Default

Maximum frequency

SWEEP > Step Sweep > Stop Freq

Example

:SWEep:STEP:STOP:FREQuency 1 GHz

Command Format

[:SOURce]:SWEep:STEP:STARt:LEVel <level> [:SOURce]:SWEep:STEP:STARt:LEVel?

Instruction

Set the start level for the sweep mode. Get the start level for the sweep mode.

Parameter Type

Float, unit: dBm, dBmV, dBuV, V, W, Default: dBm

Parameter Range

Full level range.

Return

Float, unit: dBm

Default

-110 dBm

SWEEP > Step Sweep > Start Level

Example

:SWEep:STEP:STARt:LEVel 0 dBm

Command Format

[:SOURce]:SWEep:STEP:STOP:LEVel <level> [:SOURce]:SWEep:STEP:STOP:LEVel?

Instruction

Set the stop level for the sweep mode. Get the stop level for the sweep mode.

Parameter Type

Float, unit: dBm, dBmV, dBuV, V, W, Default dBm

Parameter Range

Full level range. Return

Float, unit: dBm

Default

-110 dBm

SWEEP > Step Sweep > Stop Level

Example

:SWEep:STEP:STOP:LEVel 0 dBm

Command Format

[:SOURce]:SWEep:STEP:DWELl <time> [:SOURce]:SWEep:STEP:DWELl?

Instruction

Set the duration of the individual sweep steps. Get the duration of the individual sweep steps.

3.6.3.4 Stop Frequency ([:SOURce]:SWEep:STEP:STOP:FREQuency)

3.6.3.5 Start Level ([:SOURce]:SWEep:STEP:STARt:LEVel)

3.6.3.6 Stop Level ([:SOURce]:SWEep:STEP:STOP:LEVel)

3.6.3.7 Dwell Time ([:SOURce]:SWEep:STEP:DWELl)

SSG3000X Programming Guide 27

SIGLENT

Parameter Type

Float, unit: ns, us, ms, s

Parameter Range

10 ms ~ 100 s Return

Float, unit: s

Default

30 ms

SWEEP > Step Sweep > Dwell Time

Example

:SWEep:STEP:DWELl 20 ms

Command Format

[:SOURce]:SWEep:STEP:POINts <points> [:SOURce]:SWEep:STEP:POINts?

Instruction

Set the number of steps in an RF sweep. Get the number of steps in an RF sweep.

Parameter Type

Integer

Parameter Range

2 ~ 65535 Return

Integer

Default

SWEEP > Step Sweep > Sweep Points

Example

:SWEep:STEP:POINts 2

Command Format

[:SOURce]:SWEep:STEP:SHAPe TRIangle|SAWtooth [:SOURce]:SWEep:STEP:SHAPe?

Instruction

Select the waveform shape of the sweep signal. Get the waveform shape of the sweep signal.

Parameter Type

Enumeration

Parameter Range

TRIangle|SAWtooth

Return

Enumeration

Default

SAWTooth

SWEEP > Step Sweep > Sweep Shape

Example

:SWEep:STEP:SHAPe TRIangle

Command Format

[:SOURce]:SWEep:STEP:SPACe LINear|LOGarithmic [:SOURce]:SWEep:STEP:SPACe?

Instruction

Select the sweep spacing. Get the sweep spacing.

Parameter Type

Enumeration

Parameter Range

LINear|LOGarithmic

Return

Enumeration

Default

LINear

SWEEP > Step Sweep > Sweep Space

3.6.3.8 Sweep Points ([:SOURce]:SWEep:STEP:POINts)

3.6.3.9 Sweep Shape ([:SOURce]:SWEep:STEP:SHAPe)

3.6.3.10 Sweep Space ([:SOURce]:SWEep:STEP:SPACe)

28 SSG3000X Programming Guide

SIGLENT

Example

:SWEep:STEP:SPACe LOGarithmic

Command Format

[:SOURce]:SWEep:LIST:ADDList <freq>,<level>,<time>

Instruction

Insert a new row.

Parameter Type

Freq: Float, unit: Hz, kHz, MHz, GHz, Default “Hz” Level: Float, unit: dBm Time: Float, unit: ns, us, ms, s

Parameter Range

Full frequency range, full frequency range, 10.0 ms ~ 100.0 s Return

None

Default

None

SWEEP > List Sweep > [+]

Example

:SWEep:LIST:ADDList 1 GHz,0 dBm,1 s

Command Format

[:SOURce]:SWEep:LIST:DELete <row>

Instruction

Delete the sweep list pair.

Parameter Type

Integer

Parameter Range

1 to count of sweep list.

Return

None

Default

None

SWEEP > List Sweep > [-]

Example

:SWEep:LIST:DELete 1

Command Format

[:SOURce]:SWEep:LIST:CHANGe <row>,<freq>,<power>,<time> Instruction

Edit sweep list pair value.

Parameter Type

Integer, Float, unit: Hz, kHz, MHz, GHz, Float, unit: dBm, dBmV, dBuV, V, W, Default: dBm, Float, unit: ns, us, ms, s

Parameter Range

Raw: 1 ~ count of pair. Freq: Full frequency range. Power: Full level range. time: 10 ms ~ 100 s.

Return

None

Default

None

SWEEP > List Sweep

Example

:SWEep:LIST:CHANGe 1,1 GHz,1 dBm, 1 s

Command Format

[:SOURce]:SWEep:LIST:CPOint?

3.6.3.11 Sweep List Add Row ([:SOURce]:SWEep:LIST:ADDList)

3.6.3.12 Sweep List Delete Row ([:SOURce]:SWEep:LIST:DELete)

3.6.3.13 Sweep List Edit ([:SOURce]:SWEep:LIST:CHANGe)

3.6.3.14 Sweep List Row Count ([:SOURce]:SWEep:LIST:CPOint?)

SSG3000X Programming Guide 29

SIGLENT

Instruction

Get how many rows in sweep list.

Parameter Type

None

Parameter Range

None

Return

Float

Default

SWEEP > List Sweep

Example

:SWEep:LIST:CPOint?

Command Format

[:SOURce]:SWEep:LIST:LIST? <begin_ row>,<end_row>

Instruction

View starting row to end row data.

Parameter Type

Integer, Integer

Parameter Range

1 to count of sweep list.

Return

String

Default

None

SWEEP > List Sweep

Example

:SWEep:LIST:LIST? 1,3

Command Format

[:SOURce]:SWEep:LIST:INITialize:PRESet Instruction

Restore the scan list of the factory default settings.

Parameter Type

None

Parameter Range

None Return

None

Default

None

SWEEP > List Sweep > Clear

Example

SWEep:LIST:INITialize:PRESet

Command Format

[:SOURce]:SWEep:LIST:INITialize:FSTep

Instruction

Regenerate the sweep list based on the data points of the current step sweep

settings.

Parameter Type

None

Parameter Range

None

Return

None

Default

None

3.6.3.15 Show Sweep List ([:SOURce]:SWEep:LIST:LIST?)

3.6.3.16 Sweep List Clear ([:SOURce]:SWEep:LIST:INITialize:PRESet)

3.6.3.17 Sweep List Initialize From Step ([:SOURce]:SWEep:LIST:INITialize:FSTep)

30 SSG3000X Programming Guide

SWEEP > List Sweep

Example

SWEep:LIST:INITialize:FSTep

3.6.3.18 Sweep List Load ([:SOURce]:SWEep:LOAD)

Command Format

[:SOURce]:CORRection:LOAD <file_name> Instruction

Load existing sweep list file.

Parameter Type

String

Parameter Range

None

Return

None

Default

None

SWEEP > List Sweep > Load

Example

:SWEep:LOAD test.lsw

Command Format

[:SOURce]:CORRection:STORe <file_name>

Instruction

Save the sweep data in the list.

Parameter Type

String

Parameter Range

None Return

None

Default

None

SWEEP > List Sweep > Store

Example

:SWEep:STORe test.lsw

Command Format

[:SOURce]:SWEep:DIRect FWD|REV [:SOURce]:SWEep:DIRect?

Instruction

Select the direction for sweep.

Parameter Type

Enumeration

Parameter Range

FWD|REV

Return

Enumeration

Default

FWD

SWEEP > Direction

Example

:SWEep:DIRect REV

Command Format

[:SOURce]:SWEep:MODE CONTinue|SINGle [:SOURce]:SWEep:MODE?

Instruction

Set the cycle mode of the sweep. Get the cycle mode of the sweep.

Parameter

Enumeration

3.6.3.19 Sweep List Store ([:SOURce]:SWEep:STORe)

SIGLENT

3.6.3.20 Sweep Direction ([:SOURce]:SWEep:DIRect)

3.6.3.21 Sweep Mode ([:SOURce]:SWEep:MODE)

SSG3000X Programming Guide 31

SIGLENT

Type

Parameter Range

CONTinue|SINGle

Return

Enumeration

Default

CONTinue

SWEEP > Sweep Mode

Example

:SWEep:MODE SINGle

Command Format

[:SOURce]:SWEep:SWEep:TRIGger:TYPE AUTO|KEY|BUS|EXT [:SOURce]:SWEep:SWEep:TRIGger:TYPE?

Instruction

Select the trigger mode. Get the trigger mode.

Parameter Type

Enumeration

Parameter Range

AUTO|KEY|BUS|EXT

Return

Enumeration

Default

AUTO

SWEEP > Trigger Mode

Example

:SWEep:SWEep:TRIGger:TYPE KEY

Command Format

[:SOURce]:SWEep:POINt:TRIGger:TYPE AUTO|KEY|BUS|EXT [:SOURce]:SWEep:POINt:TRIGger:TYPE?

Instruction

Select the point trigger. Get the point trigger.

Parameter Type

Enumeration

Parameter Range

AUTO|KEY|BUS|EXT

Return

Enumeration

Default

AUTO

SWEEP > Point Trigger

Example

:SWEep:POINt:TRIGger:TYPE KEY

Command Format

[:SOURce]:INPut:TRIGger:SLOPe POSitive|NEGative [:SOURce]:INPut:TRIGger:SLOPe?

Instruction

Select the trigger slope. Get the trigger slope.

Parameter Type

Enumeration

Parameter Range

POSitive|NEGative

Return

Enumeration

Default

POSitive

SWEEP > Trigger Slope

Example

:INPut:TRIGger:SLOPe NEGative

3.6.3.22 Trigger Mode ([:SOURce]:SWEep:SWEep:TRIGger:TYPE)

3.6.3.23 Point Trigger ([:SOURce]:SWEep:POINt:TRIGger:TYPE)

3.6.3.24 Trigger Slope ([:SOURce]:INPut:TRIGger:SLOPe)

32 SSG3000X Programming Guide

3.6.4 [:SOURce]:MODulation Subsystem

Command Format

[:SOURce]:MODulation ON|OFF|1|0 [:SOURce]:MODulation?

Instruction

Switch the modulations on and off. Get the modulations state.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0 Return

Boolean

Default

MOD

Example

MODulation ON

Command Format

[:SOURce]:AM:STATe ON|OFF|1|0 [:SOURce]:AM:STATe?

Instruction

Activate/Deactivate amplitude modulation. Get the AM state.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0 Return

Boolean

Default

AM > AM State

Example

:AM:STATe ON

Command Format

[:SOURce]:AM:WAVEform SINE|SQUAre [:SOURce]:AM:WAVEform?

Instruction

Set the AM modulation waveform. Get the AM modulation waveform.

Parameter Type

Enumeration

Parameter Range

SINE|SQUAre Return

Enumeration

Default

SINE

AM > AM Shape

Example

:AM:WAVEform SINE

3.6.4.1 Modulation State ([:SOURce]:MODulation)

3.6.5 [:SOURce]:AM Subsystem

SIGLENT

3.6.5.1 AM State ([:SOURce]:AM:STATe)

3.6.5.2 AM Shape ([:SOURce]:AM:WAVEform)

SSG3000X Programming Guide 33

SIGLENT

Command Format

[:SOURce]:AM:SOURce INTernal|EXTernal|INT+EXT [:SOURce]:AM:SOURce?

Instruction

Select the modulation signal source for amplitude modulation. Get the AM source.

Parameter Type

Enumeration

Parameter Range

INTernal|EXTernal|INT+EXT Return

Enumeration

Default

INTernal

AM > AM Source

Example

:AM:SOURce EXTernal

Command Format

[:SOURce]:AM:DEPTh <value> [:SOURce]:AM:DEPTh?

Instruction

Set the overall modulation depth of the amplitude modulation in percent. Get the AM depth.

Parameter Type

Float

Parameter Range

0.1 % ~ 100 % Return

Float

Default

50 %

AM > AM Depth

Example

:AM:DEPTh 0.2

Command Format

[:SOURce]:AM:FREQuency <value> [:SOURce]:AM:FREQuency?

Instruction

Set the AM modulation frequency. Get the AM modulation frequency.

Parameter Type

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter Range

Sine: 0.01 Hz ~ 100 kHz Square: 0.01 Hz ~ 20 kHz

Return

Float, unit: Hz

Default

1 kHz

AM > AM Rate

Example

:AM:FREQuency 10 kHz

Command Format

[:SOURce]:AM:SENSitivity?

Instruction

Query the input sensitivity of the external modulation input in %/V.

Parameter Type

None

3.6.5.3 AM Source ([:SOURce]:AM:SOURce)

3.6.5.4 AM Depth ([:SOURce]:AM:DEPTh)

3.6.5.5 AM Rate ([:SOURce]:AM:FREQuency)

3.6.5.6 AM Sensitivity ([:SOURce]:AM:SENSitivity)

34 SSG3000X Programming Guide

Parameter Range

None Return

Float, unit: %/V

Default

0 %/V

AM > AM Sensitivity

Example

AM:SENSitivity?

3.6.6 [:SOURce]:FM Subsystem

Command Format

[:SOURce]:FM:STATe ON|OFF|1|0 [:SOURce]:FM:STATe?

Instruction

Activate/Deactivate FM. Get the FM state.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0

Return

Boolean

Default

FM > FM State

Example

:FM:STATe ON

Command Format

[:SOURce]:FM:WAVEform SINE|SQUAre [:SOURce]:FM:WAVEform?

Instruction

Selects the shape of FM. Get the shape of FM.

Parameter Type

Enumeration

Parameter Range

SINE|SQUAre

Return

Enumeration

Default

SINE

FM > FM Shape

Example

:FM:WAVEform SQUAre

Command Format

[:SOURce]:FM:SOURce INTernal|EXTernal|INT+EXT [:SOURce]:FM:SOURce?

Instruction

Select the modulation signal source for frequency modulation. Get the FM Source.

Parameter Type

Enumeration

Parameter Range

INTernal|EXTernal|INT+EXT

Return

Enumeration

Default

INTernal

3.6.6.1 FM State ([:SOURce]:FM:STATe)

SIGLENT

3.6.6.2 FM Shape ([:SOURce]:FM:WAVEform)

3.6.6.3 FM Source ([:SOURce]:FM:SOURce)

SSG3000X Programming Guide 35

SIGLENT

FM > FM Source

Example

:FM:SOURce EXTernal

Command Format

[:SOURce]:FM:DEViation <value> [:SOURce]:FM:DEViation?

Instruction

Set deviation value Get deviation value

Parameter Type

Float, unit: Hz, kHz, MHz, GHz

Parameter Range

0.01 Hz ~ 1 MHz Return

Float, unit: Hz

Default

100 kHz

FM > FM Deviation

Example

:FM:DEViation 500 kHz

Command Format

[:SOURce]:FM:FREQuency <value> [:SOURce]:FM:FREQuency?

Instruction

Set the FM modulation frequency. Get the FM modulation frequency.

Parameter Type

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter Range

INTernal: SQUAre: 0.01 Hz ~ 20 kHz SINE: 0.01 Hz ~ 100 kHz INT+EXT: SQUAre: 0.01 Hz ~ 20 kHz SINE: 0.01 Hz ~ 100 kHz

Return

Float, unit: Hz

Default

10 kHz

FM > FM Rate

Example

:FM:FREQuency 40 kHz

Command Format

[:SOURce]:FM:SENSitivity?

Instruction

Displays the input sensitivity of the FM EXT input in Hz/V.

Parameter Type

None

Parameter Range

None Return

Float unit: Hz/V

Default

0 Hz/V

FM > FM Sensitivity

Example

FM:SENSitivity?

3.6.6.4 FM Deviation ([:SOURce]:FM:DEViation)

3.6.6.5 FM Rate ([:SOURce]:FM:FREQuency)

3.6.6.6 FM Sensitivity ([:SOURce]:FM:SENSitivity)

36 SSG3000X Programming Guide

3.6.7 [:SOURce]:PM Subsystem

Command Format

[:SOURce]:PM:STATe ON|OFF|1|0 [:SOURce]:PM:STATe?

Instruction

Activate/Deactivate phase modulation. Get the PM state.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0 Return

Boolean

Default

PM > PM State

Example

:PM:STATe ON

Command Format

[:SOURce]:PM:WAVEform SINE|SQUAre [:SOURce]:PM:WAVEform?

Instruction

Selects the shape of PM. Get the shape of PM.

Parameter Type

Enumeration

Parameter Range

SINE|SQUAre Return

Enumeration

Default

SINE

PM > PM Shape

Example

:PM:WAVEform SINE

Command Format

[:SOURce]:PM:SOURce INTernal|EXTernal|INT+EXT [:SOURce]:PM:SOURce?

Instruction

Select the modulation signal source for phase modulation. Get the PM source.

Parameter Type

Enumeration

Parameter Range

INTernal|EXTernal|INT+EXT

Return

Enumeration

Default

INTernal

PM > PM Source

Example

:PM:SOURce EXTernal

Command Format

[:SOURce]:PM:DEViation <value> [:SOURce]:PM:DEViation?

3.6.7.1 PM State ([:SOURce]:PM:STATe)

3.6.7.2 PM Shape ([:SOURce]:PM:WAVEform)

SIGLENT

3.6.7.3 PM Source ([:SOURce]:PM:SOURce)

3.6.7.4 PM Deviation ([:SOURce]:PM:DEViation)

SSG3000X Programming Guide 37

SIGLENT

Instruction

Set the modulation deviation of the phase modulation. Get the modulation deviation of the phase modulation.

Parameter Type

Float, unit: rad

Parameter Range

0.00001 rad ~ 5 rad

Return

Float, unit: rad

Default

1 rad

PM > PM Deviation

Example

:PM:DEViation 2

Command Format

[:SOURce]:PM:FREQuency <value> [:SOURce]:PM:FREQuency?

Instruction

Set the PM modulation frequency. Get the PM modulation frequency.

Parameter Type

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter Range

INTernal: SQUAre:0.01 Hz ~ 20 kHz SINE: 0.01 Hz ~ 100 kHz INT+EXT: SQUAre:0.01 Hz ~ 20 kHz 0.01 Hz ~ 100 kHz

Return

Float, unit: Hz

Default

10 kHz

PM > PM Rate

Example

:PM:FREQuency 10 kHz

Command Format

[:SOURce]:PM:SENSitivity? Instruction

Query the input sensitivity of the EXT MOD input in rad/v.

Parameter Type

None

Parameter Range

None Return

Float, unit: rad/V

Default

0 rad/V

PM > PM Sensitivity

Example

PM:SENSitivity?

Command Format

[:SOURce]:PULM:STATe ON|OFF|1|0 [:SOURce]:PULM:STATe?

Instruction

Activate/Deactivate the pulse modulation. Get the state of pulse modulation.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0

3.6.7.5 PM Rate ([:SOURce]:PM:FREQuency)

3.6.7.6 PM Sensitivity ([:SOURce]:PM:SENSitivity)

3.6.8 [:SOURce]:PULM Subsystem

3.6.8.1 Pulse State ([:SOURce]:PULM:STATe)

38 SSG3000X Programming Guide

Return

Boolean

Default

PULSE > Pulse State

Example

PULM:STAT ON

3.6.8.2 Pulse Out ([:SOURce]:PULM:OUT:STATe)

Command Format

[:SOURce]:PULM:OUT:STATe ON|OFF|1|0 [:SOURce]:PULM:OUT:STATe?

Instruction

Configures the signal at the PULSE OUT connector. Get the Output status.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0 Return

Boolean

Default

PULSE > Pulse Out

Example

PULM:OUT ON

Command Format

[:SOURce]:PULM:SOURce INTernal|EXTernal [:SOURce]:PULM:SOURce?

Instruction

Select the source for the pulse modulation signal. Get the source for the pulse modulation signal.

Parameter Type

Enumeration

Parameter Range

INTernal|EXTernal Return

Enumeration

Default

INTernal

PULSE > Pulse Source

Example

PULM:SOUR INTernal

Command Format

[:SOURce]:PULM:POLarity NORMal|INVerted [:SOURce]:PULM:POLarity?

Instruction

Set the period of the generated pulse. The period determines the repetition frequency of the internal signal. Get the period of the generated pulse.

Parameter Type

Enumeration

Parameter Range

NORMal|INVerted Return

Enumeration

Default

NORMal

PULSE > Pulse Polarity

Example

PULM:POL INV

SIGLENT

3.6.8.3 Pulse Source ([:SOURce]:PULM:SOURce)

3.6.8.4 Pulse Polarity ([:SOURce]:PULM:POLarity)

SSG3000X Programming Guide 39

SIGLENT

Command Format

[:SOURce]:PULM:MODE SINGle|DOUBle|PTRain [:SOURce]:PULM:MODE?

Instruction

Set the mode of the pulse generator. Get the mode of the pulse generator.

Parameter Type

Enumeration

Parameter Range

SINGle|DOUBle|PTRain SINGle Enables single pulse generation. DOUBle Enables double pulse generation. The two pulses are generated in one pulse period. PTRain A user-defined pulse train is generated The pulse train is defined by value pairs of on and off times that can be entered in a pulse train list.

Return

Enumeration

Default

SINGle

PULSE > Pulse Mode

Example

PULM:MODE DOUB

Command Format

[:SOURce]:PULM:PERiod <value> [:SOURce]:PULM:PERiod?

Instruction

Set the period of the generated pulse. The period determines the repetition frequency of the internal signal. Get the period of the generated pulse.

Parameter Type

Float, unit: ns, us, ms, s

Parameter Range

40 ns ~ 300 s

Return

Float, unit: s

Default

10 ms

PULSE > Pulse Period

Example

PULM:PER 220 us

Command Format

[:SOURce]:PULM:WIDTh <value> [:SOURce]:PULM:WIDTh?

Instruction

Set the width of the generated pulse. Get the width of the generated pulse.

Parameter Type

Float, unit: ns, us, ms, s

Parameter Range

20 ns ~ 300 s

Return

Float, unit: s

Default

2 ms

PULSE > Pulse Width

Example

PULM:WIDT 33 us

3.6.8.5 Pulse Mode ([:SOURce]:PULM:MODE)

3.6.8.6 Pulse Period ([:SOURce]:PULM:PERiod)

3.6.8.7 Pulse Width ([:SOURce]:PULM:WIDTh)

40 SSG3000X Programming Guide

SIGLENT

Command Format

[:SOURce]:PULM:DOUBle:DELay <value> [:SOURce]:PULM:DOUBle:DELay?

Instruction

Set the delay from the start of the first pulse to the start of the second pulse. Get the delay from the start of the first pulse to the start of the second pulse.

Parameter Type

Float, unit: ns, us, ms, s

Parameter Range

20 ns ~ 300 s Return

Float, unit: s

Default

4 ms

PULSE > Double Pulse Delay

Example

:PULM:DOUBle:DELay 2 ms

Command Format

[:SOURce]:PULM:DOUBle:WIDTh <time> [:SOURce]:PULM:DOUBle:WIDTh?

Instruction

Set the width of the second pulse in case of double pulse generation. Get the width of the second pulse in case of double pulse generation.

Parameter Type

Float, unit: ns, us, ms, s

Parameter Range

20 ns ~ 300 s Return

Float, unit: s

Default

2 ms

PULSE > #2 Width

Example

PULM:DOUBle:WIDTh 2 s

Command Format

[:SOURce]:PULM:TRAin:PAIR

Instruction

Add default train pair value.

Parameter Type

None

Parameter Range

None

Return

None

Default

None

PULSE > Pulse Train > [+]

Example

PULM:TRAin:PAIR

Command Format

[:SOURce]:PULM:TRAin:DELete <row> Instruction

Delete the train pair.

Parameter Type

Integer Parameter

1 ~ 2047

3.6.8.8 Double Pulse Delay ([:SOURce]:PULM:DOUBle:DELay)

3.6.8.9 #2 Width ([:SOURce]:PULM:DOUBle:WIDTh)

3.6.8.10 Pulse Train Add Row ([:SOURce]:PULM:TRAin:PAIR)

3.6.8.11 Pulse Train Delete ([:SOURce]:PULM:TRAin:DELete)

SSG3000X Programming Guide 41

SIGLENT

Range

Return

None

Default

None

PULSE > Pulse Train > [-]

Example

PULM:TRAin:DELete 5

Command Format

[:SOURce]:PULM:TRAin:CHANGe <raw>,<on_time>,<off_time>,<count> Instruction

Edit train pair value.

Parameter Type

Integer, Float, unit: ns, us, ms, s, Float, unit: ns, us, ms, s, Integer

Parameter Range

Raw: 1 ~ count of pair. On time: 10 ns ~ 300 s. Off time: 10 ns ~ 300 s. Count: 1 ~ 65535

Return

None

Default

None

PULSE > Pulse Train

Example

:PULM:TRAin:CHANGe 1,10 ms,20 ms,3

Command Format

[:SOURce]:PULM:TRAin:LIST? <begin_row>,<end_row> Instruction

View starting row to end row data.

Parameter Type

Integer, Integer

Parameter Range

Begin_row: 1 ~ the count of pulse list. End_row: Begin_row ~ the count of pulse list.

Return

String

Default

None

PULSE > Pulse Train

Example

:PULM:TRAin:LIST? 1,3

Command Format

[:SOURce]:PULM:TRAin:COUNt?

Instruction

Get count of train list.

Parameter Type

None

Parameter Range

None

Return

Integer

Default

PULSE > Pulse Train

Example

:PULM:TRAin:COUNt?

3.6.8.12 Pulse Train Edit ([:SOURce]:PULM:TRAin:CHANGe)

3.6.8.13 List Pulse Train ([:SOURce]:PULM:TRAin:LIST?)

3.6.8.14 Pulse Train Count ([:SOURce]:PULM:TRAin:COUNt?)

42 SSG3000X Programming Guide

SIGLENT

Command Format

[:SOURce]:PULM:TRAin:CLEAr

Instruction

Clear train pair list.

Parameter Type

None

Parameter Range

None

Return

None

Default

None

PULSE > Pulse Train > Store

Example

PULM:TRAin:CLEAr

Command Format

[:SOURce]:PULM:TRAin:LOAD <file>

Instruction

Load train pair list.

Parameter Type

String

Parameter Range

None Return

None

Default

None

PULSE > Pulse Train > Load

Example

PULM:TRAin:LOAD test.pulstrn

Command Format

[:SOURce]:PULM:TRAin:STORE <file>

Instruction

Store train pair list.

Parameter Type

String

Parameter Range

None

Return

None

Default

None

PULSE > Pulse Train

Example

PULM:TRAin:STORE test.pulstrn

Command Format

[:SOURce]:PULM:TRIGger:STATe ON|OFF|1|0 [:SOURce]:PULM:TRIGger:STATe?

Instruction

Set the trigger output status. Get the trigger output status.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0

3.6.8.15 Pulse Train Clear ([:SOURce]:PULM:TRAin:CLEAr)

3.6.8.16 Pulse Train Load ([:SOURce]:PULM:TRAin:LOAD)

3.6.8.17 Pulse Train Store ([:SOURce]:PULM:TRAin:STORE)

3.6.8.18 Trigger Out ([:SOURce]:PULM:TRIGger:STATe)

SSG3000X Programming Guide 43

SIGLENT

Return

Boolean

Default

PULSE > Trigger Out

Example

PULM:TRIGger:STATe ON

Command Format

[:SOURce]:PULM:TRIGger:MODE AUTO|KEY|EXTernal|EGATe [:SOURce]:PULM:TRIGger:MODE?

Instruction

Select the trigger mode for pulse modulation. Get the trigger mode for pulse modulation.

Parameter Type

Enumeration

Parameter Range

AUTO| KEY|EXTernal|EGATe Return

Enumeration

Default

AUTO

PULSE > Pulse Trigger

Example

PULM:TRIG:MODE EXTernal

Command Format

[:SOURce]:PULM:TRIGger:EXTernal:GATE:POLarity NORMal|INVerted [:SOURce]:PULM:TRIGger:EXTernal:GATE:POLarity?

Instruction

Select the polarity of the gate signal. Get the polarity of the gate signal.

Parameter Type

Enumeration

Parameter Range

NORMal|INVerted

Return

Enumeration

Default

NORMal

PULSE > Pulse Polarity

Example

PULM:TRIG:EXT:GATE:POL NORMal

Command Format

[:SOURce]:PULM:DELay <value> [:SOURce]:PULM:DELay?

Instruction

Set the pulse delay. Get the pulse delay.

Parameter Type

Float, unit: ns, us, ms, s

Parameter Range

140 ns ~ 300 s

Return

Float, unit: s

Default

140 ns

PULSE > Trig Delay

Example

PULM:DEL 30 ms

3.6.8.19 Pulse Trigger ([:SOURce]:PULM:TRIGger:MODE)

3.6.8.20 Trig Polarity ([:SOURce]:PULM:TRIGger:EXTernal:GATE:POLarity)

3.6.8.21 Trig Delay ([:SOURce]:PULM:DELay)

44 SSG3000X Programming Guide

SIGLENT

Command Format

[:SOURce]:PULM:TRIGger:EXTernal:SLOPe NEGative|POSitive [:SOURce]:PULM:TRIGger:EXTernal:SLOPe?

Instruction

Set the polarity of the active slope of an applied trigger at the PULSE EXT connector. Get the polarity of the active slope of an applied trigger at the PULSE EXT connector.

Parameter Type

Enumeration

Parameter Range

NEGative|POSitive

Return

Enumeration

Default

POSitive

PULSE > Trig Slope

Example

PULM:TRIG:EXT:SLOP NEG

Command Format

[:SOURce]:LFOutput ON|OFF|1|0 [:SOURce]:LFOutput?

Instruction

Activate/deactivate the LF output. Get the LF output state.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0

Return

Boolean

Default

LF > LF State

Example

LFOutput ON

Command Format

[:SOURce]:LFOutput:VOLTage <volt> [:SOURce]:LFOutput:VOLTage?

Instruction

Set the voltage of the LF output signal. Get the voltage of the LF output signal.

Parameter Type

Float, unit: dBm, dBmV, dBuV, V, W, Default: V (Here V is the peak-peak value)

Parameter Range

1 mVpp ~ 3 Vpp

Return

Float, unit: Vpp

Default

0.5 Vpp

LF > LF Voltage

Example

LFOutput:VOLTage 2 V

3.6.8.22 Trig Slope ([:SOURce]:PULM:TRIGger:EXTernal:SLOPe)

3.6.9 [:SOURce]:LFOutput Subsystem

3.6.9.1 LF State ([:SOURce]:LFOutput[:STATe])

3.6.9.2 LF Level ([:SOURce]:LFOutput:VOLTage)

SSG3000X Programming Guide 45

SIGLENT

Command Format

[:SOURce]:LFOutput:OFFSEt <volt> [:SOURce]:LFOutput:OFFSEt?

Instruction

Set the voltage offset of the LF output signal. Get the voltage offset of the LF output signal.

Parameter Type

Float, unit: dBm, dBmV, dBuV, V, W, Default: V

Parameter Range

Return

Float, unit: V

Default

0 V

LF > LF Offset

Example

LFOutput:OFFSEt 1 V

Command Format

[:SOURce]:LFOutput:FREQuency <freq> [:SOURce]:LFOutput:FREQuency?

Instruction

Set LF out put frequency. Get LF out put frequency. If signal source "Internal" is set, the instrument performs the analog modulations (AM/FM /PM) with this frequency.

Parameter Type

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter Range

0.01 Hz ~ 1 MHz Return

Float, unit: Hz

Default

1 kHz

LF > LF Frequency

Example

LFOutput:FREQuency 10 kHz

Command Format

[:SOURce]:LFOutput:SHAPe SINE|SQUare|TRIangle|SAWTooth|DC [:SOURce]:LFOutput:SHAPe?

Instruction

Select the shape of the LF signal. Get the shape of the LF signal.

Parameter Type

Enumeration

Parameter Range

SINE|SQUare|TRIangle|SAWTooth|DC Return

Enumeration

Default

SINE

LF > LF Shape

Example

LFOutput:SHAPe TRIangle

Command Format

[:SOURce]:LFOutput:PHASe <deg> [:SOURce]:LFOutput:PHASe?

max(2.5 ,2 )

LFoffset V LEVEL V

3.6.9.3 LF Offset ([:SOURce]:LFOutput:OFFSEt)

3.6.9.4 LF Frequency ([:SOURce]:LFOutput:FREQuency)

3.6.9.5 LF Shape ([:SOURce]:LFOutput:SHAPe)

3.6.9.6 LF Phase ([:SOURce]:LFOutput:PHASe)

46 SSG3000X Programming Guide

Instruction

Set the phase of the LF output signal. Get the phase of the LF output signal.

Parameter Type

Float, unit: deg

Parameter Range

-360 deg ~ 360 deg

Return

Float, unit: deg

Default

0 deg

LF > LF Phase

Example

LFOutput:PHASe 20

3.6.10 [:SOURce]:LFOutput:SWEep Subsystem

Command Format

[:SOURce]:LFOutput:SWEep ON|OFF|0|1 [:SOURce]:LFOutput:SWEep?

Instruction

Activate/Deactivate the LF frequency sweep signal generation. Get the state of LF frequency sweep.

Parameter Type

Boolean

Parameter Range

ON|OFF|0|1

Return

Boolean

Default

LF Sweep > LF State

Example

:LFOutput:SWEep 1

Command Format

[:SOURce]:LFOutput:SWEep:DIRect UP|DOWN [:SOURce]:LFOutput:SWEep:DIRect?

Instruction

Set the sweep direction. Get the sweep direction.

Parameter Type

Enumeration

Parameter Range

UP|DOWN

Return

Enumeration

Default

LF Sweep > Sweep Direction

Example

:LFOutput:SWEep:DIRect DOWN

Command Format

[:SOURce]:LFOutput:SWEep:STARt:FREQuency <freq> [:SOURce]:LFOutput:SWEep:STARt:FREQuency?

Instruction

Set the start frequency of sweep mode. Get the start frequency of sweep mode.

Parameter

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

3.6.10.1 Sweep State ([:SOURce]:LFOutput:SWEep)

SIGLENT

3.6.10.2 Sweep Direction ([:SOURce]:LFOutput:SWEep:DIRect)

3.6.10.3 Start Freq ([:SOURce]:LFOutput:SWEep:STARt:FREQuency)

SSG3000X Programming Guide 47

SIGLENT

Type

Parameter Range

0.01 Hz ~ Stop frequency

Return

Float, unit: Hz

Default

500 Hz

LF Sweep > Start Freq

Example

:LFOutput:SWEep:STARt:FREQuency 100

Command Format

[:SOURce]:LFOutput:SWEep:STOP:FREQuency <freq> [:SOURce]:LFOutput:SWEep:STOP:FREQuency?

Instruction

Set the stop frequency of sweep mode. Get the stop frequency of sweep mode.

Parameter Type

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter Range

Start frequency ~ Maximum frequency of LF

Return

Float, unit: Hz

Default

1.5 kHz

LF Sweep > Stop Freq

Example

:LFOutput:SWEep:STOP:FREQuency 1000

Command Format

[:SOURce]:LFOutput:SWEep:CENTer:FREQuency <freq> [:SOURce]:LFOutput:SWEep:CENTer:FREQuency?

Instruction

Set the center frequency of sweep mode. Get the center frequency of sweep mode.

Parameter Type

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter Range

0.01 Hz ~ Maximum frequency of LF Return

Float, unit: Hz

Default

1 kHz

LF Sweep > Center Freq

Example

:LFOutput:SWEep:CENTer:FREQuency 550

Command Format

[:SOURce]:LFOutput:SWEep:SPAN:FREQuency <freq> [:SOURce]:LFOutput:SWEep:SPAN:FREQuency?

Instruction

Set the center frequency of sweep mode. Get the center frequency of sweep mode.

Parameter Type

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter Range

0 Hz ~ Maximum frequency of LF – 0.01 Hz

Return

Float, unit: Hz

3.6.10.4 Stop Freq ([:SOURce]:LFOutput:SWEep:STOP:FREQuency)

3.6.10.5 Center Freq ([:SOURce]:LFOutput:SWEep:CENTer:FREQuency)

3.6.10.6 Freq Span ([:SOURce]:LFOutput:SWEep:SPAN:FREQuency)

48 SSG3000X Programming Guide

SIGLENT

Default

1 kHz

LF Sweep > Freq Span

Example

:LFOutput:SWEep:SPAN:FREQuency 550

Command Format

[:SOURce]:LFOutput:SWEep:DWELl <time> [:SOURce]:LFOutput:SWEep:DWELl?

Instruction

Set the sweep time of sweep mode. Get the sweep time of sweep mode.

Parameter Type

Float, unit: ns, us, ms, s

Parameter Range

1 ms ~ 500 s Return

Float, unit: s

Default

1 s

LF Sweep > Sweep Time

Example

:LFOutput:SWEep:DWELl 2 s

Command Format

[:SOURce]:LFOutput:SWEep:TRIGger:TYPE AUTO|KEY|BUS|EXT [:SOURce]:LFOutput:SWEep:TRIGger:TYPE?

Instruction

Select the LF frequency sweep trigger mode. Get the LF frequency sweep trigger mode.

Parameter Type

Enumeration

Parameter Range

AUTO|KEY|BUS|EXT

Return

Enumeration

Default

AUTO

LF Sweep > Trigger Mode

Example

:LFOutput:SWEep:TRIGger:TYPE KEY

Command Format

[:SOURce]:LFOutput:SWEep:SHAPe TRIangle|SAWTooth [:SOURce]:LFOutput:SWEep:SHAPe?

Instruction

Select the waveform shape of the sweep signal. Get the waveform shape of the sweep signal.

Parameter Type

Enumeration

Parameter Range

TRIangle|SAWTooth

Return

Enumeration

Default

SAWTooth

LF Sweep > Sweep Shape

Example

:LFOutput:SWEep:SHAPe TRIangle

3.6.10.7 Sweep Time ([:SOURce]:LFOutput:SWEep:DWELl)

3.6.10.8 Trigger Mode ([:SOURce]:LFOutput:SWEep:TRIGger:TYPE)

3.6.10.9 Sweep Shape ([:SOURce]:LFOutput:SWEep:SHAPe)

SSG3000X Programming Guide 49

SIGLENT

Command Format

[:SOURce]:LFOutput:SWEep:SPACing LINear|LOGarithmic [:SOURce]:LFOutput:SWEep:SPACing?

Instruction

Select the mode for the calculation of the frequency sweep intervals. Get the mode for the calculation of the frequency sweep intervals.

Parameter Type

Enumeration

Parameter Range

LINear|LOGarithmic Return

Enumeration

Default

LINear

LF Sweep > Sweep Space

Example

:LFOutput:SWEep:SPACing LOGarithmic

Command Format

:SENSe[:POWer]:TYPE? Instruction

Query the type of sensor connected to the POWER SENSOR connector.

Parameter Type

None

Parameter Range

None Return

String

Default

None

SENSOR > Sensor Info

Example

SENSe:TYPE?

Command Format

:SENSe[:POWer]:STATus OFF|ON|0|1 :SENSe[:POWer]:STATus?

Instruction

Set the sensor state. Get the sensor state.

Parameter Type

Boolean

Parameter Range

OFF|ON|0|1 Return

Boolean

Default

SENSOR > Sensor State

Example

SENSe:STATus ON

Command Format

:SENSe[:POWer]:VALue?

Instruction

Indicate the current reading of the sensor.

Parameter

None

3.6.10.10 Sweep Space ([:SOURce]:LFOutput:SWEep:SPACing)

3.7 Sense Subsystem

3.7.1 Sensor Info (:SENSe[:POWer]:TYPE)

3.7.2 Sensor State (:SENSe[:POWer]:STATus)

3.7.3 Measurement (:SENSe[:POWer]:VALue)

50 SSG3000X Programming Guide

Type

Parameter Range

None

Return

Float, unit: dBm

Default

None

SENSOR > Measurement

Example

SENSe:VALue?

3.7.4 Statistics State

Command Format

:SENSe[:POWer]:STATIStics:STATe ON|OFF|1|0 :SENSe[:POWer]:STATIStics:STATe?

Instruction

Set statistics state. Get statistics state.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0

Return

Boolean

Default

SENSOR > Statistics

Example

SENSe:STATIStics:STATe ON

Command Format

:READ[:POWer]?

Instruction

Indicate the measured mean value and maximum value.

Parameter Type

None

Parameter Range

None

Return

String

Default

None

SENSOR > Statistics

Example

READ?

Command Format

:SENSe[:POWer]:STATIStics:MAX? Instruction

Indicate the measured maximum value.

Parameter Type

None

Parameter Range

None Return

Float, unit: dBm

Default

None

SENSOR > Statistics

Example

SENSe:STATIStics:MAX?

(:SENSe[:POWer]:STATIStics:STATe)

SIGLENT

3.7.5 Statistics Value (:READ[:POWer])

3.7.6 Statistics Max Value (:SENSe[:POWer]:STATIStics:MAX?)

SSG3000X Programming Guide 51

SIGLENT

Command Format

:SENSe[:POWer]:STATIStics:MIN? Instruction

Indicate the measured minimum value.

Parameter Type

None

Parameter Range

None Return

Float, unit: dBm

Default

None

SENSOR > Statistics

Example

SENSe:STATIStics:MIN?

Command Format

:SENSe[:POWer]:STATIStics:AVG?

Instruction

Indicate the measured mean value.

Parameter Type

None

Parameter Range

None Return

Float, unit: dBm

Default

None

SENSOR > Statistics

Example

SENSe:STATIStics:AVG?

Command Format

:SENSe[:POWer]:STATIStics:COUNt?

Instruction

Indicate the measured times.

Parameter Type

None

Parameter Range

None Return

Integer

Default

None

SENSOR > Statistics

Example

SENSe:STATIStics:COUNt?

Command Format

:SENSe[:POWer]:STATIStics:CLEAr?

Instruction

Clear statistics.

Parameter

None

3.7.7 Statistics Min Value (:SENSe[:POWer]:STATIStics:MIN?)

3.7.8 Statistics Mean Value (:SENSe[:POWer]:STATIStics:AVG?)

3.7.9 Statistics Count (:SENSe[:POWer]:STATIStics:COUNt?)

3.7.10 Statistics Clear (:SENSe[:POWer]:STATIStics:CLEAr?)

52 SSG3000X Programming Guide

Type

Parameter Range

None

Return

None

Default

None

SENSOR > Statistics

Example

SENSe:STATIStics:CLEAr?

3.7.11 Auto Zero (:CALibration:ZERO:TYPE)

Command Format

:CALibration:ZERO:TYPE INTernal|EXTernal :CALibration:ZERO:TYPE?

Instruction

Select zero type. Get zero type.

Parameter Type

Enumeration

Parameter Range

INTernal|EXTernal

Return

Enumeration

Default

INTernal

SENSOR > Auto Zero

Example

CALibration:ZERO:TYPE EXTernal

Command Format

:SENSe[:POWer]:ZERO

Instruction

Perform zeroing of the sensor.

Parameter Type

None

Parameter Range

None Return

None

Default

None

SENSOR > Click to perform zeroing

Example

:SENSe:ZERO

Command Format

:SENSe[:POWer]:SOURce RF|USER :SENSe[:POWer]:SOURce?

Instruction

Select the signal source for the measurement. Get the signal source for the measurement.

Parameter Type

Enumeration

Parameter Range

RF|USER

Return

Enumeration

Default

SENSOR > Frequency

Example

SENSe:SOURce RF

SIGLENT

3.7.12 Zeroing (:SENSe[:POWer]:ZERO)

3.7.13 Frequency Type (:SENSe[:POWer]:SOURce)

SSG3000X Programming Guide 53

SIGLENT

Command Format

:SENSe[:POWer]:FREQuency <type> :SENSe[:POWer]:FREQuency?

Instruction

Set the frequency for frequency type " USER". Get the frequency for frequency type " USER".

Parameter Type

Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter Range

9 kHz ~ 3.2 GHz

Return

Float, unit: Hz

Default

None

SENSOR > Frequency

Example

SENSe:FREQuency 1 MHz

Command Format

:SENSe[:POWer]:OFFSet:STATe ON|OFF|0|1 :SENSe[:POWer]:OFFSet:STATe?

Instruction

Switch the power offset switch status. Get the power offset switch status.

Parameter Type

Boolean

Parameter Range

ON|OFF|0|1 Return

Boolean

Default

SENSOR > Level Offset

Example

SENSe:OFFSet:STATe ON

Command Format

:SENSe[:POWer]:OFFSet <power> :SENSe[:POWer]:OFFSet?

Instruction

The command enters a level offset which is added to the measured level value. Get the level offset which is added to the measured level value.

Parameter Type

Float

Parameter Range

Limit by power sensor. Return

Float, unit: dB

Default

0 dB

SENSOR > Level Offset

Example

SENSe:OFFSet 10

Command Format

:SENSe[:POWer]:FILTer:TYPE AUTO|USER|NSRatio :SENSe[:POWer]:FILTer:TYPE?

Instruction

Select the averaging mode. Get the averaging mode.

Parameter Type

Enumeration

3.7.14 Frequency (:SENSe[:POWer]:FREQuency)

3.7.15 Level Offset State (:SENSe[:POWer]:OFFSet:STATe)

3.7.16 Level Offset (:SENSe[:POWer]:OFFSet)

3.7.17 Average Type (:SENSe[:POWer]:FILTer:TYPE)

54 SSG3000X Programming Guide

Parameter Range

AUTO|USER|NSRatio Return

Enumeration

Default

None

SENSOR > Averaging

Example

SENSe:FILTer:TYPE AUTO

3.7.18 Average Times

Command Format

:SENSe[:POWer]:FILTer:LENGth <length> :SENSe[:POWer]:FILTer:LENGth?

Instruction

Set the average number times.

Parameter Type

Integer

Parameter Range

Limit by power sensor

Return

Float

Default

None

SENSOR > Averaging

Example

SENSe:FILTer:LENGth 10

Command Format

:SENSe[:POWer]:FILTer:NSRatio <noise> :SENSe[:POWer]:FILTer:NSRatio?

Instruction

The power sensor will control the internal noise that does not exceed the set value of the fixed noise parameter.

Parameter Type

Float, unit: dB

Parameter Range

Limit by power sensor.

Return

Float, unit: dB

Default

None

SENSOR > Averaging

Example

SENSe:FILTer:NSRatio 1

Command Format

:SENSe[:POWer]:LOGGing:STATe <state> :SENSe[:POWer]:LOGGing:STATe?

Instruction

Set logging state. Get logging state.

Parameter Type

Boolean

Parameter Range

ON|OFF|1|0 Return

Boolean

Default

SENSOR > Logging

Example

SENSe:LOGGing:STATe ON

(:SENSe[:POWer]:FILTer:LENGth)

SIGLENT

3.7.19 Internal Noise (:SENSe[:POWer]:FILTer:NSRatio)

3.7.20 Logging (:SENSe[:POWer]:LOGGing:STATe)

SSG3000X Programming Guide 55

SIGLENT

4.Programming Examples

This chapter gives some examples for the programmer. In these examples you can see how to use the VISA or sockets, in combination with the commands have been described above to control the signal generator. By following these examples, you can develop many more applications.

4.1 Examples of Using VISA

4.1.1 Example of VC++

Environment: Win7 32bit system, Visual Studio The functions of this example: use the NI-VISA, to control the device with USBTMC or

TCP/IP access to do a write and read. Follow the steps to finish the example:

1、 Open Visual Studio, create a new VC++ win32 console project. 2、 Set the project environment to use the NI-VISA lib, there are two ways to use NI-VISA,

static or automatic:

(1) Static: find files: visa.h, visatype.h, visa32.lib in NI-VISA install path. Copy them to your project, and add them into project. In the projectname.cpp file, add the follow two lines:

#include "visa.h"

#pragma comment(lib,"visa32.lib")

(2) Automatic: Set the .h file include directory, the NI-VISA install path, in our computer we set the path is: C:\Program Files\IVI Foundation \VISA\WinNT\include. Set this path to project---properties--

-c/c++---General---Additional Include Directories: See the picture.

Set lib path set lib file: Set lib path: the NI-VISA install path, in our computer we set the path is: C:\Program Files\IVI Foundation\VISA\WinNT\lib\msc. Set this path to project---properties---Linker---General--Additional Library Directories: as seen in the pictures below.

56 SSG3000X Programming Guide

SIGLENT

Set lib file: project---properties---Linker---Command Line---Additional Options: visa32.lib

Include visa.h file: In the projectname.cpp file:

#include <visa.h>

3、Add codes:

(1) USBTMC access code. Write a function Usbtmc_test:

int Usbtmc_test()

{ /* This code demonstrates sending synchronous read & write commands */ /* to an USB Test & Measurement Class (USBTMC) instrument using */ /* NI-VISA */ /* The example writes the "*IDN?\n" string to all the USBTMC */ /* devices connected to the system and attempts to read back */ /* results using the write and read functions. */ /* The general flow of the code is */ /* Open Resource Manager */ /* Open VISA Session to an Instrument */ /* Write the Identification Query Using viPrintf */ /* Try to Read a Response With viScanf */ /* Close the VISA Session */ /***********************************************************/ ViSession defaultRM; ViSession instr; ViUInt32 numInstrs; ViFindList findList; ViStatus status; char instrResourceString[VI_FIND_BUFLEN]; unsigned char buffer[100]; int i; /** First we must call viOpenDefaultRM to get the manager

* handle. We will store this handle in defaultRM.*/

status = viOpenDefaultRM (&defaultRM); if (status<VI_SUCCESS) { printf ("Could not open a session to the VISA Resource Manager!\n"); return status; } /* Find all the USB TMC VISA resources in our system and store the number of resources in the system in

SSG3000X Programming Guide 57

SIGLENT

numInstrs.*/

status = viFindRsrc (defaultRM, "USB?*INSTR", &findList, &numInstrs, instrResourceString); if (status<VI_SUCCESS) { printf ("An error occurred while finding resources.\nPress 'Enter' to continue."); fflush(stdin); getchar(); viClose (defaultRM); return status; } /** Now we will open VISA sessions to all USB TMC instruments.

* We must use the handle from viOpenDefaultRM and we must * also use a string that indicates which instrument to open. This * is called the instrument descriptor. The format for this string * can be found in the function panel by right clicking on the * descriptor parameter. After opening a session to the * device, we will get a handle to the instrument which we * will use in later VISA functions. The AccessMode and Timeout * parameters in this function are reserved for future * functionality. These two parameters are given the value VI_NULL.*/

for (i=0; i<int(numInstrs); i++) { if (i> 0) { viFindNext (findList, instrResourceString); } status = viOpen (defaultRM, instrResourceString, VI_NULL, VI_NULL, &instr); if (status<VI_SUCCESS) { printf ("Cannot open a session to the device %d.\n", i+1); continue ; } /* * At this point we now have a session open to the USB TMC instrument.

* We will now use the viPrintf function to send the device the string "*IDN?\n", * asking for the device's identification. */

char * cmmand ="*IDN?\n"; status = viPrintf (instr, cmmand); if (status<VI_SUCCESS) { printf ("Error writing to the device %d.\n", i+1); status = viClose (instr); continue; } /** Now we will attempt to read back a response from the device to

* the identification query that was sent. We will use the viScanf * function to acquire the data. * After the data has been read the response is displayed. */

status = viScanf(instr, "%t", buffer); if (status<VI_SUCCESS) { printf ("Error reading a response from the device %d.\n", i+1); } else { printf ("\nDevice %d: %s\n", i+1, buffer); } status = viClose (instr); } /** Now we will close the session to the instrument using

* viClose. This operation frees all system resources. */

status = viClose (defaultRM); printf("Press 'Enter' to exit."); fflush(stdin); getchar(); return 0; }

58 SSG3000X Programming Guide

int _tmain(int argc, _TCHAR* argv[])

{ Usbtmc_test(); return 0; }

Run result.

SIGLENT

(2) TCP/IP access code.

Write a function TCP_IP_Test:

int TCP_IP_Test(char *pIP)

{ char outputBuffer[VI_FIND_BUFLEN];

ViSession defaultRM, instr; ViStatus status;

/* First we will need to open the default resource manager. */ status = viOpenDefaultRM (&defaultRM); if (status<VI_SUCCESS) { printf("Could not open a session to the VISA Resource Manager!\n"); } /* Now we will open a session via TCP/IP device */ char head[256] = "TCPIP0::"; char tail[] = "::INSTR";

strcat(head,pIP); strcat(head,tail); status = viOpen (defaultRM, head, VI_LOAD_CONFIG, VI_NULL, &instr); if (status<VI_SUCCESS) { printf ("An error occurred opening the session\n"); viClose(defaultRM); } status = viPrintf(instr, "*idn?\n"); status = viScanf(instr, "%t", outputBuffer); if (status<VI_SUCCESS) { printf("viRead failed with error code: %x \n",status); viClose(defaultRM); } else { printf ("\nMesseage read from device: %*s\n", 0,outputBuffer); } status = viClose (instr); status = viClose (defaultRM); printf("Press 'Enter' to exit."); fflush(stdin); getchar(); return 0; }

int _tmain(int argc, _TCHAR* argv[])

{

SSG3000X Programming Guide 59

SIGLENT

printf("Please input IP address:"); char ip[256]; fflush(stdin); gets(ip); TCP_IP_Test(ip); return 0;

}

Run result.

4.1.2 Example of VB

Environment: Win7 32bit system, Microsoft Visual Basic 6.0 The function of this example: Use the NI-VISA, to control the device with USBTMC and

TCP/IP access to do a write and read. Follow the steps to complete the example:

1、 Open Visual Basic, build a standard application program project (Standard EXE) 2、 Set the project environment to use the NI-VISA lib, Click the Existing tab of Project>>Add

Existing Item. Search for the visa32.bas file in the include folder under the NI-VISA installation path and add the file.

This allows the VISA functions and VISA data types to be used in a program. 3、 Add codes:

(1) USBTMC access code. Write a function Usbtmc_test:

Private Function Usbtmc_test() As Long

' This code demonstrates sending synchronous read & write commands ' to an USB Test & Measurement Class (USBTMC) instrument using ' NI-VISA ' The example writes the "*IDN?\n" string to all the USBTMC ' devices connected to the system and attempts to read back ' results using the write and read functions. ' The general flow of the code is ' Open Resource Manager ' Open VISA Session to an Instrument ' Write the Identification Query Using viWrite ' Try to Read a Response With viRead

60 SSG3000X Programming Guide

' Close the VISA Session

Const MAX_CNT = 200

Dim defaultRM As Long Dim instrsesn As Long Dim numlnstrs As Long Dim findList As Long Dim retCount As Long

Dim status As Long Dim instrResourceString As String * VI_FIND_BUFLEN Dim Buffer As String * MAX_CNT Dim i As Integer ' First we must call viOpenDefaultRM to get the manager ' handle. We will store this handle in defaultRM. status = viOpenDefaultRM(defaultRM) If (status < VI_SUCCESS) Then resultTxt.Text = "Could not open a session to the VISA Resource Manager!" Usbtmc_test = status Exit Function End If

' Find all the USB TMC VISA resources in our system and store the ' number of resources in the system in numInstrs. status = viFindRsrc(defaultRM, "USB?*INSTR", findList, numlnstrs, instrResourceString) If (status < VI_SUCCESS) Then resultTxt.Text = "An error occurred while finding resources." viClose(defaultRM) Usbtmc_test = status Exit Function End If

' Now we will open VISA sessions to all USB TMC instruments. ' We must use the handle from viOpenDefaultRM and we must ' also use a string that indicates which instrument to open. This ' is called the instrument descriptor. The format for this string ' can be found in the function panel by right clicking on the ' descriptor parameter. After opening a session to the ' device, we will get a handle to the instrument which we ' will use in later VISA functions. The AccessMode and Timeout ' parameters in this function are reserved for future ' functionality. These two parameters are given the value VI_NULL. For i = 0 To numInstrs If (i > 0) Then status = viFindNext(findList, instrResourceString) End If status = viOpen(defaultRM, instrResourceString, VI_NULL, VI_NULL, instrsesn) If (status < VI_SUCCESS) Then resultTxt.Text = "Cannot open a session to the device " + CStr(i + 1) GoTo NextFind End If

' At this point we now have a session open to the USB TMC instrument. ' We will now use the viWrite function to send the device the string "*IDN?", ' asking for the device's identification. status = viWrite(instrsesn, "*IDN?", 5, retCount) If (status < VI_SUCCESS) Then resultTxt.Text = "Error writing to the device." status = viClose(instrsesn) GoTo NextFind End If

' Now we will attempt to read back a response from the device to ' the identification query that was sent. We will use the viRead ' function to acquire the data. ' After the data has been read the response is displayed. status = viRead(instrsesn, Buffer, MAX_CNT, retCount)

SIGLENT

SSG3000X Programming Guide 61

SIGLENT

If (status < VI_SUCCESS) Then resultTxt.Text = "Error reading a response from the device." + CStr(i + 1) Else resultTxt.Text = "Read from device: " + CStr(i + 1) + " " + Buffer End If status = viClose(instrsesn)

Next i ' Now we will close the session to the instrument using

' viClose. This operation frees all system resources. status = viClose(defaultRM) Usbtmc_test = 0

End Function

(2) TCP/IP access code. Write a function TCP_IP_Test:

Private Function TCP_IP_Test(ByVal ip As String) As Long

Dim outputBuffer As String * VI_FIND_BUFLEN Dim defaultRM As Long Dim instrsesn As Long Dim status As Long Dim count As Long

' First we will need to open the default resource manager. status = viOpenDefaultRM(defaultRM) If (status < VI_SUCCESS) Then resultTxt.Text = "Could not open a session to the VISA Resource Manager!" TCP_IP_Test = status Exit Function End If

' Now we will open a session via TCP/IP device status = viOpen(defaultRM, "TCPIP0::" + ip + "::INSTR", VI_LOAD_CONFIG, VI_NULL, instrsesn) If (status < VI_SUCCESS) Then resultTxt.Text = "An error occurred opening the session" viClose(defaultRM) TCP_IP_Test = status Exit Function End If

status = viWrite(instrsesn, "*IDN?", 5, count) If (status < VI_SUCCESS) Then resultTxt.Text = "Error writing to the device." End If status = viRead(instrsesn, outputBuffer, VI_FIND_BUFLEN, count) If (status < VI_SUCCESS) Then resultTxt.Text = "Error reading a response from the device." + CStr(i + 1) Else resultTxt.Text = "read from device:" + outputBuffer End If status = viClose(instrsesn) status = viClose(defaultRM) TCP_IP_Test = 0

End Function

(3) Button control code:

Private Sub exitBtn_Click()

End

End Sub Private Sub tcpipBtn_Click()

Dim stat As Long stat = TCP_IP_Test(ipTxt.Text) If (stat < VI_SUCCESS) Then resultTxt.Text = Hex(stat) End If

62 SSG3000X Programming Guide

End Sub Private Sub usbBtn_Click()

Dim stat As Long stat = Usbtmc_test If (stat < VI_SUCCESS) Then resultTxt.Text = Hex(stat) End If

End Sub

Run result:

SIGLENT

4.1.3 Example of MATLAB

Environment: Win7 32bit system, MATLAB R2013a The function of this example: Use the NI-VISA, to control the device with USBTMC or

TCP/IP access to do a write and read. Follow the steps to complete the example:

1、 Open MATLAB, modify the current directory. In this demo, the current directory is modified to D:\USBTMC_TCPIP_Demo.

2、 Click File>>New>>Script in the Matlab interface to create an empty M file 3、 Add codes:

(1)USBTMC access code Write a function Usbtmc_test.

function USBTMC_test()

% This code demonstrates sending synchronous read & write commands % to an USB Test & Measurement Class (USBTMC) instrument using % NI-VISA

%Create a VISA-USB object connected to a USB instrument

vu = visa('ni','USB0::0xF4EC::0x1501::0123456789::INSTR');

%Open the VISA object created

fopen(vu);

%Send the string "*IDN?",asking for the device's identification.

fprintf(vu,'*IDN?');

%Request the data

outputbuffer = fscanf(vu); disp(outputbuffer);

SSG3000X Programming Guide 63

SIGLENT

%Close the VISA object

fclose(vu); delete(vu); clear vu;

end

Run result:

(2)TCP/IP access code.

Write a function TCP_IP_Test:

function TCP_IP_test()

% This code demonstrates sending synchronous read & write commands % to an TCP/IP instrument using NI-VISA

%Create a VISA-TCPIP object connected to an instrument %configured with IP address.

vt = visa('ni',['TCPIP0::','10.11.11.215','::INSTR']);

%Open the VISA object created

fopen(vt);

%Send the string "*IDN?",asking for the device's identification.

fprintf(vt,'*IDN?');

%Request the data

outputbuffer = fscanf(vt); disp(outputbuffer);

%Close the VISA object

fclose(vt); delete(vt); clear vt;

end

Run result:

4.1.4 Example of LabVIEW

Environment: Win7 32bit system, LabVIEW 2011 The functions of this example: use the NI-VISA, to control the device with USBTMC and

TCP/IP access to do a write and read. Follow the steps to complete the example:

1、 Open LabVIEW, create a VI file. 2、 Add controls. Right-click in the Front Panel interface, select and add VISA resource

name, error in, error out and some indicators from the Controls column. 3、 Open the Block Diagram interface. Right-click on the VISA resource name and you can

64 SSG3000X Programming Guide

SIGLENT

select and add the following functions from VISA Palette from the pop-up menu: VISA Write, VISA Read, VISA Open and VISA Close.

4、 Connect them as shown in the figure below

5、 Select the device resource from the VISA Resource Name list box and run the program.

In this example, the VI opens a VISA session to a USBTMC device, writes a command to the device, and reads back the response. In this example, the specific command being sent is the device ID query. Check with your device manufacturer for the device command set. After all communication is complete, the VI closes the VISA session.

6、Communicating with the device via TCP/IP is similar to USBTMC. But you need to change VISA Write and VISA Read Function to Synchronous I/O. The LabVIEW default is

asynchronous I/O. Right-click the node and select Synchronous I/O Mod>>Synchronous from the shortcut menu to write or read data synchronously.

7、 Connect them as shown in the figure below

SSG3000X Programming Guide 65

SIGLENT

8、 Input the IP address and run the program.

4.2 Examples of Using Socket

4.2.1 Example of Python

Python is an interpreted programming language that lets you work quickly and is very portable.Python has a low-level networking module that provides access to the socket interface.Python scripts can be written for sockets to do a variety of test and measurements tasks.

Environment: Win7 32bit system, Python v2.7.5 The functions of this example: Open a socket, sends a query, and closes the socket. It

does this loop 10 times.

Below is the code of the script:

#!/usr/bin/env python #-*- coding:utf-8 –*#----------------------------------------------------------------------------# The short script is a example that open a socket, sends a query,

66 SSG3000X Programming Guide

# print the return message and closes the socket. #----------------------------------------------------------------------------import socket # for sockets import sys # for exit import time # for sleep #----------------------------------------------------------------------------remote_ip = "10.11.13.32" # should match the instrument’s IP address port = 5024 # the port number of the instrument service count = 0

def SocketConnect(): try: #create an AF_INET, STREAM socket (TCP) s = socket.socket(socket.AF_INET, socket.SOCK_STREAM) except socket.error: print ('Failed to create socket.') sys.exit(); try: #Connect to remote server s.connect((remote_ip , port)) info = s.recv(4096) print (info) except socket.error: print ('failed to connect to ip ' + remote_ip) return s

def SocketQuery(Sock, cmd): try : #Send cmd string Sock.sendall(cmd) time.sleep(1) except socket.error: #Send failed print ('Send failed') sys.exit() reply = Sock.recv(4096) return reply

def SocketClose(Sock): #close the socket Sock.close() time.sleep(.300)

def main(): global remote_ip global port global count

# Body: send the SCPI commands *IDN? 10 times and print the return message s = SocketConnect() for i in range(10): qStr = SocketQuery(s, b'*IDN?') print (str(count) + ":: " + str(qStr)) count = count + 1 SocketClose(s) input('Press "Enter" to exit')

if __name__ == '__main__': proc = main()

Run result:

SIGLENT

SSG3000X Programming Guide 67

SIGLENT

4.2.2 Example of Telnet

Telnet SCPI: Provides the ability to send single SCPI commands from a remote PC to the

signal generator using LAN port number 5024.

How to send single SCPI commands using Telnet:

1. On the remote PC, click Start, then Run

2. Type: telnet <ip address> 5024

3. A Telnet window with a >> prompt should appear on the remote PC screen.

4. From the SCPI prompt:  Type single SCPI commands. Press Enter to send the command.

68 SSG3000X Programming Guide

 To exit the telnet window click X in the upper-right corner.  To get a normal telnet prompt, press Ctrl + ] (closing bracket).

SIGLENT

 To get SCPI prompt again, type open <ip Address> 5024.

Press Enter:

 To close the normal telnet window, type Quit and press Enter.

SSG3000X Programming Guide 69

Siglent SSG3021X Programming guide

Specifications and Main Features

Frequently Asked Questions

User Manual