from ....Internal.Core import Core
from ....Internal.CommandsGroup import CommandsGroup
from ....Internal import Conversions
from .... import enums
from .... import repcap
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
class RangeCls:
"""
| Commands in total: 1
| Subgroups: 0
| Direct child commands: 1
"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("range", core, parent)
[docs]
def set(self, mode: enums.RuntMode, trigger=repcap.Trigger.Default) -> None:
"""
``TRIGger<*>:RUNT:RANGe`` \n
Snippet: ``driver.trigger.runt.range.set(mode = enums.RuntMode.ANY, trigger = repcap.Trigger.Default)`` \n
Defines the time limit of the runt pulse in relation to the method ``RsRtx.trigger.runt.width.set()`` and method
``RsRtx.trigger.runt.delta.set()`` settings.
:param mode: ANY | LONGer | SHORter | WITHin | OUTSide \n
- ANY: Triggers on all runts fulfilling the level condition, without time limitation.
- LONGer: Triggers on runts longer than the given Runt width.
- SHORter: Triggers on runts shorter than the given Runt width.
- WITHin: Triggers if the runt length is inside a given time range. The range is defined by Runt width and ±Delta.
- OUTSide: Triggers if the runt length is outside a given time range. The range is defined by Runt width and ±Delta.
:param trigger: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Trigger')
"""
param = Conversions.enum_scalar_to_str(mode, enums.RuntMode)
trigger_cmd_val = self._cmd_group.get_repcap_cmd_value(trigger, repcap.Trigger)
self._core.io.write_with_opc(f'TRIGger{trigger_cmd_val}:RUNT:RANGe {param}')
# noinspection PyTypeChecker
[docs]
def get(self, trigger=repcap.Trigger.Default) -> enums.RuntMode:
"""
``TRIGger<*>:RUNT:RANGe`` \n
Snippet: ``value: enums.RuntMode = driver.trigger.runt.range.get(trigger = repcap.Trigger.Default)`` \n
Defines the time limit of the runt pulse in relation to the method ``RsRtx.trigger.runt.width.set()`` and method
``RsRtx.trigger.runt.delta.set()`` settings.
:param trigger: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Trigger')
:return: mode: ANY | LONGer | SHORter | WITHin | OUTSide \n
- ANY: Triggers on all runts fulfilling the level condition, without time limitation.
- LONGer: Triggers on runts longer than the given Runt width.
- SHORter: Triggers on runts shorter than the given Runt width.
- WITHin: Triggers if the runt length is inside a given time range. The range is defined by Runt width and ±Delta.
- OUTSide: Triggers if the runt length is outside a given time range. The range is defined by Runt width and ±Delta.
"""
trigger_cmd_val = self._cmd_group.get_repcap_cmd_value(trigger, repcap.Trigger)
response = self._core.io.query_str_with_opc(f'TRIGger{trigger_cmd_val}:RUNT:RANGe?')
return Conversions.str_to_scalar_enum(response, enums.RuntMode)