SIGLENT Contents Programming Overview ............5 Build Communication ..............5 1.1.1 Build Communication Using VISA ............. 5 1.1.2 Build Communication Using Sockets ............8 1.1.3 Connecting the signal generator via the USB Host port ......8 Remote Control Capabilities ............9 1.2.1...
Page 3
SIGLENT 3.2.5 Subnet Mask (:SYSTem:COMMunicate:LAN:SMASk) ........ 21 3.2.6 IP Config (:SYSTem:COMMunicate:LAN:TYPE) ......... 22 3.2.7 Power On Type (:SYSTem:PON:TYPE) ............. 22 3.2.8 10M Adjustment State (:SYSTem:REF:DAC:STAT) ........22 3.2.9 Ref Osc Code (:SYSTem:REF:DAC) ............23 3.2.10 Ref Osc Code Store (:SYSTem:REF:DAC:SAVE) ......... 23 3.2.11...
Page 4
SIGLENT 3.6.7 Statistics Min Value (:SENSe[:POWer]:STATIStics:MIN?) ......78 3.6.8 Statistics Mean Value (:SENSe[:POWer]:STATIStics:AVG?) ......78 3.6.9 Statistics Count (:SENSe[:POWer]:STATIStics:COUNt?) ......79 3.6.10 Statistics Clear (:SENSe[:POWer]:STATIStics:CLEAr?) ........ 79 3.6.11 Auto Zero (:CALibration:ZERO:TYPE) ............79 3.6.12 Zeroing (:SENSe[:POWer]:ZERO) ............80 3.6.13 Frequency Type (:SENSe[:POWer]:SOURce) ..........80 3.6.14...
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.
Page 6
SIGLENT b. Click Unzip, the installation process will automatically launch after unzipping files. If your computer needs to install .NET Framework 4, its setup process will auto start. c.The NI-VISA installing dialog is shown above. Click Next to start the installation process.
Page 7
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.
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. 8 SSG3000X Programming Guide...
SIGLENT 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”.
Page 10
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.
Page 11
SIGLENT 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 11...
Page 12
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. 12 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.
SIGLENT :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”.
SIGLENT 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.
SIGLENT 3. System Commands This chapter introduces the Siglent Technologies SSG3000X SCPI commands, include: IEEE Common Commands System Subsystem Preset Subsystem Output Subsystem Source Subsystem Sense Subsystem 3.1 IEEE Common Commands 3.1.1 Identification Query (*IDN) Command *IDN? Format Instruction Returns an instrument identification information string. The string will contain the manufacturer, model number, serial number, software number, FPGA number and CPLD number.
SIGLENT Example *RST 3.1.3 Clear Status (*CLS) Command *CLS Format 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.
SIGLENT 3.1.6 Operation Complete Query (*OPC) Command *OPC Format *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.
SIGLENT 3.1.9 Wait-to-Continue (*WAI) Command *WAI Format 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. Menu None Example *WAI 3.1.10 Self Test Query (*TST)
SIGLENT Get System time: :SYSTem:TIME? 3.2.2 System Date (:SYSTem:DATE) Command :SYSTem:DATE <yyyymmdd> Format :SYSTem:DATE? Instruction Set system date. Get system date. Parameter String Type Parameter year(four digits), month(1 ~ 12), date(1 ~ 31) Range Return String Default None Menu Utility > Setting > Time Setting...
SIGLENT :SYSTem:COMMunicate:LAN:IPADdress? 3.2.4 Gateway (:SYSTem:COMMunicate:LAN:GATeway) Command :SYSTem:COMMunicate:LAN:GATeway <“xxx.xxx.xxx.xxx”> Format :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 String Type Parameter Conform to the IP standard (0~255.0~255.0~255.0~255)
SIGLENT 3.2.6 IP Config (:SYSTem:COMMunicate:LAN:TYPE) Command :SYSTem:COMMunicate:LAN:TYPE STATIC|DHCP Format :SYSTem:COMMunicate:LAN:TYPE? Instruction Toggles the IP assignment Setting between static (manual) and DHCP (dynamic assignment) mode. Get IP config. Parameter Enumeration Type Parameter STATIC|DHCP Range Return Enumeration Default None Menu Utility > Interface > LAN Setting > DHCP State...
SIGLENT Instruction Set 10M Adjustment State. Get 10M Adjustment State. Parameter Boolean Type Parameter ON|OFF|1|0 Range Return Boolean Default Menu Utility > Setting > 10M Adjustment Example :SYSTem:REF:DAC:STAT ON 3.2.9 Ref Osc Code (:SYSTem:REF:DAC) Command :SYSTem:REF:DAC <value> Format :SYSTem:REF:DAC? Instruction Set ref osc code.
SIGLENT 3.3 Preset Subsystem 3.3.1 Preset (:SOURce:PRESet) Command :SOURce:PRESet Format Instruction Presets all parameters which are related to the selected signal path. Parameter None Type Return None Default None Menu None Example SOUR:PRES 3.3.1 System Preset (:SYSTem:PRESet) Command :SYSTem:PRESet Format Instruction Presets all parameters.
SIGLENT Menu Utility > Preset Example :SYSTem:PRESet:SAVE 3.3.3 Preset Path (:SYSTem:PRESet:PATH) Command :SYSTem:PRESet:PATH <path> Format Instruction Set preset file when preset type is user. Parameter String Type Return None Default None Menu Utility > Preset Example :SYSTem:PRESet:PATH test.xml 3.3.4 Preset Type (:SYSTem:PRESet:TYPE)
SIGLENT Parameter None Range Return None Default None Menu None Example :SYSTem:FDEFault 3.4 Output Subsystem 3.4.1 RF Output (:OUTPut[:STATe]) Command :OUTPut[:STATe] ON|OFF|1|0 Format :OUTPut[:STATe]? Instruction Activate/Deactivate the RF output. Get the RF state. Parameter Boolean Type Parameter ON|OFF|1|0 Range Return...
Page 28
SIGLENT Get the frequency display on parameter bar. Parameter Float, unit: Hz, kHz, MHz, GHz, Default “Hz” Type Parameter Frequency offset + Full frequency range Range Return Float, unit: Hz Default Maximum frequency Menu Freq Example FREQuency:DISPlay 2 MHz 3.5.1.2 Frequency ([:SOURce]:FREQuency[:FIX]) Command [:SOURce]:FREQuency[:FIX] <freq>...
Page 29
SIGLENT Default 0 Hz Menu FREQ > Freq Offset Example FREQuency:OFFSet 2 MHz 3.5.1.4 Phase Offset ([:SOURce]:PHASe) Command [:SOURce]:PHASe <phase> Format [:SOURce]:PHASe? Instruction Set the phase of the RF output signal. Get the phase of the RF output signal. Parameter...
SIGLENT 3.5.2 [:SOURce]:POWer Subsystem 3.5.2.1 Level Display ([:SOURce]:POWer:POWer) Command [:SOURce]:POWer:POWer <power> Format [:SOURce]:POWer:POWer? Instruction Set the RF level display on parameter bar. Get the RF level display on parameter bar. Parameter Float, unit: dBm, dBmV, dBuV, V, W, Default: dBm...
Page 31
SIGLENT 3.5.2.3 Level Offset ([:SOURce]:POWer:OFFSet) Command [:SOURce]:POWer:OFFSet <power> Format [: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 Float Type Parameter -100 dB ~ 100 dB...
Page 32
SIGLENT 3.5.2.5 Flatness List State ([:SOURce]:CORRection[:FLATness]) Command [:SOURce]:CORRection[:FLATness] ON|OFF|1|0 Format [:SOURce]:CORRection[:FLATness]? Instruction Activate/deactivate flatness. Parameter Boolean Type Parameter ON|OFF|1|0 Range Return Boolean Default Menu LEVEL > Flatness Example CORRection:FLATness ON 3.5.2.6 Flatness List Add Row ([:SOURce]:CORRection:FLATness:PAIR) Command [:SOURce]:CORRection:FLATness:PAIR <freq>,<power> Format Instruction Insert a new row.
Page 33
SIGLENT Parameter Integer Type Parameter Less than the total count of the flatness. Range Return None Default None Menu LEVEL > Flatness > [-] Example CORRection:FLATness:DELete 0 3.5.2.8 Flatness List Count ([:SOURce]:CORRection:FLATness:COUNt?) Command [:SOURce]:CORRection:FLATness:COUNt? Format Instruction Indicates the total count of the flatness.
Page 34
SIGLENT Menu LEVEL > Flatness > Store Example :CORRection:STORe test.uflt 3.5.2.10 Flatness List Load ([:SOURce]:CORRection:LOAD) Command [:SOURce]:CORRection:LOAD <file_name> Format Instruction Load existing flatness correction files. Parameter String Type Parameter None Range Return None Default None Menu LEVEL > Flatness > Load Example :CORRection:LOAD test.uflt...
Page 35
SIGLENT Format [:SOURce]:CORRection:FLATness:FILL:TYPE? Instruction Set the Fill Type to generate flatness list. Get the Fill Type to generate flatness list. Parameter Enumeration Type Parameter FLATness|MANUal|SWEEPlist Range Return Enumeration Default FLATness Menu LEVEL > Flatness > Set > Fill Type Example :CORRection:FLATness:FILL:TYPE FLATness 3.5.2.13 Flatness List Start Freq...
Page 36
SIGLENT Instruction Set the stop frequency when you want to fill the flatness list with the sensor and filling type is “Manual Step”. Get the stop frequency when you want to fill the flatness list with the sensor and filling type is “Manual Step”.
Page 37
SIGLENT Get the linear frequency step in Manual Step Fill Type. Parameter Float, unit: Hz, kHz, MHz, GHz, Default “Hz” Type Parameter None Range Return Float, unit: Hz Default None Menu LEVEL > Flatness > Set > Fill Type > Manual Step...
Page 38
SIGLENT Parameter 2 ~ 500 Range Return Integer Default Menu LEVEL > Flatness > Set > Fill Type > Manual Step Example :CORRection:FLATness:POINt 5 3.5.2.19 Level Control ([:SOURce]:POWer:SPC:STATe) Command [:SOURce]:POWer:SPC:STATe ON|OFF|1|0 Format [:SOURce]:POWer:SPC:STATe? Instruction Activate/Deactivate power control using the sensor.
SIGLENT 3.5.2.21 Level Limit ([:SOURce]:POWer:LIMit) Command [:SOURce]:POWer:LIMit <power> Format [:SOURce]:POWer:LIMit? Instruction Set an upper limit for the RF output power. Get an upper limit for the RF output power. Parameter Float, unit: dBm, dBmV, dBuV, V, W, Default: dBm Type...
Page 40
SIGLENT Format [:SOURce]:SWEep:STATe? Instruction Activate frequency or/and level sweep. Parameter Enumeration Type Parameter OFF|FREQuency|LEVel|LEV_FREQ Range Return Enumeration Default Menu SWEEP > Sweep State Example :SWEep:STATe OFF 3.5.3.2 Sweep Type ([:SOURce]:SWEep:TYPE) Command [:SOURce]:SWEep:TYPE LIST|STEP Format [:SOURce]:SWEep:TYPE? Instruction Set sweep type. Get sweep type.
Page 41
SIGLENT Parameter Full frequency range. Range Return Float, unit: Hz Default Maximum frequency Menu SWEEP > Step Sweep > Start Freq Example :SWEep:STEP:STARt:FREQuency 1 GHz 3.5.3.4 Stop Frequency ([:SOURce]:SWEep:STEP:STOP:FREQuency) Command [:SOURce]:SWEep:STEP:STOP:FREQuency <freq> Format [:SOURce]:SWEep:STEP:STOP:FREQuency? Instruction Set the stop frequency for the sweep mode.
Page 42
SIGLENT 3.5.3.6 Stop Level ([:SOURce]:SWEep:STEP:STOP:LEVel) Command [:SOURce]:SWEep:STEP:STOP:LEVel <level> Format [:SOURce]:SWEep:STEP:STOP:LEVel? Instruction Set the stop level for the sweep mode. Get the stop level for the sweep mode. Parameter Float, unit: dBm, dBmV, dBuV, V, W, Default dBm Type Parameter Full level range.
Page 43
SIGLENT Parameter Integer Type Parameter 2 ~ 65535 Range Return Integer Default Menu SWEEP > Step Sweep > Sweep Points Example :SWEep:STEP:POINts 2 3.5.3.9 Sweep Shape ([:SOURce]:SWEep:STEP:SHAPe) Command [:SOURce]:SWEep:STEP:SHAPe TRIangle|SAWtooth Format [:SOURce]:SWEep:STEP:SHAPe? Instruction Select the waveform shape of the sweep signal.
Page 44
SIGLENT Menu SWEEP > Step Sweep > Sweep Space Example :SWEep:STEP:SPACe LOGarithmic 3.5.3.11 Sweep Step in Linear Sweep Space ([:SOURce]:SWEep[:FREQuency]:STEP[:LINear]) Command [:SOURce]:SWEep[:FREQuency]:STEP[:LINear] <freq> Format [:SOURce]:SWEep[:FREQuency]:STEP[:LINear]? Instruction Set the sweep step in linear sweep space. Get the sweep step in linear sweep space.
Page 45
SIGLENT 3.5.3.13 Sweep List Add Row ([:SOURce]:SWEep:LIST:ADDList) Command [:SOURce]:SWEep:LIST:ADDList <freq>,<level>,<time> Format Instruction Insert a new row. Parameter Freq: Float, unit: Hz, kHz, MHz, GHz, Default “Hz” Type Level: Float, unit: dBm Time: Float, unit: ns, us, ms, s Parameter Full frequency range, full frequency range, 10.0 ms ~ 100.0 s...
Page 46
SIGLENT Parameter Raw: 1 ~ count of pair. Range Freq: Full frequency range. Power: Full level range. time: 10 ms ~ 100 s. Return None Default None Menu SWEEP > List Sweep Example :SWEep:LIST:CHANGe 1,1 GHz,1 dBm, 1 s 3.5.3.16 Sweep List Row Count ([:SOURce]:SWEep:LIST:CPOint?)
Page 47
SIGLENT 3.5.3.18 Sweep List Clear ([:SOURce]:SWEep:LIST:INITialize:PRESet) Command [:SOURce]:SWEep:LIST:INITialize:PRESet Format Instruction Restore the scan list of the factory default settings. Parameter None Type Parameter None Range Return None Default None Menu SWEEP > List Sweep > Clear Example SWEep:LIST:INITialize:PRESet 3.5.3.19 Sweep List Initialize From Step...
Page 48
SIGLENT Instruction Load existing sweep list file. Parameter String Type Parameter None Range Return None Default None Menu SWEEP > List Sweep > Load Example :SWEep:LOAD test.lsw 3.5.3.21 Sweep List Store ([:SOURce]:SWEep:STORe) Command [:SOURce]:CORRection:STORe <file_name> Format Instruction Save the sweep data in the list.
Page 49
SIGLENT Example :SWEep:DIRect REV 3.5.3.23 Sweep Mode ([:SOURce]:SWEep:MODE) Command [:SOURce]:SWEep:MODE CONTinue|SINGle Format [:SOURce]:SWEep:MODE? Instruction Set the cycle mode of the sweep. Get the cycle mode of the sweep. Parameter Enumeration Type Parameter CONTinue|SINGle Range Return Enumeration Default CONTinue Menu SWEEP > Sweep Mode...
SIGLENT Instruction Select the point trigger. Get the point trigger. Parameter Enumeration Type Parameter AUTO|KEY|BUS|EXT Range Return Enumeration Default AUTO Menu SWEEP > Point Trigger Example :SWEep:POINt:TRIGger:TYPE KEY 3.5.3.26 Trigger Slope ([:SOURce]:INPut:TRIGger:SLOPe) Command [:SOURce]:INPut:TRIGger:SLOPe POSitive|NEGative Format [:SOURce]:INPut:TRIGger:SLOPe? Instruction Select the trigger slope.
SIGLENT Type Parameter ON|OFF|1|0 Range Return Boolean Default Menu Example MODulation ON 3.5.5 [:SOURce]:AM Subsystem 3.5.5.1 AM State ([:SOURce]:AM:STATe) Command [:SOURce]:AM:STATe ON|OFF|1|0 Format [:SOURce]:AM:STATe? Instruction Activate/Deactivate amplitude modulation. Get the AM state. Parameter Boolean Type Parameter ON|OFF|1|0 Range Return Boolean...
Page 52
SIGLENT Return Enumeration Default SINE Menu AM > AM Shape Example :AM:WAVEform SINE 3.5.5.3 AM Source ([:SOURce]:AM:SOURce) Command [:SOURce]:AM:SOURce INTernal|EXTernal|INT+EXT Format [:SOURce]:AM:SOURce? Instruction Select the modulation signal source for amplitude modulation. Get the AM source. Parameter Enumeration Type Parameter INTernal|EXTernal|INT+EXT...
SIGLENT 3.5.5.5 AM Rate ([:SOURce]:AM:FREQuency) Command [:SOURce]:AM:FREQuency <value> Format [:SOURce]:AM:FREQuency? Instruction Set the AM modulation frequency. Get the AM modulation frequency. Parameter Float, unit: Hz, kHz, MHz, GHz, Default “Hz” Type Parameter Sine: 0.01 Hz ~ 100 kHz Range Square: 0.01 Hz ~ 20 kHz...
Page 54
SIGLENT Instruction Activate/Deactivate FM. Get the FM state. Parameter Boolean Type Parameter ON|OFF|1|0 Range Return Boolean Default Menu FM > FM State Example :FM:STATe ON 3.5.6.2 FM Shape ([:SOURce]:FM:WAVEform) Command [:SOURce]:FM:WAVEform SINE|SQUAre Format [:SOURce]:FM:WAVEform? Instruction Selects the shape of FM.
Page 55
SIGLENT Return Enumeration Default INTernal Menu FM > FM Source Example :FM:SOURce EXTernal 3.5.6.4 FM Deviation ([:SOURce]:FM:DEViation) Command [:SOURce]:FM:DEViation <value> Format [:SOURce]:FM:DEViation? Instruction Set deviation value Get deviation value Parameter Float, unit: Hz, kHz, MHz, GHz Type Parameter 0.01 Hz ~ 1 MHz...
SIGLENT 3.5.6.6 FM Sensitivity ([:SOURce]:FM:SENSitivity) Command [:SOURce]:FM:SENSitivity? Format Instruction Displays the input sensitivity of the FM EXT input in Hz/V. Parameter None Type Parameter None Range Return Float unit: Hz/V Default 0 Hz/V Menu FM > FM Sensitivity Example FM:SENSitivity? 3.5.7 [:SOURce]:PM Subsystem...
Page 57
SIGLENT Instruction Selects the shape of PM. Get the shape of PM. Parameter Enumeration Type Parameter SINE|SQUAre Range Return Enumeration Default SINE Menu PM > PM Shape Example :PM:WAVEform SINE 3.5.7.3 PM Source ([:SOURce]:PM:SOURce) Command [:SOURce]:PM:SOURce INTernal|EXTernal|INT+EXT Format [:SOURce]:PM:SOURce? Instruction Select the modulation signal source for phase modulation.
Page 58
SIGLENT Return Float, unit: rad Default 1 rad Menu PM > PM Deviation Example :PM:DEViation 2 3.5.7.5 PM Rate ([:SOURce]:PM:FREQuency) Command [:SOURce]:PM:FREQuency <value> Format [:SOURce]:PM:FREQuency? Instruction Set the PM modulation frequency. Get the PM modulation frequency. Parameter Float, unit: Hz, kHz, MHz, GHz, Default “Hz”...
SIGLENT 3.5.8 [:SOURce]:PULM Subsystem 3.5.8.1 Pulse State ([:SOURce]:PULM:STATe) Command [:SOURce]:PULM:STATe ON|OFF|1|0 Format [:SOURce]:PULM:STATe? Instruction Activate/Deactivate the pulse modulation. Get the state of pulse modulation. Parameter Boolean Type Parameter ON|OFF|1|0 Range Return Boolean Default Menu PULSE > Pulse State Example PULM:STAT ON 3.5.8.2 Pulse Out ([:SOURce]:PULM:OUT:STATe)
Page 60
SIGLENT Format [:SOURce]:PULM:SOURce? Instruction Select the source for the pulse modulation signal. Get the source for the pulse modulation signal. Parameter Enumeration Type Parameter INTernal|EXTernal Range Return Enumeration Default INTernal Menu PULSE > Pulse Source Example PULM:SOUR INTernal 3.5.8.4 Pulse Polarity ([:SOURce]:PULM:POLarity)
Page 61
SIGLENT Parameter SINGle|DOUBle|PTRain Range 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.
Page 62
SIGLENT Parameter Float, unit: ns, us, ms, s Type Parameter 20 ns ~ 300 s Range Return Float, unit: s Default 2 ms Menu PULSE > Pulse Width Example PULM:WIDT 33 us 3.5.8.8 Double Pulse Delay ([:SOURce]:PULM:DOUBle:DELay) Command [:SOURce]:PULM:DOUBle:DELay <value>...
Page 63
SIGLENT Return Float, unit: s Default 2 ms Menu PULSE > #2 Width Example PULM:DOUBle:WIDTh 2 s 3.5.8.10 Pulse Train Add Row ([:SOURce]:PULM:TRAin:PAIR) Command [:SOURce]:PULM:TRAin:PAIR Format Instruction Add default train pair value. Parameter None Type Parameter None Range Return None...
Page 64
SIGLENT Format Instruction Edit train pair value. Parameter Integer, Float, unit: ns, us, ms, s, Float, unit: ns, us, ms, s, Integer Type Parameter Raw: 1 ~ count of pair. Range On time: 10 ns ~ 300 s. Off time: 10 ns ~ 300 s.
Page 65
SIGLENT Return Integer Default Menu PULSE > Pulse Train Example :PULM:TRAin:COUNt? 3.5.8.15 Pulse Train Clear ([:SOURce]:PULM:TRAin:CLEAr) Command [:SOURce]:PULM:TRAin:CLEAr Format Instruction Clear train pair list. Parameter None Type Parameter None Range Return None Default None Menu PULSE > Pulse Train > Store...
Page 66
SIGLENT Format Instruction Store train pair list. Parameter String Type Parameter None Range Return None Default None Menu PULSE > Pulse Train Example PULM:TRAin:STORE test.pulstrn 3.5.8.18 Trigger Out ([:SOURce]:PULM:TRIGger:STATe) Command [:SOURce]:PULM:TRIGger:STATe ON|OFF|1|0 Format [:SOURce]:PULM:TRIGger:STATe? Instruction Set the trigger output status.
Page 67
SIGLENT Return Enumeration Default AUTO Menu PULSE > Pulse Trigger Example PULM:TRIG:MODE EXTernal 3.5.8.20 Trig Polarity ([:SOURce]:PULM:TRIGger:EXTernal:GATE:POLarity) Command [:SOURce]:PULM:TRIGger:EXTernal:GATE:POLarity NORMal|INVerted Format [:SOURce]:PULM:TRIGger:EXTernal:GATE:POLarity? Instruction Select the polarity of the gate signal. Get the polarity of the gate signal. Parameter Enumeration Type...
SIGLENT 3.5.8.22 Trig Slope ([:SOURce]:PULM:TRIGger:EXTernal:SLOPe) Command [:SOURce]:PULM:TRIGger:EXTernal:SLOPe NEGative|POSitive Format [:SOURce]:PULM:TRIGger:EXTernal:SLOPe? Instructio 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.
Page 69
SIGLENT 3.5.9.2 LF Level ([:SOURce]:LFOutput:VOLTage) Command [:SOURce]:LFOutput:VOLTage <volt> Format [:SOURce]:LFOutput:VOLTage? Instruction Set the voltage of the LF output signal. Get the voltage of the LF output signal. Parameter Float, unit: dBm, dBmV, dBuV, V, W, Default: V (Here V is the peak-peak...
Page 70
SIGLENT If signal source "Internal" is set, the instrument performs the analog modulations (AM/FM /PM) with this frequency. Parameter Float, unit: Hz, kHz, MHz, GHz, Default “Hz” Type Parameter 0.01 Hz ~ 1 MHz Range Return Float, unit: Hz Default...
SIGLENT Range Return Float, unit: deg Default 0 deg Menu LF > LF Phase Example LFOutput:PHASe 20 3.5.10 [:SOURce]:LFOutput:SWEep Subsystem 3.5.10.1 Sweep State ([:SOURce]:LFOutput:SWEep) Command [:SOURce]:LFOutput:SWEep ON|OFF|0|1 Format [:SOURce]:LFOutput:SWEep? Instruction Activate/Deactivate the LF frequency sweep signal generation. Get the state of LF frequency sweep.
Page 72
SIGLENT Menu LF Sweep > Sweep Direction Example :LFOutput:SWEep:DIRect DOWN 3.5.10.3 Start Freq ([:SOURce]:LFOutput:SWEep:STARt:FREQuency) Command [:SOURce]:LFOutput:SWEep:STARt:FREQuency <freq> Format [: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”...
Page 73
SIGLENT 3.5.10.5 Center Freq ([:SOURce]:LFOutput:SWEep:CENTer:FREQuency) Command [:SOURce]:LFOutput:SWEep:CENTer:FREQuency <freq> Format [:SOURce]:LFOutput:SWEep:CENTer:FREQuency? Instruction Set the center frequency of sweep mode. Get the center frequency of sweep mode. Parameter Float, unit: Hz, kHz, MHz, GHz, Default “Hz” Type Parameter 0.01 Hz ~ Maximum frequency of LF...
Page 74
SIGLENT Format [:SOURce]:LFOutput:SWEep:DWELl? Instruction Set the sweep time of sweep mode. Get the sweep time of sweep mode. Parameter Float, unit: ns, us, ms, s Type Parameter 1 ms ~ 500 s Range Return Float, unit: s Default Menu LF Sweep > Sweep Time...
SIGLENT Range Return Enumeration Default SAWTooth Menu LF Sweep > Sweep Shape Example :LFOutput:SWEep:SHAPe TRIangle 3.5.10.10 Sweep Space ([:SOURce]:LFOutput:SWEep:SPACing) Command [:SOURce]:LFOutput:SWEep:SPACing LINear|LOGarithmic Format [: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.
SIGLENT Example SENSe:TYPE? 3.6.2 Sensor State (:SENSe[:POWer]:STATus) Command :SENSe[:POWer]:STATus OFF|ON|0|1 Format :SENSe[:POWer]:STATus? Instruction Set the sensor state. Get the sensor state. Parameter Boolean Type Parameter OFF|ON|0|1 Range Return Boolean Default Menu SENSOR > Sensor State Example SENSe:STATus ON 3.6.3 Measurement (:SENSe[:POWer]:VALue)
SIGLENT Instruction Set statistics state. Get statistics state. Parameter Boolean Type Parameter ON|OFF|1|0 Range Return Boolean Default Menu SENSOR > Statistics Example SENSe:STATIStics:STATe ON 3.6.5 Statistics Value (:READ[:POWer]) Command :READ[:POWer]? Format Instruction Indicate the measured mean value and maximum value.
SIGLENT Default None Menu SENSOR > Statistics Example SENSe:STATIStics:MAX? 3.6.7 Statistics Min Value (:SENSe[:POWer]:STATIStics:MIN?) Command :SENSe[:POWer]:STATIStics:MIN? Format Instruction Indicate the measured minimum value. Parameter None Type Parameter None Range Return Float, unit: dBm Default None Menu SENSOR > Statistics Example SENSe:STATIStics:MIN? 3.6.8 Statistics Mean Value...
SIGLENT Parameter Enumeration Type Parameter INTernal|EXTernal Range Return Enumeration Default INTernal Menu SENSOR > Auto Zero Example CALibration:ZERO:TYPE EXTernal 3.6.12 Zeroing (:SENSe[:POWer]:ZERO) Command :SENSe[:POWer]:ZERO Format Instruction Perform zeroing of the sensor. Parameter None Type Parameter None Range Return None Default...
SIGLENT Example SENSe:SOURce RF 3.6.14 Frequency (:SENSe[:POWer]:FREQuency) Command :SENSe[:POWer]:FREQuency <type> Format :SENSe[:POWer]:FREQuency? Instruction Set the frequency for frequency type " USER". Get the frequency for frequency type " USER". Parameter Float, unit: Hz, kHz, MHz, GHz, Default “Hz” Type Parameter 9 kHz ~ 3.2 GHz...
SIGLENT Format :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 Float Type Parameter Limit by power sensor. Range Return...
SIGLENT Range Return Float Default None Menu SENSOR > Averaging Example SENSe:FILTer:LENGth 10 3.6.19 Internal Noise (:SENSe[:POWer]:FILTer:NSRatio) Command :SENSe[:POWer]:FILTer:NSRatio <noise> Format :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.
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.
Page 85
SIGLENT 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. Set lib file: project---properties---Linker---Command Line---Additional Options: visa32.lib...
Page 86
SIGLENT /* 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 */...
Page 87
SIGLENT * 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.*/ (i=0;...
Page 88
SIGLENT * viClose. This operation frees all system resources. status = viClose (defaultRM); printf("Press 'Enter' to exit."); fflush(stdin); getchar(); return int _tmain(int argc, _TCHAR* argv[]) Usbtmc_test(); return Run result. (2) TCP/IP access code. TCP_IP_Test: Write a function int TCP_IP_Test(char *pIP) char outputBuffer[VI_FIND_BUFLEN];...
Page 89
SIGLENT printf ("An error occurred opening the session\n"); viClose(defaultRM); status = viPrintf(instr, "*idn?\n"); status = viScanf(instr, "%t", outputBuffer); (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);...
SIGLENT 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、...
Page 91
SIGLENT numlnstrs As Long findList As Long retCount As Long status As Long instrResourceString As String * VI_FIND_BUFLEN Buffer As String * MAX_CNT As Integer ' First we must call viOpenDefaultRM to get the manager ' handle. We will store this handle in defaultRM.
Page 92
SIGLENT 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.
Page 93
SIGLENT ' First we will need to open the default resource manager. status = viOpenDefaultRM(defaultRM) (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::"...
SIGLENT Private Sub usbBtn_Click() stat As Long stat = Usbtmc_test (stat < VI_SUCCESS) Then resultTxt.Text = Hex(stat) End If End Sub Run result: 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.
Page 95
SIGLENT %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); %Close the VISA object fclose(vu);...
SIGLENT %Request the data outputbuffer = fscanf(vt); disp(outputbuffer); %Close the VISA object fclose(vt); delete(vt); clear vt; 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.
Page 97
SIGLENT 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.
SIGLENT 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.
Page 99
SIGLENT #----------------------------------------------------------------------------- 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...
SIGLENT 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"...
Page 101
SIGLENT Type: telnet <ip address> 5024 A Telnet window with a >> prompt should appear on the remote PC screen. From the SCPI prompt: Type single SCPI commands. Press Enter to send the command. ⚫ To exit the telnet window click X in the upper-right corner.
Page 102
SIGLENT Press Enter: To close the normal telnet window, type Quit and press Enter. ⚫ 102 SSG3000X Programming Guide...
Need help?
Do you have a question about the SSG3000X Series and is the answer not in the manual?
Questions and answers