DSO2000 Series SCPI Programmers Manual

WisdomAugust

3. ACQuire Command Subsystem

Command List

l ACQuire: POINts

l ACQuire:TYPE

l ACQuire:SRATe?

l ACQuire:COUNt

3.1 ACQuire: POINts

Command	:ACQuire: POINts <value> :ACQuire: POINts?
Description	Set or query the storage depth of the oscilloscope[size=10.5000pt].
Parameters	:<value> ::= [size=10.5000pt]memory depth value.
State	value	Memory depth
	4000	4K
	40000	40K
	400000	400K
	4000000	4M
	8000000	8M
Return	The query returns the actual number of points (integer).
Example	:ACQuire: POINts 4000 /*Set memory depth to 4k*/ :ACQuire: POINts? /*The query returns[size=10.5000pt] 4000*/

WisdomAugust

3.2 ACQuire:TYPE

Command	:ACQuire:TYPE <value> :ACQuire:TYPE?
Description	Set or query the acquisition method of oscilloscope samples
Parameters	:<value> ::= < NORMal | AVERage | PEAK | HRESolution>
State	?NORMal (normal): In this mode, the oscilloscope samples the signal at equal time intervals to reconstruct the waveform. For most waveforms, using this mode produces the best display results. ?AVERages: In this mode, the oscilloscope averages waveforms that have been 18 / 136 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. ?PEAK (Peak Detection): In this mode, the oscilloscope collects the maximum and minimum values of the sampling interval signal to obtain the signal envelope or narrow pulses that may be lost. Using this mode can avoid aliasing of the signal, but the display noise is relatively large. ?HRESolution (high resolution): This mode uses an oversampling technique to average the neighboring points of the sampled waveform to reduce random noise on the input signal and produce a smoother waveform on the screen. It is usually used when the sampling rate of the digitizer is higher than the storage rate of the acquisition memory.
Return	The query returns NORM, AVERage, PEAK, or HRESolution.
Example	:ACQuire:TYPE AVERage[size=10.5000pt] /*Set the acquisition method to average*/ :ACQuire:TYPE?[size=10.5000pt] /*The query returns AVERage*/

WisdomAugust

3.3 ACQuire:SRATe?

Command	:ACQuire:SRATe?
Description	Query the current sampling rate.
State	The number of waveform points sampled per second.
Return	The query returns the sample rate as a real number.
Example	:ACQuire:SRATe?[size=10.5000pt] /*The query returns 1.25e+06*/

3.4 ACQuire:COUNt

Command	:ACQuire:COUNt <value> :ACQuire:COUNt?
Description	Set or query the average number of times in the average acquisition mode
Parameters	:<value> ::= <4|8|16|32|64|128>
Return	The query returns current average times.
Example	:ACQuire:COUNt  64 /*Set the average number to 64*/ :ACQuire:COUNt? /*The query returns 64*/

WisdomAugust

4. TRIGger Command Subsystem

Command List

l TRIGger:FORCe

l TRIGger:MODE

l TRIGger:STATus?

l TRIGger:SWEep

l TRIGger:HOLDoff

l TRIGger:EDGe

l TRIGger: PULSe

l TRIGger:SLOPe

l TRIGger:TV

l TRIGger:TIMeout

l TRIGger:WINDOw

l TRIGger:INTERVAl

l TRIGger:UNDER_Am

l TRIGger:UART

l TRIGger:CAN

l TRIGger: LIN

l TRIGger:IIC

l TRIGger:SPI

l TRIGger: PATTern

WisdomAugust

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

4.2TRIGger:MODE

Command	:TRIGger:MODE <mode> :TRIGger:MODE?
Description	Select or query the trigger type.
Parameters	:<mode> ::= < EDGE | PULSe | TV | SLOPe | TIMeout | WINdow | PATTern | INTerval | UNDerthrow | UART | LIN | CAN | SPI | IIC>
Return	Return EDGE, PULSe, TV, SLOPe, TIMeout, WINdow, PATTern, INTerval, UNDerthrow, UART, LIN, CAN, SPI, IIC
Example	:TRIGger:MODE SLOPe[size=10.5000pt] /*Set the trigger type to slope trigger*/ :TRIGger:MODE? /*The query returns SLOPe*/

4.3TRIGger:STATus?

Command	:TRIGger:STATus?
Description	Query the current trigger status.
Return	Return TRIGed, NOTRIG

WisdomAugust

4.4 TRIGger:SWEep

Command	:TRIGger:SWEep <value> :TRIGger:SWEep?
Description	Set or query the trigger mode.
Parameters	:<value> ::= < AUTO | NORMal | SINGle>
State	?AUTO: Automatic triggering, waveform display regardless of whether trigger 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. ?SINGle: Single trigger. The oscilloscope waits for the trigger, displays the waveform when the trigger conditions are met, and then stops.
Return	The query returns AUTO, NORMal, or SINGle.
Example	:TRIGger:SWEep SINGle[size=10.5000pt] /*Select single trigger mode*/ :TRIGger:SWEep?[size=10.5000pt] /*The query returns SINGle*/

4.5 TRIGger:HOLDoff

