SCPI Programmers Manual Introduction to SCPI commands SCPI is the abbreviation of Programmable Instrument Standard Commands. It defines a set of standard syntax and commands for controlling programmable test and measurement instruments. SCPI commands are ASCII strings that are passed into the instrument through the physical transport layer. The command consists of a series of keywords, and some also need to include parameters.
Page 3
SCPI Programmers Manual For example: :MEASure:ADISplay? Can be abbreviated to :MEAS:ADIS?
SCPI Programmers Manual 1. CHANnel<n> Command Subsystem :CHANnel<n> commands are used to set or query the vertical system parameters such as bandwidth limit, coupling, vertical scale, and vertical offset of the analog channel of the oscilloscope. Command List ⚫ CHANnel<n>:BWLimit ⚫...
SCPI Programmers Manual Return The query returns AC,DC,GND Example :CHANnel1:COUPling AC /*Select AC coupling mode*/ :CHANnel1:COUPling? /*Query returns AC*/ 1.3 CHANnel<n>:DISPlay Command :CHANnel<n>:DISPlay <bool> :CHANnel<n>:DISPlay? Description Turn on or off the specified channel or query the switch status of the specified channel.
SCPI Programmers Manual 1.6 CHANnel<n>:SCALe Command :CHANnel<n>:SCALe <scale> [<suffix>] :CHANnel<n>:SCALe? Description Sets or queries the vertical scale of the specified channel. The default unit is V. Parameters :<scale> ::= vertical units per division in NR3 format :<suffix> ::= {V | mV} :<n>::= {1 | 2 | 3 | 4} ▷CHANnel<n>:SCALe command to setup each channel’s vertical scale.The settable State...
SCPI Programmers Manual 2.3 TIMebase:WINDow:SCALe Command :TIMebase:WINDow:SCALe <scale_value> :TIMebase:WINDow:SCALe? Description Set or query the horizontal scale of the sub-window (microseconds/div). Parameters :<sacle_value> ::= The current number of microseconds per grid of the subwindow. State The main scan scale determines the range of this command, the maximum value is half of the main scan scale.
SCPI Programmers Manual sampled multiple times to reduce random noise on the input signal and improve vertical resolution. The number of averages can be set by the: ACQuire: AVERages command. The higher the number of averages, the lower the noise and the higher the vertical resolution, but the slower the response of the displayed waveform to waveform changes.
SCPI Programmers Manual ⚫ TRIGger:PULSe ⚫ TRIGger:SLOPe ⚫ TRIGger:TV ⚫ TRIGger:TIMeout ⚫ TRIGger:WINDOw ⚫ TRIGger:INTERVAl ⚫ TRIGger:UNDER_Am ⚫ TRIGger:UART ⚫ TRIGger:CAN ⚫ TRIGger:LIN ⚫ TRIGger:IIC ⚫ TRIGger:SPI ⚫ TRIGger:PATTern 4.1 TRIGger:FORCe Command :TRIGger:FORCe Description Select or query the force trigger. State Even if the trigger conditions are not met, this command will let the oscilloscope acquire waveforms...
SCPI Programmers Manual 4.4 TRIGger:SWEep Command :TRIGger:SWEep <value> :TRIGger:SWEep? Description Set or query the trigger mode. Parameters :<value> ::= < AUTO | NORMal | SINGle> ▷AUTO: Automatic triggering, waveform display regardless of whether trigger State conditions are met. ▷NORMal: Normal trigger, display the waveform when the trigger condition is met, keep the original waveform display when the trigger condition is not met, and wait for the next trigger.
SCPI Programmers Manual 4.6.2 TRIGger:EDGe:SLOPe Command :TRIGger:EDGe:SLOPe <slope> :TRIGger:EDGe:SLOPe? Description Set or query the type of edge trigger. Parameters :<slope> ::= < RISIng| FALLing | EITHer > ▷RISIng: rising edge State ▷FALLing: falling edge ▷EITHer: rising or falling edge Return The query returns RISIng, FALLing, EITHer Example :TRIGger:EDGe:SLOPe RISIng /*Set the edge type to rising edge*/...
SCPI Programmers Manual Return The query returns EQUAl, NEQUal, GRAt, LESS Example :TRIGger:SLOPe:WHEN NEQUal /*Set trigger condition to NEQUal*/ :TRIGger:SLOPe:WHEN? /*The query returns NEQUal*/ 4.8.4 TRIGger:SLOPe:WIDth Command :TRIGger:SLOPe:WIDth <value> :TRIGger:SLOPe:WIDth? Description Set or query the trigger condition of the slope trigger. Parameters :<value>...
SCPI Programmers Manual 4.9.5 TRIGger:TV:STANdard Command :TRIGger:TV:STANdard <standard> :TRIGger:TV:STANdard? Description Set or query the video standard of the video Parameters :<standard> ::= < NTSC | PAL > Return The query returns NTSC, PAL Example :TRIGger:TV:STANdard NTSC /*Select NTSC video standard*/ :TRIGger:TV:STANdard? /*The query returns NTSC*/ 4.9.6 TRIGger:VIDeo:LEVel Command...
SCPI Programmers Manual 4.10.3 TRIGger:TIMeout:WIDth Command :TRIGger:TIMeout:WIDth <value> :TRIGger:TIMeout:WIDth? Description Sets or queries the timeout period triggered by the timeout. Parameters :<value> ::=trigger timeout value (range: 8ns-10s) Return The query returns the timeout value in scientific notation. :TRIGger:TIMeout:WIDth 0.000003 /*Set the timeout time to 3μs*/ Example :TRIGger:TIMeout:WIDth? /*The query returns 3.000000e-06*/ 4.10.4 TRIGger:TIMeout:POLarity...
SCPI Programmers Manual Example :TRIGger:WINDOw:ALEVel 0.16 /*Set the trigger level upper limit to 160mV*/ :TRIGger:WINDOw:ALEVel? /*The query returns 1.600000e-01*/ 4.11.3 TRIGger:WINDOw:BLEVel Command :TRIGger:WINDOw:BLEVel <level> :TRIGger:WINDOw:BLEVel? Description Set or query the lower limit of the trigger level when the amplitude trigger is triggered.
SCPI Programmers Manual 4.12.3 TRIGger:INTERVAl:WHEN Command :TRIGger:INTERVAl:WHEN <when> :TRIGger:INTERVAl:WHEN? Description Set or query the trigger condition of the interval trigger Parameters :<when> ::= < EQUAl| NEQUal| GREAt| LESS> State The interval between two consecutive rising (or falling) edges meets the set time condition(<,>, =,! =) Return The query returns EQUAl, NEQUal, GRAt, LESS...
SCPI Programmers Manual Return The query returns the upper trigger level in scientific notation. Example :TRIGger:UNDER_Am:ALEVel 0.16 /*Set the trigger level upper limit to 160mV*/ :TRIGger:UNDER_Am:ALEVel? /*The query returns 1.600000e-01*/ 4.13.6 TRIGger:UNDER_Am:BLEVel Command :TRIGger:UNDER_Am:BLEVel <level> :TRIGger:UNDER_Am:BLEVel? Description Set or query the lower limit of the trigger level when the runt pulse is triggered. Parameters :<level>...
SCPI Programmers Manual :TRIGger:UART:BAUd? Description Set or query the baud rate triggered by the UART. The default unit is bps. Parameters :<baud> ::=<110|300|600|1200|2400|4800|9600|14400|19200|38400|57600|115200|230 400|380400|460400|921600|USER> Return The query returns an integer or USER. Example :TRIGger:UART:BAUd 4800 /*Set the baud rate to 4800*/ :TRIGger:UART:BAUd? /*he query returns 4800*/ 4.14.4 TRIGger:UART:ALEVel Command...
SCPI Programmers Manual Description Set or query the trigger level during CAN trigger Parameters :<level> ::= trigger level value (in V) Return Returns the trigger level value in scientific notation Example :TRIGger:CAN:ALEVel 0.16 /*Set trigger level 160mV*/ :TRIGger:CAN:ALEVel? TRIGger:CAN:ALEVel? 4.16 TRIGger:LIN Command List ⚫...
SCPI Programmers Manual Description Set or query the address value when the IIC trigger condition is an address or address data. Parameters :<addr> ::= 8 digits Return The query returns an integer. Example :TRIGger:IIC:ADDer 20 /*Set the address value to 20*/ :TRIGger:IIC:ADDer? /*The query returns START 20*/ 4.17.5 TRIGger:IIC:DATA Command...
SCPI Programmers Manual :TRIGger:SPI:DATA? Description Set or query the data value triggered by SPI. Parameters :<data> ::= 0—(2 Return The query returns an integer. Example :TRIGger:SPI:DATA 20 /*Set the data value to 20*/ :TRIGger:SPI:DATA? /*The query returns 20*/ 4.18.6 TRIGger:SPI:MASK Command :TRIGger:SPI:MASK <mask>...
SCPI Programmers Manual :<pa_ch1> Discrete {H|L|X|} :<pa_ch2> Discrete {H|L|X|} :<pa_ch3> Discrete {H|L|X|} :<pa_ch4> Discrete {H|L|X|} :<pa_D10> Discrete {H|L|X|} :<pa_D43> Discrete {H|L|X|} State Parameters <pa_ch1> to <pa_ch4> set the pattern of the analog channels CH1 to CH4, and parameters <pa_D10> to <pa_D43> set the pattern of the digital channel.
SCPI Programmers Manual Description The oscilloscope starts performing a self-calibration operation. ▷ Self-calibration operation can quickly make the oscilloscope reach the best working State condition to obtain the most accurate measurement value. ▷ Before performing a self-calibration, make sure that no signals are connected to all channels until the self-calibration operation ends.
SCPI Programmers Manual 6.6 MATH:OFFSet Command :MATH:OFFSet <value> :MATH:OFFSet? Description Sets or queries the vertical offset of the operation result. Parameters :<value> ::= offset value (in V) Return The query returns the vertical offset of the current operation result in scientific notation.
SCPI Programmers Manual :MATH:FFT:HSCale? Description Set or query the horizontal scale of the FFT operation result. The default unit is Hz. Parameters :<hscale> ::= <125000|250000|625000|1250000> State You can observe the detailed information of the spectrum by reducing the horizontal scale. Return The query returns the current horizontal scale in scientific notation.
SCPI Programmers Manual data[94]-data[102] (9 digits): Display trigger time of current frame. data[103]-data[111] (9 digits): The current frame displays the start point of the data acquisition start time point. data[112]-data[127] (16digits): Reserved bit. This command is issued again before this data is read to analyze the waveform data data[x] as follows: data[0]-data[1] (2 digits): #9 data[2]-data[10] (9 digits): Indicates the byte length of the current data packet.
SCPI Programmers Manual 8.3 DISPlay:GRID Command :DISPlay:GRID <type> :DISPlay:GRID? Description Sets or queries the type of grid displayed on the screen. Parameters :<type> ::= < DOTTed| REAL> State DOTTed: dot grid REAL: line grid Return The query returns DOTTed, REAL Example :DISPlay:GRID DOTTed /*set the background grid to DOTTed */ :DISPlay:GRID? /*The query returns DOTTed*/...
SCPI Programmers Manual 9.8 CURSor:MANual:BX Command :CURSor:MANual:BX <value> :CURSor:MANual:BX? Description Set or query the horizontal position of cursor B when manual cursor measurement is performed. Parameters :<type> ::= 0-770 State The horizontal and vertical positions of the cursor are defined by the pixel coordinates of the screen.
SCPI Programmers Manual Return The query returns CHANnel1, CHANnel2, CHANnel3, CHANnel4 or MATH. Example :CURSor:TRACk:SOURcea CHANnel1 /*Set the channel source to CH1*/ :CURSor:TRACk:SOURcea? /*The query returns CHANnel1*/ 9.13 CURSor:TRACk:SOURceb Command :CURSor:TRACk:SOURceb <source> :CURSor:TRACk:SOURceb? Description Set or query the channel source of cursor B measurement during cursor tracking measurement.
SCPI Programmers Manual 9.18 CURSor:TRACk:BX Command :CURSor:TRACk:BX <value> :CURSor:TRACk:BX? Description Set or query the horizontal position of cursor B when cursor tracking measurement. Parameters :<type> ::= 0-770 State The horizontal and vertical positions of the cursor are defined by the pixel coordinates of the screen.
SCPI Programmers Manual 10.5 MEASure:GATE:ENABle Command :MEASure:GATE:ENABle <bool> :MEASure:GATE:ENABle? Description Set or query the current gate control status Parameters :<bool> ::= {{1 | ON} | {0 | OFF} Return The query returns ON,OFF Example :MEASure:GATE:ENABle ON /*Turn on the gate function*/ :MEASure:GATE:ENABle? /*Query returns ON*/ 10.6 MEASure:GATE:AY Command...
SCPI Programmers Manual 11.1 MASK:EANBle Command :MASK:EANBle <bool> :MASK:EANBle? Description Turn the pass / fail test function on or off, or query the status of the pass / fail test function. Parameters :<bool> ::= {{1 | ON} | {0 | OFF} Return The query returns ON,OFF Example...
SCPI Programmers Manual 11.5 MASK:SOOutput Command :MASK:SOOutput <bool> :MASK:SOOutput? Description Turn on or off the sound prompt when the test fails output, or query the status of the sound prompt. Parameters :<bool> ::= {{1 | ON} | {0 | OFF} ▷Off: When a failed waveform is detected, it will be displayed and output, but the State buzzer will not alarm.
SCPI Programmers Manual ⚫ SYSTem:GAM? ⚫ SYSTem:RAM? ⚫ SYSTem:PON ⚫ SYSTem:LANGuage ⚫ SYSTem:LOCKed ⚫ SETUp:ALL? 12.1 SYSTem:GAM? Command :SYSTem:GAM? Description Query the number of grids in the horizontal direction of the instrument screen. Return The query returns 12. 12.2 SYSTem:RAM? Command :SYSTem:RAM? Description...
SCPI Programmers Manual :SYSTem:LOCKed? Description Turn the keyboard lock function on or off, or query the status of the keyboard lock function. Parameters :<bool> ::= {{1 | ON} | {0 | OFF} Return The query returns ON,OFF. 12.6 SETUp:ALL? Command :SETUp:ALL? Description Get all the states needed to boot up at once.
Page 56
SCPI Programmers Manual Window trigger source: <Detailed view TRIGger:WINDOw:SOURce> Window trigger level a: <See TRIGger:WINDOw:ALEVel for details> Window trigger level b: <See TRIGger:WINDOw:BLEVel for details> Interval trigger source: <For details, see TRIGger:INTERVAl:SOURce> Interval trigger edge: <See TRIGger:INTERVAl:SLOp for details> Interval trigger condition: <See TRIGger:INTERVAl:WHEN for details> Interval trigger time: <See TRIGger:INTERVAl:TIME for details>...
SCPI Programmers Manual TRIGger:SPI:ALEVel> The trigger level of the SPI trigger data channel: <For details, see TRIGger:SPI:BLEVel> Pattern triggered by pattern: <For details, see TRIGger:LOGIc:POLarity> Conditions for pattern triggering: <For details, see TRIGger:LOGIc:WHEN> Pattern trigger width: <For details, see TRIGger:LOGIc:TIME> Pattern trigger CH1 level: <For details, see TRIGger:LOGIc:ALEVel>...
SCPI Programmers Manual Description Set or query the duty cycle of the signal source Parameters :<duty> ::= 0-99 Return The query returns the duty cycle value Example :DDS: DUTY 50 /*Set the signal source signal duty cycle to 50%*/ :DDS:DUTY? /*The query returns 50*/ 13.7 DDS:WAVE:MODE Command :DDS:WAVE:MODE <bool>...
SCPI Programmers Manual 13.11 DDS:MODE:DEPThordeviation Command :DDS:MODE:DEPThordeviation <value> :DDS:MODE:DEPThordeviation? Description Set or query the deviation or depth of signal source modulation Parameters The modulation type is AM: <value> ::= modulation depth Modulation type is FM: <value> ::= deviation Return When the modulation type is AM, the query returns the value of the modulation depth The query returns deviation when the modulation type is FM Example Modulation type is AM...
SCPI Programmers Manual Description Send a signal source burst once 13.16 DDS:ARB:DAC16:BIN Command :DDS:ARB:DAC16:BIN <binary_block_data> Description Download waveform data, <binary_block_data> means to download binary data, <binary_block_data> is a binary data block starting with # sign, "#508192" binary data, "5" after "#" means there are 5 characters representing data length information , "8192"...