from .....Internal.Core import Core
from .....Internal.CommandsGroup import CommandsGroup
from .....Internal import Conversions
from ..... import repcap
# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
[docs]class CmOffsetCls:
"""CmOffset commands group definition. 1 total commands, 0 Subgroups, 1 group commands"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("cmOffset", core, parent)
[docs] def set(self, cm_offset: float, probe=repcap.Probe.Default) -> None:
"""SCPI: [SENSe]:PROBe<pb>:SETup:CMOFfset \n
Snippet: driver.sense.probe.setup.cmOffset.set(cm_offset = 1.0, probe = repcap.Probe.Default) \n
Sets the common mode offset. The setting is only available if a differential probe in CM-mode is connected to the FSW. If
the probe is disconnected, the common mode offset of the probe is reset to 0.0 V. Note that if the offset for DM-mode or
CM-mode is changed, the offsets for the P-mode and N-mode are adapted accordingly, and vice versa. For details see 'Using
Probes'. \n
:param cm_offset: Offset of the mean voltage between the positive and negative input terminal vs. ground Range: -16 V to +16 V, Unit: V
:param probe: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Probe')
"""
param = Conversions.decimal_value_to_str(cm_offset)
probe_cmd_val = self._cmd_group.get_repcap_cmd_value(probe, repcap.Probe)
self._core.io.write(f'SENSe:PROBe{probe_cmd_val}:SETup:CMOFfset {param}')
[docs] def get(self, probe=repcap.Probe.Default) -> float:
"""SCPI: [SENSe]:PROBe<pb>:SETup:CMOFfset \n
Snippet: value: float = driver.sense.probe.setup.cmOffset.get(probe = repcap.Probe.Default) \n
Sets the common mode offset. The setting is only available if a differential probe in CM-mode is connected to the FSW. If
the probe is disconnected, the common mode offset of the probe is reset to 0.0 V. Note that if the offset for DM-mode or
CM-mode is changed, the offsets for the P-mode and N-mode are adapted accordingly, and vice versa. For details see 'Using
Probes'. \n
:param probe: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Probe')
:return: cm_offset: Offset of the mean voltage between the positive and negative input terminal vs. ground Range: -16 V to +16 V, Unit: V"""
probe_cmd_val = self._cmd_group.get_repcap_cmd_value(probe, repcap.Probe)
response = self._core.io.query_str(f'SENSe:PROBe{probe_cmd_val}:SETup:CMOFfset?')
return Conversions.str_to_float(response)