Command	:TRIGger:HOLDoff <value> :TRIGger:HOLDoff?
Description	Set or query the holdoff time.
Parameters	:<value> ::= Trigger holdoff time (in second)
State	Trigger holdoff can stably trigger complex waveforms (such as pulse series). Holdoff time is the time the oscilloscope waits to re-enable the trigger circuit. The oscilloscope will not trigger until the holdoff time is over. When the trigger method is video trigger, timeout trigger, setup hold, UART, LIN, CAN, IIC or SPI, this setting is not available.
Return	The query returns the trigger holdoff time in scientific notation.
Example	:TRIGger:HOLDoff 0.0000002[size=10.5000pt] /*Set trigger holdoff time to 200ns*/ :TRIGger:HOLDoff?[size=10.5000pt] /*The query returns 2.000000e-07*/

WisdomAugust

4.6 TRIGger:EDGe

Command List

l TRIGger:EDGe:SOURce

l TRIGger:EDGe:SLOPe

l TRIGger:EDGeEVel

4.6.1 TRIGger:EDGe:SOURce

Command	:TRIGger:EDGe:SOURce <source> :TRIGger:EDGe:SOURce?
Description	Set or query the trigger source for edge trigger.
Parameters	:<source> ::= < CHANnel1 | CHANnel2 | CHANnel3 | CHANnel4 | EXT/10>
Return	The query returns CHANnel1, CHANnel2, CHANnel3, CHANnel4, EXT/10
Example	:TRIGger:EDGe:SOURce CHANnel1[size=10.5000pt] / * Set the trigger source to CH1 * / :TRIGger:EDGe:SOURce?[size=10.5000pt] / * The query returns CHANnel1 * /

WisdomAugust

4.6.1 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 >
State	?RISIng: rising edge ?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*/ :TRIGger:EDGe:SLOPe? /*The query returns RISIng*/

4.6.2 TRIGger:EDGe: LEVel

Command	:TRIGger:EDGe: LEVel <level> :TRIGger:EDGe: LEVel?
Description	Set or query the trigger level when the edge triggers.
Parameters	:<level> ::= trigger level ( unit is V)
Return	The query returns the trigger level value in scientific notation.
Example	:TRIGger:EDGe: LEVel 0.16 /*Set the trigger level to 160mV*/ :TRIGger:EDGe: LEVel? /*The query returns 1.600e-1*/

WisdomAugust

4.6.3 TRIGger:EDGe: LEVel

Command	:TRIGger:EDGe: LEVel <level> :TRIGger:EDGe: LEVel?
Description	Set or query the trigger level when the edge triggers.
Parameters	:<level> ::= trigger level ( unit is V)
Return	The query returns the trigger level value in scientific notation.
Example	:TRIGger:EDGe: LEVel 0.16 /*Set the trigger level to 160mV*/ :TRIGger:EDGe: LEVel? /*The query returns 1.600e-1*/

4.7 TRIGger: PULSe

Command List

l TRIGger: PULSe:SOURce

l TRIGger: PULSe: POLarity

l TRIGger: PULSe:WHEN

l TRIGger: PULSe:WIDth

l TRIGger: PULSe: LEVel

4.7.1 TRIGger: PULSe:SOURce

Command	:TRIGger: PULSe:SOURce <source> :TRIGger: PULSe:SOURce?
Description	Set or query the trigger source of the pulse width trigger.
Parameters	:<source> ::= < CHANnel1 | CHANnel2 | CHANnel3 | CHANnel4>
Return	The query returns CHANnel1, CHANnel2, CHANnel3, CHANnel4
Example	:TRIGger: PULSe:SOURce CHANnel1 /*set trigger source to CH1*/ :TRIGger: PULSe:SOURce? /*The query returns CHANnel1*/

WisdomAugust

4.7.2 TRIGger: PULSe: POLarity

Command	:TRIGger: PULSe: POLarity <polarity> :TRIGger: PULSe: POLarity?
Description	Set or query the trigger polarity of pulse width trigger
Parameters	:<polarity> ::= < POSItive | NEGAtive>
State	POSItive: Positive pulse trigger NEGAtive: negative pulse trigger
Return	The query returns POSItive, NEGAtive
Example	:TRIGger: PULSe: POLarity POSItive /*Set positive pulse trigger*/ :TRIGger: PULSe: POLarity? /*The query returns POSItive*/

4.7.3 TRIGger: PULSe:WHEN

Command	:TRIGger: PULSe:WHEN <when> :TRIGger: PULSe:WHEN?
Description	Set or query the trigger conditions for pulse width trigger.
Parameters	<when> ::= < EQUAl| NEQUal| GREAt| LESS>
State	?EQUAl = (equal to time value): Only when the positive or negative pulse width of the input signal is equal to the set pulse width can it trigger. [Pulse width error is 5%] NEQUal! = (Not equal to time value): Only when the positive or negative pulse width of the input signal is not equal to the set pulse width, can the [pulse width error be 5%] be triggered. GREAt > (greater than the time value): Only when the positive or negative pulse width of the input signal is greater than the set pulse width can it trigger [pulse width error is 5%]. ?LESS <(less than time value): Only when the positive or negative pulse width of the input signal is less than the set pulse width can the [pulse width error be 5%] be triggered.
Return	The query returns EQUAl, NEQUal, GRAt, LESS
Example	:TRIGger: PULSe:WHEN NEQUal /*Set trigger condition to NEQUal*/ :TRIGger: PULSe:WHEN? /*The query returns NEQUal*/