from ........Internal.Core import Core
from ........Internal.CommandsGroup import CommandsGroup
from ........Internal import Conversions
from ........ import repcap
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
class CarrierCls:
"""
| Commands in total: 1
| Subgroups: 0
| Direct child commands: 1
"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("carrier", core, parent)
[docs]
def set(self, power: float, subBlock=repcap.SubBlock.Default) -> None:
"""
``[SENSe]:ESPectrum<sb>:MSR:GSM:CARRier`` \n
Snippet: ``driver.applications.k14Xnr5G.sense.espectrum.msr.gsm.carrier.set(power = 1.0, subBlock = repcap.SubBlock.Default)`` \n
Defines the power of the GSM carrier (if available, see method ``RsFsw.sense.espectrum.msr.gsm.cpresent.set()`` ) .
Is only available for band category 2 (see method ``RsFsw.sense.espectrum.msr.bcategory.set()`` ) .
:param power: Range: 0 dBm to 100 dBm, Unit: dBm
:param subBlock: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Espectrum')
"""
param = Conversions.decimal_value_to_str(power)
subBlock_cmd_val = self._cmd_group.get_repcap_cmd_value(subBlock, repcap.SubBlock)
self._core.io.write(f'SENSe:ESPectrum{subBlock_cmd_val}:MSR:GSM:CARRier {param}')
[docs]
def get(self, subBlock=repcap.SubBlock.Default) -> float:
"""
``[SENSe]:ESPectrum<sb>:MSR:GSM:CARRier`` \n
Snippet: ``value: float = driver.applications.k14Xnr5G.sense.espectrum.msr.gsm.carrier.get(subBlock = repcap.SubBlock.Default)`` \n
Defines the power of the GSM carrier (if available, see method ``RsFsw.sense.espectrum.msr.gsm.cpresent.set()`` ) .
Is only available for band category 2 (see method ``RsFsw.sense.espectrum.msr.bcategory.set()`` ) .
:param subBlock: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Espectrum')
:return: power: Range: 0 dBm to 100 dBm, Unit: dBm
"""
subBlock_cmd_val = self._cmd_group.get_repcap_cmd_value(subBlock, repcap.SubBlock)
response = self._core.io.query_str(f'SENSe:ESPectrum{subBlock_cmd_val}:MSR:GSM:CARRier?')
return Conversions.str_to_float(response)