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
[docs]class DigitalCls:
"""Digital commands group definition. 27 total commands, 6 Subgroups, 4 group commands"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("digital", core, parent)
@property
def bbmm(self):
"""bbmm commands group. 2 Sub-classes, 0 commands."""
if not hasattr(self, '_bbmm'):
from .Bbmm import BbmmCls
self._bbmm = BbmmCls(self._core, self._cmd_group)
return self._bbmm
@property
def channel(self):
"""channel commands group. 4 Sub-classes, 0 commands."""
if not hasattr(self, '_channel'):
from .Channel import ChannelCls
self._channel = ChannelCls(self._core, self._cmd_group)
return self._channel
@property
def gdelay(self):
"""gdelay commands group. 0 Sub-classes, 1 commands."""
if not hasattr(self, '_gdelay'):
from .Gdelay import GdelayCls
self._gdelay = GdelayCls(self._core, self._cmd_group)
return self._gdelay
@property
def oflow(self):
"""oflow commands group. 1 Sub-classes, 1 commands."""
if not hasattr(self, '_oflow'):
from .Oflow import OflowCls
self._oflow = OflowCls(self._core, self._cmd_group)
return self._oflow
@property
def power(self):
"""power commands group. 1 Sub-classes, 4 commands."""
if not hasattr(self, '_power'):
from .Power import PowerCls
self._power = PowerCls(self._core, self._cmd_group)
return self._power
@property
def symbolRate(self):
"""symbolRate commands group. 2 Sub-classes, 4 commands."""
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:
"""SCPI: [SOURce<HW>]:IQ:OUTPut:DIGital:CDEVice \n
Snippet: value: str = driver.source.iq.output.digital.get_cdevice() \n
Queries information on the connected device. \n
: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:
"""SCPI: [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. \n
: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:
"""SCPI: [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. \n
: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:
"""SCPI: [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. \n
: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:
"""SCPI: [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. \n
: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:
"""SCPI: [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
INTRO_CMD_HELP: 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 ([:SOURce<hw>]:BBIN:STATe)
- The external digital baseband input ([:SOURce<hw>]:BBIN:STATe) and digital output ([:SOURce<hw>]:IQ:OUTPut:DIGital:STATe) because they share the same physical connectors (Dig I/Q and the HS Dig I/Q) .
- The digital output ([:SOURce<hw>]:IQ:OUTPut:DIGital:STATe) and the output of analog I/Q signals:
Table Header: \n
- If [:SOURce<hw>]:IQ:SOURce BASeband, [:SOURce<hw>]:IQ:STATe + OUTPut<hw>:STATe or
- [:SOURce<hw>]:IQ:OUTPut:ANALog:STATe \n
: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:
"""SCPI: [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
INTRO_CMD_HELP: 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 ([:SOURce<hw>]:BBIN:STATe)
- The external digital baseband input ([:SOURce<hw>]:BBIN:STATe) and digital output ([:SOURce<hw>]:IQ:OUTPut:DIGital:STATe) because they share the same physical connectors (Dig I/Q and the HS Dig I/Q) .
- The digital output ([:SOURce<hw>]:IQ:OUTPut:DIGital:STATe) and the output of analog I/Q signals:
Table Header: \n
- If [:SOURce<hw>]:IQ:SOURce BASeband, [:SOURce<hw>]:IQ:STATe + OUTPut<hw>:STATe or
- [:SOURce<hw>]:IQ:OUTPut:ANALog:STATe \n
: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