from ......Internal.Core import Core
from ......Internal.CommandsGroup import CommandsGroup
from ......Internal import Conversions
from ......Internal.Utilities import trim_str_response
from ...... import enums
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
class DigitalCls:
"""
| Commands in total: 27
| Subgroups: 6
| Direct child commands: 4
"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("digital", core, parent)
@property
def bbmm(self):
"""
| Commands in total: 2
| Subgroups: 2
| Direct child commands: 0
"""
if not hasattr(self, '_bbmm'):
from .Bbmm import BbmmCls
self._bbmm = BbmmCls(self._core, self._cmd_group)
return self._bbmm
@property
def channel(self):
"""
| Commands in total: 5
| Subgroups: 4
| Direct child commands: 0
"""
if not hasattr(self, '_channel'):
from .Channel import ChannelCls
self._channel = ChannelCls(self._core, self._cmd_group)
return self._channel
@property
def gdelay(self):
"""
| Commands in total: 1
| Subgroups: 0
| Direct child commands: 1
"""
if not hasattr(self, '_gdelay'):
from .Gdelay import GdelayCls
self._gdelay = GdelayCls(self._core, self._cmd_group)
return self._gdelay
@property
def oflow(self):
"""
| Commands in total: 3
| Subgroups: 1
| Direct child commands: 1
"""
if not hasattr(self, '_oflow'):
from .Oflow import OflowCls
self._oflow = OflowCls(self._core, self._cmd_group)
return self._oflow
@property
def power(self):
"""
| Commands in total: 6
| Subgroups: 1
| Direct child commands: 4
"""
if not hasattr(self, '_power'):
from .Power import PowerCls
self._power = PowerCls(self._core, self._cmd_group)
return self._power
@property
def symbolRate(self):
"""
| Commands in total: 6
| Subgroups: 2
| Direct child commands: 4
"""
if not hasattr(self, '_symbolRate'):
from .SymbolRate import SymbolRateCls
self._symbolRate = SymbolRateCls(self._core, self._cmd_group)
return self._symbolRate
[docs]
def get_cdevice(self) -> str:
"""
``[SOURce<HW>]:IQ:OUTPut:DIGital:CDEVice`` \n
Snippet: ``value: str = driver.source.iq.output.digital.get_cdevice()`` \n
Queries information on the connected device.
:return: cdevice: string
"""
response = self._core.io.query_str('SOURce<HwInstance>:IQ:OUTPut:DIGital:CDEVice?')
return trim_str_response(response)
# noinspection PyTypeChecker
[docs]
def get_interface(self) -> enums.BbinInterfaceMode:
"""
``[SOURce<HW>]:IQ:OUTPut:DIGital:INTerface`` \n
Snippet: ``value: enums.BbinInterfaceMode = driver.source.iq.output.digital.get_interface()`` \n
Selects the connector at that the signal is output.
:return: bbout_interf_mode: HSDin | DIN HSDin HS Dig I/Q DIN Dig I/Q
"""
response = self._core.io.query_str('SOURce<HwInstance>:IQ:OUTPut:DIGital:INTerface?')
return Conversions.str_to_scalar_enum(response, enums.BbinInterfaceMode)
[docs]
def set_interface(self, bbout_interf_mode: enums.BbinInterfaceMode) -> None:
"""
``[SOURce<HW>]:IQ:OUTPut:DIGital:INTerface`` \n
Snippet: ``driver.source.iq.output.digital.set_interface(bbout_interf_mode = enums.BbinInterfaceMode.DIGital)`` \n
Selects the connector at that the signal is output.
:param bbout_interf_mode: HSDin | DIN HSDin HS Dig I/Q DIN Dig I/Q
"""
param = Conversions.enum_scalar_to_str(bbout_interf_mode, enums.BbinInterfaceMode)
self._core.io.write(f'SOURce<HwInstance>:IQ:OUTPut:DIGital:INTerface {param}')
# noinspection PyTypeChecker
[docs]
def get_pon(self) -> enums.UnchOff:
"""
``[SOURce<HW>]:IQ:OUTPut:DIGital:PON`` \n
Snippet: ``value: enums.UnchOff = driver.source.iq.output.digital.get_pon()`` \n
Sets the power-on state of the selected digital I/Q output.
:return: pon: OFF | UNCHanged
"""
response = self._core.io.query_str('SOURce<HwInstance>:IQ:OUTPut:DIGital:PON?')
return Conversions.str_to_scalar_enum(response, enums.UnchOff)
[docs]
def set_pon(self, pon: enums.UnchOff) -> None:
"""
``[SOURce<HW>]:IQ:OUTPut:DIGital:PON`` \n
Snippet: ``driver.source.iq.output.digital.set_pon(pon = enums.UnchOff.OFF)`` \n
Sets the power-on state of the selected digital I/Q output.
:param pon: OFF | UNCHanged
"""
param = Conversions.enum_scalar_to_str(pon, enums.UnchOff)
self._core.io.write(f'SOURce<HwInstance>:IQ:OUTPut:DIGital:PON {param}')
[docs]
def get_state(self) -> bool:
"""
``[SOURce<HW>]:IQ:OUTPut:DIGital:STATe`` \n
Snippet: ``value: bool = driver.source.iq.output.digital.get_state()`` \n
Activates the digital I/Q signal output. Note: Interdependencies
The following functions cannot be activated simultaneously. They deactivate each other. \n
- The internal baseband generator ([:SOURce<hw>]:BB:<DigStd>:STATe) and the external digital baseband input (method ``RsSmbv.source.bbin.state()`` )
- The external digital baseband input (method ``RsSmbv.source.bbin.state()`` ) and digital output (method ``RsSmbv.source.iq.output.digital.state()`` ) because they share the same physical connectors (Dig I/Q and the HS Dig I/Q) .
- The digital output (method ``RsSmbv.source.iq.output.digital.state()`` ) and the output of analog I/Q signals:
\n
- If [:SOURce<hw>]:IQ:SOURce BASeband, method ``RsSmbv.source.iq.state()`` + OUTPut<hw>:STATe or
- method ``RsSmbv.source.iq.output.analog.state()``
:return: state: 1 | ON | 0| OFF
"""
response = self._core.io.query_str('SOURce<HwInstance>:IQ:OUTPut:DIGital:STATe?')
return Conversions.str_to_bool(response)
[docs]
def set_state(self, state: bool) -> None:
"""
``[SOURce<HW>]:IQ:OUTPut:DIGital:STATe`` \n
Snippet: ``driver.source.iq.output.digital.set_state(state = False)`` \n
Activates the digital I/Q signal output. Note: Interdependencies
The following functions cannot be activated simultaneously. They deactivate each other. \n
- The internal baseband generator ([:SOURce<hw>]:BB:<DigStd>:STATe) and the external digital baseband input (method ``RsSmbv.source.bbin.state()`` )
- The external digital baseband input (method ``RsSmbv.source.bbin.state()`` ) and digital output (method ``RsSmbv.source.iq.output.digital.state()`` ) because they share the same physical connectors (Dig I/Q and the HS Dig I/Q) .
- The digital output (method ``RsSmbv.source.iq.output.digital.state()`` ) and the output of analog I/Q signals:
\n
- If [:SOURce<hw>]:IQ:SOURce BASeband, method ``RsSmbv.source.iq.state()`` + OUTPut<hw>:STATe or
- method ``RsSmbv.source.iq.output.analog.state()``
:param state: 1 | ON | 0| OFF
"""
param = Conversions.bool_to_str(state)
self._core.io.write(f'SOURce<HwInstance>:IQ:OUTPut:DIGital:STATe {param}')
def clone(self) -> 'DigitalCls':
"""
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 = DigitalCls(self._core, self._cmd_group.parent)
self._cmd_group.synchronize_repcaps(new_group)
return new_group