from ......Internal.Core import Core
from ......Internal.CommandsGroup import CommandsGroup
from ......Internal import Conversions
from ...... import enums
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
[docs]class TriggerCls:
"""Trigger commands group definition. 17 total commands, 6 Subgroups, 5 group commands"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("trigger", core, parent)
@property
def arm(self):
"""arm commands group. 1 Sub-classes, 0 commands."""
if not hasattr(self, '_arm'):
from .Arm import ArmCls
self._arm = ArmCls(self._core, self._cmd_group)
return self._arm
@property
def execute(self):
"""execute commands group. 0 Sub-classes, 1 commands."""
if not hasattr(self, '_execute'):
from .Execute import ExecuteCls
self._execute = ExecuteCls(self._core, self._cmd_group)
return self._execute
@property
def external(self):
"""external commands group. 3 Sub-classes, 0 commands."""
if not hasattr(self, '_external'):
from .External import ExternalCls
self._external = ExternalCls(self._core, self._cmd_group)
return self._external
@property
def obaseband(self):
"""obaseband commands group. 0 Sub-classes, 2 commands."""
if not hasattr(self, '_obaseband'):
from .Obaseband import ObasebandCls
self._obaseband = ObasebandCls(self._core, self._cmd_group)
return self._obaseband
@property
def output(self):
"""output commands group. 2 Sub-classes, 0 commands."""
if not hasattr(self, '_output'):
from .Output import OutputCls
self._output = OutputCls(self._core, self._cmd_group)
return self._output
@property
def time(self):
"""time commands group. 2 Sub-classes, 1 commands."""
if not hasattr(self, '_time'):
from .Time import TimeCls
self._time = TimeCls(self._core, self._cmd_group)
return self._time
# noinspection PyTypeChecker
[docs] def get_rmode(self) -> enums.TrigRunMode:
"""SCPI: [SOURce<HW>]:BB:PRAMp:TRIGger:RMODe \n
Snippet: value: enums.TrigRunMode = driver.source.bb.pramp.trigger.get_rmode() \n
Queries the status of signal generation. \n
:return: rmode: STOP| RUN
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:TRIGger:RMODe?')
return Conversions.str_to_scalar_enum(response, enums.TrigRunMode)
[docs] def get_slength(self) -> int:
"""SCPI: [SOURce<HW>]:BB:PRAMp:TRIGger:SLENgth \n
Snippet: value: int = driver.source.bb.pramp.trigger.get_slength() \n
Defines the length of the signal sequence to be output in the SINGle trigger mode,
see [:SOURce<hw>]:BB:PRAMp[:TRIGger]:SEQuence. \n
:return: slength: integer Range: 1 to 7000, Unit: symbol
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:TRIGger:SLENgth?')
return Conversions.str_to_int(response)
[docs] def set_slength(self, slength: int) -> None:
"""SCPI: [SOURce<HW>]:BB:PRAMp:TRIGger:SLENgth \n
Snippet: driver.source.bb.pramp.trigger.set_slength(slength = 1) \n
Defines the length of the signal sequence to be output in the SINGle trigger mode,
see [:SOURce<hw>]:BB:PRAMp[:TRIGger]:SEQuence. \n
:param slength: integer Range: 1 to 7000, Unit: symbol
"""
param = Conversions.decimal_value_to_str(slength)
self._core.io.write(f'SOURce<HwInstance>:BB:PRAMp:TRIGger:SLENgth {param}')
# noinspection PyTypeChecker
[docs] def get_sl_unit(self) -> enums.UnitSlDvb:
"""SCPI: [SOURce<HW>]:BB:PRAMp:TRIGger:SLUNit \n
Snippet: value: enums.UnitSlDvb = driver.source.bb.pramp.trigger.get_sl_unit() \n
Defines the unit for the entry of the length of the signal sequence to be output in the Single trigger mode, see
[:SOURce<hw>]:BB:PRAMp[:TRIGger]:SEQuence. \n
:return: sl_unit: FRAMe| SEQuence FRAMe Unit Frame. A single frame is generated after a trigger event. SEQuence Unit Sequence Length. A single sequence is generated after a trigger event.
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:TRIGger:SLUNit?')
return Conversions.str_to_scalar_enum(response, enums.UnitSlDvb)
[docs] def set_sl_unit(self, sl_unit: enums.UnitSlDvb) -> None:
"""SCPI: [SOURce<HW>]:BB:PRAMp:TRIGger:SLUNit \n
Snippet: driver.source.bb.pramp.trigger.set_sl_unit(sl_unit = enums.UnitSlDvb.FRAMe) \n
Defines the unit for the entry of the length of the signal sequence to be output in the Single trigger mode, see
[:SOURce<hw>]:BB:PRAMp[:TRIGger]:SEQuence. \n
:param sl_unit: FRAMe| SEQuence FRAMe Unit Frame. A single frame is generated after a trigger event. SEQuence Unit Sequence Length. A single sequence is generated after a trigger event.
"""
param = Conversions.enum_scalar_to_str(sl_unit, enums.UnitSlDvb)
self._core.io.write(f'SOURce<HwInstance>:BB:PRAMp:TRIGger:SLUNit {param}')
# noinspection PyTypeChecker
[docs] def get_source(self) -> enums.TriggerSourceC:
"""SCPI: [SOURce<HW>]:BB:PRAMp:TRIGger:SOURce \n
Snippet: value: enums.TriggerSourceC = driver.source.bb.pramp.trigger.get_source() \n
INTRO_CMD_HELP: Selects the trigger signal source and determines the way the triggering is executed. Provided are: \n
- Internal triggering by a command (INTernal)
- External trigger signal via one of the local or global connectors
Table Header: \n
- EGT1|EGT2: External global trigger
- EGC1|EGC2: External global clock
- ELTRigger: External local trigger
- ELCLock: External local clock
- Internal triggering by a signal from the other basebands (INTA|INTB)
- OBASeband|BEXTernal|EXTernal: Setting only Provided only for backward
compatibility with other Rohde & Schwarz signal generators. The R&S SMW accepts these values and maps them automatically
as follows: EXTernal = EGT1, BEXTernal = EGT2, OBASeband = INTA or INTB (depending on the current baseband) \n
:return: source: INTernal| EGT1| EXTernal| EGC1 | INTB| OBASeband| ELTRigger| EGT2| EGC2| INTA| ELCLock| BEXTernal
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:TRIGger:SOURce?')
return Conversions.str_to_scalar_enum(response, enums.TriggerSourceC)
[docs] def set_source(self, source: enums.TriggerSourceC) -> None:
"""SCPI: [SOURce<HW>]:BB:PRAMp:TRIGger:SOURce \n
Snippet: driver.source.bb.pramp.trigger.set_source(source = enums.TriggerSourceC.BBSY) \n
INTRO_CMD_HELP: Selects the trigger signal source and determines the way the triggering is executed. Provided are: \n
- Internal triggering by a command (INTernal)
- External trigger signal via one of the local or global connectors
Table Header: \n
- EGT1|EGT2: External global trigger
- EGC1|EGC2: External global clock
- ELTRigger: External local trigger
- ELCLock: External local clock
- Internal triggering by a signal from the other basebands (INTA|INTB)
- OBASeband|BEXTernal|EXTernal: Setting only Provided only for backward
compatibility with other Rohde & Schwarz signal generators. The R&S SMW accepts these values and maps them automatically
as follows: EXTernal = EGT1, BEXTernal = EGT2, OBASeband = INTA or INTB (depending on the current baseband) \n
:param source: INTernal| EGT1| EXTernal| EGC1 | INTB| OBASeband| ELTRigger| EGT2| EGC2| INTA| ELCLock| BEXTernal
"""
param = Conversions.enum_scalar_to_str(source, enums.TriggerSourceC)
self._core.io.write(f'SOURce<HwInstance>:BB:PRAMp:TRIGger:SOURce {param}')
# noinspection PyTypeChecker
[docs] def get_sequence(self) -> enums.DmTrigMode:
"""SCPI: [SOURce<HW>]:BB:PRAMp:[TRIGger]:SEQuence \n
Snippet: value: enums.DmTrigMode = driver.source.bb.pramp.trigger.get_sequence() \n
INTRO_CMD_HELP: Selects the trigger mode: \n
- AUTO = auto
- RETRigger = retrigger
- AAUTo = armed auto
- ARETrigger = armed retrigger
- SINGle = single
Selects the trigger mode. \n
:return: sequence: AUTO| RETRigger| AAUTo| ARETrigger| SINGle
"""
response = self._core.io.query_str('SOURce<HwInstance>:BB:PRAMp:TRIGger:SEQuence?')
return Conversions.str_to_scalar_enum(response, enums.DmTrigMode)
[docs] def set_sequence(self, sequence: enums.DmTrigMode) -> None:
"""SCPI: [SOURce<HW>]:BB:PRAMp:[TRIGger]:SEQuence \n
Snippet: driver.source.bb.pramp.trigger.set_sequence(sequence = enums.DmTrigMode.AAUTo) \n
INTRO_CMD_HELP: Selects the trigger mode: \n
- AUTO = auto
- RETRigger = retrigger
- AAUTo = armed auto
- ARETrigger = armed retrigger
- SINGle = single
Selects the trigger mode. \n
:param sequence: AUTO| RETRigger| AAUTo| ARETrigger| SINGle
"""
param = Conversions.enum_scalar_to_str(sequence, enums.DmTrigMode)
self._core.io.write(f'SOURce<HwInstance>:BB:PRAMp:TRIGger:SEQuence {param}')
def clone(self) -> 'TriggerCls':
"""Clones the group by creating new object from it and its whole existing subgroups
Also copies all the existing default Repeated Capabilities setting,
which you can change independently without affecting the original group"""
new_group = TriggerCls(self._core, self._cmd_group.parent)
self._cmd_group.synchronize_repcaps(new_group)
return new_group