advertisement
RIGOL
:MASK Commands
:MASK:ENABle
Syntax
:MASK:ENABle <bool>
:MASK:ENABle?
Description
Enable or disable the pass/fail test function; or query the current status of the pass/fail test function.
Parameter
Name Type Range Default
<bool> Bool {{1|ON}|{0|OFF}} 0|OFF
Explanation
In the following states, the pass/fail test function cannot be enabled and this command is invalid.
In the X-Y time base mode.
In the ROLL time base mode.
In the Y-T time base mode, when the horizontal time base is set to 200ms/div or slower and the instrument enters the slow sweep mode.
When the waveform recording is enabled.
Return Format
The query returns 1 or 0.
2-134 MSO2000A/DS2000A Programming Guide
:MASK:SOURce
Syntax
:MASK:SOURce <source>
:MASK:SOURce?
Description
Set or query the measurement source of the pass/fail test.
Parameter
Name
<source>
Type
Discrete
Range
{CHANnel1|CHANnel2}
Default
CHANnel1
Explanation
Only the channel enabled can be selected as the measurement source of the pass/fail test.
Return Format
The query returns CHAN1 or CHAN2.
:MASK:OPERate
Syntax
:MASK:OPERate <oper>
:MASK:OPERate?
Description
Run or stop the pass/fail test; or query the current status of the pass/fail test.
Parameter
Name
<oper>
Type
Discrete
Range
{RUN|STOP}
Default
STOP
Explanation
Before executing this command, use the :MASK:ENABle command to enable the pass/fail test.
Return Format
The query returns RUN or STOP.
RIGOL
MSO2000A/DS2000A Programming Guide 2-135
RIGOL
:MASK:MDISplay
Syntax
:MASK:MDISplay <bool>
:MASK:MDISplay?
Description
When the pass/fail test is enabled, enable or disable the message display; or query the current status of the message display.
Parameter
Name Type
<bool> Bool
Range
{{1|ON}|{0|OFF}}
Default
0|OFF
Explanation
To enable the message display, first use the :MASK:ENABle command to enable the pass/fail test.
Return Format
The query returns 1 or 0.
:MASK:SOOutput
Syntax
:MASK:SOOutput <bool>
:MASK:SOOutput?
Description
Enable or disable the “Stop On Fail” function; or query the current status of the “Stop On Fail” function.
Parameter
Name Type
<bool> Bool
Explanation
Range
{{1|ON}|{0|OFF}}
Default
0|OFF
ON: when failed waveform is detected, the oscilloscope stops the test and enters the “STOP” state.
At this point, the results of the last statistic are displayed on the screen (if display is enabled) and only a single pulse is output from the [Trigger Out] (if enabled) at the rear panel.
OFF: the oscilloscope continues with the test even when failed waveform is detected. The test results on the screen will update continuously and a pulse is output from [Trigger Out] at the rear panel each time a failed waveform is detected.
Return Format
The query returns 1 or 0.
2-136 MSO2000A/DS2000A Programming Guide
RIGOL
:MASK:OUTPut
Syntax
:MASK:OUTPut <type>
:MASK:OUTPut?
Description
Set or query the output mode when the test fails.
Parameter
Name Type Range
<type>
Explanation
Discrete {FAIL|FSOund}
Default
FAIL
FAIL: when a failed waveform is detected, the oscilloscope displays the statistic results and outputs a pulse; but the beeper does not sound.
FSOund: when a failed waveform is detected, the oscilloscope displays the statistic results and outputs a pulse; while at the same time, the beeper sounds (not related to the on/off state of the sound).
Return Format
The query returns FAIL or FSO.
:MASK:X
:MASK:Y
Syntax
:MASK:X <x>
:MASK:X?
:MASK:Y <y>
:MASK:Y?
Description
Set or query the horizontal or vertical adjustment parameter of the pass/fail test mask.
Parameter
Name
<x>
Type
Real
Range
0.02 to 4, the step is 0.02
Default
0.24
<y> Real 0.04 to 5.12, the step is 0.04 0.48
Return Format
The query returns the horizontal or vertical adjustment parameter of the pass/fail test mask in scientific notation.
MSO2000A/DS2000A Programming Guide 2-137
RIGOL
:MASK:CREate
Syntax
:MASK:CREate
Description
Create the mask of the pass/fail test using the horizontal adjustment parameter and the vertical adjustment parameter currently set.
Explanation
This command is valid only when the pass/fail test function is enabled ( :MASK:ENABle ) and is in
running state ( :MASK:OPERate ).
:MASK:PASSed?
Syntax
:MASK:PASSed?
Description
Query the number of frames that pass the pass/fail test.
Return Format
The query returns the number of frames that pass the pass/fail test in integer.
:MASK:FAILed?
Syntax
:MASK:FAILed?
Description
Query the number of failed frames in the pass/fail test.
Return Format
The query returns the number of failed frames in the pass/fail test in integer.
2-138 MSO2000A/DS2000A Programming Guide
RIGOL
:MASK:TOTal?
Syntax
:MASK:TOTal?
Description
Query the total number of frames of the pass/fail test.
Return Format
The query returns the total number of frames of the pass/fail test in integer.
:MASK:RESet
Syntax
:MASK:RESet
Description
Reset the number of passed frames, the number of failed frames and the total number of frames.
Explanation
After sending this command, the number of passed frames, the number of failed frames and the total number of frames are all set to 0.
To query the number of passed frames, refer to the :MASK:PASSed?
To query the number of failed frames, refer to the :MASK:FAILed?
To query the total number of frames of the test, refer to the :MASK:TOTal?
MSO2000A/DS2000A Programming Guide 2-139
RIGOL
:MASK:DATA
Syntax
:MASK:DATA <mask>
:MASK:DATA?
Description
Send or read the mask of the pass/fail test.
Parameter
Name Type Range Default
<mask>
Explanation
Refer to the Explanation
<mask> is binary data block. Directly place the data stream behind the command string to finish the sending in one operation.
Make sure that the buffer is large enough to receive the data stream; otherwise the program might be abnormal when reading the data.
Return Format
The data returned consists of two parts (the TMC data description header and the MASK data). The format of the TMC data description header is #NX…X; wherein, # is the denoter, N is less than or equal to
9 and the N figures following it denotes the length of the data stream in bytes. For example,
#9000001408; wherein, N is 9 and 000001408 denotes that the data strem contains 1408 bytes of effective data. The MASK data is denoted in ASCII format.
2-140 MSO2000A/DS2000A Programming Guide
advertisement
Related manuals
advertisement