Chapter 2 Command System
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 Listl CHANnel<n>: BWLimitl CHANnel<n>: COUPlingl CHANnel<n>: DISPlayl CHANnel<n>: INVertl CHANnel<n>: OFFSetl CHANnel<n>: SCALel CHANnel<n>: PROBel CHANnel<n>: VERNier
Edited by WisdomAugust at 2021-7-7 08:20
1.1 CHANnel<n>:BWLimit
Command:CHANnel<n>:BWLimit <type>:CHANnel<n>:BWLimit?
DescriptionSet or query the parameters of bandwidth limit for the indicated channel.
Parameters:<type>::= {{1 | ON} | {0 | OFF}:<n>::= {1 | 2 | 3 | 4}
State?OFF: Turn off the 20MHz bandwidth limit, and the high-frequency components contained in the measured signal can pass.?ON: Turn on the bandwidth limitation, and the high-frequency components contained in the signal under test are attenuated. Turning on bandwidth limiting reduces waveform noise, but attenuates high-frequency components.
ReturnThe query returns 0 or 1.
Example:CHANnel1:BWLimit 1 /*Enable 20MHz bandwidth limit*/:CHANnel1:BWLimit? /*The query returns 1*/
Edited by WisdomAugust at 2021-7-8 08:21
1.2 CHANnel<n>:COUPling
Command:CHANnel<n>:COUPling <coupling>:CHANnel<n>:COUPling?
DescriptionSet or query the connection of the indicated channel signal.
Parameters:<coupling> ::= {AC | DC | GND}:<n>::= {1 | 2 | 3 | 4}
State?AC: The DC component of the signal under test is blocked.?DC: Both the DC and AC components of the signal under test can pass.?GND: Both the DC and AC components of the signal under test are blocked
ReturnThe query returns AC,DC,GND
Example:CHANnel1:COUPling AC /*Select AC coupling mode*/:CHANnel1:COUPling? /*Query returns AC*/
Edited by WisdomAugust at 2021-7-9 11:48
1.3 CHANnel<n>: DISPlay
Command:CHANnel<n>: DISPlay <bool>:CHANnel<n>: DISPlay?
DescriptionTurn on or off the specified channel or query the switch status of the specified channel.
Parameters:<bool> ::= {{1 | ON} | {0 | OFF}}:<n>::= {1 | 2 | 3 | 4}
ReturnThe query returns 0 or 1.
Example:CHANnel1: DISPlay ON /*Turn on CH1*/:CHANnel1: DISPlay? /*The query returns 1*/
1.4 CHANnel<n>:INVert
Command:CHANnel<n>:INVert <bool>:CHANnel<n>:INVert?
DescriptionTurn the waveform inversion of the specified channel on or off or query the switching status of the waveform inversion of the specified channel.
Parameters:<bool> ::= {{1 | ON} | {0 | OFF}}:<n>::= {1 | 2 | 3 | 4}
ReturnThe query returns 0 or 1.
Example:CHANnel1:INVert ON /*Turn on the waveform inversion of CH1*/:CHANnel1:INVert? /*The query returns 1*/
Edited by WisdomAugust at 2021-8-2 11:42
1.5 CHANnel<n>:OFFSet
Command:CHANnel<n>:OFFSet <offset> [<suffix>]:CHANnel<n>:OFFSet?
DescriptionSets or queries the vertical displacement of the specified channel. The default unit is V.
Parameters:<offset> ::= Vertical offset value in NR3 format:<suffix> ::= {V | mV}:<n>::= {1 | 2 | 3 | 4}
State?The set vertical displacement value is affected by the vertical gear and probe ratio. ?The range of legal values varies with the vertical scale and probe ratio. If 21 / 136 you set an offset outside the legal range, the offset value will be automatically set to the closest legal value.
ReturnThe query returns the vertical displacement value in scientific notation.
Example:CHANnel1:OFFSet 1V /*Set the vertical offset of CH1 to 1V*/:CHANnel1:OFFSet? /*The query returns 1*/
1.6 CHANnel<n>:SCALe
Command:CHANnel<n>:SCALe <scale> [<suffix>]:CHANnel<n>:SCALe?
DescriptionSets 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}
State?CHANnel<n>:SCALe command to setup each channel’s vertical scale.The settable range of the vertical scale is related to the currently set probe ratio (set by the: ?CHANnel : PROBe command).
ReturnThe query returns the vertical scale value in scientific notation.
Example:CHANnel1:SCALe 1V /*Set the vertical scale to 1V*/:CHANnel1:SCALe?/*The query returns 1.000e + 00*/
Edited by WisdomAugust at 2021-8-9 15:04
1.7 CHANnel<n>: PROBe
Command:CHANnel<n>: PROBe <atten>:CHANnel<n>: PROBe?
DescriptionSet or query the probe factor of the specified channel.
Parameters:<atten> ::= {1 | 10 | 100 | 1000}:<n>::= {1 | 2 | 3 | 4}
State?Set the probe factor, which is displayed after multiplying the acquired signal by a specified multiple (does not affect the actual amplitude of the signal).?Setting the probe ratio affects the settable range of the current vertical scale.
ReturnThe query returns the probe attenuation ratio in scientific notation.
Example:CHANnel1: PROBe 10 /*Set the probe attenuation ratio to 10X*/:CHANnel1: PROBe? /*The query returns 1.000000e + 01*/
1.8 CHANnel<n>:VERNier
Command:CHANnel<n>:VERNier <bool>:CHANnel<n>:VERNier?
DescriptionTurn the fine adjustment function of the vertical scale of the specified channel on or off, or query the status of the fine adjustment function of the vertical scale of the specified channel.
Parameters:<bool> ::= {{1 | ON} | {0 | OFF}}:<n>::= {1 | 2 | 3 | 4}
StateThe trim setting is off by default. At this time, you can only set the vertical scale in 1-2-5 steps, that is, 500u, 1mV, 2mV, 5mV, 10mV ... 10V (probe ratio is 1X). When the trim setting is on, you can further adjust the vertical scale within a smaller range to improve vertical resolution. If the amplitude of the input waveform is slightly larger than the full scale in the current scale, and the amplitude displayed by the waveform of the next gear is slightly lower, you can use fine adjustment to improve the waveform display amplitude to facilitate observation of signal details.
ReturnThe query returns 1 or 0.
Example:CHANnel1:VERNier ON /*Turn on the fine adjustment function of CH1 vertical scale*/:CHANnel1:VERNier? /*The query returns 1*/
Edited by WisdomAugust at 2021-8-9 15:04
2. TIMebase Command Subsystem
Command Listl TIMebase:WINDow:ENABlel TIMebase:WINDow: POSitionl TIMebase:WINDow:SCALel TIMebase: POSitionl TIMebase:SCALel TIMebase:RANGel TIMebase:MODE
2.1 TIMebase:WINDow:ENABle
Command:TIMebase:WINDow:ENABle <bool>:TIMebase:WINDow:ENABle?
DescriptionTurn on or off the dual window function, or query the status of the dual window.
Parameters:<bool> ::= {{1 | ON} | {0 | OFF}
StateThe dual window mode can be used to zoom in a section of the waveform horizontally in order to view the waveform details.
ReturnThe query returns ON or Off.
Example:TIMebase:WINDow:ENABle ON /*Turn on delayed scanning*/:TIMebase:WINDow:ENABle? /*The query returns 1*/
Edited by WisdomAugust at 2021-8-9 15:03
2.2 TIMebase:WINDow: POSition
Command:TIMebase:WINDow: POSition <pos value>:TIMebase:WINDow: POSition?
DescriptionSet or query horizontal position of the zoomed view of the main scan.
Parameters:<pos value> ::= The value of the horizontal position (in seconds)
StateThe main scan range and the horizontal position of the main scan determine the range of this command. The value of this command must keep the zoomed view window within the main scan range.
ReturnReturns the position of the current horizontal window in the zoomed view in scientific notation.
Example:TIMebase:WINDow: POSition 0.001 /*Set the horizontal position to 0.001s*/:TIMebase:WINDow: POSition? /*The query returns1.000e-03*/
2.3 TIMebase:WINDow:SCALe
Command:TIMebase:WINDow:SCALe <scale_value>:TIMebase:WINDow:SCALe?
DescriptionSet or query the horizontal scale of the sub-window (microseconds/div).
Parameters:<sacle_value> ::= The current number of microseconds per grid of the subwindow.
StateThe main scan scale determines the range of this command, the maximum value is half of the main scan scale.
ReturnReturn the time base gear of the sub-window in scientific notation.
Example:TIMebase:WINDow:SCALe 0.0005 /*Set the delay time base to 500us*/:TIMebase:WINDow:SCALe? /*The query returns 5.000e-4*/
Edited by WisdomAugust at 2021-8-9 15:02
2.4 TIMebase: POSition
Command:TIMebase: POSition <pos value>:TIMebase: POSition?
DescriptionSet or query the main time base offset.
Parameters:<pos value> ::= offset value (in second).
ReturnReturn the main time base offset value in scientific notation.
Example:TIMebase: POSition 0.0002 /*Set main time base to 200us*/:TIMebase: POSition? /*The query returns 2.000e-4*/
2.5TIMebase:SCALe
Command:TIMebase:SCALe <scale value>:TIMebase:SCALe?
DescriptionSet or query the horizontal scale of the main window (seconds/div).
Parameters:<scale value> ::= The current number of seconds per grid in the main window
ReturnReturn to the main window time base gear in scientific notation.
Example:TIMebase:SCALe 0.0005 /*Set the main time base to 500us*/:TIMebase:SCALe? /*The query returns 5.000e-4*/
Edited by WisdomAugust at 2021-8-9 15:00
2.6 TIMebase:RANGe
Command:TIMebase:RANGe <range value>:TIMebase:RANGe?
DescriptionSet or query the full-scale horizontal time of the main window.
Parameters:<range value> ::= range value (in second).
ReturnReturn the full-scale time base range of the main window in scientific notation.
Example:TIMebase:RANGe 0.0016 /*Set main time base to100us*/:TIMebase:RANGe? /*The query returns 1.600e-03*/
2.7TIMebase:MODE
Command:TIMebase:MODE <value>:TIMebase:MODE?
DescriptionSets or queries the horizontal time base mode.
Parameters:<value> ::= <MAIN | XY | ROLL>
State?MAIN: YT mode?XY: XY mode?ROLL: ROLL mode
ReturnThe query returns MAIN, XY, or ROLL.
Example:TIMebase:MODE XY /*Set the horizontal time base mode to XY mode*/:TIMebase:MODE? /*The query returns XY*/