Coupling Trigger Subsystem Module - coupling.py¶
-
class
ds2000.trigger.coupling.Coupling(subdevice)¶ Bases:
ds2000.common.SubController-
ac()¶ Rigol Programming Guide
Syntax
:TRIGger:COUPling <couple> :TRIGger:COUPling?
Description
Select the desired trigger coupling mode. Query the current trigger coupling mode.
Parameter
Name
Type
Range
Default
<couple>
Discrete
{AC|DC|LFReject|HFReject}
DC
Explanation
It is only available in edge trigger.
Return Format
The query returns AC, DC, LFR or HFR.
Example
:TRIGger:COUPling LFReject The query returns LFR.
- Return type
None
-
dc()¶ Rigol Programming Guide
Syntax
:TRIGger:COUPling <couple> :TRIGger:COUPling?
Description
Select the desired trigger coupling mode. Query the current trigger coupling mode.
Parameter
Name
Type
Range
Default
<couple>
Discrete
{AC|DC|LFReject|HFReject}
DC
Explanation
It is only available in edge trigger.
Return Format
The query returns AC, DC, LFR or HFR.
Example
:TRIGger:COUPling LFReject The query returns LFR.
- Return type
None
-
high_frequency_reject()¶ Rigol Programming Guide
Syntax
:TRIGger:COUPling <couple> :TRIGger:COUPling?
Description
Select the desired trigger coupling mode. Query the current trigger coupling mode.
Parameter
Name
Type
Range
Default
<couple>
Discrete
{AC|DC|LFReject|HFReject}
DC
Explanation
It is only available in edge trigger.
Return Format
The query returns AC, DC, LFR or HFR.
Example
:TRIGger:COUPling LFReject The query returns LFR.
- Return type
None
-
low_frequency_reject()¶ Rigol Programming Guide
Syntax
:TRIGger:COUPling <couple> :TRIGger:COUPling?
Description
Select the desired trigger coupling mode. Query the current trigger coupling mode.
Parameter
Name
Type
Range
Default
<couple>
Discrete
{AC|DC|LFReject|HFReject}
DC
Explanation
It is only available in edge trigger.
Return Format
The query returns AC, DC, LFR or HFR.
Example
:TRIGger:COUPling LFReject The query returns LFR.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:COUPling <couple> :TRIGger:COUPling?
Description
Select the desired trigger coupling mode. Query the current trigger coupling mode.
Parameter
Name
Type
Range
Default
<couple>
Discrete
{AC|DC|LFReject|HFReject}
DC
Explanation
It is only available in edge trigger.
Return Format
The query returns AC, DC, LFR or HFR.
Example
:TRIGger:COUPling LFReject The query returns LFR.
- Return type
str
-
Delay Trigger Subsystem Module - delay.py¶
-
class
ds2000.trigger.delay.Delay(device)¶ Bases:
ds2000.common.SubController-
get_lower_limit()¶ ToDo: The range in the note is the same as in the table? Rigol Programming Guide
Syntax
:TRIGger:DELay:TLOWer <NR3> :TRIGger:DELay:TLOWer?
Description
Set the lower limit of the delay time in delay trigger. Query the current lower limit of the delay time in delay trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
2ns to 3.99s
1μs
Note: when the delay type is GLESs or GOUT, the range is from 2ns to 3.99s.
Explanation
This command is available when the delay type (refer to the :TRIGger:DELay:TYPe command) is LESS, GOUT or GLESs.
Return Format
The query returns the lower limit of the delay time in scientific notation.
Example
:TRIGger:DELay:TLOWer 0.002 The query returns 2.000000e-03.
- Return type
float
-
get_signal(source)¶ source must be “a”, “b”, “A”, “B” 1 or 2 channel must be 1 or 2
Rigol Programming Guide
Syntax
:TRIGger:DELay:SA <Source> :TRIGger:DELay:SA?
:TRIGger:DELay:SB <Source> :TRIGger:DELay:SB?
Description
Select the trigger source of signal source A in delay trigger. Query the current trigger source of signal source A in delay trigger.
Select the trigger source of signal source B in delay trigger. Query the current trigger source of signal source B in delay trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:DELay:SA CHANnel2 The query returns CHAN2.
:TRIGger:DELay:SB CHANnel2 The query returns CHAN2.
- Return type
int
-
get_upper_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:DELay:TUPPer <NR3> :TRIGger:DELay:TUPPer?
Description
Set the upper limit of the delay time in delay trigger. Query the current upper limit of the delay time in delay trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
2ns to 4s
2μs
Note: when the delay type is GLESs or GOUT, the range is from 12ns to 4s.
Explanation
This command is available when the delay type (refer to the :TRIGger:DELay:TYPe command) is LESS, GOUT or GLESs.
Return Format
The query returns the upper limit of the delay time in scientific notation.
Example
:TRIGger:DELay:TUPPer 0.002 The query returns 2.000000e-03.
- Return type
float
-
set_lower_limit(time=1e-06)¶ ToDo: The range in the note is the same as in the table? Rigol Programming Guide
Syntax
:TRIGger:DELay:TLOWer <NR3> :TRIGger:DELay:TLOWer?
Description
Set the lower limit of the delay time in delay trigger. Query the current lower limit of the delay time in delay trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
2ns to 3.99s
1μs
Note: when the delay type is GLESs or GOUT, the range is from 2ns to 3.99s.
Explanation
This command is available when the delay type (refer to the :TRIGger:DELay:TYPe command) is LESS, GOUT or GLESs.
Return Format
The query returns the lower limit of the delay time in scientific notation.
Example
:TRIGger:DELay:TLOWer 0.002 The query returns 2.000000e-03.
- Return type
None
-
set_signal(source, channel)¶ source must be “a”, “b”, “A”, “B” 1 or 2 channel must be 1 or 2
Rigol Programming Guide
Syntax
:TRIGger:DELay:SA <Source> :TRIGger:DELay:SA?
:TRIGger:DELay:SB <Source> :TRIGger:DELay:SB?
Description
Select the trigger source of signal source A in delay trigger. Query the current trigger source of signal source A in delay trigger.
Select the trigger source of signal source B in delay trigger. Query the current trigger source of signal source B in delay trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:DELay:SA CHANnel2 The query returns CHAN2.
:TRIGger:DELay:SB CHANnel2 The query returns CHAN2.
- Return type
None
-
set_slope(source, positive=True)¶ Rigol Programming Guide
Syntax :TRIGger:DELay:SLOPA <slope> :TRIGger:DELay:SLOPA?
:TRIGger:DELay:SLOPB <slope> :TRIGger:DELay:SLOPB?
Description
Set the edge type of edge A of delay trigger. Query the current edge type of edge A of delay trigger.
Set the edge type of edge B of delay trigger. Query the current edge type of edge B of delay trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:DELay:SLOPA NEGative The query returns NEG.
:TRIGger:DELay:SLOPB NEGative The query returns NEG.
- Return type
None
-
set_upper_limit(time=2e-09)¶ Rigol Programming Guide
Syntax
:TRIGger:DELay:TUPPer <NR3> :TRIGger:DELay:TUPPer?
Description
Set the upper limit of the delay time in delay trigger. Query the current upper limit of the delay time in delay trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
2ns to 4s
2μs
Note: when the delay type is GLESs or GOUT, the range is from 12ns to 4s.
Explanation
This command is available when the delay type (refer to the :TRIGger:DELay:TYPe command) is LESS, GOUT or GLESs.
Return Format
The query returns the upper limit of the delay time in scientific notation.
Example
:TRIGger:DELay:TUPPer 0.002 The query returns 2.000000e-03.
- Return type
None
-
slope_is_positive(source)¶ Rigol Programming Guide
Syntax :TRIGger:DELay:SLOPA <slope> :TRIGger:DELay:SLOPA?
:TRIGger:DELay:SLOPB <slope> :TRIGger:DELay:SLOPB?
Description
Set the edge type of edge A of delay trigger. Query the current edge type of edge A of delay trigger.
Set the edge type of edge B of delay trigger. Query the current edge type of edge B of delay trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:DELay:SLOPA NEGative The query returns NEG.
:TRIGger:DELay:SLOPB NEGative The query returns NEG.
- Return type
bool
-
-
class
ds2000.trigger.delay.DelayType(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
between()¶ Rigol Programming Guide
Syntax
:TRIGger:DELay:TYPe <type> :TRIGger:DELay:TYPe?
Description
Set the delay type of delay trigger. Query the current delay type of delay trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{GREater|LESS|GLESs|GOUT}
GREater
Explanation
GREater: trigger when the time difference (△T) between the specified edges of source A and source B is greater than the preset time limit (refer to the :TRIGger:DELay:TLOWer command).
LESS: trigger when the time difference (△T) between the specified edges of source A and source B is lower than the preset time limit (refer to the :TRIGger:DELay:TUPPer command).
GLESs: trigger when the time difference (△T) between the specified edges of source A and source B is greater than the lower limit of the preset time (refer to the :TRIGger:DELay:TLOWer command) and lower than the upper limit of the preset time (refer to the :TRIGger:DELay:TUPPer command). Note that the time lower limit must be lower than the time upper limit.
GOUT: trigger when the time difference (△T) between the specified edges of source A and source B is lower than the lower limit of the preset time (refer to the :TRIGger:DELay:TLOWer command) or greater than the upper limit of the preset time (refer to the :TRIGger:DELay:TUPPer command). Note that the time lower
limit must be lower than the time upper limit.
Return Format
The query returns GOUT, GRE, LESS or GLES.
Example
:TRIGger:DELay:TYPe GOUT The query returns GOUT.
- Return type
None
-
greater()¶ Rigol Programming Guide
Syntax
:TRIGger:DELay:TYPe <type> :TRIGger:DELay:TYPe?
Description
Set the delay type of delay trigger. Query the current delay type of delay trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{GREater|LESS|GLESs|GOUT}
GREater
Explanation
GREater: trigger when the time difference (△T) between the specified edges of source A and source B is greater than the preset time limit (refer to the :TRIGger:DELay:TLOWer command).
LESS: trigger when the time difference (△T) between the specified edges of source A and source B is lower than the preset time limit (refer to the :TRIGger:DELay:TUPPer command).
GLESs: trigger when the time difference (△T) between the specified edges of source A and source B is greater than the lower limit of the preset time (refer to the :TRIGger:DELay:TLOWer command) and lower than the upper limit of the preset time (refer to the :TRIGger:DELay:TUPPer command). Note that the time lower limit must be lower than the time upper limit.
GOUT: trigger when the time difference (△T) between the specified edges of source A and source B is lower than the lower limit of the preset time (refer to the :TRIGger:DELay:TLOWer command) or greater than the upper limit of the preset time (refer to the :TRIGger:DELay:TUPPer command). Note that the time lower
limit must be lower than the time upper limit.
Return Format
The query returns GOUT, GRE, LESS or GLES.
Example
:TRIGger:DELay:TYPe GOUT The query returns GOUT.
- Return type
None
-
less()¶ Rigol Programming Guide
Syntax
:TRIGger:DELay:TYPe <type> :TRIGger:DELay:TYPe?
Description
Set the delay type of delay trigger. Query the current delay type of delay trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{GREater|LESS|GLESs|GOUT}
GREater
Explanation
GREater: trigger when the time difference (△T) between the specified edges of source A and source B is greater than the preset time limit (refer to the :TRIGger:DELay:TLOWer command).
LESS: trigger when the time difference (△T) between the specified edges of source A and source B is lower than the preset time limit (refer to the :TRIGger:DELay:TUPPer command).
GLESs: trigger when the time difference (△T) between the specified edges of source A and source B is greater than the lower limit of the preset time (refer to the :TRIGger:DELay:TLOWer command) and lower than the upper limit of the preset time (refer to the :TRIGger:DELay:TUPPer command). Note that the time lower limit must be lower than the time upper limit.
GOUT: trigger when the time difference (△T) between the specified edges of source A and source B is lower than the lower limit of the preset time (refer to the :TRIGger:DELay:TLOWer command) or greater than the upper limit of the preset time (refer to the :TRIGger:DELay:TUPPer command). Note that the time lower
limit must be lower than the time upper limit.
Return Format
The query returns GOUT, GRE, LESS or GLES.
Example
:TRIGger:DELay:TYPe GOUT The query returns GOUT.
- Return type
None
-
outside()¶ Rigol Programming Guide
Syntax
:TRIGger:DELay:TYPe <type> :TRIGger:DELay:TYPe?
Description
Set the delay type of delay trigger. Query the current delay type of delay trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{GREater|LESS|GLESs|GOUT}
GREater
Explanation
GREater: trigger when the time difference (△T) between the specified edges of source A and source B is greater than the preset time limit (refer to the :TRIGger:DELay:TLOWer command).
LESS: trigger when the time difference (△T) between the specified edges of source A and source B is lower than the preset time limit (refer to the :TRIGger:DELay:TUPPer command).
GLESs: trigger when the time difference (△T) between the specified edges of source A and source B is greater than the lower limit of the preset time (refer to the :TRIGger:DELay:TLOWer command) and lower than the upper limit of the preset time (refer to the :TRIGger:DELay:TUPPer command). Note that the time lower limit must be lower than the time upper limit.
GOUT: trigger when the time difference (△T) between the specified edges of source A and source B is lower than the lower limit of the preset time (refer to the :TRIGger:DELay:TLOWer command) or greater than the upper limit of the preset time (refer to the :TRIGger:DELay:TUPPer command). Note that the time lower
limit must be lower than the time upper limit.
Return Format
The query returns GOUT, GRE, LESS or GLES.
Example
:TRIGger:DELay:TYPe GOUT The query returns GOUT.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:DELay:TYPe <type> :TRIGger:DELay:TYPe?
Description
Set the delay type of delay trigger. Query the current delay type of delay trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{GREater|LESS|GLESs|GOUT}
GREater
Explanation
GREater: trigger when the time difference (△T) between the specified edges of source A and source B is greater than the preset time limit (refer to the :TRIGger:DELay:TLOWer command).
LESS: trigger when the time difference (△T) between the specified edges of source A and source B is lower than the preset time limit (refer to the :TRIGger:DELay:TUPPer command).
GLESs: trigger when the time difference (△T) between the specified edges of source A and source B is greater than the lower limit of the preset time (refer to the :TRIGger:DELay:TLOWer command) and lower than the upper limit of the preset time (refer to the :TRIGger:DELay:TUPPer command). Note that the time lower limit must be lower than the time upper limit.
GOUT: trigger when the time difference (△T) between the specified edges of source A and source B is lower than the lower limit of the preset time (refer to the :TRIGger:DELay:TLOWer command) or greater than the upper limit of the preset time (refer to the :TRIGger:DELay:TUPPer command). Note that the time lower
limit must be lower than the time upper limit.
Return Format
The query returns GOUT, GRE, LESS or GLES.
Example
:TRIGger:DELay:TYPe GOUT The query returns GOUT.
- Return type
-
Duration Trigger Subsystem Module - duration.py¶
-
class
ds2000.trigger.duration.Duration(device)¶ Bases:
ds2000.common.SubController-
get_lower_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:DURATion:TLOWer <NR3> :TRIGger:DURATion:TLOWer?
Description
Set the lower limit of the duration in duration trigger and the unit is s. Query the current lower limit of the duration in duration trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
2ns to 4s
1μs
Note: when the trigger condition is GLESs, the range is from 2ns to 3.99s.
Explanation
This command is available when the trigger condition (refer to the :TRIGger:DURATion:WHEN command) is set to GREater or GLESs.
Return Format
The query returns the lower limit of the duration in scientific notation.
Example
:TRIGger:DURATion:TLOWer 0.000003 The query returns 3.000000e-06.
- Return type
float
-
get_source()¶ Rigol Programming Guide
Syntax
:TRIGger:DURATion:SOURce <source> :TRIGger:DURATion:SOURce?
Description
Select the trigger source of duration trigger. Query the current trigger source of duration trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:DURATion:SOURce CHANnel2 The query returns CHAN2.
- Return type
int
-
get_type()¶ Rigol Programming Guide
Syntax
:TRIGger:DURATion:TYPe <type> :TRIGger:DURATion:TYPe?
Description
Set the current patterns of the channels. Query the current patterns of the channels.
Parameter
Name
Type
Range
Default
<type>
Discrete
{H,L,X}
H,L
Note: the default patterns of CH1 and CH2 from the left to right.
Return Format
The query returns the current patterns of the two channels.
Example
:TRIGger:DURATion:TYPe L,X The query returns L,X.
- Return type
str
-
get_upper_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:DURATion:TUPPer <NR3> :TRIGger:DURATion:TUPPer?
Description
Set the upper limit of the duration in duration trigger and the unit is s. Query the current upper limit of the duration in duration trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
2ns to 4s
2μs
Note: when the trigger condition is GLESs, the range is from 12ns to 4s.
Explanation
This command is available when the trigger condition (refer to the :TRIGger:DURATion:WHEN command) is set to LESS or GLESs.
Return Format
The query returns the upper limit of the duration in scientific notation.
Example
:TRIGger:DURATion:TUPPer 0.000003 The query returns 3.000000e-06.
- Return type
float
-
set_lower_limit(time=1e-06)¶ Rigol Programming Guide
Syntax
:TRIGger:DURATion:TLOWer <NR3> :TRIGger:DURATion:TLOWer?
Description
Set the lower limit of the duration in duration trigger and the unit is s. Query the current lower limit of the duration in duration trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
2ns to 4s
1μs
Note: when the trigger condition is GLESs, the range is from 2ns to 3.99s.
Explanation
This command is available when the trigger condition (refer to the :TRIGger:DURATion:WHEN command) is set to GREater or GLESs.
Return Format
The query returns the lower limit of the duration in scientific notation.
Example
:TRIGger:DURATion:TLOWer 0.000003 The query returns 3.000000e-06.
- Return type
None
-
set_source(channel=1)¶ Rigol Programming Guide
Syntax
:TRIGger:DURATion:SOURce <source> :TRIGger:DURATion:SOURce?
Description
Select the trigger source of duration trigger. Query the current trigger source of duration trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:DURATion:SOURce CHANnel2 The query returns CHAN2.
- Return type
None
-
set_type(pattern='H,L')¶ Rigol Programming Guide
Syntax
:TRIGger:DURATion:TYPe <type> :TRIGger:DURATion:TYPe?
Description
Set the current patterns of the channels. Query the current patterns of the channels.
Parameter
Name
Type
Range
Default
<type>
Discrete
{H,L,X}
H,L
Note: the default patterns of CH1 and CH2 from the left to right.
Return Format
The query returns the current patterns of the two channels.
Example
:TRIGger:DURATion:TYPe L,X The query returns L,X.
- Return type
None
-
set_upper_limit(time=2e-06)¶ Rigol Programming Guide
Syntax
:TRIGger:DURATion:TUPPer <NR3> :TRIGger:DURATion:TUPPer?
Description
Set the upper limit of the duration in duration trigger and the unit is s. Query the current upper limit of the duration in duration trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
2ns to 4s
2μs
Note: when the trigger condition is GLESs, the range is from 12ns to 4s.
Explanation
This command is available when the trigger condition (refer to the :TRIGger:DURATion:WHEN command) is set to LESS or GLESs.
Return Format
The query returns the upper limit of the duration in scientific notation.
Example
:TRIGger:DURATion:TUPPer 0.000003 The query returns 3.000000e-06.
- Return type
None
-
-
class
ds2000.trigger.duration.DurationWhen(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
duration_of_pattern_between_lower_and_upper_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:DURATion:WHEN <when> :TRIGger:DURATion:WHEN?
Description
Select the trigger condition of duration trigger. Query the current trigger condition of duration trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{GREater|LESS|GLESs}
PGReater
Explanation
GREater: you need to specify a time (refer to the :TRIGger:DURATion:TLOWer command). The oscilloscope triggers when the duration of the pattern is greater than the preset time.
LESS: you need to specify a time (refer to the :TRIGger:DURATion:TUPPer command). The oscilloscope triggers when the duration of the pattern is lower than the preset time.
GLESs: you need to specify a upper limit of time (refer to the :TRIGger:DURATion:TUPPer command) and lower limit of time (refer to the :TRIGger:DURATion:TLOWer command). The oscilloscope triggers when the duration of the pattern is lower than the preset upper limit of time and greater than the preset lower limit of time.
Return Format
The query returns GRE, LESS or GLES.
Example
:TRIGger:DURATion:WHEN LESS The query returns LESS.
- Return type
None
-
duration_of_pattern_greater_than_lower_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:DURATion:WHEN <when> :TRIGger:DURATion:WHEN?
Description
Select the trigger condition of duration trigger. Query the current trigger condition of duration trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{GREater|LESS|GLESs}
PGReater
Explanation
GREater: you need to specify a time (refer to the :TRIGger:DURATion:TLOWer command). The oscilloscope triggers when the duration of the pattern is greater than the preset time.
LESS: you need to specify a time (refer to the :TRIGger:DURATion:TUPPer command). The oscilloscope triggers when the duration of the pattern is lower than the preset time.
GLESs: you need to specify a upper limit of time (refer to the :TRIGger:DURATion:TUPPer command) and lower limit of time (refer to the :TRIGger:DURATion:TLOWer command). The oscilloscope triggers when the duration of the pattern is lower than the preset upper limit of time and greater than the preset lower limit of time.
Return Format
The query returns GRE, LESS or GLES.
Example
:TRIGger:DURATion:WHEN LESS The query returns LESS.
- Return type
None
-
duration_of_pattern_lower_than_upper_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:DURATion:WHEN <when> :TRIGger:DURATion:WHEN?
Description
Select the trigger condition of duration trigger. Query the current trigger condition of duration trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{GREater|LESS|GLESs}
PGReater
Explanation
GREater: you need to specify a time (refer to the :TRIGger:DURATion:TLOWer command). The oscilloscope triggers when the duration of the pattern is greater than the preset time.
LESS: you need to specify a time (refer to the :TRIGger:DURATion:TUPPer command). The oscilloscope triggers when the duration of the pattern is lower than the preset time.
GLESs: you need to specify a upper limit of time (refer to the :TRIGger:DURATion:TUPPer command) and lower limit of time (refer to the :TRIGger:DURATion:TLOWer command). The oscilloscope triggers when the duration of the pattern is lower than the preset upper limit of time and greater than the preset lower limit of time.
Return Format
The query returns GRE, LESS or GLES.
Example
:TRIGger:DURATion:WHEN LESS The query returns LESS.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:DURATion:WHEN <when> :TRIGger:DURATion:WHEN?
Description
Select the trigger condition of duration trigger. Query the current trigger condition of duration trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{GREater|LESS|GLESs}
PGReater
Explanation
GREater: you need to specify a time (refer to the :TRIGger:DURATion:TLOWer command). The oscilloscope triggers when the duration of the pattern is greater than the preset time.
LESS: you need to specify a time (refer to the :TRIGger:DURATion:TUPPer command). The oscilloscope triggers when the duration of the pattern is lower than the preset time.
GLESs: you need to specify a upper limit of time (refer to the :TRIGger:DURATion:TUPPer command) and lower limit of time (refer to the :TRIGger:DURATion:TLOWer command). The oscilloscope triggers when the duration of the pattern is lower than the preset upper limit of time and greater than the preset lower limit of time.
Return Format
The query returns GRE, LESS or GLES.
Example
:TRIGger:DURATion:WHEN LESS The query returns LESS.
- Return type
str
-
Edge Trigger Subsystem Module - edge.py¶
-
class
ds2000.trigger.edge.Edge(device)¶ Bases:
ds2000.common.SubController-
get_level()¶ Rigol Programming Guide
Syntax
:TRIGger:EDGe:LEVel <level> :TRIGger:EDGe:LEVel?
Description
Set the trigger level of edge trigger and the unit is the same with the current amplitude unit. Query the current trigger level of edge trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:EDGe:LEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
set_level(level=0.0)¶ Rigol Programming Guide
Syntax
:TRIGger:EDGe:LEVel <level> :TRIGger:EDGe:LEVel?
Description
Set the trigger level of edge trigger and the unit is the same with the current amplitude unit. Query the current trigger level of edge trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:EDGe:LEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
-
class
ds2000.trigger.edge.EdgeSlope(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
both_edges()¶ Rigol Programming Guide
Syntax
:TRIGger:EDGe:SLOPe <slope> :TRIGger:EDGe:SLOPe?
Description
Select the edge type of edge trigger. Query the current edge type of edge trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative|RFALl}
POSitive
Return Format
The query returns POS, NEG or RFAL.
Example
:TRIGger:EDGe:SLOPe NEGative The query returns NEG.
- Return type
None
-
falling_edge()¶ Rigol Programming Guide
Syntax
:TRIGger:EDGe:SLOPe <slope> :TRIGger:EDGe:SLOPe?
Description
Select the edge type of edge trigger. Query the current edge type of edge trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative|RFALl}
POSitive
Return Format
The query returns POS, NEG or RFAL.
Example
:TRIGger:EDGe:SLOPe NEGative The query returns NEG.
- Return type
None
-
rising_edge()¶ Rigol Programming Guide
Syntax
:TRIGger:EDGe:SLOPe <slope> :TRIGger:EDGe:SLOPe?
Description
Select the edge type of edge trigger. Query the current edge type of edge trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative|RFALl}
POSitive
Return Format
The query returns POS, NEG or RFAL.
Example
:TRIGger:EDGe:SLOPe NEGative The query returns NEG.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:EDGe:SLOPe <slope> :TRIGger:EDGe:SLOPe?
Description
Select the edge type of edge trigger. Query the current edge type of edge trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative|RFALl}
POSitive
Return Format
The query returns POS, NEG or RFAL.
Example
:TRIGger:EDGe:SLOPe NEGative The query returns NEG.
- Return type
str
-
-
class
ds2000.trigger.edge.EdgeSource(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
ac_line()¶ Rigol Programming Guide
Syntax
:TRIGger:EDGe:SOURce <source> :TRIGger:EDGe:SOURce?
Description
Select the trigger source of edge trigger. Query the current trigger source of edge trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2|EXT|ACLine}
CHANnel1
Return Format
The query returns CHAN1, CHAN2, EXT or ACL.
Example
:TRIGger:EDGe:SOURce CHANnel2 The query returns CHAN2.
- Return type
None
-
channel1()¶ Rigol Programming Guide
Syntax
:TRIGger:EDGe:SOURce <source> :TRIGger:EDGe:SOURce?
Description
Select the trigger source of edge trigger. Query the current trigger source of edge trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2|EXT|ACLine}
CHANnel1
Return Format
The query returns CHAN1, CHAN2, EXT or ACL.
Example
:TRIGger:EDGe:SOURce CHANnel2 The query returns CHAN2.
- Return type
None
-
channel2()¶ Rigol Programming Guide
Syntax
:TRIGger:EDGe:SOURce <source> :TRIGger:EDGe:SOURce?
Description
Select the trigger source of edge trigger. Query the current trigger source of edge trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2|EXT|ACLine}
CHANnel1
Return Format
The query returns CHAN1, CHAN2, EXT or ACL.
Example
:TRIGger:EDGe:SOURce CHANnel2 The query returns CHAN2.
- Return type
None
-
ext()¶ Rigol Programming Guide
Syntax
:TRIGger:EDGe:SOURce <source> :TRIGger:EDGe:SOURce?
Description
Select the trigger source of edge trigger. Query the current trigger source of edge trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2|EXT|ACLine}
CHANnel1
Return Format
The query returns CHAN1, CHAN2, EXT or ACL.
Example
:TRIGger:EDGe:SOURce CHANnel2 The query returns CHAN2.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:EDGe:SOURce <source> :TRIGger:EDGe:SOURce?
Description
Select the trigger source of edge trigger. Query the current trigger source of edge trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2|EXT|ACLine}
CHANnel1
Return Format
The query returns CHAN1, CHAN2, EXT or ACL.
Example
:TRIGger:EDGe:SOURce CHANnel2 The query returns CHAN2.
- Return type
str
-
I2C Trigger Subsystem Module - i2c.py¶
-
class
ds2000.trigger.i2c.I2C(device)¶ Bases:
ds2000.common.SubController-
get_address()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:ADDRess <adr> :TRIGger:IIC:ADDRess?
Description
Set the address value in IIC trigger when the trigger condition is Address or A&D. Query the current address value in IIC trigger when the trigger condition is Address or A&D.
Parameter
Name
Type
Range
Default
<adr>
Integer
0 to $ 2^{n} – 1 $: 0 to 127, 0 to 255 or 0 to 1023
1
Note: in the expression 2n - 1, n is the current address bits (refer to the :TRIGger:IIC:AWIDth command).
Explanation
To set the IIC trigger condition, refer to the :TRIGger:IIC:WHEN command.
Return Format
The query returns an integer.
Example
:TRIGger:IIC:ADDRess 100 The query returns 100.
- Return type
int
-
get_address_bits_width()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:AWIDth <bits> :TRIGger:IIC:AWIDth?
Description
Set the address bits in IIC trigger when the trigger condition is Address or A&D. Query the current address bits in IIC trigger when the trigger condition is Address or A&D.
Parameter
Name
Type
Range
Default
<bits>
Discrete
{7|8|10}
7
Explanation
To set the IIC trigger condition, refer to the :TRIGger:IIC:WHEN command.
Return Format
The query returns 7, 8 or 10.
Example
:TRIGger:IIC:AWIDth 10 The query returns 10.
- Return type
int
-
get_data()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:DATA <dat> :TRIGger:IIC:DATA?
Description
Set the data value in IIC trigger when the trigger condition is Data or A&D. Query the current data value in IIC trigger when the trigger condition is Data or A&D.
Parameter
Name
Type
Range
Default
<dat>
Integer
0 to 240 - 1
0
Explanation
To set the IIC trigger condition, refer to the :TRIGger:IIC:WHEN command.
Return Format
The query returns an integer.
Example
:TRIGger:IIC:DATA 64 The query returns 64.
- Return type
int
-
get_scl_source()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:SCL <source> :TRIGger:IIC:SCL?
Description
Select the SCL channel source in IIC trigger. Query the current SCL channel source in IIC trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:IIC:SCL CHANnel2 The query returns CHAN2.
- Return type
str
-
get_scl_trigger_level()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:CLEVel <level> :TRIGger:IIC:CLEVel?
Description
Set the trigger level of SCL in IIC trigger and the unit is the same with the current amplitude unit. Query the current trigger level of SCL in IIC trigger.
Parameter
Name
Type
Range
Default
<level>
Real
- ± 5 × VerticalScale from
the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command.
For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:IIC:CLEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
get_sda_source()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:SDA <source> :TRIGger:IIC:SDA?
Description
Select the SDA channel source in IIC trigger. Query the current SDA channel source in IIC trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel2
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:IIC:SDA CHANnel2 The query returns CHAN2.
- Return type
str
-
get_sda_trigger_level()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:DLEVel <level> :TRIGger:IIC:DLEVel?
Description
Set the trigger level of SDA in IIC trigger and the unit is the same with the current amplitude unit. Query the current trigger level of SDA in IIC trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command.
For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:IIC:DLEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
set_address(address=1)¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:ADDRess <adr> :TRIGger:IIC:ADDRess?
Description
Set the address value in IIC trigger when the trigger condition is Address or A&D. Query the current address value in IIC trigger when the trigger condition is Address or A&D.
Parameter
Name
Type
Range
Default
<adr>
Integer
0 to $ 2^{n} – 1 $: 0 to 127, 0 to 255 or 0 to 1023
1
Note: in the expression 2n - 1, n is the current address bits (refer to the :TRIGger:IIC:AWIDth command).
Explanation
To set the IIC trigger condition, refer to the :TRIGger:IIC:WHEN command.
Return Format
The query returns an integer.
Example
:TRIGger:IIC:ADDRess 100 The query returns 100.
- Return type
None
-
set_address_bits_width(address_width=7)¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:AWIDth <bits> :TRIGger:IIC:AWIDth?
Description
Set the address bits in IIC trigger when the trigger condition is Address or A&D. Query the current address bits in IIC trigger when the trigger condition is Address or A&D.
Parameter
Name
Type
Range
Default
<bits>
Discrete
{7|8|10}
7
Explanation
To set the IIC trigger condition, refer to the :TRIGger:IIC:WHEN command.
Return Format
The query returns 7, 8 or 10.
Example
:TRIGger:IIC:AWIDth 10 The query returns 10.
- Return type
None
-
set_data(data_value=0)¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:DATA <dat> :TRIGger:IIC:DATA?
Description
Set the data value in IIC trigger when the trigger condition is Data or A&D. Query the current data value in IIC trigger when the trigger condition is Data or A&D.
Parameter
Name
Type
Range
Default
<dat>
Integer
0 to 240 - 1
0
Explanation
To set the IIC trigger condition, refer to the :TRIGger:IIC:WHEN command.
Return Format
The query returns an integer.
Example
:TRIGger:IIC:DATA 64 The query returns 64.
- Return type
None
-
set_scl_source(channel=1)¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:SCL <source> :TRIGger:IIC:SCL?
Description
Select the SCL channel source in IIC trigger. Query the current SCL channel source in IIC trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:IIC:SCL CHANnel2 The query returns CHAN2.
- Return type
None
-
set_scl_trigger_level(level=0)¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:CLEVel <level> :TRIGger:IIC:CLEVel?
Description
Set the trigger level of SCL in IIC trigger and the unit is the same with the current amplitude unit. Query the current trigger level of SCL in IIC trigger.
Parameter
Name
Type
Range
Default
<level>
Real
- ± 5 × VerticalScale from
the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command.
For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:IIC:CLEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
set_sda_source(channel=2)¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:SDA <source> :TRIGger:IIC:SDA?
Description
Select the SDA channel source in IIC trigger. Query the current SDA channel source in IIC trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel2
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:IIC:SDA CHANnel2 The query returns CHAN2.
- Return type
None
-
set_sda_trigger_level(level=0)¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:DLEVel <level> :TRIGger:IIC:DLEVel?
Description
Set the trigger level of SDA in IIC trigger and the unit is the same with the current amplitude unit. Query the current trigger level of SDA in IIC trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command.
For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:IIC:DLEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
-
class
ds2000.trigger.i2c.I2CDirection(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
read()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:DIRection <dir> :TRIGger:IIC:DIRection?
Description
Set the data direction in IIC trigger when the trigger condition is Address or A&D. Query the current data direction in IIC trigger when the trigger condition is Address or A&D.
Parameter
Name
Type
Range
Default
<dir>
Discrete
{READ|WRITe|RWRite}
READ
Explanation
To set the IIC trigger condition, refer to the :TRIGger:IIC:WHEN command.
Return Format
The query returns READ, WRIT or RWR.
Example
:TRIGger:IIC:DIRection RWRite The query returns RWR.
- Return type
None
-
read_write()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:DIRection <dir> :TRIGger:IIC:DIRection?
Description
Set the data direction in IIC trigger when the trigger condition is Address or A&D. Query the current data direction in IIC trigger when the trigger condition is Address or A&D.
Parameter
Name
Type
Range
Default
<dir>
Discrete
{READ|WRITe|RWRite}
READ
Explanation
To set the IIC trigger condition, refer to the :TRIGger:IIC:WHEN command.
Return Format
The query returns READ, WRIT or RWR.
Example
:TRIGger:IIC:DIRection RWRite The query returns RWR.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:DIRection <dir> :TRIGger:IIC:DIRection?
Description
Set the data direction in IIC trigger when the trigger condition is Address or A&D. Query the current data direction in IIC trigger when the trigger condition is Address or A&D.
Parameter
Name
Type
Range
Default
<dir>
Discrete
{READ|WRITe|RWRite}
READ
Explanation
To set the IIC trigger condition, refer to the :TRIGger:IIC:WHEN command.
Return Format
The query returns READ, WRIT or RWR.
Example
:TRIGger:IIC:DIRection RWRite The query returns RWR.
- Return type
str
-
write()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:DIRection <dir> :TRIGger:IIC:DIRection?
Description
Set the data direction in IIC trigger when the trigger condition is Address or A&D. Query the current data direction in IIC trigger when the trigger condition is Address or A&D.
Parameter
Name
Type
Range
Default
<dir>
Discrete
{READ|WRITe|RWRite}
READ
Explanation
To set the IIC trigger condition, refer to the :TRIGger:IIC:WHEN command.
Return Format
The query returns READ, WRIT or RWR.
Example
:TRIGger:IIC:DIRection RWRite The query returns RWR.
- Return type
None
-
-
class
ds2000.trigger.i2c.I2CWhen(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
address()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:WHEN <trig_type> :TRIGger:IIC:WHEN?
Description
Set the trigger condition of IIC trigger. Query the current trigger condition of IIC trigger.
Parameter
Name
Type
Range
Default
<trig_type>
Discrete
{STARt|RESTart|STOP|NACKnowledge| ADDRess|DATA|ADATa}
STARt
Explanation
STARt: trigger when SDA data transitions from high to low while SCL is high.
RESTart: trigger when another start condition occurs before a stop condition.
STOP: trigger when SDA data transitions from low to high while SCL is high.
NACKnowledge: trigger when the SDA data is high during any acknowledgement of SCL clock position.
ADDRess: trigger on the clock (SCL) edge corresponding to the byte of data (SDA) behind the preset address (Write, Read or R/W direction).
DATA: the trigger searches for the control byte value on the data line (SDA) following which there is a reading bit and an acknowledgement bit and then searches for the specified data value.
- ADATa: trigger when the “Address” and “Data” conditions are met at the
same time.
Return Format
The query returns STAR, STOP, NACK, REST, ADDR, DATA or ADAT.
Example
:TRIGger:IIC:WHEN RESTart The query returns REST.
- Return type
None
-
address_and_data()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:WHEN <trig_type> :TRIGger:IIC:WHEN?
Description
Set the trigger condition of IIC trigger. Query the current trigger condition of IIC trigger.
Parameter
Name
Type
Range
Default
<trig_type>
Discrete
{STARt|RESTart|STOP|NACKnowledge| ADDRess|DATA|ADATa}
STARt
Explanation
STARt: trigger when SDA data transitions from high to low while SCL is high.
RESTart: trigger when another start condition occurs before a stop condition.
STOP: trigger when SDA data transitions from low to high while SCL is high.
NACKnowledge: trigger when the SDA data is high during any acknowledgement of SCL clock position.
ADDRess: trigger on the clock (SCL) edge corresponding to the byte of data (SDA) behind the preset address (Write, Read or R/W direction).
DATA: the trigger searches for the control byte value on the data line (SDA) following which there is a reading bit and an acknowledgement bit and then searches for the specified data value.
- ADATa: trigger when the “Address” and “Data” conditions are met at the
same time.
Return Format
The query returns STAR, STOP, NACK, REST, ADDR, DATA or ADAT.
Example
:TRIGger:IIC:WHEN RESTart The query returns REST.
- Return type
None
-
data()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:WHEN <trig_type> :TRIGger:IIC:WHEN?
Description
Set the trigger condition of IIC trigger. Query the current trigger condition of IIC trigger.
Parameter
Name
Type
Range
Default
<trig_type>
Discrete
{STARt|RESTart|STOP|NACKnowledge| ADDRess|DATA|ADATa}
STARt
Explanation
STARt: trigger when SDA data transitions from high to low while SCL is high.
RESTart: trigger when another start condition occurs before a stop condition.
STOP: trigger when SDA data transitions from low to high while SCL is high.
NACKnowledge: trigger when the SDA data is high during any acknowledgement of SCL clock position.
ADDRess: trigger on the clock (SCL) edge corresponding to the byte of data (SDA) behind the preset address (Write, Read or R/W direction).
DATA: the trigger searches for the control byte value on the data line (SDA) following which there is a reading bit and an acknowledgement bit and then searches for the specified data value.
- ADATa: trigger when the “Address” and “Data” conditions are met at the
same time.
Return Format
The query returns STAR, STOP, NACK, REST, ADDR, DATA or ADAT.
Example
:TRIGger:IIC:WHEN RESTart The query returns REST.
- Return type
None
-
nack()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:WHEN <trig_type> :TRIGger:IIC:WHEN?
Description
Set the trigger condition of IIC trigger. Query the current trigger condition of IIC trigger.
Parameter
Name
Type
Range
Default
<trig_type>
Discrete
{STARt|RESTart|STOP|NACKnowledge| ADDRess|DATA|ADATa}
STARt
Explanation
STARt: trigger when SDA data transitions from high to low while SCL is high.
RESTart: trigger when another start condition occurs before a stop condition.
STOP: trigger when SDA data transitions from low to high while SCL is high.
NACKnowledge: trigger when the SDA data is high during any acknowledgement of SCL clock position.
ADDRess: trigger on the clock (SCL) edge corresponding to the byte of data (SDA) behind the preset address (Write, Read or R/W direction).
DATA: the trigger searches for the control byte value on the data line (SDA) following which there is a reading bit and an acknowledgement bit and then searches for the specified data value.
- ADATa: trigger when the “Address” and “Data” conditions are met at the
same time.
Return Format
The query returns STAR, STOP, NACK, REST, ADDR, DATA or ADAT.
Example
:TRIGger:IIC:WHEN RESTart The query returns REST.
- Return type
None
-
restart()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:WHEN <trig_type> :TRIGger:IIC:WHEN?
Description
Set the trigger condition of IIC trigger. Query the current trigger condition of IIC trigger.
Parameter
Name
Type
Range
Default
<trig_type>
Discrete
{STARt|RESTart|STOP|NACKnowledge| ADDRess|DATA|ADATa}
STARt
Explanation
STARt: trigger when SDA data transitions from high to low while SCL is high.
RESTart: trigger when another start condition occurs before a stop condition.
STOP: trigger when SDA data transitions from low to high while SCL is high.
NACKnowledge: trigger when the SDA data is high during any acknowledgement of SCL clock position.
ADDRess: trigger on the clock (SCL) edge corresponding to the byte of data (SDA) behind the preset address (Write, Read or R/W direction).
DATA: the trigger searches for the control byte value on the data line (SDA) following which there is a reading bit and an acknowledgement bit and then searches for the specified data value.
- ADATa: trigger when the “Address” and “Data” conditions are met at the
same time.
Return Format
The query returns STAR, STOP, NACK, REST, ADDR, DATA or ADAT.
Example
:TRIGger:IIC:WHEN RESTart The query returns REST.
- Return type
None
-
start()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:WHEN <trig_type> :TRIGger:IIC:WHEN?
Description
Set the trigger condition of IIC trigger. Query the current trigger condition of IIC trigger.
Parameter
Name
Type
Range
Default
<trig_type>
Discrete
{STARt|RESTart|STOP|NACKnowledge| ADDRess|DATA|ADATa}
STARt
Explanation
STARt: trigger when SDA data transitions from high to low while SCL is high.
RESTart: trigger when another start condition occurs before a stop condition.
STOP: trigger when SDA data transitions from low to high while SCL is high.
NACKnowledge: trigger when the SDA data is high during any acknowledgement of SCL clock position.
ADDRess: trigger on the clock (SCL) edge corresponding to the byte of data (SDA) behind the preset address (Write, Read or R/W direction).
DATA: the trigger searches for the control byte value on the data line (SDA) following which there is a reading bit and an acknowledgement bit and then searches for the specified data value.
- ADATa: trigger when the “Address” and “Data” conditions are met at the
same time.
Return Format
The query returns STAR, STOP, NACK, REST, ADDR, DATA or ADAT.
Example
:TRIGger:IIC:WHEN RESTart The query returns REST.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:WHEN <trig_type> :TRIGger:IIC:WHEN?
Description
Set the trigger condition of IIC trigger. Query the current trigger condition of IIC trigger.
Parameter
Name
Type
Range
Default
<trig_type>
Discrete
{STARt|RESTart|STOP|NACKnowledge| ADDRess|DATA|ADATa}
STARt
Explanation
STARt: trigger when SDA data transitions from high to low while SCL is high.
RESTart: trigger when another start condition occurs before a stop condition.
STOP: trigger when SDA data transitions from low to high while SCL is high.
NACKnowledge: trigger when the SDA data is high during any acknowledgement of SCL clock position.
ADDRess: trigger on the clock (SCL) edge corresponding to the byte of data (SDA) behind the preset address (Write, Read or R/W direction).
DATA: the trigger searches for the control byte value on the data line (SDA) following which there is a reading bit and an acknowledgement bit and then searches for the specified data value.
- ADATa: trigger when the “Address” and “Data” conditions are met at the
same time.
Return Format
The query returns STAR, STOP, NACK, REST, ADDR, DATA or ADAT.
Example
:TRIGger:IIC:WHEN RESTart The query returns REST.
- Return type
str
-
stop()¶ Rigol Programming Guide
Syntax
:TRIGger:IIC:WHEN <trig_type> :TRIGger:IIC:WHEN?
Description
Set the trigger condition of IIC trigger. Query the current trigger condition of IIC trigger.
Parameter
Name
Type
Range
Default
<trig_type>
Discrete
{STARt|RESTart|STOP|NACKnowledge| ADDRess|DATA|ADATa}
STARt
Explanation
STARt: trigger when SDA data transitions from high to low while SCL is high.
RESTart: trigger when another start condition occurs before a stop condition.
STOP: trigger when SDA data transitions from low to high while SCL is high.
NACKnowledge: trigger when the SDA data is high during any acknowledgement of SCL clock position.
ADDRess: trigger on the clock (SCL) edge corresponding to the byte of data (SDA) behind the preset address (Write, Read or R/W direction).
DATA: the trigger searches for the control byte value on the data line (SDA) following which there is a reading bit and an acknowledgement bit and then searches for the specified data value.
- ADATa: trigger when the “Address” and “Data” conditions are met at the
same time.
Return Format
The query returns STAR, STOP, NACK, REST, ADDR, DATA or ADAT.
Example
:TRIGger:IIC:WHEN RESTart The query returns REST.
- Return type
None
-
Mode Selector Trigger Subsystem Module - mode.py¶
-
class
ds2000.trigger.mode.Mode(subdevice)¶ Bases:
ds2000.common.SubController-
delay()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
duration()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
edge()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
i2c()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
nth_edge()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
pattern()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
pulse()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
rs232()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
runt()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
setup_hold()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
slope()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
spi()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
str
-
timeout()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
usb()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
video()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
windows()¶ Rigol Programming Guide
Syntax
:TRIGger:MODE <mode> :TRIGger:MODE?
Description
Select the trigger type. Query the current trigger type.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{EDGE|PULSe|RUNT|WIND|NEDG| SLOPe|VIDeo|PATTern|DELay| TIMeout|DURATion|SHOLd| RS232|IIC|SPI|USB}
EDGE
Return Format
The query returns the current trigger type.
Example
:TRIGger:MODE SLOPe The query returns SLOP.
- Return type
None
-
Nth Edge Trigger Subsystem Module - nth_edge.py¶
-
class
ds2000.trigger.nth_edge.NthEdge(device)¶ Bases:
ds2000.common.SubController-
get_edge()¶ Rigol Programming Guide
Syntax
:TRIGger:NEDGe:EDGE <NR1> :TRIGger:NEDGe:EDGE?
Description
Set the edge number of Nth edge trigger. Query the current edge number of Nth edge trigger.
Parameter
Name
Type
Range
Default
<NR1>
Integer
1 to 65535
2
Return Format
The query returns an integer between 1 and 65535.
Example
:TRIGger:NEDGe:EDGE
- Return type
int
-
get_idle()¶ Rigol Programming Guide
Syntax
:TRIGger:NEDGe:IDLE <NR3> :TRIGger:NEDGe:IDLE?
Description
Set the idle time of Nth edge trigger. Query the current idle time of Nth edge trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
16ns to 4s
1μs
Return Format
The query returns the idle time value in scientific notation.
Example
:TRIGger:NEDGe:IDLE 0.002 The query returns 2.000000e-03.
- Return type
float
-
get_level()¶ Rigol Programming Guide
Syntax
:TRIGger:NEDGe:LEVel <level> :TRIGger:NEDGe:LEVel?
Description
Set the trigger level in Nth edge trigger and the unit is the same with the current amplitude unit. Query the current trigger level in Nth edge trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:NEDGe:LEVel 0.16 The query returns 1.600000e-01.
- Return type
int
-
set_edge(number=2)¶ Rigol Programming Guide
Syntax
:TRIGger:NEDGe:EDGE <NR1> :TRIGger:NEDGe:EDGE?
Description
Set the edge number of Nth edge trigger. Query the current edge number of Nth edge trigger.
Parameter
Name
Type
Range
Default
<NR1>
Integer
1 to 65535
2
Return Format
The query returns an integer between 1 and 65535.
Example
:TRIGger:NEDGe:EDGE
- Return type
None
-
set_idle(time=1e-09)¶ Rigol Programming Guide
Syntax
:TRIGger:NEDGe:IDLE <NR3> :TRIGger:NEDGe:IDLE?
Description
Set the idle time of Nth edge trigger. Query the current idle time of Nth edge trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
16ns to 4s
1μs
Return Format
The query returns the idle time value in scientific notation.
Example
:TRIGger:NEDGe:IDLE 0.002 The query returns 2.000000e-03.
- Return type
None
-
set_level(level=0)¶ Rigol Programming Guide
Syntax
:TRIGger:NEDGe:LEVel <level> :TRIGger:NEDGe:LEVel?
Description
Set the trigger level in Nth edge trigger and the unit is the same with the current amplitude unit. Query the current trigger level in Nth edge trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:NEDGe:LEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
set_slope(positive=True)¶ Rigol Programming Guide
Syntax
:TRIGger:NEDGe:SLOPe <slope> :TRIGger:NEDGe:SLOPe?
Description
Select the edge type of Nth edge trigger. Query the current edge type of Nth edge trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POSitive or NEGative.
Example
:TRIGger:NEDGe:SLOPe NEGative The query returns NEG.
- Return type
None
-
slope_is_negative()¶ - Return type
bool
-
slope_is_positive()¶ Rigol Programming Guide
Syntax
:TRIGger:NEDGe:SLOPe <slope> :TRIGger:NEDGe:SLOPe?
Description
Select the edge type of Nth edge trigger. Query the current edge type of Nth edge trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POSitive or NEGative.
Example
:TRIGger:NEDGe:SLOPe NEGative The query returns NEG.
- Return type
bool
-
-
class
ds2000.trigger.nth_edge.NthEdgeSource(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
channel1()¶ Rigol Programming Guide
Syntax
:TRIGger:NEDGe:SOURce <source> :TRIGger:NEDGe:SOURce?
Description
Select the trigger source of Nth egde trigger. Query the current trigger source of Nth edge trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:NEDGe:SOURce CHANnel2 The query returns CHAN2.
- Return type
None
-
channel2()¶ Rigol Programming Guide
Syntax
:TRIGger:NEDGe:SOURce <source> :TRIGger:NEDGe:SOURce?
Description
Select the trigger source of Nth egde trigger. Query the current trigger source of Nth edge trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:NEDGe:SOURce CHANnel2 The query returns CHAN2.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:NEDGe:SOURce <source> :TRIGger:NEDGe:SOURce?
Description
Select the trigger source of Nth egde trigger. Query the current trigger source of Nth edge trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:NEDGe:SOURce CHANnel2 The query returns CHAN2.
- Return type
int
-
Pattern Trigger Subsystem Module - pattern.py¶
-
class
ds2000.trigger.pattern.Pattern(subdevice)¶ Bases:
ds2000.common.SubController-
get_level(channel=1)¶ Rigol Programming Guide
Syntax
:TRIGger:PATTern:LEVel <chan>,<level> :TRIGger:PATTern:LEVel? <chan>
Description
Set the trigger level of each channel in pattern trigger and the unit is the same with the current amplitude unit. Query the current trigger level of each channel in pattern trigger.
Parameter
Name
Type
Range
Default
<chan>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
<level>
Real
± 5 × VerticalScale from the screen - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:PATTern:LEVel CHANnel2,0.16 The query returns 1.600000e-01.
- Return type
float
-
get_pattern()¶ Rigol Programming Guide
Syntax
:TRIGger:PATTern:PATTern <pattern> :TRIGger:PATTern:PATTern?
Description
Set the pattern code of each channel in pattern trigger. Query the current pattern code of each channel in pattern trigger.
Parameter
Name
Type
Range
Default
<pattern>
Discrete
{H,L,X,R,F}
H,L
Note: they are the default pattern codes for CH1 and CH2 from the left to the right.
Explanation
In the pattern, you can only specify one rising edge or falling edge. If one edge item is currently defined and then another edge item is defined in the other channel in the pattern, the former edge item defined will be replaced by X.
Return Format
The query returns the current pattern codes of both the channels.
Example
:TRIGger:PATTern:PATTern H,R The query returns H,R.
- Return type
Tuple[str, …]
-
set_level(channel=1, level=0)¶ Rigol Programming Guide
Syntax
:TRIGger:PATTern:LEVel <chan>,<level> :TRIGger:PATTern:LEVel? <chan>
Description
Set the trigger level of each channel in pattern trigger and the unit is the same with the current amplitude unit. Query the current trigger level of each channel in pattern trigger.
Parameter
Name
Type
Range
Default
<chan>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
<level>
Real
± 5 × VerticalScale from the screen - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:PATTern:LEVel CHANnel2,0.16 The query returns 1.600000e-01.
- Return type
None
-
set_pattern(pattern=['H', 'L'])¶ Rigol Programming Guide
Syntax
:TRIGger:PATTern:PATTern <pattern> :TRIGger:PATTern:PATTern?
Description
Set the pattern code of each channel in pattern trigger. Query the current pattern code of each channel in pattern trigger.
Parameter
Name
Type
Range
Default
<pattern>
Discrete
{H,L,X,R,F}
H,L
Note: they are the default pattern codes for CH1 and CH2 from the left to the right.
Explanation
In the pattern, you can only specify one rising edge or falling edge. If one edge item is currently defined and then another edge item is defined in the other channel in the pattern, the former edge item defined will be replaced by X.
Return Format
The query returns the current pattern codes of both the channels.
Example
:TRIGger:PATTern:PATTern H,R The query returns H,R.
- Return type
None
-
Pulse Trigger Subsystem Module - pulse.py¶
-
class
ds2000.trigger.pulse.Pulse(device)¶ Bases:
ds2000.common.SubController-
get_level()¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:LEVel <level> :TRIGger:PULSe:LEVel?
Description
Set the trigger level in pulse trigger and the unit is the same with the current amplitude unit. Query the current trigger level in pulse trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:PULSe:LEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
get_lower_pulse_width()¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:LWIDth <width> :TRIGger:PULSe:LWIDth?
Description
Set the lower limit of the pulse width in pulse trigger and the unit is s. Query the current lower limit of the pulse width in pulse trigger
Parameter
Name
Type
Range
Default
<width>
Real
2ns to 4s
1μs
Note: when the trigger condition is PGLess or NGLess, the range is from 2ns to 3.99s.
Explanation
This command is available when the trigger condition (refer to the :TRIGger:PULSe:WHEN command) is PGReater, NGReater, PGLess or NGLess.
Return Format
The query returns the lower limit of the pulse width in scientific notation.
Example
:TRIGger:PULSe:LWIDth 0.000003 The query returns 3.000000e-06.
- Return type
float
-
get_source()¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:SOURce <source> :TRIGger:PULSe:SOURce?
Description
Select the trigger source in pulse trigger. Query the current trigger source in pulse trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format The query returns CHAN1 or CHAN2.
Example
:TRIGger:PULSe:SOURce CHANnel2 The query returns CHAN2.
- Return type
str
-
get_upper_pulse_width()¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:UWIDth <width> :TRIGger:PULSe:UWIDth?
Description
Set the upper limit of the pulse width in pulse trigger and the unit is s. Query the current upper limit of the pulse width in pulse trigger.
Parameter
Name
Type
Range
Default
<width>
Real
2ns to 4s
2μs
Note: when the trigger condition is PGLess or NGLess, the range is from 10ns to 4s.
Explanation
This command is available when the trigger condition (refer to the :TRIGger:PULSe:WHEN command) is PLESs, NLESs, PGLess or NGLess.
Return Format
The query returns the upper limit of the pulse width in scientific notation.
Example
:TRIGger:PULSe:UWIDth 0.000003 The query returns 3.000000e-06.
- Return type
float
-
set_level(level=0.0)¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:LEVel <level> :TRIGger:PULSe:LEVel?
Description
Set the trigger level in pulse trigger and the unit is the same with the current amplitude unit. Query the current trigger level in pulse trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:PULSe:LEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
set_lower_pulse_width(time=1e-06)¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:LWIDth <width> :TRIGger:PULSe:LWIDth?
Description
Set the lower limit of the pulse width in pulse trigger and the unit is s. Query the current lower limit of the pulse width in pulse trigger
Parameter
Name
Type
Range
Default
<width>
Real
2ns to 4s
1μs
Note: when the trigger condition is PGLess or NGLess, the range is from 2ns to 3.99s.
Explanation
This command is available when the trigger condition (refer to the :TRIGger:PULSe:WHEN command) is PGReater, NGReater, PGLess or NGLess.
Return Format
The query returns the lower limit of the pulse width in scientific notation.
Example
:TRIGger:PULSe:LWIDth 0.000003 The query returns 3.000000e-06.
- Return type
None
-
set_source(channel=1)¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:SOURce <source> :TRIGger:PULSe:SOURce?
Description
Select the trigger source in pulse trigger. Query the current trigger source in pulse trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format The query returns CHAN1 or CHAN2.
Example
:TRIGger:PULSe:SOURce CHANnel2 The query returns CHAN2.
- Return type
None
-
set_upper_pulse_width(time=2e-06)¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:UWIDth <width> :TRIGger:PULSe:UWIDth?
Description
Set the upper limit of the pulse width in pulse trigger and the unit is s. Query the current upper limit of the pulse width in pulse trigger.
Parameter
Name
Type
Range
Default
<width>
Real
2ns to 4s
2μs
Note: when the trigger condition is PGLess or NGLess, the range is from 10ns to 4s.
Explanation
This command is available when the trigger condition (refer to the :TRIGger:PULSe:WHEN command) is PLESs, NLESs, PGLess or NGLess.
Return Format
The query returns the upper limit of the pulse width in scientific notation.
Example
:TRIGger:PULSe:UWIDth 0.000003 The query returns 3.000000e-06.
- Return type
None
-
-
class
ds2000.trigger.pulse.PulseWhen(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
set_neg_pulse_width_between_specified_upper_and_lower_pulse_width()¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:WHEN <when> :TRIGger:PULSe:WHEN?
Description
Select the trigger condition of pulse trigger. Query the current trigger condition of pulse trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
GReater
Explanation
PGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified Pulse Width.
PLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is lower than the specified Pulse Width.
NGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified Pulse Width.
NLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is lower than the specified Pulse Width.
PGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
NGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:PULSe:WHEN PGReater The query returns PGR.
- Return type
None
-
set_neg_pulse_width_greater_than_specified_lower_pulse_width()¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:WHEN <when> :TRIGger:PULSe:WHEN?
Description
Select the trigger condition of pulse trigger. Query the current trigger condition of pulse trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
GReater
Explanation
PGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified Pulse Width.
PLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is lower than the specified Pulse Width.
NGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified Pulse Width.
NLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is lower than the specified Pulse Width.
PGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
NGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:PULSe:WHEN PGReater The query returns PGR.
- Return type
None
-
set_neg_pulse_width_lower_than_specified_upper_pulse_width()¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:WHEN <when> :TRIGger:PULSe:WHEN?
Description
Select the trigger condition of pulse trigger. Query the current trigger condition of pulse trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
GReater
Explanation
PGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified Pulse Width.
PLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is lower than the specified Pulse Width.
NGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified Pulse Width.
NLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is lower than the specified Pulse Width.
PGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
NGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:PULSe:WHEN PGReater The query returns PGR.
- Return type
None
-
set_pos_pulse_width_between_specified_upper_and_lower_pulse_width()¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:WHEN <when> :TRIGger:PULSe:WHEN?
Description
Select the trigger condition of pulse trigger. Query the current trigger condition of pulse trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
GReater
Explanation
PGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified Pulse Width.
PLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is lower than the specified Pulse Width.
NGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified Pulse Width.
NLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is lower than the specified Pulse Width.
PGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
NGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:PULSe:WHEN PGReater The query returns PGR.
- Return type
None
-
set_pos_pulse_width_greater_than_specified_lower_pulse_width()¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:WHEN <when> :TRIGger:PULSe:WHEN?
Description
Select the trigger condition of pulse trigger. Query the current trigger condition of pulse trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
GReater
Explanation
PGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified Pulse Width.
PLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is lower than the specified Pulse Width.
NGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified Pulse Width.
NLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is lower than the specified Pulse Width.
PGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
NGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:PULSe:WHEN PGReater The query returns PGR.
- Return type
None
-
set_pos_pulse_width_lower_than_specified_upper_pulse_width()¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:WHEN <when> :TRIGger:PULSe:WHEN?
Description
Select the trigger condition of pulse trigger. Query the current trigger condition of pulse trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
GReater
Explanation
PGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified Pulse Width.
PLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is lower than the specified Pulse Width.
NGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified Pulse Width.
NLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is lower than the specified Pulse Width.
PGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
NGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:PULSe:WHEN PGReater The query returns PGR.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:PULSe:WHEN <when> :TRIGger:PULSe:WHEN?
Description
Select the trigger condition of pulse trigger. Query the current trigger condition of pulse trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
GReater
Explanation
PGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified Pulse Width.
PLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the positive pulse width of the input signal is lower than the specified Pulse Width.
NGReater: you need to specify a pulse width (refer to the :TRIGger:PULSe:LWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified Pulse Width.
NLESs: you need to specify a pulse width (refer to the :TRIGger:PULSe:UWIDth command). The oscilloscope triggers when the negative pulse width of the input signal is lower than the specified Pulse Width.
PGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the positive pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
NGLess: you need to specify an upper (refer to the :TRIGger:PULSe:UWIDth command) and a lower (refer to the :TRIGger:PULSe:LWIDth command) pulse width. The oscilloscope triggers when the negative pulse width of the input signal is greater than the specified lower pulse width and lower than the upper pulse width.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:PULSe:WHEN PGReater The query returns PGR.
- Return type
str
-
RS232 Trigger Subsystem Module - rs232.py¶
-
class
ds2000.trigger.rs232.RS232(device)¶ Bases:
ds2000.common.SubController-
get_baud()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:BAUD <baud_rate> :TRIGger:RS232:BAUD?
Description
Set the baud rate in RS232 trigger and the unit is bps. Query the current baud rate in RS232 trigger.
Parameter
Name
Type
Range
Default
<baud_rate>
Discrete
{2400|4800|9600|19200|38400| 57600|115200|USER}
9600
Note: for USER, refer to the :TRIGger:RS232:BUSer command.
Return Format
The query returns the baud rate currently set.
Example
:TRIGger:RS232:BAUD 4800 The query returns 4800.
AND
:TRIGger:RS232:BUSer <user baud> :TRIGger:RS232:BUSer?
Description
Set the user-defined baud rate in RS232 trigger and the unit is bps. Query the current user-defined baud rate in RS232 trigger.
Parameter
Name
Type
Range
Default
<user baud>
Integer
1 to 900000
9600
Return Format
The query returns the current baud rate.
Example
:TRIGger:RS232:BUSer 50000 The query returns 50000.
- Return type
Dict[str,int]
-
get_data()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:DATA <data> :TRIGger:RS232:DATA?
Description
Set the data value in RS232 trigger when the trigger condition is Data. Query the current data value in RS232 trigger when the trigger condition is Data.
Parameter
Name
Type
Range
Default
<data>
Integer
0 to $ 2^{n}-1 $
70
Note: in the expression $ 2^{n} - 1 $, n is the current data bits (refer to the :TRIGger:RS232:WIDTh command).
Explanation
To set the trigger condition, refer to the :TRIGger:RS232:WHEN command.
Return Format
The query returns an integer.
Example
:TRIGger:RS232:DATA 10 The query returns 10.
- Return type
int
-
get_data_bit_width()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:WIDTh <width> :TRIGger:RS232:WIDTh?
Description
Set the data bits in RS232 trigger when the trigger condition is Data. Query the current data bits in RS232 trigger when the trigger condition is Data.
Parameter
Name
Type
Range
Default
<width>
Discrete
{5|6|7|8}
8
Explanation
To set the trigger condition, refer to the :TRIGger:RS232:WHEN command.
Return Format
The query returns 5, 6, 7 or 8.
Example
:TRIGger:RS232:WIDTh 6 The query returns 6.
- Return type
int
-
get_level()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:LEVel <level> :TRIGger:RS232:LEVel?
Description
Set the trigger level in RS232 trigger and the unit is the same with the current amplitude unit. Query the current trigger level in RS232 trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:RS232:LEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
get_source()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:SOURce <source> :TRIGger:RS232:SOURce?
Description
Select the trigger source of RS232 trigger. Query the current trigger source of RS232 trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Reuturn Format The query returns CHAN1 or CHAN2.
Example
:TRIGger:RS232:SOURce CHANnel2 The query returns CHAN2.
- Return type
str
-
get_stop_bits()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:STOP <bit> :TRIGger:RS232:STOP?
Description
Set the stop bit in RS232 trigger when the trigger condition is Error. Query the current stop bit in RS232 trigger when the trigger condition is Error.
Parameter
Name
Type
Range
Default
<bit>
Discrete
{1|2}
1
Explanation
To set the trigger condition, refer to the :TRIGger:RS232:WHEN command.
Return Format
The query returns 1 or 2.
Example
:TRIGger:RS232:STOP 2 The query returns 2.
- Return type
int
-
set_baud(baud=9600)¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:BAUD <baud_rate> :TRIGger:RS232:BAUD?
Description
Set the baud rate in RS232 trigger and the unit is bps. Query the current baud rate in RS232 trigger.
Parameter
Name
Type
Range
Default
<baud_rate>
Discrete
{2400|4800|9600|19200|38400| 57600|115200|USER}
9600
Note: for USER, refer to the :TRIGger:RS232:BUSer command.
Return Format
The query returns the baud rate currently set.
Example
:TRIGger:RS232:BAUD 4800 The query returns 4800.
AND
:TRIGger:RS232:BUSer <user baud> :TRIGger:RS232:BUSer?
Description
Set the user-defined baud rate in RS232 trigger and the unit is bps. Query the current user-defined baud rate in RS232 trigger.
Parameter
Name
Type
Range
Default
<user baud>
Integer
1 to 900000
9600
Return Format
The query returns the current baud rate.
Example
:TRIGger:RS232:BUSer 50000 The query returns 50000.
- Return type
None
-
set_data(data_bits=70)¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:DATA <data> :TRIGger:RS232:DATA?
Description
Set the data value in RS232 trigger when the trigger condition is Data. Query the current data value in RS232 trigger when the trigger condition is Data.
Parameter
Name
Type
Range
Default
<data>
Integer
0 to $ 2^{n}-1 $
70
Note: in the expression $ 2^{n} - 1 $, n is the current data bits (refer to the :TRIGger:RS232:WIDTh command).
Explanation
To set the trigger condition, refer to the :TRIGger:RS232:WHEN command.
Return Format
The query returns an integer.
Example
:TRIGger:RS232:DATA 10 The query returns 10.
- Return type
None
-
set_data_bit_width(data_bit_width=70)¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:WIDTh <width> :TRIGger:RS232:WIDTh?
Description
Set the data bits in RS232 trigger when the trigger condition is Data. Query the current data bits in RS232 trigger when the trigger condition is Data.
Parameter
Name
Type
Range
Default
<width>
Discrete
{5|6|7|8}
8
Explanation
To set the trigger condition, refer to the :TRIGger:RS232:WHEN command.
Return Format
The query returns 5, 6, 7 or 8.
Example
:TRIGger:RS232:WIDTh 6 The query returns 6.
- Return type
None
-
set_level(level=0)¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:LEVel <level> :TRIGger:RS232:LEVel?
Description
Set the trigger level in RS232 trigger and the unit is the same with the current amplitude unit. Query the current trigger level in RS232 trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:RS232:LEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
set_source(channel=1)¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:SOURce <source> :TRIGger:RS232:SOURce?
Description
Select the trigger source of RS232 trigger. Query the current trigger source of RS232 trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Reuturn Format The query returns CHAN1 or CHAN2.
Example
:TRIGger:RS232:SOURce CHANnel2 The query returns CHAN2.
- Return type
None
-
set_stop_bits(stop_bits=1)¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:STOP <bit> :TRIGger:RS232:STOP?
Description
Set the stop bit in RS232 trigger when the trigger condition is Error. Query the current stop bit in RS232 trigger when the trigger condition is Error.
Parameter
Name
Type
Range
Default
<bit>
Discrete
{1|2}
1
Explanation
To set the trigger condition, refer to the :TRIGger:RS232:WHEN command.
Return Format
The query returns 1 or 2.
Example
:TRIGger:RS232:STOP 2 The query returns 2.
- Return type
None
-
-
class
ds2000.trigger.rs232.RS232Parity(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
set_even()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:PARity <parity> :TRIGger:RS232:PARity?
Description
Set the even-odd check mode in RS232 trigger when the trigger condition is Error or Check Error. Query the current even-odd check mode in RS232 trigger when the trigger condition is Error or Check Error.
Parameter
Name
Type
Range
Default
<parity>
Discrete
{EVEN|ODD|NONE}
NONE
Note: the even-odd check mode can not be set to NONE when the trigger condition is Check Error.
Explanation
To set the trigger condition, refer to the :TRIGger:RS232:WHEN command.
Return Format
The query returns EVEN, ODD or NONE.
Example
:TRIGger:RS232:PARity EVEN The query returns EVEN.
- Return type
None
-
set_none()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:PARity <parity> :TRIGger:RS232:PARity?
Description
Set the even-odd check mode in RS232 trigger when the trigger condition is Error or Check Error. Query the current even-odd check mode in RS232 trigger when the trigger condition is Error or Check Error.
Parameter
Name
Type
Range
Default
<parity>
Discrete
{EVEN|ODD|NONE}
NONE
Note: the even-odd check mode can not be set to NONE when the trigger condition is Check Error.
Explanation
To set the trigger condition, refer to the :TRIGger:RS232:WHEN command.
Return Format
The query returns EVEN, ODD or NONE.
Example
:TRIGger:RS232:PARity EVEN The query returns EVEN.
- Return type
None
-
set_odd()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:PARity <parity> :TRIGger:RS232:PARity?
Description
Set the even-odd check mode in RS232 trigger when the trigger condition is Error or Check Error. Query the current even-odd check mode in RS232 trigger when the trigger condition is Error or Check Error.
Parameter
Name
Type
Range
Default
<parity>
Discrete
{EVEN|ODD|NONE}
NONE
Note: the even-odd check mode can not be set to NONE when the trigger condition is Check Error.
Explanation
To set the trigger condition, refer to the :TRIGger:RS232:WHEN command.
Return Format
The query returns EVEN, ODD or NONE.
Example
:TRIGger:RS232:PARity EVEN The query returns EVEN.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:PARity <parity> :TRIGger:RS232:PARity?
Description
Set the even-odd check mode in RS232 trigger when the trigger condition is Error or Check Error. Query the current even-odd check mode in RS232 trigger when the trigger condition is Error or Check Error.
Parameter
Name
Type
Range
Default
<parity>
Discrete
{EVEN|ODD|NONE}
NONE
Note: the even-odd check mode can not be set to NONE when the trigger condition is Check Error.
Explanation
To set the trigger condition, refer to the :TRIGger:RS232:WHEN command.
Return Format
The query returns EVEN, ODD or NONE.
Example
:TRIGger:RS232:PARity EVEN The query returns EVEN.
- Return type
str
-
-
class
ds2000.trigger.rs232.RS232When(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
set_data()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:WHEN <when> :TRIGger:RS232:WHEN?
Description
Set the trigger condition of RS232 trigger to Start, Error, Check Error or Data. Query the current trigger condition of RS232 trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{STARt|ERRor|PARity|DATA}
STARt
Explanation
STARt: trigger on the start frame position.
ERRor: trigger when error frame is detected.
PARity: trigger when check error is detected.
DATA: trigger on the last bit of the preset data bits and even-odd check bits.
Return Format
The query returns STAR, ERR, PAR or DATA.
Example
:TRIGger:RS232:WHEN ERRor The query returns ERR.
- Return type
None
-
set_error_detected()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:WHEN <when> :TRIGger:RS232:WHEN?
Description
Set the trigger condition of RS232 trigger to Start, Error, Check Error or Data. Query the current trigger condition of RS232 trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{STARt|ERRor|PARity|DATA}
STARt
Explanation
STARt: trigger on the start frame position.
ERRor: trigger when error frame is detected.
PARity: trigger when check error is detected.
DATA: trigger on the last bit of the preset data bits and even-odd check bits.
Return Format
The query returns STAR, ERR, PAR or DATA.
Example
:TRIGger:RS232:WHEN ERRor The query returns ERR.
- Return type
None
-
set_parity_error_detected()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:WHEN <when> :TRIGger:RS232:WHEN?
Description
Set the trigger condition of RS232 trigger to Start, Error, Check Error or Data. Query the current trigger condition of RS232 trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{STARt|ERRor|PARity|DATA}
STARt
Explanation
STARt: trigger on the start frame position.
ERRor: trigger when error frame is detected.
PARity: trigger when check error is detected.
DATA: trigger on the last bit of the preset data bits and even-odd check bits.
Return Format
The query returns STAR, ERR, PAR or DATA.
Example
:TRIGger:RS232:WHEN ERRor The query returns ERR.
- Return type
None
-
set_start_frame_position()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:WHEN <when> :TRIGger:RS232:WHEN?
Description
Set the trigger condition of RS232 trigger to Start, Error, Check Error or Data. Query the current trigger condition of RS232 trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{STARt|ERRor|PARity|DATA}
STARt
Explanation
STARt: trigger on the start frame position.
ERRor: trigger when error frame is detected.
PARity: trigger when check error is detected.
DATA: trigger on the last bit of the preset data bits and even-odd check bits.
Return Format
The query returns STAR, ERR, PAR or DATA.
Example
:TRIGger:RS232:WHEN ERRor The query returns ERR.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:RS232:WHEN <when> :TRIGger:RS232:WHEN?
Description
Set the trigger condition of RS232 trigger to Start, Error, Check Error or Data. Query the current trigger condition of RS232 trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{STARt|ERRor|PARity|DATA}
STARt
Explanation
STARt: trigger on the start frame position.
ERRor: trigger when error frame is detected.
PARity: trigger when check error is detected.
DATA: trigger on the last bit of the preset data bits and even-odd check bits.
Return Format
The query returns STAR, ERR, PAR or DATA.
Example
:TRIGger:RS232:WHEN ERRor The query returns ERR.
- Return type
str
-
Runt Trigger Subsystem Module - runt.py¶
-
class
ds2000.trigger.runt.Runt(device)¶ Bases:
ds2000.common.SubController-
get_lower_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:WLOWer <NR3> :TRIGger:RUNT:WLOWer?
Description
Set the lower limit of the pulse width in runt trigger. Query the current lower limit of the pulse width in runt trigger.
Parameter
Name
Type
Range
Default
<NR3>
Discrete
2ns to 4s
1μs
Note: when the qualifier is GLESs, the range of the lower limit of the pulse width is from 2ns to 3.99s.
Explanation
This command is available when the qualifier (refer to the :TRIGger:RUNT:WHEN command) is set to GREater or GLESs.
Return Format
The query returns the lower limit of the pulse width in scientific notation.
Example
:TRIGger:RUNT:WLOWer 0.02 The query returns 2.000000e-02.
- Return type
float
-
get_lower_limit_trigger_level()¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:BLEVel <level> :TRIGger:RUNT:BLEVel?
Description
Set the lower limit of the trigger level in runt trigger and the unit is the same with the current amplitude unit.
Query the current lower limit of the trigger level in runt trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the lower limit of the trigger level in scientific notation.
Example
:TRIGger:RUNT:BLEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
get_polarity()¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:POLarity <polarity> :TRIGger:RUNT:POLarity?
Description
Select the pulse polarity of runt trigger. Query the current pulse polarity of runt trigger.
Parameter
Name
Type
Range
Default
<polarity>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:RUNT:POLarity NEGative The query returns NEG.
- Return type
str
-
get_source()¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:SOURce <source> :TRIGger:RUNT:SOURce?
Description
Select the trigger source of runt trigger. Query the current trigger source of runt trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:RUNT:SOURce CHANnel2 The query returns CHAN2.
- Return type
str
-
get_upper_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:WUPPer <NR3> :TRIGger:RUNT:WUPPer?
Description
Set the upper limit of the pulse width in runt trigger. Query the current upper limit of the pulse width in runt trigger.
Parameter
Name
Type
Range
Default
<NR3>
Discrete
2ns to 4s
2μs
Note: when the qualifier is GLESs, the range of the upper limit of the pulse width is from 10ns to 4s.
Explanation
This command is available when the qualifier (refer to the :TRIGger:RUNT:WHEN command) is set to LESS or GLESs.
Return Format
The query returns the upper limit of the pulse width in scientific notation.
Example
:TRIGger:RUNT:WUPPer 0.02 The query returns 2.000000e-02.
- Return type
float
-
get_upper_limit_trigger_level()¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:ALEVel <level> :TRIGger:RUNT:ALEVel?
Description
Set the upper limit of the trigger level in runt trigger and the unit is the same with the current amplitude unit.
Query the current upper limit of the trigger level in runt trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the upper limit of the trigger level in scientific notation.
Example
:TRIGger:RUNT:ALEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
set_lower_limit(time=1e-06)¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:WLOWer <NR3> :TRIGger:RUNT:WLOWer?
Description
Set the lower limit of the pulse width in runt trigger. Query the current lower limit of the pulse width in runt trigger.
Parameter
Name
Type
Range
Default
<NR3>
Discrete
2ns to 4s
1μs
Note: when the qualifier is GLESs, the range of the lower limit of the pulse width is from 2ns to 3.99s.
Explanation
This command is available when the qualifier (refer to the :TRIGger:RUNT:WHEN command) is set to GREater or GLESs.
Return Format
The query returns the lower limit of the pulse width in scientific notation.
Example
:TRIGger:RUNT:WLOWer 0.02 The query returns 2.000000e-02.
- Return type
None
-
set_lower_limit_trigger_level(level=0.0)¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:BLEVel <level> :TRIGger:RUNT:BLEVel?
Description
Set the lower limit of the trigger level in runt trigger and the unit is the same with the current amplitude unit.
Query the current lower limit of the trigger level in runt trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the lower limit of the trigger level in scientific notation.
Example
:TRIGger:RUNT:BLEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
set_polarity_negative()¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:POLarity <polarity> :TRIGger:RUNT:POLarity?
Description
Select the pulse polarity of runt trigger. Query the current pulse polarity of runt trigger.
Parameter
Name
Type
Range
Default
<polarity>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:RUNT:POLarity NEGative The query returns NEG.
- Return type
None
-
set_polarity_positive()¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:POLarity <polarity> :TRIGger:RUNT:POLarity?
Description
Select the pulse polarity of runt trigger. Query the current pulse polarity of runt trigger.
Parameter
Name
Type
Range
Default
<polarity>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:RUNT:POLarity NEGative The query returns NEG.
- Return type
None
-
set_source(channel=1)¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:SOURce <source> :TRIGger:RUNT:SOURce?
Description
Select the trigger source of runt trigger. Query the current trigger source of runt trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:RUNT:SOURce CHANnel2 The query returns CHAN2.
- Return type
None
-
set_upper_limit(time=2e-06)¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:WUPPer <NR3> :TRIGger:RUNT:WUPPer?
Description
Set the upper limit of the pulse width in runt trigger. Query the current upper limit of the pulse width in runt trigger.
Parameter
Name
Type
Range
Default
<NR3>
Discrete
2ns to 4s
2μs
Note: when the qualifier is GLESs, the range of the upper limit of the pulse width is from 10ns to 4s.
Explanation
This command is available when the qualifier (refer to the :TRIGger:RUNT:WHEN command) is set to LESS or GLESs.
Return Format
The query returns the upper limit of the pulse width in scientific notation.
Example
:TRIGger:RUNT:WUPPer 0.02 The query returns 2.000000e-02.
- Return type
None
-
set_upper_limit_trigger_level(level=0.0)¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:ALEVel <level> :TRIGger:RUNT:ALEVel?
Description
Set the upper limit of the trigger level in runt trigger and the unit is the same with the current amplitude unit.
Query the current upper limit of the trigger level in runt trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the upper limit of the trigger level in scientific notation.
Example
:TRIGger:RUNT:ALEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
-
class
ds2000.trigger.runt.RuntWhen(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
set_none()¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:WHEN <when> :TRIGger:RUNT:WHEN?
Description
Select the qualifier of runt trigger. Query the current qualifier of runt trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{NONE|GREater|LESS|GLESs}
NONE
Explanation
NONE: do not set the trigger condition of runt trigger.
GREater: trigger when the runt pulse width is greater than the lower limit of pulse width (refer to the :TRIGger:RUNT:WLOWer command).
LESS: trigger when the runt pulse width is lower than the upper limit of pulse width (refer to the :TRIGger:RUNT:WUPPer command).
GLESs: trigger when the runt pulse width is greater than the lower limit (refer to the :TRIGger:RUNT:WLOWer command) and lower than the upper limit (refer to the :TRIGger:RUNT:WUPPer command) of pulse width. Note: the lower limit of the pulse width must be lower than the upper limit.
Return Format
The query returns NONE, GRE, LESS or GLES.
Example
:TRIGger:RUNT:WHEN LESS The query returns LESS.
- Return type
None
-
set_pulse_width_between_lower_and_upper_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:WHEN <when> :TRIGger:RUNT:WHEN?
Description
Select the qualifier of runt trigger. Query the current qualifier of runt trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{NONE|GREater|LESS|GLESs}
NONE
Explanation
NONE: do not set the trigger condition of runt trigger.
GREater: trigger when the runt pulse width is greater than the lower limit of pulse width (refer to the :TRIGger:RUNT:WLOWer command).
LESS: trigger when the runt pulse width is lower than the upper limit of pulse width (refer to the :TRIGger:RUNT:WUPPer command).
GLESs: trigger when the runt pulse width is greater than the lower limit (refer to the :TRIGger:RUNT:WLOWer command) and lower than the upper limit (refer to the :TRIGger:RUNT:WUPPer command) of pulse width. Note: the lower limit of the pulse width must be lower than the upper limit.
Return Format
The query returns NONE, GRE, LESS or GLES.
Example
:TRIGger:RUNT:WHEN LESS The query returns LESS.
- Return type
None
-
set_pulse_width_greater_than_lower_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:WHEN <when> :TRIGger:RUNT:WHEN?
Description
Select the qualifier of runt trigger. Query the current qualifier of runt trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{NONE|GREater|LESS|GLESs}
NONE
Explanation
NONE: do not set the trigger condition of runt trigger.
GREater: trigger when the runt pulse width is greater than the lower limit of pulse width (refer to the :TRIGger:RUNT:WLOWer command).
LESS: trigger when the runt pulse width is lower than the upper limit of pulse width (refer to the :TRIGger:RUNT:WUPPer command).
GLESs: trigger when the runt pulse width is greater than the lower limit (refer to the :TRIGger:RUNT:WLOWer command) and lower than the upper limit (refer to the :TRIGger:RUNT:WUPPer command) of pulse width. Note: the lower limit of the pulse width must be lower than the upper limit.
Return Format
The query returns NONE, GRE, LESS or GLES.
Example
:TRIGger:RUNT:WHEN LESS The query returns LESS.
- Return type
None
-
set_pulse_width_lower_than_upper_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:WHEN <when> :TRIGger:RUNT:WHEN?
Description
Select the qualifier of runt trigger. Query the current qualifier of runt trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{NONE|GREater|LESS|GLESs}
NONE
Explanation
NONE: do not set the trigger condition of runt trigger.
GREater: trigger when the runt pulse width is greater than the lower limit of pulse width (refer to the :TRIGger:RUNT:WLOWer command).
LESS: trigger when the runt pulse width is lower than the upper limit of pulse width (refer to the :TRIGger:RUNT:WUPPer command).
GLESs: trigger when the runt pulse width is greater than the lower limit (refer to the :TRIGger:RUNT:WLOWer command) and lower than the upper limit (refer to the :TRIGger:RUNT:WUPPer command) of pulse width. Note: the lower limit of the pulse width must be lower than the upper limit.
Return Format
The query returns NONE, GRE, LESS or GLES.
Example
:TRIGger:RUNT:WHEN LESS The query returns LESS.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:RUNT:WHEN <when> :TRIGger:RUNT:WHEN?
Description
Select the qualifier of runt trigger. Query the current qualifier of runt trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{NONE|GREater|LESS|GLESs}
NONE
Explanation
NONE: do not set the trigger condition of runt trigger.
GREater: trigger when the runt pulse width is greater than the lower limit of pulse width (refer to the :TRIGger:RUNT:WLOWer command).
LESS: trigger when the runt pulse width is lower than the upper limit of pulse width (refer to the :TRIGger:RUNT:WUPPer command).
GLESs: trigger when the runt pulse width is greater than the lower limit (refer to the :TRIGger:RUNT:WLOWer command) and lower than the upper limit (refer to the :TRIGger:RUNT:WUPPer command) of pulse width. Note: the lower limit of the pulse width must be lower than the upper limit.
Return Format
The query returns NONE, GRE, LESS or GLES.
Example
:TRIGger:RUNT:WHEN LESS The query returns LESS.
- Return type
str
-
Setup/Hold Trigger Subsystem Module - setup_hold.py¶
-
class
ds2000.trigger.setup_hold.SetupHold(device)¶ Bases:
ds2000.common.SubController-
get_hold_time()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:HTIMe <NR3> :TRIGger:SHOLd:HTIMe?
Description
Set the hold time of setup/hold trigger. Query the current hold time of setup/hold trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
2ns to 1s
50ns
Explanation
This command is available when the hold type (refer to the :TRIGger:SHOLd:TYPe command) is set to HOLd or SETHOLd. Reuturn Format The query returns the hold time in scientific notation.
Example
:TRIGger:SHOLd:HTIMe 0.002 The query returns 2.000000e-03.
- Return type
float
-
get_setup_time()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:STIMe <NR3> :TRIGger:SHOLd:STIMe?
Description
Set the setup time of setup/hold trigger. Query the current setup time of setup/hold trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
2ns to 1s
50ns
Explanation
This command is available when the hold type (refer to the :TRIGger:SHOLd:TYPe command) is set to SETup or SETHOLd. Reuturn Format The query returns the setup time in scientific notation.
Example
:TRIGger:SHOLd:STIMe 0.002 The query returns 2.000000e-03.
- Return type
float
-
set_hold_time(time=5e-08)¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:HTIMe <NR3> :TRIGger:SHOLd:HTIMe?
Description
Set the hold time of setup/hold trigger. Query the current hold time of setup/hold trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
2ns to 1s
50ns
Explanation
This command is available when the hold type (refer to the :TRIGger:SHOLd:TYPe command) is set to HOLd or SETHOLd. Reuturn Format The query returns the hold time in scientific notation.
Example
:TRIGger:SHOLd:HTIMe 0.002 The query returns 2.000000e-03.
- Return type
None
-
set_setup_time(time=5e-08)¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:STIMe <NR3> :TRIGger:SHOLd:STIMe?
Description
Set the setup time of setup/hold trigger. Query the current setup time of setup/hold trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
2ns to 1s
50ns
Explanation
This command is available when the hold type (refer to the :TRIGger:SHOLd:TYPe command) is set to SETup or SETHOLd. Reuturn Format The query returns the setup time in scientific notation.
Example
:TRIGger:SHOLd:STIMe 0.002 The query returns 2.000000e-03.
- Return type
None
-
-
class
ds2000.trigger.setup_hold.SetupHoldClockSource(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
channel1()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:CSrc <source> :TRIGger:SHOLd:CSrc?
Description
Set the clock source of setup/hold trigger. Query the current clock source of setup/hold trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:SHOLd:CSrc CHANnel2 The query returns CHAN2.
- Return type
None
-
channel2()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:CSrc <source> :TRIGger:SHOLd:CSrc?
Description
Set the clock source of setup/hold trigger. Query the current clock source of setup/hold trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:SHOLd:CSrc CHANnel2 The query returns CHAN2.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:CSrc <source> :TRIGger:SHOLd:CSrc?
Description
Set the clock source of setup/hold trigger. Query the current clock source of setup/hold trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:SHOLd:CSrc CHANnel2 The query returns CHAN2.
- Return type
str
-
-
class
ds2000.trigger.setup_hold.SetupHoldDataSource(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
channel1()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:DSrc <source> :TRIGger:SHOLd:DSrc?
Description
Set the data source of setup/hold trigger. Query the current data source of setup/hold trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel2
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:SHOLd:DSrc CHANnel1 The query returns CHAN2.
- Return type
None
-
channel2()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:DSrc <source> :TRIGger:SHOLd:DSrc?
Description
Set the data source of setup/hold trigger. Query the current data source of setup/hold trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel2
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:SHOLd:DSrc CHANnel1 The query returns CHAN2.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:DSrc <source> :TRIGger:SHOLd:DSrc?
Description
Set the data source of setup/hold trigger. Query the current data source of setup/hold trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel2
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:SHOLd:DSrc CHANnel1 The query returns CHAN2.
- Return type
str
-
-
class
ds2000.trigger.setup_hold.SetupHoldPattern(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
high()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:PATTern <pattern> :TRIGger:SHOLd:PATTern?
Description
Set the data type of setup/hold trigger. Query the current data type of setup/hold trigger.
Parameter
Name
Type
Range
Default
<pattern>
Discrete
{H|L}
H
Return Format
The query returns the pattern currently set for each channel.
Example
:TRIGger:SHOLd:PATTern L The query returns L.
- Return type
None
-
low()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:PATTern <pattern> :TRIGger:SHOLd:PATTern?
Description
Set the data type of setup/hold trigger. Query the current data type of setup/hold trigger.
Parameter
Name
Type
Range
Default
<pattern>
Discrete
{H|L}
H
Return Format
The query returns the pattern currently set for each channel.
Example
:TRIGger:SHOLd:PATTern L The query returns L.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:PATTern <pattern> :TRIGger:SHOLd:PATTern?
Description
Set the data type of setup/hold trigger. Query the current data type of setup/hold trigger.
Parameter
Name
Type
Range
Default
<pattern>
Discrete
{H|L}
H
Return Format
The query returns the pattern currently set for each channel.
Example
:TRIGger:SHOLd:PATTern L The query returns L.
- Return type
str
-
-
class
ds2000.trigger.setup_hold.SetupHoldSlope(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
falling_edge()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:SLOPe <slope> :TRIGger:SHOLd:SLOPe?
Description
Set the edge type of setup/hold trigger to the rising edge or falling edge. Query the current edge type of setup/hold trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:SHOLd:SLOPe NEGative The query returns NEG.
- Return type
None
-
rising_edge()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:SLOPe <slope> :TRIGger:SHOLd:SLOPe?
Description
Set the edge type of setup/hold trigger to the rising edge or falling edge. Query the current edge type of setup/hold trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:SHOLd:SLOPe NEGative The query returns NEG.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:SLOPe <slope> :TRIGger:SHOLd:SLOPe?
Description
Set the edge type of setup/hold trigger to the rising edge or falling edge. Query the current edge type of setup/hold trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:SHOLd:SLOPe NEGative The query returns NEG.
- Return type
str
-
-
class
ds2000.trigger.setup_hold.SetupHoldType(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
hold()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:TYPe <type> :TRIGger:SHOLd:TYPe?
Description
Set the hold type of setup/hold trigger. Query the current hold type of setup/hold trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{SETup|HOLd|SETHOLd}
SETup
Explanation
SETup: set the time (refer to the :TRIGger:SHOLd:STIMe command) that the data stays stable and constant before the clock edge appears.
HOLd: set the time (refer to the :TRIGger:SHOLd:HTIMe command) that the data stays stable and constant after the clock edge appears.
SETHOLd: set the time (refer to the :TRIGger:SHOLd:STIMe and :TRIGger:SHOLd:HTIMe commands) that the data stays stable and constant before and after the clock edge appears.
Return Format
The query returns SETup, HOL or SETHOL.
Example
:TRIGger:SHOLd:TYPe SETHOLd The query returns SETHOL.
- Return type
None
-
setup()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:TYPe <type> :TRIGger:SHOLd:TYPe?
Description
Set the hold type of setup/hold trigger. Query the current hold type of setup/hold trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{SETup|HOLd|SETHOLd}
SETup
Explanation
SETup: set the time (refer to the :TRIGger:SHOLd:STIMe command) that the data stays stable and constant before the clock edge appears.
HOLd: set the time (refer to the :TRIGger:SHOLd:HTIMe command) that the data stays stable and constant after the clock edge appears.
SETHOLd: set the time (refer to the :TRIGger:SHOLd:STIMe and :TRIGger:SHOLd:HTIMe commands) that the data stays stable and constant before and after the clock edge appears.
Return Format
The query returns SETup, HOL or SETHOL.
Example
:TRIGger:SHOLd:TYPe SETHOLd The query returns SETHOL.
- Return type
None
-
setup_hold()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:TYPe <type> :TRIGger:SHOLd:TYPe?
Description
Set the hold type of setup/hold trigger. Query the current hold type of setup/hold trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{SETup|HOLd|SETHOLd}
SETup
Explanation
SETup: set the time (refer to the :TRIGger:SHOLd:STIMe command) that the data stays stable and constant before the clock edge appears.
HOLd: set the time (refer to the :TRIGger:SHOLd:HTIMe command) that the data stays stable and constant after the clock edge appears.
SETHOLd: set the time (refer to the :TRIGger:SHOLd:STIMe and :TRIGger:SHOLd:HTIMe commands) that the data stays stable and constant before and after the clock edge appears.
Return Format
The query returns SETup, HOL or SETHOL.
Example
:TRIGger:SHOLd:TYPe SETHOLd The query returns SETHOL.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:SHOLd:TYPe <type> :TRIGger:SHOLd:TYPe?
Description
Set the hold type of setup/hold trigger. Query the current hold type of setup/hold trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{SETup|HOLd|SETHOLd}
SETup
Explanation
SETup: set the time (refer to the :TRIGger:SHOLd:STIMe command) that the data stays stable and constant before the clock edge appears.
HOLd: set the time (refer to the :TRIGger:SHOLd:HTIMe command) that the data stays stable and constant after the clock edge appears.
SETHOLd: set the time (refer to the :TRIGger:SHOLd:STIMe and :TRIGger:SHOLd:HTIMe commands) that the data stays stable and constant before and after the clock edge appears.
Return Format
The query returns SETup, HOL or SETHOL.
Example
:TRIGger:SHOLd:TYPe SETHOLd The query returns SETHOL.
- Return type
str
-
Slope Trigger Subsystem Module - slope.py¶
-
class
ds2000.trigger.slope.Slope(device)¶ Bases:
ds2000.common.SubController-
get_lower_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:TLOWer <time> :TRIGger:SLOPe:TLOWer?
Description
Set the lower limit of time in slope trigger and the unit is s. Query the current lower limit of time in slope trigger.
Parameter
Name
Type
Range
Default
<time>
Real
10ns to 1s
1μs
Note: when the trigger condition is PGLess or NGLess, the range is from 10ns to 999ms.
Explanation
This command is only available when the trigger condition (refer to the :TRIGger:SLOPe:WHEN command) is PGReater, NGReater, PGLess or NGLess.
Return Format
The query returns the lower limit of time in scientific notation.
Example
:TRIGger:SLOPe:TLOWer 0.000003 The query returns 3.000000e-06.
- Return type
float
-
get_lower_limit_trigger_level()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:BLEVel <level> :TRIGger:SLOPe:BLEVel?
Description
Set the lower limit of the trigger level in slope trigger and the unit is the same with the current amplitude unit. Query the current lower limit of the trigger level in slope trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the lower limit of the trigger level in scientific notation.
Example
:TRIGger:SLOPe:BLEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
get_source()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:SOURce <source> :TRIGger:SLOPe:SOURce?
Description
Select the trigger source of slope trigger. Query the current trigger source of slope trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:SLOPe:SOURce CHANnel2 The query returns CHAN2.
- Return type
str
-
get_upper_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:TUPPer <time> :TRIGger:SLOPe:TUPPer?
Description
Set the upper limit of time in slope trigger and the unit is s. Query the current upper limit of time in slope trigger.
Parameter
Name
Type
Range
Default
<time>
Real
10ns to 1s
2μs
Note: when the trigger condition is PGLess or NGLess, the range is from 20ns to 1s.
Explanation
This command is only available when the trigger condition (refer to the :TRIGger:SLOPe:WHEN command) is PLESs, NLESs, PGLess or NGLess.
Return Format
The query returns the upper limit of time in scientific notation.
Example
:TRIGger:SLOPe:TUPPer 0.000003 The query returns 3.000000e-06.
- Return type
float
-
get_upper_limit_trigger_level()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:ALEVel <level> :TRIGger:SLOPe:ALEVel?
Description
Set the upper limit of the trigger level in slope trigger and the unit is the same with the current amplitude unit. Query the current upper limit of the trigger level in slope trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the upper limit of the trigger level in scientific notation.
Example
:TRIGger:SLOPe:ALEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
set_lower_limit(time=1e-06)¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:TLOWer <time> :TRIGger:SLOPe:TLOWer?
Description
Set the lower limit of time in slope trigger and the unit is s. Query the current lower limit of time in slope trigger.
Parameter
Name
Type
Range
Default
<time>
Real
10ns to 1s
1μs
Note: when the trigger condition is PGLess or NGLess, the range is from 10ns to 999ms.
Explanation
This command is only available when the trigger condition (refer to the :TRIGger:SLOPe:WHEN command) is PGReater, NGReater, PGLess or NGLess.
Return Format
The query returns the lower limit of time in scientific notation.
Example
:TRIGger:SLOPe:TLOWer 0.000003 The query returns 3.000000e-06.
- Return type
None
-
set_lower_limit_trigger_level(level=0.0)¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:BLEVel <level> :TRIGger:SLOPe:BLEVel?
Description
Set the lower limit of the trigger level in slope trigger and the unit is the same with the current amplitude unit. Query the current lower limit of the trigger level in slope trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the lower limit of the trigger level in scientific notation.
Example
:TRIGger:SLOPe:BLEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
set_source(channel=1)¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:SOURce <source> :TRIGger:SLOPe:SOURce?
Description
Select the trigger source of slope trigger. Query the current trigger source of slope trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:SLOPe:SOURce CHANnel2 The query returns CHAN2.
- Return type
None
-
set_upper_limit(time=2e-06)¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:TUPPer <time> :TRIGger:SLOPe:TUPPer?
Description
Set the upper limit of time in slope trigger and the unit is s. Query the current upper limit of time in slope trigger.
Parameter
Name
Type
Range
Default
<time>
Real
10ns to 1s
2μs
Note: when the trigger condition is PGLess or NGLess, the range is from 20ns to 1s.
Explanation
This command is only available when the trigger condition (refer to the :TRIGger:SLOPe:WHEN command) is PLESs, NLESs, PGLess or NGLess.
Return Format
The query returns the upper limit of time in scientific notation.
Example
:TRIGger:SLOPe:TUPPer 0.000003 The query returns 3.000000e-06.
- Return type
None
-
set_upper_limit_trigger_level(level=0.0)¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:ALEVel <level> :TRIGger:SLOPe:ALEVel?
Description
Set the upper limit of the trigger level in slope trigger and the unit is the same with the current amplitude unit. Query the current upper limit of the trigger level in slope trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the upper limit of the trigger level in scientific notation.
Example
:TRIGger:SLOPe:ALEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
-
class
ds2000.trigger.slope.SlopeWhen(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
set_negative_slope_time_between_specified_lower_and_upper_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:WHEN <when> :TRIGger:SLOPe:WHEN?
Description
Select the trigger condition of slope trigger. Query the current trigger condition of slope trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
PGReater
Explanation
PGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the positive slope time of the input signal is greater than the specified time.
PLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the positive slope time of the input signal is lower than the specified time.
NGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the negative slope time of the input signal is greater than the specified time.
NLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the negative slope time of the input signal is lower than the specified time.
PGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWer command) of time. The oscilloscope triggers when the positive slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
NGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWercommand) of time. The oscilloscope triggers when the negative slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:SLOPe:WHEN PGReater The query returns PGR.
- Return type
None
-
set_negative_slope_time_greater_than_specified_lower_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:WHEN <when> :TRIGger:SLOPe:WHEN?
Description
Select the trigger condition of slope trigger. Query the current trigger condition of slope trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
PGReater
Explanation
PGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the positive slope time of the input signal is greater than the specified time.
PLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the positive slope time of the input signal is lower than the specified time.
NGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the negative slope time of the input signal is greater than the specified time.
NLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the negative slope time of the input signal is lower than the specified time.
PGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWer command) of time. The oscilloscope triggers when the positive slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
NGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWercommand) of time. The oscilloscope triggers when the negative slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:SLOPe:WHEN PGReater The query returns PGR.
- Return type
None
-
set_negative_slope_time_lower_than_specified_upper_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:WHEN <when> :TRIGger:SLOPe:WHEN?
Description
Select the trigger condition of slope trigger. Query the current trigger condition of slope trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
PGReater
Explanation
PGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the positive slope time of the input signal is greater than the specified time.
PLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the positive slope time of the input signal is lower than the specified time.
NGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the negative slope time of the input signal is greater than the specified time.
NLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the negative slope time of the input signal is lower than the specified time.
PGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWer command) of time. The oscilloscope triggers when the positive slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
NGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWercommand) of time. The oscilloscope triggers when the negative slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:SLOPe:WHEN PGReater The query returns PGR.
- Return type
None
-
set_positive_slope_time_between_specified_lower_and_upper_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:WHEN <when> :TRIGger:SLOPe:WHEN?
Description
Select the trigger condition of slope trigger. Query the current trigger condition of slope trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
PGReater
Explanation
PGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the positive slope time of the input signal is greater than the specified time.
PLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the positive slope time of the input signal is lower than the specified time.
NGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the negative slope time of the input signal is greater than the specified time.
NLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the negative slope time of the input signal is lower than the specified time.
PGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWer command) of time. The oscilloscope triggers when the positive slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
NGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWercommand) of time. The oscilloscope triggers when the negative slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:SLOPe:WHEN PGReater The query returns PGR.
- Return type
None
-
set_positive_slope_time_greater_than_specified_lower_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:WHEN <when> :TRIGger:SLOPe:WHEN?
Description
Select the trigger condition of slope trigger. Query the current trigger condition of slope trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
PGReater
Explanation
PGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the positive slope time of the input signal is greater than the specified time.
PLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the positive slope time of the input signal is lower than the specified time.
NGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the negative slope time of the input signal is greater than the specified time.
NLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the negative slope time of the input signal is lower than the specified time.
PGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWer command) of time. The oscilloscope triggers when the positive slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
NGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWercommand) of time. The oscilloscope triggers when the negative slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:SLOPe:WHEN PGReater The query returns PGR.
- Return type
None
-
set_positive_slope_time_lower_than_specified_upper_limit()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:WHEN <when> :TRIGger:SLOPe:WHEN?
Description
Select the trigger condition of slope trigger. Query the current trigger condition of slope trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
PGReater
Explanation
PGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the positive slope time of the input signal is greater than the specified time.
PLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the positive slope time of the input signal is lower than the specified time.
NGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the negative slope time of the input signal is greater than the specified time.
NLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the negative slope time of the input signal is lower than the specified time.
PGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWer command) of time. The oscilloscope triggers when the positive slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
NGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWercommand) of time. The oscilloscope triggers when the negative slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:SLOPe:WHEN PGReater The query returns PGR.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:WHEN <when> :TRIGger:SLOPe:WHEN?
Description
Select the trigger condition of slope trigger. Query the current trigger condition of slope trigger.
Parameter
Name
Type
Range
Default
<when>
Discrete
{PGReater|PLESs|NGReater |NLESs|PGLess|NGLess}
PGReater
Explanation
PGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the positive slope time of the input signal is greater than the specified time.
PLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the positive slope time of the input signal is lower than the specified time.
NGReater: you need to specify a time value (refer to the :TRIGger:SLOPe:TLOWer command). The oscilloscope triggers when the negative slope time of the input signal is greater than the specified time.
NLESs: you need to specify a time value (refer to the :TRIGger:SLOPe:TUPPer command). The oscilloscope triggers when the negative slope time of the input signal is lower than the specified time.
PGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWer command) of time. The oscilloscope triggers when the positive slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
NGLess: you need to specify an upper limit (refer to the :TRIGger:SLOPe:TUPPer command) and a lower limit (refer to the :TRIGger:SLOPe:TLOWercommand) of time. The oscilloscope triggers when the negative slope time of the input signal is greater than the specified lower limit and lower than the specified upper limit.
Return Format
The query returns PGR, PLES, NGR, NLES, PGL or NGL.
Example
:TRIGger:SLOPe:WHEN PGReater The query returns PGR.
- Return type
str
-
-
class
ds2000.trigger.slope.SlopeWindow(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
set_adjust_lower_limit_of_trigger_level()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:WINDow <window> :TRIGger:SLOPe:WINDow?
Description
Set the type of the vertical window in slope trigger. Query the current type of the vertical window in slope trigger.
Parameter
Name
Type
Range
Default
<window>
Discrete
{TA|TB|TAB}
TA
Explanation
Different vertical windows correspond to different trigger level adjustment modes.
TA: only adjust the upper limit of the trigger level. Refer to the :TRIGger:SLOPe:ALEVel command.
TB: only adjust the lower limit of the trigger level. Refer to the :TRIGger:SLOPe:BLEVel command.
TAB: adjust the upper and lower limits of the trigger level at the same time. Refer to the :TRIGger:SLOPe:ALEVel and :TRIGger:SLOPe:BLEVel commands.
Return Format
The query returns TA, TB or TAB.
Example
:TRIGger:SLOPe:WINDow TB The query returns TB.
- Return type
None
-
set_adjust_upper_and_lower_limit_of_trigger_level()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:WINDow <window> :TRIGger:SLOPe:WINDow?
Description
Set the type of the vertical window in slope trigger. Query the current type of the vertical window in slope trigger.
Parameter
Name
Type
Range
Default
<window>
Discrete
{TA|TB|TAB}
TA
Explanation
Different vertical windows correspond to different trigger level adjustment modes.
TA: only adjust the upper limit of the trigger level. Refer to the :TRIGger:SLOPe:ALEVel command.
TB: only adjust the lower limit of the trigger level. Refer to the :TRIGger:SLOPe:BLEVel command.
TAB: adjust the upper and lower limits of the trigger level at the same time. Refer to the :TRIGger:SLOPe:ALEVel and :TRIGger:SLOPe:BLEVel commands.
Return Format
The query returns TA, TB or TAB.
Example
:TRIGger:SLOPe:WINDow TB The query returns TB.
- Return type
None
-
set_adjust_upper_limit_of_trigger_level()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:WINDow <window> :TRIGger:SLOPe:WINDow?
Description
Set the type of the vertical window in slope trigger. Query the current type of the vertical window in slope trigger.
Parameter
Name
Type
Range
Default
<window>
Discrete
{TA|TB|TAB}
TA
Explanation
Different vertical windows correspond to different trigger level adjustment modes.
TA: only adjust the upper limit of the trigger level. Refer to the :TRIGger:SLOPe:ALEVel command.
TB: only adjust the lower limit of the trigger level. Refer to the :TRIGger:SLOPe:BLEVel command.
TAB: adjust the upper and lower limits of the trigger level at the same time. Refer to the :TRIGger:SLOPe:ALEVel and :TRIGger:SLOPe:BLEVel commands.
Return Format
The query returns TA, TB or TAB.
Example
:TRIGger:SLOPe:WINDow TB The query returns TB.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:SLOPe:WINDow <window> :TRIGger:SLOPe:WINDow?
Description
Set the type of the vertical window in slope trigger. Query the current type of the vertical window in slope trigger.
Parameter
Name
Type
Range
Default
<window>
Discrete
{TA|TB|TAB}
TA
Explanation
Different vertical windows correspond to different trigger level adjustment modes.
TA: only adjust the upper limit of the trigger level. Refer to the :TRIGger:SLOPe:ALEVel command.
TB: only adjust the lower limit of the trigger level. Refer to the :TRIGger:SLOPe:BLEVel command.
TAB: adjust the upper and lower limits of the trigger level at the same time. Refer to the :TRIGger:SLOPe:ALEVel and :TRIGger:SLOPe:BLEVel commands.
Return Format
The query returns TA, TB or TAB.
Example
:TRIGger:SLOPe:WINDow TB The query returns TB.
- Return type
str
-
SPI Trigger Subsystem Module - spi.py¶
-
class
ds2000.trigger.spi.SPI(subdevice)¶ Bases:
ds2000.common.SubController-
get_data()¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:DATA <data> :TRIGger:SPI:DATA?
Description
Set the data value in SPI trigger. Query the current data value in SPI trigger.
Parameter
Name
Type
Range
Default
<data>
Integer
0 to $ 2^{n} – 1 $
0
Note: in the expression 2n-1, n is the current data bits (refer to the :TRIGger:SPI:WIDTh command).
Return Format
The query returns an integer.
Example
:TRIGger:SPI:DATA 5 The query returns 5.
- Return type
int
-
get_scl_source()¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:SCL <source> :TRIGger:SPI:SCL?
Description
Select the SCL channel source in SPI trigger. Query the current SCL channel source in SPI trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:SPI:SCL CHANnel2 The query returns CHAN2.
- Return type
str
-
get_scl_trigger_level()¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:CLEVel <level> :TRIGger:SPI:CLEVel?
Description
Set the trigger level of SCL in SPI trigger and the unit is the same with the current amplitude unit. Query the current trigger level of SCL in SPI trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command.
For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:SPI:CLEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
get_sda_source()¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:SDA <source> :TRIGger:SPI:SDA?
Description
Select the SDA channel source in SPI trigger. Query the current SDA channel source in SPI trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel2
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:SPI:SDA CHANnel2 The query returns CHAN2.
- Return type
str
-
get_sda_trigger_level()¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:DLEVel <level> :TRIGger:SPI:DLEVel?
Description
Set the trigger level of SDA in SPI trigger and the unit is the same with the current amplitude unit. Query the current trigger level of SDA in SPI trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command.
For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:SPI:DLEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
get_slope()¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:SLOPe <slope> :TRIGger:SPI:SLOPe?
Description
Set the trigger edge of the clock signal in SPI trigger. Query the current trigger edge of the clock signal in SPI trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:SPI:SLOPe POSitive The query returns POS.
- Return type
str
-
get_timeout()¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:TIMeout <time_value> :TRIGger:SPI:TIMeout?
Description
Set the timeout time in SPI trigger when the trigger condition is Timeout and the unit is s. Query the current timeout time in SPI trigger when the trigger condition is Timeout.
Parameter
Name
Type
Range
Default
<time_value>
Real
100ns to 1s
1µs
Return Format
The query returns the timeout time in scientific notation.
Example
:TRIGger:SPI:TIMeout 0.000002 The query returns 2.000000e-06.
- Return type
float
-
get_width()¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:WIDTh <width> :TRIGger:SPI:WIDTh?
Description
Set the bits of SDA in SPI trigger. Query the current bits of SDA in SPI trigger.
Parameter
Name
Type
Range
Default
<width>
Integer
4 to 32
8
Return Format
The query returns an integer.
Example
:TRIGger:SPI:WIDTh 10 The query returns 10.
- Return type
int
-
set_data(data=0)¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:DATA <data> :TRIGger:SPI:DATA?
Description
Set the data value in SPI trigger. Query the current data value in SPI trigger.
Parameter
Name
Type
Range
Default
<data>
Integer
0 to $ 2^{n} – 1 $
0
Note: in the expression 2n-1, n is the current data bits (refer to the :TRIGger:SPI:WIDTh command).
Return Format
The query returns an integer.
Example
:TRIGger:SPI:DATA 5 The query returns 5.
- Return type
None
-
set_scl_source(channel=1)¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:SCL <source> :TRIGger:SPI:SCL?
Description
Select the SCL channel source in SPI trigger. Query the current SCL channel source in SPI trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:SPI:SCL CHANnel2 The query returns CHAN2.
- Return type
None
-
set_scl_trigger_level(level=0.0)¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:CLEVel <level> :TRIGger:SPI:CLEVel?
Description
Set the trigger level of SCL in SPI trigger and the unit is the same with the current amplitude unit. Query the current trigger level of SCL in SPI trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command.
For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:SPI:CLEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
set_sda_source(channel=2)¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:SDA <source> :TRIGger:SPI:SDA?
Description
Select the SDA channel source in SPI trigger. Query the current SDA channel source in SPI trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel2
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:SPI:SDA CHANnel2 The query returns CHAN2.
- Return type
None
-
set_sda_trigger_level(level=0.0)¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:DLEVel <level> :TRIGger:SPI:DLEVel?
Description
Set the trigger level of SDA in SPI trigger and the unit is the same with the current amplitude unit. Query the current trigger level of SDA in SPI trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command.
For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:SPI:DLEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
set_slope_negative()¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:SLOPe <slope> :TRIGger:SPI:SLOPe?
Description
Set the trigger edge of the clock signal in SPI trigger. Query the current trigger edge of the clock signal in SPI trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:SPI:SLOPe POSitive The query returns POS.
- Return type
None
-
set_slope_positive()¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:SLOPe <slope> :TRIGger:SPI:SLOPe?
Description
Set the trigger edge of the clock signal in SPI trigger. Query the current trigger edge of the clock signal in SPI trigger.
Parameter
Name
Type
Range
Default
<slope>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:SPI:SLOPe POSitive The query returns POS.
- Return type
None
-
set_timeout(time=1e-06)¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:TIMeout <time_value> :TRIGger:SPI:TIMeout?
Description
Set the timeout time in SPI trigger when the trigger condition is Timeout and the unit is s. Query the current timeout time in SPI trigger when the trigger condition is Timeout.
Parameter
Name
Type
Range
Default
<time_value>
Real
100ns to 1s
1µs
Return Format
The query returns the timeout time in scientific notation.
Example
:TRIGger:SPI:TIMeout 0.000002 The query returns 2.000000e-06.
- Return type
None
-
set_width(width=8)¶ Rigol Programming Guide
Syntax
:TRIGger:SPI:WIDTh <width> :TRIGger:SPI:WIDTh?
Description
Set the bits of SDA in SPI trigger. Query the current bits of SDA in SPI trigger.
Parameter
Name
Type
Range
Default
<width>
Integer
4 to 32
8
Return Format
The query returns an integer.
Example
:TRIGger:SPI:WIDTh 10 The query returns 10.
- Return type
None
-
Sweep Trigger Subsystem Module - sweep.py¶
-
class
ds2000.trigger.sweep.Sweep(subdevice)¶ Bases:
ds2000.common.SubController-
auto()¶ Rigol Programming Guide
Syntax
:TRIGger:SWEep <sweep> :TRIGger:SWEep?
Description
Set the trigger mode to auto, normal or single. Query the current trigger mode.
Parameter
Name
Type
Range
Default
<sweep>
Discrete
{AUTO|NORMal|SINGle}
AUTO
Return Format
The query returns AUTO, NORM or SING.
Example
:TRIGger:SWEep SINGle The query returns SING.
- Return type
None
-
normal()¶ Rigol Programming Guide
Syntax
:TRIGger:SWEep <sweep> :TRIGger:SWEep?
Description
Set the trigger mode to auto, normal or single. Query the current trigger mode.
Parameter
Name
Type
Range
Default
<sweep>
Discrete
{AUTO|NORMal|SINGle}
AUTO
Return Format
The query returns AUTO, NORM or SING.
Example
:TRIGger:SWEep SINGle The query returns SING.
- Return type
None
-
single()¶ Rigol Programming Guide
Syntax
:TRIGger:SWEep <sweep> :TRIGger:SWEep?
Description
Set the trigger mode to auto, normal or single. Query the current trigger mode.
Parameter
Name
Type
Range
Default
<sweep>
Discrete
{AUTO|NORMal|SINGle}
AUTO
Return Format
The query returns AUTO, NORM or SING.
Example
:TRIGger:SWEep SINGle The query returns SING.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:SWEep <sweep> :TRIGger:SWEep?
Description
Set the trigger mode to auto, normal or single. Query the current trigger mode.
Parameter
Name
Type
Range
Default
<sweep>
Discrete
{AUTO|NORMal|SINGle}
AUTO
Return Format
The query returns AUTO, NORM or SING.
Example
:TRIGger:SWEep SINGle The query returns SING.
- Return type
str
-
Timeout Trigger Subsystem Module - timeout.py¶
-
class
ds2000.trigger.timeout.Timeout(device)¶ Bases:
ds2000.common.SubController-
get_time()¶ Rigol Programming Guide
Syntax
:TRIGger:TIMeout:TIMe <NR3> :TRIGger:TIMeout:TIMe?
Description
Set the timeout time of timeout trigger. Query the current timeout time of timeout trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
16ns to 4s
1μs
Return Format
The query returns the timeout time in scientific notation.
Example
:TRIGger:TIMeout:TIMe 0.002 The query returns 2.000000e+06.
- Return type
float
-
set_time(time=1e-06)¶ Rigol Programming Guide
Syntax
:TRIGger:TIMeout:TIMe <NR3> :TRIGger:TIMeout:TIMe?
Description
Set the timeout time of timeout trigger. Query the current timeout time of timeout trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
16ns to 4s
1μs
Return Format
The query returns the timeout time in scientific notation.
Example
:TRIGger:TIMeout:TIMe 0.002 The query returns 2.000000e+06.
- Return type
None
-
USB Trigger Subsystem Module - usb.py¶
-
class
ds2000.trigger.usb.USB(device)¶ Bases:
ds2000.common.SubController-
get_data_minus_source()¶ Rigol Programming Guide
Syntax
:TRIGger:USB:DMINus <source> :TRIGger:USB:DMINus?
Description
Select the D- data channel source in USB trigger. Query the current D- data channel source in USB trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel2
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:USB:DMINus CHANnel2 The query returns CHAN2.
- Return type
str
-
get_data_minus_trigger_level()¶ Rigol Programming Guide
Syntax
:TRIGger:USB:MLEVel <level> :TRIGger:USB:MLEVel?
Description
Set the trigger level of the D- data line in USB trigger and the unit is the same with the current amplitude unit. Query the current trigger level of the D- data line in USB trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:USB:MLEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
get_data_plus_source()¶ Rigol Programming Guide
Syntax
:TRIGger:USB:DPLus <source> :TRIGger:USB:DPLus?
Description
Select the D+ data channel source in USB trigger. Query the current D+ data channel source in USB trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:USB:DPLus CHANnel2 The query returns CHAN2.
- Return type
str
-
get_data_plus_trigger_level()¶ Rigol Programming Guide
Syntax
:TRIGger:USB:PLEVel <level> :TRIGger:USB:PLEVel?
Description
Set the trigger level of the D+ data line in USB trigger and the unit is the same with the current amplitude unit. Query the current trigger level of the D+ data line in USB trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5× VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:USB:PLEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
get_speed()¶ Rigol Programming Guide
Syntax
:TRIGger:USB:SPEed <value> :TRIGger:USB:SPEed?
Description
Set the signal speed in USB trigger to Low Speed or Full Speed. Query the current signal speed in USB trigger.
Parameter
Name
Type
Range
Default
<value>
Discrete
{LOW|FULL}
LOW
Return Format
The query returns LOW or FULL.
Example
:TRIGger:USB:SPEed FULL The query returns FULL.
- Return type
str
-
set_data_minus_source(channel=2)¶ Rigol Programming Guide
Syntax
:TRIGger:USB:DMINus <source> :TRIGger:USB:DMINus?
Description
Select the D- data channel source in USB trigger. Query the current D- data channel source in USB trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel2
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:USB:DMINus CHANnel2 The query returns CHAN2.
- Return type
None
-
set_data_minus_trigger_level(level=0.0)¶ Rigol Programming Guide
Syntax
:TRIGger:USB:MLEVel <level> :TRIGger:USB:MLEVel?
Description
Set the trigger level of the D- data line in USB trigger and the unit is the same with the current amplitude unit. Query the current trigger level of the D- data line in USB trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:USB:MLEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
set_data_plus_source(channel=1)¶ Rigol Programming Guide
Syntax
:TRIGger:USB:DPLus <source> :TRIGger:USB:DPLus?
Description
Select the D+ data channel source in USB trigger. Query the current D+ data channel source in USB trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:USB:DPLus CHANnel2 The query returns CHAN2.
- Return type
None
-
set_data_plus_trigger_level(level=0.0)¶ Rigol Programming Guide
Syntax
:TRIGger:USB:PLEVel <level> :TRIGger:USB:PLEVel?
Description
Set the trigger level of the D+ data line in USB trigger and the unit is the same with the current amplitude unit. Query the current trigger level of the D+ data line in USB trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5× VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:USB:PLEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
set_speed_full()¶ Rigol Programming Guide
Syntax
:TRIGger:USB:SPEed <value> :TRIGger:USB:SPEed?
Description
Set the signal speed in USB trigger to Low Speed or Full Speed. Query the current signal speed in USB trigger.
Parameter
Name
Type
Range
Default
<value>
Discrete
{LOW|FULL}
LOW
Return Format
The query returns LOW or FULL.
Example
:TRIGger:USB:SPEed FULL The query returns FULL.
- Return type
None
-
set_speed_low()¶ Rigol Programming Guide
Syntax
:TRIGger:USB:SPEed <value> :TRIGger:USB:SPEed?
Description
Set the signal speed in USB trigger to Low Speed or Full Speed. Query the current signal speed in USB trigger.
Parameter
Name
Type
Range
Default
<value>
Discrete
{LOW|FULL}
LOW
Return Format
The query returns LOW or FULL.
Example
:TRIGger:USB:SPEed FULL The query returns FULL.
- Return type
None
-
-
class
ds2000.trigger.usb.USBWhen(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
set_eop()¶ Rigol Programming Guide
Syntax
:TRIGger:USB:WHEN <condition> :TRIGger:USB:WHEN?
Description
Set the trigger condition of USB trigger. Query the current trigger condition of USB trigger.
Parameter
Name
Type
Range
Default
<condition>
Discrete
{SOP|EOP|RC|SUSPend|EXITsuspend}
SOP
Explanation
SOP: trigger at the sync bit at the start of the data packet (SOP).
EOP: trigger at the end of the SEO portion of the EOP of the data packet.
RC: trigger when SEO is greater than 10 ms.
SUSPend: trigger when the idle time of the bus is greater than 3 ms.
EXITsuspend: trigger when the bus exits from idle state for more than 10 ms.
Return Format
The query returns SOP, EOP, RC, SUSP or EXIT.
Example
:TRIGger:USB:WHEN RC The query returns RC.
- Return type
None
-
set_exit_suspend()¶ Rigol Programming Guide
Syntax
:TRIGger:USB:WHEN <condition> :TRIGger:USB:WHEN?
Description
Set the trigger condition of USB trigger. Query the current trigger condition of USB trigger.
Parameter
Name
Type
Range
Default
<condition>
Discrete
{SOP|EOP|RC|SUSPend|EXITsuspend}
SOP
Explanation
SOP: trigger at the sync bit at the start of the data packet (SOP).
EOP: trigger at the end of the SEO portion of the EOP of the data packet.
RC: trigger when SEO is greater than 10 ms.
SUSPend: trigger when the idle time of the bus is greater than 3 ms.
EXITsuspend: trigger when the bus exits from idle state for more than 10 ms.
Return Format
The query returns SOP, EOP, RC, SUSP or EXIT.
Example
:TRIGger:USB:WHEN RC The query returns RC.
- Return type
None
-
set_rc()¶ Rigol Programming Guide
Syntax
:TRIGger:USB:WHEN <condition> :TRIGger:USB:WHEN?
Description
Set the trigger condition of USB trigger. Query the current trigger condition of USB trigger.
Parameter
Name
Type
Range
Default
<condition>
Discrete
{SOP|EOP|RC|SUSPend|EXITsuspend}
SOP
Explanation
SOP: trigger at the sync bit at the start of the data packet (SOP).
EOP: trigger at the end of the SEO portion of the EOP of the data packet.
RC: trigger when SEO is greater than 10 ms.
SUSPend: trigger when the idle time of the bus is greater than 3 ms.
EXITsuspend: trigger when the bus exits from idle state for more than 10 ms.
Return Format
The query returns SOP, EOP, RC, SUSP or EXIT.
Example
:TRIGger:USB:WHEN RC The query returns RC.
- Return type
None
-
set_sop()¶ Rigol Programming Guide
Syntax
:TRIGger:USB:WHEN <condition> :TRIGger:USB:WHEN?
Description
Set the trigger condition of USB trigger. Query the current trigger condition of USB trigger.
Parameter
Name
Type
Range
Default
<condition>
Discrete
{SOP|EOP|RC|SUSPend|EXITsuspend}
SOP
Explanation
SOP: trigger at the sync bit at the start of the data packet (SOP).
EOP: trigger at the end of the SEO portion of the EOP of the data packet.
RC: trigger when SEO is greater than 10 ms.
SUSPend: trigger when the idle time of the bus is greater than 3 ms.
EXITsuspend: trigger when the bus exits from idle state for more than 10 ms.
Return Format
The query returns SOP, EOP, RC, SUSP or EXIT.
Example
:TRIGger:USB:WHEN RC The query returns RC.
- Return type
None
-
set_suspend()¶ Rigol Programming Guide
Syntax
:TRIGger:USB:WHEN <condition> :TRIGger:USB:WHEN?
Description
Set the trigger condition of USB trigger. Query the current trigger condition of USB trigger.
Parameter
Name
Type
Range
Default
<condition>
Discrete
{SOP|EOP|RC|SUSPend|EXITsuspend}
SOP
Explanation
SOP: trigger at the sync bit at the start of the data packet (SOP).
EOP: trigger at the end of the SEO portion of the EOP of the data packet.
RC: trigger when SEO is greater than 10 ms.
SUSPend: trigger when the idle time of the bus is greater than 3 ms.
EXITsuspend: trigger when the bus exits from idle state for more than 10 ms.
Return Format
The query returns SOP, EOP, RC, SUSP or EXIT.
Example
:TRIGger:USB:WHEN RC The query returns RC.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:USB:WHEN <condition> :TRIGger:USB:WHEN?
Description
Set the trigger condition of USB trigger. Query the current trigger condition of USB trigger.
Parameter
Name
Type
Range
Default
<condition>
Discrete
{SOP|EOP|RC|SUSPend|EXITsuspend}
SOP
Explanation
SOP: trigger at the sync bit at the start of the data packet (SOP).
EOP: trigger at the end of the SEO portion of the EOP of the data packet.
RC: trigger when SEO is greater than 10 ms.
SUSPend: trigger when the idle time of the bus is greater than 3 ms.
EXITsuspend: trigger when the bus exits from idle state for more than 10 ms.
Return Format
The query returns SOP, EOP, RC, SUSP or EXIT.
Example
:TRIGger:USB:WHEN RC The query returns RC.
- Return type
str
-
Video Trigger Subsystem Module - video.py¶
-
class
ds2000.trigger.video.Video(device)¶ Bases:
ds2000.common.SubController-
MAX_LINES_OF_VIDEO_STANDATD: Dict[str, int] = {'1080I24HZ': 1125, '1080I25HZ': 1125, '1080I30HZ': 1125, '1080P24HZ': 1125, '1080P25HZ': 1125, '1080P30HZ': 1125, '1080P50HZ': 1125, '1080P60HZ': 1125, '480P': 525, '576P': 625, '720P24HZ': 750, '720P25HZ': 750, '720P30HZ': 750, '720P50HZ': 750, '720P60HZ': 750, 'NTSC': 525, 'PAL': 625}¶
-
get_level()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:LEVel <level> :TRIGger:VIDeo:LEVel?
Description
Set the trigger level in video trigger and the unit is the same with the current amplitude unit. Query the current trigger level in video trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:VIDeo:LEVel 0.16 The query returns 1.600000e-01.
- Return type
float
-
get_line()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:LINE <line> :TRIGger:VIDeo:LINE?
Description
Set the line number in video trigger when the sync type is Line Number (refer to the :TRIGger:VIDeo:MODE command). Query the current line number of the specified line.
Parameter
Name
Type
Range
Default
<line>
Integer
NTSC：1 to 525 PAL：1 to 625 480P：1 to 525 576P：1 to 625 720P60HZ：1 to 750 720P50HZ：1 to 750 720P30HZ：1 to 750 720P25HZ：1 to 750 720P24HZ：1 to 750 1080P60HZ：1 to 1125 1080P50HZ：1 to 1125 1080P30HZ：1 to 1125 1080P25HZ：1 to 1125 1080P24HZ：1 to 1125 1080I30HZ：1 to 1125 1080I25HZ：1 to 1125 1080I24HZ：1 to 1125
1
Return Format
The query returns an integer.
Example
:TRIGger:VIDeo:LINE 100 The query returns 100.
- Return type
int
-
get_polarity()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:POLarity <polarity> :TRIGger:VIDeo:POLarity?
Description
Set the video polarity in video trigger. Query the current video polarity in video trigger.
Parameter
Name
Type
Range
Default
<polarity>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:VIDeo:POLarity POSitive The query returns POS.
- Return type
str
-
get_source()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:SOURce <source> :TRIGger:VIDeo:SOURce?
Description
Select the trigger source of video trigger. Query the current trigger source of video trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:VIDeo:SOURce CHANnel2 The query returns CHAN2.
- Return type
str
-
set_level(level=0.0)¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:LEVel <level> :TRIGger:VIDeo:LEVel?
Description
Set the trigger level in video trigger and the unit is the same with the current amplitude unit. Query the current trigger level in video trigger.
Parameter
Name
Type
Range
Default
<level>
Real
± 5 × VerticalScale from the screen center - OFFSet
0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to the :CHANNel<n>:OFFSet command.
Return Format
The query returns the trigger level in scientific notation.
Example
:TRIGger:VIDeo:LEVel 0.16 The query returns 1.600000e-01.
- Return type
None
-
set_line(line=1)¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:LINE <line> :TRIGger:VIDeo:LINE?
Description
Set the line number in video trigger when the sync type is Line Number (refer to the :TRIGger:VIDeo:MODE command). Query the current line number of the specified line.
Parameter
Name
Type
Range
Default
<line>
Integer
NTSC：1 to 525 PAL：1 to 625 480P：1 to 525 576P：1 to 625 720P60HZ：1 to 750 720P50HZ：1 to 750 720P30HZ：1 to 750 720P25HZ：1 to 750 720P24HZ：1 to 750 1080P60HZ：1 to 1125 1080P50HZ：1 to 1125 1080P30HZ：1 to 1125 1080P25HZ：1 to 1125 1080P24HZ：1 to 1125 1080I30HZ：1 to 1125 1080I25HZ：1 to 1125 1080I24HZ：1 to 1125
1
Return Format
The query returns an integer.
Example
:TRIGger:VIDeo:LINE 100 The query returns 100.
- Return type
None
-
set_polarity_negative()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:POLarity <polarity> :TRIGger:VIDeo:POLarity?
Description
Set the video polarity in video trigger. Query the current video polarity in video trigger.
Parameter
Name
Type
Range
Default
<polarity>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:VIDeo:POLarity POSitive The query returns POS.
- Return type
None
-
set_polarity_positive()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:POLarity <polarity> :TRIGger:VIDeo:POLarity?
Description
Set the video polarity in video trigger. Query the current video polarity in video trigger.
Parameter
Name
Type
Range
Default
<polarity>
Discrete
{POSitive|NEGative}
POSitive
Return Format
The query returns POS or NEG.
Example
:TRIGger:VIDeo:POLarity POSitive The query returns POS.
- Return type
None
-
set_source(channel=1)¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:SOURce <source> :TRIGger:VIDeo:SOURce?
Description
Select the trigger source of video trigger. Query the current trigger source of video trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:VIDeo:SOURce CHANnel2 The query returns CHAN2.
- Return type
None
-
-
class
ds2000.trigger.video.VideoMode(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
set_all_lines()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:MODE <mode> :TRIGger:VIDeo:MODE?
Description
Set the sync type in video trigger to AllLine, Line Number, Odd Field or Even Field. Query the current sync type in video trigger.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{ODDField|EVENfield|LINE|ALINes}
ALINes
Note: when the video standard is HDTV, the sync type could only be set to AllLine or Line Number. For the video standard, refer to the :TRIGger:VIDeo:STANdard command.
Explanation
ODDField: trigger on the rising edge of the first ramp waveform pulse in the odd field.
EVENfield: trigger on the rising edge of the first ramp waveform pulse in the even field.
LINE for NTSC and PAL/SECAM video standards, trigger on the specified line in the odd or even field; for HDTV video standard, trigger on the specified line. Note that when this sync trigger mode is selected, you can modify the line number using in the “Line Num” menu with a step of 1. The range of the line number is from 1 to 525 (NTSC), 1 to 625 (PAL/SECAM), 1 to 525 (480P), 1 to 625 (576P), 1 to 750 (720P), 1 to 1125 (1080P) or 1 to 1125 (1080I).
ALINes: trigger on all the horizontal sync pulses.
Return Format
The query returns ODDF, EVEN, LINE or ALIN.
Example
:TRIGger:VIDeo:MODE ODDField The query returns ODDF.
- Return type
None
-
set_even_field()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:MODE <mode> :TRIGger:VIDeo:MODE?
Description
Set the sync type in video trigger to AllLine, Line Number, Odd Field or Even Field. Query the current sync type in video trigger.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{ODDField|EVENfield|LINE|ALINes}
ALINes
Note: when the video standard is HDTV, the sync type could only be set to AllLine or Line Number. For the video standard, refer to the :TRIGger:VIDeo:STANdard command.
Explanation
ODDField: trigger on the rising edge of the first ramp waveform pulse in the odd field.
EVENfield: trigger on the rising edge of the first ramp waveform pulse in the even field.
LINE for NTSC and PAL/SECAM video standards, trigger on the specified line in the odd or even field; for HDTV video standard, trigger on the specified line. Note that when this sync trigger mode is selected, you can modify the line number using in the “Line Num” menu with a step of 1. The range of the line number is from 1 to 525 (NTSC), 1 to 625 (PAL/SECAM), 1 to 525 (480P), 1 to 625 (576P), 1 to 750 (720P), 1 to 1125 (1080P) or 1 to 1125 (1080I).
ALINes: trigger on all the horizontal sync pulses.
Return Format
The query returns ODDF, EVEN, LINE or ALIN.
Example
:TRIGger:VIDeo:MODE ODDField The query returns ODDF.
- Return type
None
-
set_odd_field()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:MODE <mode> :TRIGger:VIDeo:MODE?
Description
Set the sync type in video trigger to AllLine, Line Number, Odd Field or Even Field. Query the current sync type in video trigger.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{ODDField|EVENfield|LINE|ALINes}
ALINes
Note: when the video standard is HDTV, the sync type could only be set to AllLine or Line Number. For the video standard, refer to the :TRIGger:VIDeo:STANdard command.
Explanation
ODDField: trigger on the rising edge of the first ramp waveform pulse in the odd field.
EVENfield: trigger on the rising edge of the first ramp waveform pulse in the even field.
LINE for NTSC and PAL/SECAM video standards, trigger on the specified line in the odd or even field; for HDTV video standard, trigger on the specified line. Note that when this sync trigger mode is selected, you can modify the line number using in the “Line Num” menu with a step of 1. The range of the line number is from 1 to 525 (NTSC), 1 to 625 (PAL/SECAM), 1 to 525 (480P), 1 to 625 (576P), 1 to 750 (720P), 1 to 1125 (1080P) or 1 to 1125 (1080I).
ALINes: trigger on all the horizontal sync pulses.
Return Format
The query returns ODDF, EVEN, LINE or ALIN.
Example
:TRIGger:VIDeo:MODE ODDField The query returns ODDF.
- Return type
None
-
set_specific_line()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:MODE <mode> :TRIGger:VIDeo:MODE?
Description
Set the sync type in video trigger to AllLine, Line Number, Odd Field or Even Field. Query the current sync type in video trigger.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{ODDField|EVENfield|LINE|ALINes}
ALINes
Note: when the video standard is HDTV, the sync type could only be set to AllLine or Line Number. For the video standard, refer to the :TRIGger:VIDeo:STANdard command.
Explanation
ODDField: trigger on the rising edge of the first ramp waveform pulse in the odd field.
EVENfield: trigger on the rising edge of the first ramp waveform pulse in the even field.
LINE for NTSC and PAL/SECAM video standards, trigger on the specified line in the odd or even field; for HDTV video standard, trigger on the specified line. Note that when this sync trigger mode is selected, you can modify the line number using in the “Line Num” menu with a step of 1. The range of the line number is from 1 to 525 (NTSC), 1 to 625 (PAL/SECAM), 1 to 525 (480P), 1 to 625 (576P), 1 to 750 (720P), 1 to 1125 (1080P) or 1 to 1125 (1080I).
ALINes: trigger on all the horizontal sync pulses.
Return Format
The query returns ODDF, EVEN, LINE or ALIN.
Example
:TRIGger:VIDeo:MODE ODDField The query returns ODDF.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:MODE <mode> :TRIGger:VIDeo:MODE?
Description
Set the sync type in video trigger to AllLine, Line Number, Odd Field or Even Field. Query the current sync type in video trigger.
Parameter
Name
Type
Range
Default
<mode>
Discrete
{ODDField|EVENfield|LINE|ALINes}
ALINes
Note: when the video standard is HDTV, the sync type could only be set to AllLine or Line Number. For the video standard, refer to the :TRIGger:VIDeo:STANdard command.
Explanation
ODDField: trigger on the rising edge of the first ramp waveform pulse in the odd field.
EVENfield: trigger on the rising edge of the first ramp waveform pulse in the even field.
LINE for NTSC and PAL/SECAM video standards, trigger on the specified line in the odd or even field; for HDTV video standard, trigger on the specified line. Note that when this sync trigger mode is selected, you can modify the line number using in the “Line Num” menu with a step of 1. The range of the line number is from 1 to 525 (NTSC), 1 to 625 (PAL/SECAM), 1 to 525 (480P), 1 to 625 (576P), 1 to 750 (720P), 1 to 1125 (1080P) or 1 to 1125 (1080I).
ALINes: trigger on all the horizontal sync pulses.
Return Format
The query returns ODDF, EVEN, LINE or ALIN.
Example
:TRIGger:VIDeo:MODE ODDField The query returns ODDF.
- Return type
str
-
-
class
ds2000.trigger.video.VideoStandard(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
set_ntsc()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_1080i24hz()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_1080i25hz()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_1080i30hz()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_1080p24hz()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_1080p25hz()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_1080p30hz()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_1080p50hz()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_1080p60hz()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_480p()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_576p()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_720p24hz()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_720p25hz()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_720p30hz()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_720p50hz()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_on_720p60hz()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
set_pal_secam()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Description
Select the video standard in video trigger. Query the current video standard in video trigger.
Parameter
Name
Type
Range
Default
<standard>
Discrete
{PALSecam|NTSC|480P|576P|720P60HZ| 720P50HZ|720P30HZ|720P25HZ| 720P24HZ|1080P60HZ|1080P50HZ| 1080P30HZ|1080P25HZ|1080P24HZ| 1080I30HZ|1080I25HZ|1080I24HZ}
NTSC
Return Format
The query returns the video standard selected.
Example
:TRIGger:VIDeo:STANdard NTSC The query returns NTSC.
- Return type
str
-
Windows Trigger Subsystem Module - windows.py¶
-
class
ds2000.trigger.windows.Windows(device)¶ Bases:
ds2000.common.SubController-
get_source()¶ Rigol Programming Guide
Syntax
:TRIGger:WINDows:SOURce <source> :TRIGger:WINDows:SOURce?
Description
Select the trigger source of windows trigger. Query the current trigger source of windows trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:WINDows:SOURce CHANnel2 The query returns CHAN2.
- Return type
str
-
get_time()¶ Rigol Programming Guide
Syntax
:TRIGger:WINDows:TIMe <NR3> :TRIGger:RUNT:TIMe?
Description
Select the windows time of windows trigger. Query the current windows time of windows trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
16ns to 4s
1μs
Explanation
This command is only available when the trigger position of windows trigger (refer to the :TRIGger:Windows:POSition command) is set to TIMe.
Return Format
The query returns the windows time in scientific notation.
Example
:TRIGger:WINDows:TIMe 0.002 The query returns 2.000000e-03.
- Return type
float
-
set_source(channel=1)¶ Rigol Programming Guide
Syntax
:TRIGger:WINDows:SOURce <source> :TRIGger:WINDows:SOURce?
Description
Select the trigger source of windows trigger. Query the current trigger source of windows trigger.
Parameter
Name
Type
Range
Default
<source>
Discrete
{CHANnel1|CHANnel2}
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
Example
:TRIGger:WINDows:SOURce CHANnel2 The query returns CHAN2.
- Return type
None
-
set_time(time=1e-06)¶ Rigol Programming Guide
Syntax
:TRIGger:WINDows:TIMe <NR3> :TRIGger:RUNT:TIMe?
Description
Select the windows time of windows trigger. Query the current windows time of windows trigger.
Parameter
Name
Type
Range
Default
<NR3>
Real
16ns to 4s
1μs
Explanation
This command is only available when the trigger position of windows trigger (refer to the :TRIGger:Windows:POSition command) is set to TIMe.
Return Format
The query returns the windows time in scientific notation.
Example
:TRIGger:WINDows:TIMe 0.002 The query returns 2.000000e-03.
- Return type
None
-
-
class
ds2000.trigger.windows.WindowsPosition(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
set_enter()¶ Rigol Programming Guide
Syntax
:TRIGger:WINDows:POSition <pos> :TRIGger:RUNT:POSition?
Description
Select the trigger position of windows trigger. Query the current trigger position of windows trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{EXIT|ENTER|TIMe}
ENTER
Return Format
The query returns EXIT, ENTER or TIM.
Example
:TRIGger:WINDows:POSition ENTER The query returns ENTER.
- Return type
None
-
set_exit()¶ Rigol Programming Guide
Syntax
:TRIGger:WINDows:POSition <pos> :TRIGger:RUNT:POSition?
Description
Select the trigger position of windows trigger. Query the current trigger position of windows trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{EXIT|ENTER|TIMe}
ENTER
Return Format
The query returns EXIT, ENTER or TIM.
Example
:TRIGger:WINDows:POSition ENTER The query returns ENTER.
- Return type
None
-
set_time()¶ Rigol Programming Guide
Syntax
:TRIGger:WINDows:POSition <pos> :TRIGger:RUNT:POSition?
Description
Select the trigger position of windows trigger. Query the current trigger position of windows trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{EXIT|ENTER|TIMe}
ENTER
Return Format
The query returns EXIT, ENTER or TIM.
Example
:TRIGger:WINDows:POSition ENTER The query returns ENTER.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:WINDows:POSition <pos> :TRIGger:RUNT:POSition?
Description
Select the trigger position of windows trigger. Query the current trigger position of windows trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{EXIT|ENTER|TIMe}
ENTER
Return Format
The query returns EXIT, ENTER or TIM.
Example
:TRIGger:WINDows:POSition ENTER The query returns ENTER.
- Return type
str
-
-
class
ds2000.trigger.windows.WindowsSlope(subsubdevice)¶ Bases:
ds2000.common.SubSubController-
set_negative()¶ Rigol Programming Guide
Syntax
:TRIGger:WINDows:SLOPe <type> :TRIGger:RUNT:SLOPe?
Description
Select the windows type of windows trigger. Query the current windows type of windows trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{POSitive|NEGative|RFALl}
POSitive
Return Format
The query returns POSitive, NEGative or RFALl.
Example :TRIGger:WINDows:SLOPe NEGative The query returns NEG.
- Return type
None
-
set_positive()¶ Rigol Programming Guide
Syntax
:TRIGger:WINDows:SLOPe <type> :TRIGger:RUNT:SLOPe?
Description
Select the windows type of windows trigger. Query the current windows type of windows trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{POSitive|NEGative|RFALl}
POSitive
Return Format
The query returns POSitive, NEGative or RFALl.
Example :TRIGger:WINDows:SLOPe NEGative The query returns NEG.
- Return type
None
-
set_rfali()¶ Rigol Programming Guide
Syntax
:TRIGger:WINDows:SLOPe <type> :TRIGger:RUNT:SLOPe?
Description
Select the windows type of windows trigger. Query the current windows type of windows trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{POSitive|NEGative|RFALl}
POSitive
Return Format
The query returns POSitive, NEGative or RFALl.
Example :TRIGger:WINDows:SLOPe NEGative The query returns NEG.
- Return type
None
-
status()¶ Rigol Programming Guide
Syntax
:TRIGger:WINDows:SLOPe <type> :TRIGger:RUNT:SLOPe?
Description
Select the windows type of windows trigger. Query the current windows type of windows trigger.
Parameter
Name
Type
Range
Default
<type>
Discrete
{POSitive|NEGative|RFALl}
POSitive
Return Format
The query returns POSitive, NEGative or RFALl.
Example :TRIGger:WINDows:SLOPe NEGative The query returns NEG.
- Return type
str
-