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 AttenuationCls:
"""
| Commands in total: 1
| Subgroups: 0
| Direct child commands: 1
"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("attenuation", core, parent)
[docs]
def set(self, attenuation: enums.GsmBursSlotAtt, frameIx=repcap.FrameIx.Default, slotNull=repcap.SlotNull.Default, subChannel=repcap.SubChannel.Default, userIx=repcap.UserIx.Default) -> None:
"""
``[SOURce<HW>]:BB:GSM:[FRAMe<DI>]:SLOT<ST0>:[SUBChannel<US>]:[USER<CH>]:ATTenuation`` \n
Snippet: ``driver.source.bb.gsm.frame.slot.subChannel.user.attenuation.set(attenuation = enums.GsmBursSlotAtt.A1, frameIx = repcap.FrameIx.Default, slotNull = repcap.SlotNull.Default, subChannel = repcap.SubChannel.Default, userIx = repcap.UserIx.Default)`` \n
The command selects one of seven possible values for the level attenuation. This value defines by how much the power of
the selected slot with power control level BB:GSM:SLOT:LEV ATT is reduced in relation to the normal output power
(attribute ...:LEVEL FULL) . The seven possible values are set using the command SOURce:BB:GSM:SATTenuation<n>.
:param attenuation: A1 | A2 | A3 | A4 | A5 | A6 | A7
:param frameIx: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Frame')
:param slotNull: optional repeated capability selector. Default value: Nr0 (settable in the interface 'Slot')
:param subChannel: optional repeated capability selector. Default value: Nr1 (settable in the interface 'SubChannel')
:param userIx: optional repeated capability selector. Default value: Nr1 (settable in the interface 'User')
"""
param = Conversions.enum_scalar_to_str(attenuation, enums.GsmBursSlotAtt)
frameIx_cmd_val = self._cmd_group.get_repcap_cmd_value(frameIx, repcap.FrameIx)
slotNull_cmd_val = self._cmd_group.get_repcap_cmd_value(slotNull, repcap.SlotNull)
subChannel_cmd_val = self._cmd_group.get_repcap_cmd_value(subChannel, repcap.SubChannel)
userIx_cmd_val = self._cmd_group.get_repcap_cmd_value(userIx, repcap.UserIx)
self._core.io.write(f'SOURce<HwInstance>:BB:GSM:FRAMe{frameIx_cmd_val}:SLOT{slotNull_cmd_val}:SUBChannel{subChannel_cmd_val}:USER{userIx_cmd_val}:ATTenuation {param}')
# noinspection PyTypeChecker
[docs]
def get(self, frameIx=repcap.FrameIx.Default, slotNull=repcap.SlotNull.Default, subChannel=repcap.SubChannel.Default, userIx=repcap.UserIx.Default) -> enums.GsmBursSlotAtt:
"""
``[SOURce<HW>]:BB:GSM:[FRAMe<DI>]:SLOT<ST0>:[SUBChannel<US>]:[USER<CH>]:ATTenuation`` \n
Snippet: ``value: enums.GsmBursSlotAtt = driver.source.bb.gsm.frame.slot.subChannel.user.attenuation.get(frameIx = repcap.FrameIx.Default, slotNull = repcap.SlotNull.Default, subChannel = repcap.SubChannel.Default, userIx = repcap.UserIx.Default)`` \n
The command selects one of seven possible values for the level attenuation. This value defines by how much the power of
the selected slot with power control level BB:GSM:SLOT:LEV ATT is reduced in relation to the normal output power
(attribute ...:LEVEL FULL) . The seven possible values are set using the command SOURce:BB:GSM:SATTenuation<n>.
:param frameIx: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Frame')
:param slotNull: optional repeated capability selector. Default value: Nr0 (settable in the interface 'Slot')
:param subChannel: optional repeated capability selector. Default value: Nr1 (settable in the interface 'SubChannel')
:param userIx: optional repeated capability selector. Default value: Nr1 (settable in the interface 'User')
:return: attenuation: A1 | A2 | A3 | A4 | A5 | A6 | A7
"""
frameIx_cmd_val = self._cmd_group.get_repcap_cmd_value(frameIx, repcap.FrameIx)
slotNull_cmd_val = self._cmd_group.get_repcap_cmd_value(slotNull, repcap.SlotNull)
subChannel_cmd_val = self._cmd_group.get_repcap_cmd_value(subChannel, repcap.SubChannel)
userIx_cmd_val = self._cmd_group.get_repcap_cmd_value(userIx, repcap.UserIx)
response = self._core.io.query_str(f'SOURce<HwInstance>:BB:GSM:FRAMe{frameIx_cmd_val}:SLOT{slotNull_cmd_val}:SUBChannel{subChannel_cmd_val}:USER{userIx_cmd_val}:ATTenuation?')
return Conversions.str_to_scalar_enum(response, enums.GsmBursSlotAtt)