Holdoff

SCPI Commands :

TRIGger:HOLDoff:AUTotime
TRIGger:HOLDoff:EVENts
TRIGger:HOLDoff:MAX
TRIGger:HOLDoff:MIN
TRIGger:HOLDoff:MODE
TRIGger:HOLDoff:SCALing
TRIGger:HOLDoff:TIME
Commands in total: 7
Subgroups: 0
Direct child commands: 7
get_auto_time() float[source]
# TRIGger:HOLDoff:AUTotime
value: float = driver.trigger.holdoff.get_auto_time()

Returns the resulting holdoff time, if method RsMxo.trigger.holdoff.mode() is set to AUTO: Auto time = Auto time scaling * Horizontal scale. The auto time scaling factor is defined with method RsMxo.trigger.holdoff.scaling() .

Returns:

auto_time: 1E-07 to 10

get_events() int[source]
# TRIGger:HOLDoff:EVENts
value: int = driver.trigger.holdoff.get_events()

Defines the number of triggers to be skipped, if method RsMxo.trigger.holdoff.mode() is set to EVENts. The next trigger only occurs when this number of events is reached.

Returns:

events: 1 to 2147483647

get_max() float[source]
# TRIGger:HOLDoff:MAX
value: float = driver.trigger.holdoff.get_max()

Defines the upper limit for the random time holdoff, if method RsMxo.trigger.holdoff.mode() is set to RANDom.

Returns:

random_max_time: 1E-07 to 10

get_min() float[source]
# TRIGger:HOLDoff:MIN
value: float = driver.trigger.holdoff.get_min()

Defines the lower limit for the random time holdoff, if method RsMxo.trigger.holdoff.mode() is set to RANDom.

Returns:

random_min_time: 1E-07 to 5

get_mode() TriggerHoldoffMode[source]
# TRIGger:HOLDoff:MODE
value: enums.TriggerHoldoffMode = driver.trigger.holdoff.get_mode()

Selects the method to define the holdoff condition. The trigger holdoff defines when the next trigger after the current will be recognized. Thus, it affects the next trigger to occur after the current one. Holdoff helps to obtain stable triggering when the oscilloscope is triggering on undesired events. Holdoff settings are not available if the trigger source is an external trigger input or serial bus, and if you trigger on a sequence of events.

Returns:

mode: TIME | EVENts | RANDom | AUTO | OFF

  • TIME: Defines the holdoff directly as a time period. The next trigger occurs only after the holdoff time has passed, which is defined using TRIGger:HOLDoff:TIME) .

  • EVENts: Defines the holdoff as a number of trigger events. The next trigger occurs only when this number of events is reached. The number of triggers to be skipped is defined with TRIGger:HOLDoff:EVENts.

  • RANDom: Defines the holdoff as a random time limited by TRIGger:HOLDoff:MIN and TRIGger:HOLDoff:MAX. For each acquisition cycle, the instrument selects a new random holdoff time from the specified range.

  • AUTO: The holdoff time is calculated automatically based on the current horizontal scale.

  • OFF: No holdoff

get_scaling() float[source]
# TRIGger:HOLDoff:SCALing
value: float = driver.trigger.holdoff.get_scaling()

Sets the auto time scaling factor that the horizontal scale is multipied with, if method RsMxo.trigger.holdoff.mode() is set to AUTO. Auto time = Auto time scaling * Horizontal scale The next trigger occurs only after this time has passed.

Returns:

auto_time_scl: 0.001 to 1000

get_time() float[source]
# TRIGger:HOLDoff:TIME
value: float = driver.trigger.holdoff.get_time()

Defines the holdoff time period, if method RsMxo.trigger.holdoff.mode() is set to TIME. The next trigger occurs only after this time has passed.

Returns:

time: 1E-07 to 10

set_events(events: int) None[source]
# TRIGger:HOLDoff:EVENts
driver.trigger.holdoff.set_events(events = 1)

Defines the number of triggers to be skipped, if method RsMxo.trigger.holdoff.mode() is set to EVENts. The next trigger only occurs when this number of events is reached.

Parameters:

events – 1 to 2147483647

set_max(random_max_time: float) None[source]
# TRIGger:HOLDoff:MAX
driver.trigger.holdoff.set_max(random_max_time = 1.0)

Defines the upper limit for the random time holdoff, if method RsMxo.trigger.holdoff.mode() is set to RANDom.

Parameters:

random_max_time – 1E-07 to 10

set_min(random_min_time: float) None[source]
# TRIGger:HOLDoff:MIN
driver.trigger.holdoff.set_min(random_min_time = 1.0)

Defines the lower limit for the random time holdoff, if method RsMxo.trigger.holdoff.mode() is set to RANDom.

Parameters:

random_min_time – 1E-07 to 5

set_mode(mode: TriggerHoldoffMode) None[source]
# TRIGger:HOLDoff:MODE
driver.trigger.holdoff.set_mode(mode = enums.TriggerHoldoffMode.AUTO)

Selects the method to define the holdoff condition. The trigger holdoff defines when the next trigger after the current will be recognized. Thus, it affects the next trigger to occur after the current one. Holdoff helps to obtain stable triggering when the oscilloscope is triggering on undesired events. Holdoff settings are not available if the trigger source is an external trigger input or serial bus, and if you trigger on a sequence of events.

Parameters:

mode

TIME | EVENts | RANDom | AUTO | OFF

  • TIME: Defines the holdoff directly as a time period. The next trigger occurs only after the holdoff time has passed, which is defined using TRIGger:HOLDoff:TIME) .

  • EVENts: Defines the holdoff as a number of trigger events. The next trigger occurs only when this number of events is reached. The number of triggers to be skipped is defined with TRIGger:HOLDoff:EVENts.

  • RANDom: Defines the holdoff as a random time limited by TRIGger:HOLDoff:MIN and TRIGger:HOLDoff:MAX. For each acquisition cycle, the instrument selects a new random holdoff time from the specified range.

  • AUTO: The holdoff time is calculated automatically based on the current horizontal scale.

  • OFF: No holdoff

set_scaling(auto_time_scl: float) None[source]
# TRIGger:HOLDoff:SCALing
driver.trigger.holdoff.set_scaling(auto_time_scl = 1.0)

Sets the auto time scaling factor that the horizontal scale is multipied with, if method RsMxo.trigger.holdoff.mode() is set to AUTO. Auto time = Auto time scaling * Horizontal scale The next trigger occurs only after this time has passed.

Parameters:

auto_time_scl – 0.001 to 1000

set_time(time: float) None[source]
# TRIGger:HOLDoff:TIME
driver.trigger.holdoff.set_time(time = 1.0)

Defines the holdoff time period, if method RsMxo.trigger.holdoff.mode() is set to TIME. The next trigger occurs only after this time has passed.

Parameters:

time – 1E-07 to 10