1.Introduction to the SCPI Language 1. Introduction to the SCPI Language 1.1. Command Syntax The command systems present a hierarchy structure (tree system) and each command consists of a “Root” keyword and one or multiple sub-keywords. The keywords are separated by ":" and are followed by the parameter settings available, "?" is added at the end of the command string to indicate query and the command and parameter are separated by "space".
1.Introduction to the SCPI Language Integers, for example, 0, 2, 30, -5 (5) NR2 numeric Decimal numbers, for example, 0.6, 3.1415926, -2.6 (6) NR3 numeric Floating point numbers, for example, 3.1415E-7, -8.2E3 (7) NRf numeric Flexible decimal number that may be type NR1, NR2 or NR3 See NR1, NR2, and NR3 examples (8) string Alphanumeric characters (must be within quotation marks)
2. Commands COUNter:COUPing This command sets or queries the coupling mode of the counter to AC or DC. Syntax COUNter:COUPing [AC|DC] COUNter:COUPing? Arguments AC means that AC is selected for the coupling mode of the counter. DC means that DC is selected for the coupling mode of the counter. Returns AC|DC Example...
might returns 2.265700368E+01. COUNter:FREQ? (Query Only) This query-only command returns the measurement results for frequency of the counter. Syntax COUNter:FREQ? Arguments None Returns <frequency>::=<NR3> Examples :COUNter:FREQ? might returns 1.000082563E+02. COUNter:HFR This command enables or disables the high-frequency reject of the counter. The query returns the state of high-frequency reject of the counter.
COUNter:PERiod? (Query Only) This query-only command returns the measurement results for period of the counter. Syntax COUNter:PERiod? Arguments None Returns <period>::=<NR3> Examples :COUNter:PERiod? might returns 8.545000251E-03. COUNter:PULSewidth? (Query Only) This query-only command returns the measurement results for pulse width of the counter. Syntax COUNter:PULSewidth? Arguments...
Syntax COUNter:SENSitivity [LOW|MIDDle|HIGH] COUNter:SENSitivity? Arguments LOW means that Low is selected for the trigger sensitivity of the counter. MIDDle means that Middle is selected for the trigger sensitivity of the counter. HIGH means that High is selected for the trigger sensitivity of the counter. Returns LOW|MIDDle|HIGH Example...
DISPlay:SAVer:DELay This command sets or queries delay time for the screen saver function. The setting range is 1 minute to 999 minutes. Syntax DISPlay:SAVer:DELay {<minutes>|MINimum|MAXimum} DISPlay:SAVer:DELay? {MINimum|MAXimum} Arguments <minutes>::=<NR1>[<units>] where: <NR1> is the delay time in minutes. <units>::=MIN Returns <minutes> Examples DISPlay:SAVer:DELay 30 sets the delay time for the screen saver function to 30 minutes.
DISPlay:SAVer[:STATe] This command sets or queries the screen saver setting of the LCD display. When enabled, the screen saver function starts automatically if no operations are applied to the instrument front panel for the delay time set in DISPlay:SAVer:DELay. Syntax DISPlay:SAVer[:STATe] {ON|OFF|<NR1>} DISPlay:SAVer[:STATe]? Arguments...
1.BMP in a USB memory. *IDN? (Query Only) This query-only command returns identification information on the instrument. Syntax *IDN? Arguments None Returns <Manufacturer>,<Model>,<Serial Number>,<Firmware Level> Examples *IDN? might return the following response: OWON,XDG3202,1837001,SCPI:99.0 FV:V1.2.0...
OUTPut[1|2]:IMPedance This command sets the output load impedance for the specified channel. The specified value is used for amplitude, offset, and high/low level settings. You can set the impedance to any value from 1 Ω to 10 kΩ with a resolution of 1 Ω. The default value is 50 Ω. The query returns the current load impedance setting in ohms.
Examples OUTPut1:STATe ON sets the instrument CH1 output to ON. *RST (No Query Form) This command resets the instrument to the factory default settings. Syntax *RST Arguments None Examples *RST resets the instrument settings to the factory defaults. [SOURce[1|2]]:AM[:DEPTh] This command sets or queries the modulation depth of AM modulation for the specified channel.
Examples SOURce1:AM:DEPth MAXimum sets the depth of modulating signal on CH1 to the maximum value. [SOURce[1|2]]:AM:INTernal:FREQuency This command sets or queries the internal modulation frequency of AM modulation for the specified channel. Use this command when the internal modulation source is selected. Set the internal modulation frequency from 2 mHz to 100.00 kHz with resolution of 1 mHz.
Returns INT|EXT Examples SOURce1:AM:SOURce INTernal sets the CH1 source of modulating signal to internal. [SOURce[1|2]]:AM:STATe This command enables or disables AM modulation for the specified channel. The query returns the state of AM modulation. Syntax [SOURce[1|2]]:AM:STATe {ON|OFF|<NR1>} [SOURce[1|2]]:AM:STATe? Arguments If [SOURce[1|2]] are omitted, CH1 is specified automatically. ON or <NR1>≠0 enables AM modulation.
<amplitude>::=<NRf>[<units>] where: <NRf> is the modulation amplitude. <units>::=[mVpp|Vpp] MINimum sets the modulation amplitude to minimum value. MAXimum sets the modulation amplitude to maximum value. Returns <amplitude> Examples SOURce1:ASKey:AMPLitude MAXimum sets the amplitude of modulating signal on CH1 to the maximum value. [SOURce[1|2]]:ASKey:INTernal:RATE This command sets or queries the internal modulation rate of ASK modulation for the specified channel.
Syntax [SOURce[1|2]]:ASKey:SOURce [INTernal|EXTernal] [SOURce[1|2]]:ASKey:SOURce? Arguments INTernal means that the carrier waveform is modulated with an internal source. EXTernal means that the carrier waveform is modulated with an external source. Returns INT|EXT Examples SOURce1:ASKey:SOURce INTernal sets the CH1 source of modulating signal to internal. [SOURce[1|2]]:ASKey:STATe This command enables or disables ASK modulation.
Syntax [SOURce[1|2]]:BPSKey:DATA [01|10|PN15|PN21] [SOURce[1|2]]:BPSKey:DATA? Arguments 01 means that the carrier waveform is modulated with 01 pattern. 10 means that the carrier waveform is modulated with 10 pattern. PN15 means that the carrier waveform is modulated with PN15 pattern. PN21 means that the carrier waveform is modulated with PN21 pattern. Returns 01|10|PN15|PN21 Examples...
[SOURce[1|2]]:BPSKey:PHASe This command sets or queries the phase deviation of BPSK modulation for the specified channel. Syntax [SOURce[1|2]]:BPSKey:PHASe {<phase>|MINimum|MAXimum} [SOURce[1|2]]:BPSKey:PHASe? [MINimum|MAXimum] Arguments <phase>::=<NR3>[<units>] where: <NR3> is the phase deviation. <units>::=[RAD|DEG] If <units> are omitted, RAD is specified automatically. The setting ranges are: RAD: 0 PI to +1 PI, relative to phase value DEG: 0 to +180, in 1 degree steps, relative to phase value Returns...
Examples SOURce1:BPSKey:STATe ON enables the CH1 BPSK modulation. [SOURce[1|2]]:BURSt:GATE:POLarity This command sets the generator to output a burst when the gated signal at the [Ext Trig/Burst/Fsk In] connector at the rear panel is high level or low level. This command is only available in gated Burst mode. Syntax [SOURce[1|2]]:BURSt:GATE:POLarity{NORMal|INVerted} [SOURce[1|2]]:BURSt:GATE:POLarity?
Returns <period> Examples SOURce1:BURSt:INTernal:PERiod 200ns sets the CH1 Burst period to 200 ns. [SOURce[1|2]]:BURSt:MODE This command sets or queries the burst mode for the specified channel. Syntax [SOURce[1|2]]:BURSt:MODE {TRIGgered|GATed} [SOURce[1|2]]:BURSt:MODE? Arguments TRIGgered means that triggered mode is selected for burst mode. GATed means that gated mode is selected for burst mode.
<NRf> is the burst count. The burst count ranges from 1 to 500,000. INFinity sets the burst count to infinite count. MINimum sets the burst count to minimum count. MAXimum sets the burst count to maximum count. Returns <cycles> Examples SOURce1:BURSt:NCYCles 2 sets the CH1 burst count to 2.
[SOURce[1|2]]:BURSt:STATe? Arguments ON or <NR1>≠0 enables the burst mode. OFF or <NR1>=0 disables the burst mode. Returns <NR1> Examples SOURce1:BURSt:STATe ON enables the burst mode for the CH1. [SOURce[1|2]]:FM[:DEViation] This command sets or queries the peak frequency deviation of FM modulation for the specified channel.
specified channel. Use this command when the internal modulation source is selected. Set the internal modulation frequency from 2 mHz to 100.00 kHz with resolution of 1 mHz. Syntax [SOURce[1|2]]:FM:INTernal:FREQuency {<frequency>|MINimum|MAXimum} [SOURce[1|2]]:FM:INTernal:FREQuency? [MINimum|MAXimum] Arguments <frequency>::=<NRf>[<units>] where: <NRf> is the modulation frequency. <units>::=[Hz|kHz|MHz] Returns <frequency>...
[SOURce[1|2]]:FM:STATe This command enables or disables FM modulation. The query returns the state of FM modulation. Syntax [SOURce[1|2]]:FM:STATe {ON|OFF|<NR1>} [SOURce[1|2]]:FM:STATe? Arguments ON or <NR1>≠0 enables FM modulation. OFF or <NR1>=0 disables FM modulation. Returns <NR1> Examples SOURce1:FM:STATe ON enables the CH1 FM modulation. [SOURce[1|2]]:FREQuency:CENTer This command sets or queries the center frequency of sweep for the specified channel.
sets the CH1 center frequency to 550 kHz. [SOURce[1|2]]:FREQuency[:FIXed] This command sets or queries the frequency of output waveform for the specified channel. The setting range of output frequency depends on the type of output waveform. If you change the type of output waveform, it might change the output frequency because changing waveform types impacts on the setting range of output frequency.
where: <NRf> is the frequency span. <units>::=[Hz|kHz|MHz] Returns <frequency> Examples SOURce1:FREQuency:SPAN 900 kHz sets the CH1 frequency span to 900 kHz. [SOURce[1|2]]:FREQuency:STARt This command sets or queries the start frequency of sweep for the specified channel. This command is always used with the [SOURce[1|2]]:FREQuency:STOP command. The setting range of start frequency depends on the waveform selected for sweep.
Syntax [SOURce[1|2]]:FREQuency:STOP {<frequency>|MINimum|MAXimum} [SOURce[1|2]]:FREQuency:STOP? {MINimum|MAXimum} Arguments <frequency>::=<NRf>[<units>] where: <NRf> is the stop frequency. <units>::=[Hz|kHz|MHz] Returns <frequency> Examples SOURce1:FREQuency:STOP 100KHz sets the stop frequency of CH1 to 100 kHz. [SOURce[1|2]]:FSKey[:FREQuency] This command sets or queries the hop frequency of FSK modulation for the specified channel.
[SOURce[1|2]]:FSKey:INTernal:RATE This command sets or queries the internal modulation rate of FSK modulation for the specified channel. Use this command when the internal modulation source is selected. Syntax [SOURce[1|2]]:FSKey:INTernal:RATE {<rate>|MINimum|MAXimum} [SOURce[1|2]]:FSKey:INTernal:RATE? {MINimum|MAXimum} Arguments <rate>::=<NRf>[<units>] where: <NRf> is the modulation rate. <units>::=[Hz|kHz|MHz] Returns <rate>...
[SOURce[1|2]]:FSKey:STATe This command enables or disables FSK modulation. The query returns the state of FSK modulation. Select a sine, square, ramp, or arbitrary waveform as the carrier waveform. Syntax [SOURce[1|2]]:FSKey:STATe {ON|OFF|<NR1>} [SOURce[1|2]]:FSKey:STATe? Arguments ON or <NR1>≠0 enables FSK modulation. OFF or <NR1>=0 disables FSK modulation. Returns <NR1>...
Returns <frequency> Examples SOURce1:3FSKey:FREQuency 2,1.0MHz sets the hop frequency 2 of CH1 3FSK modulation to 1.0 MHz. [SOURce[1|2]]:3FSKey:INTernal:RATE This command sets or queries the internal modulation rate of 3FSK modulation for the specified channel. Syntax [SOURce[1|2]]:3FSKey:INTernal:RATE {<rate>|MINimum|MAXimum} [SOURce[1|2]]:3FSKey:INTernal:RATE? {MINimum|MAXimum} Arguments <rate>::=<NRf>[<units>] where: <NRf>...
OFF or <NR1>=0 disables 3FSK modulation. Returns <NR1> Examples SOURce1:3FSKey:STATe ON enables the CH1 3FSK modulation. [SOURce[1|2]]:4FSKey[:FREQuency] This command sets or queries the hop frequency of 4FSK modulation for the specified channel. Syntax [SOURce[1|2]]:4FSKey[:FREQuency] <n>,{<frequency>|MINimum|MAXimum} [SOURce[1|2]]:4FSKey[:FREQuency]? <n>,{MINimum|MAXimum} Arguments <n>::=<NR1> where: <NR1>...
Syntax [SOURce[1|2]]:4FSKey:INTernal:RATE {<rate>|MINimum|MAXimum} [SOURce[1|2]]:4FSKey:INTernal:RATE? {MINimum|MAXimum} Arguments <rate>::=<NRf>[<units>] where: <NRf> is the modulation rate. <units>::=[Hz|kHz|MHz] Returns <rate> Examples SOURce1:4FSKey:INTernal:RATE 50Hz sets the CH1 internal 4FSK modulation rate to 50 Hz. [SOURce[1|2]]:4FSKey:STATe This command enables or disables 4FSK modulation. The query returns the state of 4FSK modulation.
The setting range is 0.0% to 100.0%. Syntax [SOURce[1|2]]:FUNCtion:RAMP:SYMMetry {<symmetry>|MINimum|MAXimum} [SOURce[1|2]]:FUNCtion:RAMP:SYMMetry? Arguments <symmetry>::=<NR2>[<units>] where: <NR2> is the symmetry. <units>::=PCT Returns <symmetry> Examples SOURce1:FUNCtion:RAMP:SYMMetry 80.5 sets the symmetry of the CH1 ramp waveform to 80.5%. [SOURce[1|2]]:MOD:STATe This command enables or disables the modulation function for the specified channel. The query returns the state of modulation function.
[SOURce[1|2]]:OSKey:INTernal:RATE This command sets or queries the internal modulation rate of OSK modulation for the specified channel. Syntax [SOURce[1|2]]:OSKey:INTernal:RATE {<rate>|MINimum|MAXimum} [SOURce[1|2]]:OSKey:INTernal:RATE? {MINimum|MAXimum} Arguments <rate>::=<NRf>[<units>] where: <NRf> is the modulation rate. <units>::=[Hz|kHz|MHz] Returns <rate> Examples SOURce1:OSKey:INTernal:RATE 50Hz sets the CH1 internal OSK modulation rate to 50 Hz. [SOURce[1|2]]:OSKey:STATe This command enables or disables OSK modulation.
SOURce1:OSKey:STATe ON enables the CH1 OSK modulation. [SOURce[1|2]]:OSKey:TIME This command sets or queries the oscillate period for the OSK modulation for the specified channel. Syntax [SOURce[1|2]]:OSKey:TIME {<seconds>|MINimum|MAXimum} [SOURce[1|2]]:OSKey:TIME? Arguments <seconds>::=<NRf>[<units>] where: <NRf> is the oscillate period in seconds. <units>::=[ns|us|ms|s] Returns <seconds>...
<units>::=[RAD|DEG] If <units> are omitted, RAD is specified automatically. The setting ranges are: RAD: 0 to +2 PI, relative to phase value DEG: 0 to +360, relative to phase value Returns <phase> Examples SOURce1:PHASe:ADJust MAXimum sets the maximum value for the phase of CH1 output waveform. [SOURce[1|2]]:PM[:DEViation] This command sets or queries the phase deviation of PM modulation for the specified channel.
[SOURce[1|2]]:PM:INTernal:FREQuency This command sets or queries the internal modulation frequency of PM modulation for the specified channel. Use this command when the internal modulation source is selected. Set the internal modulation frequency from 2 mHz to 100.00 kHz with resolution of 1 mHz. Syntax [SOURce[1|2]]:PM:INTernal:FREQuency {<frequency>|MINimum|MAXimum} [SOURce[1|2]]:PM:INTernal:FREQuency? [MINimum|MAXimum]...
Examples SOURce1:PM:SOURce INTernal sets the CH1 source of modulating signal to internal. [SOURce[1|2]]:PM:STATe This command enables or disables PM modulation. The query returns the state of PM modulation. Select a sine, square, ramp, or arbitrary waveform as the carrier waveform. Syntax [SOURce[1|2]]:PM:STATe {ON|OFF|<NR1>} [SOURce[1|2]]:PM:STATe?
DEG: 0 to +180, in 1 degree steps, relative to phase value Returns <deviation> Examples SOURce1:PSKey:DEViation MAXimum sets the maximum value for the CH1 phase deviation of PSK modulation. [SOURce[1|2]]:PSKey:INTernal:RATE This command sets or queries the internal modulation rate of PSK modulation for the specified channel.
Arguments INTernal means that the carrier waveform is modulated with an internal source. EXTernal means that the carrier waveform is modulated with an external source. Returns INT|EXT Examples SOURce1:PSKey:SOURce INTernal sets the CH1 source of modulating signal to internal. [SOURce[1|2]]:PSKey:STATe This command enables or disables PSK modulation.
Syntax [SOURce[1|2]]:PULSe:DCYCle {<percent>|MINimum|MAXimum} [SOURce[1|2]]:PULSe:DCYCle? [MINimum|MAXimum] Arguments <percent>::=<NR2>[<units>] where: <NR2> is the duty cycle. <units>::=PCT Returns <percent> Examples SOURce1:PULSe:DCYCle 80.5 sets the duty cycle of the pulse waveform on CH1 to 80.5%. [SOURce[1|2]]:PULSe:TRANsition[:LEADing] This command sets or queries the leading edge time of pulse waveform. Syntax [SOURce[1|2]]:PULSe:TRANsition[:LEADing] {<seconds>|MINimum|MAXimum} [SOURce[1|2]]:PULSe:TRANsition[:LEADing]?[MINimum|MAXimum]...
[SOURce[1|2]]:PULSe:TRANsition:TRAiling This command sets or queries the trailing edge time of pulse waveform. Syntax [SOURce[1|2]]:PULSe:TRANsition:TRAiling {<seconds>|MINimum|MAXimum} [SOURce[1|2]]:PULSe:TRANsition:TRAiling?[MINimum|MAXimum] Arguments <seconds>::=<NRf>[<units>] where <NRf> is the trailing edge of pulse waveform. <units>::=[ns|us|ms|s] Returns <seconds> Examples SOURce1:PULSe:TRANsition:TRAiling 200ns sets the trailing edge time to 200 ns. [SOURce[1|2]]:PULSe:WIDTh This command sets or queries the pulse width for the specified channel.
[SOURce[1|2]]:PWM:INTernal:FREQuency This command sets or queries the internal modulation frequency of PWM modulation for the specified channel. Use this command when the internal modulation source is selected. Set the internal modulation frequency from 2 mHz to 100.00 kHz with resolution of 1 mHz. Select the source of modulating signal by using the [SOURce[1|2]]:PWM:SOURce [INTernal|EXTernal] command.
INT|EXT Examples SOURce1:PWM:SOURce INTernal sets the source of modulating signal on CH1 to internal. [SOURce[1|2]]:PWM:STATe This command enables or disables PWM modulation. The query returns the state of PWM modulation. Select only pulse waveform as a carrier waveform for PWM. Syntax [SOURce[1|2]]:PWM:STATe {ON|OFF|<NR1>} [SOURce[1|2]]:PWM:STATe?
Returns <percent> Examples SOURce1:PWM:DEViation:DCYCle 5.0 sets the CH1 PWM deviation to 5.0%. [SOURce[1|2]]:SWEep:SOURce This command sets or queries the trigger source in the sweep mode for the specified channel. Syntax [SOURce[1|2]]:SWEep:SOURce [TIMer|MANual|EXTernal] [SOURce[1|2]]:SWEep:SOURce? Arguments TIMer specifies an internal clock as the trigger source. MANual specifies a manual trigger input as the trigger source.
LOGarithmic sets the sweep spacing to logarithmic. Returns LIN|LOG Examples SOURce1:SWEep:SPACing LINear sets the CH1 sweep spacing to linear. [SOURce[1|2]]:SWEep:STATe This command enables or disables the sweep mode for the specified channel. The query returns the state of sweep mode. Syntax [SOURce[1|2]]:SWEep:STATe {ON|OFF|<NR1>} [SOURce[1|2]]:SWEep:STATe?
<seconds>::=<NRf>[<units>] where: <NRf> is the sweep time in seconds. <units>::=[ns|us|ms|s] Returns <seconds> Examples SOURce1:SWEep:TIME 100ms sets the CH1 sweep time to 100 ms. [SOURce[1|2]]:VOLTage[:LEVel][:IMMediate]:OFFSet This command sets or queries the offset level for the specified channel. Syntax [SOURce[1|2]]:VOLTage[:LEVel][:IMMediate]:OFFSet {<voltage>|MINimum|MAXimum} [SOURce[1|2]]:VOLTage[:LEVel][:IMMediate]:OFFSet? {MINimum|MAXimum} Arguments <voltage>::=<NR3>[<units>] where:...
{<amplitude>|MINimum|MAXimum} [SOURce[1|2]]:VOLTage[:LEVel][:IMMediate][:AMPLitude]? {MINimum|MAXimum} Arguments <amplitude>::=<NR3>[<units>] where: <NR3> is the output amplitude. <units>::=[mVpp|Vpp] Returns <amplitude> Examples SOURce1:VOLTage:LEVel:IMMediate:AMPLitude 1Vpp sets the CH1 output amplitude to 1 Vpp. SYSTem:BEEPer[:IMMediate] (No Query Form) This command causes the instrument to beep immediately. This command is only available when the beeper is enabled.
Syntax SYSTem:BEEPer:STATe {ON|OFF|<NR1>} SYSTem:BEEPer:STATe? Arguments ON or <NR1>≠0 enables the beeper. OFF or <NR1>=0 disables the beeper. Returns <NR1> Examples SYSTEM:BEEPER:STATE ON enables the beeper function. SYSTem:ERRor[:NEXT]? (Query Only) This query-only command returns the contents of the Error/Event queue. Syntax SYSTem:ERRor[:NEXT]? Arguments None...
information on the screen. Different languages may support different types of languages. Syntax SYSTem:LANguage {SCHinese|TCHinese|ENGLish|PORTuguese|GERMan|POLish|KORean|JAPAnese} SYSTem:LANguage? Arguments SCHinese|TCHinese|ENGLish|PORTuguese|GERMan|POLish|KORean|JAPAnese specifies which language will be used to display instrument information on the screen. Returns SCH|TCH|ENGL|PORT|GERM|POL|KOR|JAPA Examples SYSTEM:LANGUAGE ENGLish specifies that the instrument displays information in English. SYSTem:VERSion? (Query Only) This query-only command returns the software version of the instrument.
TRACe|DATA[:DATA] This command transfers the waveform data from the external controller to the edit memory in the instrument. The query returns the binary block data. Syntax TRACe|DATA[:DATA] EMEMory,<binary_block_data> TRACe|DATA[:DATA]? EMEMory Arguments <binary_block_data> where <binary_block_data> is the waveform data in binary format. Returns <binary_block_data>...
Page 56
The oldest error code and text are retrieved by using the following command: SYSTem:ERRor[:NEXT]?