tdl-xoa-driver 1.1.0__py3-none-any.whl → 1.2.0__py3-none-any.whl

xoa_driver/internals/commands/c_commands.py

@@ -2039,3 +2039,29 @@ class C_MODEL_NUMBER:
         """
 
         return Token(self._connection, build_get_request(self))
+    
+
+@register_command
+@dataclass
+class C_USED_TPLDID:
+    """
+    Get the used TPLD IDs from the chassis.
+    """
+
+    code: typing.ClassVar[int] = 44
+    pushed: typing.ClassVar[bool] = False
+
+    _connection: 'interfaces.IConnection'
+
+    class GetDataAttr(ResponseBodyStruct):
+        used_tpld_ids: typing.List[int] = field(XmpSequence(types_chunk=[XmpInt()]))
+        """integer list, the used TPLD IDs from the chassis."""
+
+    def get(self) -> Token[GetDataAttr]:
+        """Get the used TPLD IDs from the chassis.
+
+        :return: the used TPLD IDs from the chassis.
+        :rtype: C_USED_TPLDID.GetDataAttr
+        """
+
+        return Token(self._connection, build_get_request(self))

xoa_driver/internals/commands/enums.py

@@ -733,15 +733,11 @@ class PayloadType(IntEnum):
 
     INC16 = 5
     """
-    .. versionadded:: 1.1
-
     Incrementing with 0xFFFF (16-bit mode)
     """
 
     DEC16 = 6
     """
-    .. versionadded:: 1.1
-
     Decrementing with 0xFFFF (16-bit mode)
     """
 
@@ -1064,6 +1060,12 @@ class MediaConfigurationType(IntEnum):
     OSFP_NRZ = 120
     """OSFP, 56G serdes, NRZ"""
 
+    QSFP_DD_NRZ_ANLT = 121
+    """QSFP-DD, 25G serdes, L1/ANLT"""
+
+    OSFP_NRZ_ANLT = 122
+    """OSFP, 25G serdes, L1/ANLT"""    
+
     UNKNOWN = 255
 
 
@@ -2278,8 +2280,6 @@ class LinkTrainingFailureType(IntEnum):
 
 class Layer1ConfigType(IntEnum):
     """
-    .. versionadded:: 1.1
-
     Enums for PL1_CFG_TMP's type.
     """
 
@@ -2314,8 +2314,6 @@ class Layer1ConfigType(IntEnum):
 class Layer1LogType(IntEnum):
     """
 
-    .. versionadded:: 1.1
-
     .. warning::
 
         Still in beta mode. Subjected to changes
@@ -2332,10 +2330,7 @@ class Layer1LogType(IntEnum):
 
 class LinkTrainAlgorithm(IntEnum):
     """
-    .. versionadded:: 1.2
-
     Link Training Algorithm
-
     """
 
     INTERACTIVE = 0
@@ -2350,8 +2345,6 @@ class LinkTrainAlgorithm(IntEnum):
 
 class LinkTrainCmd(IntEnum):
     """
-    .. versionadded:: 1.1
-
     Link Training commands
 
     """
@@ -2380,8 +2373,6 @@ class LinkTrainCmd(IntEnum):
 
 class LinkTrainPresets(IntEnum):
     """
-    .. versionadded:: 1.1
-
     Link Training presets
 
     """
@@ -2407,8 +2398,6 @@ class LinkTrainPresets(IntEnum):
 
 class LinkTrainCoeffs(IntEnum):
     """
-    .. versionadded:: 1.1
-
 
     Link Training coefficients
 
@@ -2435,8 +2424,6 @@ class LinkTrainCoeffs(IntEnum):
 
 class LinkTrainEncoding(IntEnum):
     """
-    .. versionadded:: 1.1
-
     Link Training Encoding
 
     """
@@ -2456,8 +2443,6 @@ class LinkTrainEncoding(IntEnum):
 
 class LinkTrainCmdResults(IntEnum):
     """
-    .. versionadded:: 1.1
-
     Link Training Command Results
 
     """
@@ -2495,8 +2480,6 @@ class LinkTrainCmdResults(IntEnum):
 
 class LinkTrainCmdFlags(IntEnum):
     """
-    .. versionadded:: 1.1
-
     Link Training Command Flags
 
     """
@@ -2522,8 +2505,6 @@ class LinkTrainCmdFlags(IntEnum):
 
 class LinkTrainAnnounce(IntEnum):
     """
-    .. versionadded:: 1.1
-
     Link Training Announce
 
     """
@@ -2534,8 +2515,6 @@ class LinkTrainAnnounce(IntEnum):
 
 class AnLtLogControl(IntEnum):
     """
-    .. versionadded:: 1.3
-
     ANLT log control bits
 
     """
@@ -3264,8 +3243,8 @@ class MACSecRekeyMode(IntEnum):
     PN_EXHAUSTION = 0
     """Switch to the next SAK when PN is exhausted."""
 
-    PACKET_CNT = 1
-    """Switch to the next SAK when the given number of packets are transmitted."""
+    PACKET_NUMBER = 1
+    """Switch to the next SAK when the given packet number is transmitted."""
 
 
 class MACSecEncryptionMode(IntEnum):

xoa_driver/internals/commands/m_commands.py

@@ -1605,8 +1605,6 @@ class M_TXCLOCKFILTER_NEW:
 @dataclass
 class M_CLOCKPPBSWEEP:
     """
-    .. versionadded:: 1.1
-
     Start and stop deviation sweep the local clock of the test module, which drives the TX rate of the test ports.
 
     Note: The sweep is independent of the :class:`M_CLOCKPPB` parameter, i.e. the sweep uses the deviation set by :class:`M_CLOCKPPB` as its zero point.
@@ -1685,8 +1683,6 @@ class M_CLOCKPPBSWEEP:
 @dataclass
 class M_CLOCKSWEEPSTATUS:
     """
-    .. versionadded:: 1.1
-
     Return the current status of the :class:`M_CLOCKPPBSWEEP` function.
 
     """

xoa_driver/internals/commands/p_commands.py

@@ -5053,14 +5053,14 @@ class P_MACSEC_TXSC_REKEY_MODE:
         """byte, the rekey mode of the port’s TX SC"""
 
         value: int = field(XmpInt())
-        """integer, defines the packet count. This value will be ignored if the mode is set to PN_EXHAUSTION"""
+        """integer, defines the packet number that triggers the rekey. This value will be ignored if the mode is set to PN_EXHAUSTION"""
 
     class SetDataAttr(RequestBodyStruct):
         mode: MACSecRekeyMode = field(XmpByte())
         """byte, the rekey mode of the port’s TX SC"""
 
         value: int = field(XmpInt())
-        """integer, defines the packet count. This value will be ignored if the mode is set to PN_EXHAUSTION"""
+        """integer, defines the packet number that triggers the rekey. This value will be ignored if the mode is set to PN_EXHAUSTION"""
 
     def get(self) -> Token[GetDataAttr]:
         """Get the rekey mode of the port’s TX SC
@@ -5997,4 +5997,31 @@ class P_MACSEC_RX_ENABLE:
 
     set_on = functools.partialmethod(set, OnOff.ON)
     """Enable the RX port MACSec.
-    """
+    """
+
+@register_command
+@dataclass
+class P_USED_TPLDID:
+    """
+    Get the used TPLD IDs from the port. If the port doesn't support TPLD ID traffic, the port will return <NOTSUPPORTED>
+    """
+
+    code: typing.ClassVar[int] = 319
+    pushed: typing.ClassVar[bool] = False
+
+    _connection: 'interfaces.IConnection'
+    _module: int
+    _port: int
+
+    class GetDataAttr(ResponseBodyStruct):
+        used_tpld_ids: typing.List[int] = field(XmpSequence(types_chunk=[XmpInt()]))
+        """integer list, the used TPLD IDs from the port."""
+
+    def get(self) -> Token[GetDataAttr]:
+        """Get the used TPLD IDs from the port.
+
+        :return: the used TPLD IDs from the port.
+        :rtype: P_USED_TPLDID.GetDataAttr
+        """
+
+        return Token(self._connection, build_get_request(self, module=self._module, port=self._port))

xoa_driver/internals/commands/pl1_commands.py

@@ -59,14 +59,7 @@ from .enums import (
 @dataclass
 class PL1_AUTONEGINFO:
     """
-    .. versionadded:: 2.0
-
-    .. warning::
-
-        Still in beta mode. Subjected to changes
-
     Get L1 auto-negotiation information. Information is split into a number of pages.
-
     """
 
     code: typing.ClassVar[int] = 385
@@ -117,12 +110,6 @@ class PL1_AUTONEGINFO:
 @dataclass
 class PL1_LINKTRAININFO:
     """
-    .. versionadded:: 2.0
-
-    .. warning::
-
-        Still in beta mode. Subjected to changes
-
     Get L1 link training information. Information is per Serdes and split into a number of pages.
     """
 
@@ -304,12 +291,6 @@ class PL1_LINKTRAININFO:
 @dataclass
 class PL1_LOG:
     """
-    .. versionadded:: 2.0
-
-    .. warning::
-
-        Still in beta mode. Subjected to changes
-
     Return a log line of either AN or LT for the given Serdes. The log string line contains the latest 100 lines.
     """
 
@@ -339,8 +320,6 @@ class PL1_LOG:
 @dataclass
 class PL1_CFG_TMP:
     """
-    .. versionadded:: 1.1
-
     .. warning::
 
         Still in beta mode. Subjected to changes
@@ -388,8 +367,6 @@ class PL1_CFG_TMP:
 @dataclass
 class PL1_LINKTRAIN_CMD:
     """
-    .. versionadded:: 1.1
-
     .. warning::
 
         Still in beta mode. Subjected to changes
@@ -440,8 +417,6 @@ class PL1_LINKTRAIN_CMD:
 @dataclass
 class PL1_LT_PHYTXEQ_RANGE:
     """
-    .. versionadded:: 2.9
-    
     Configure the lower and the upper bound of transmit equalizer (native value) of the serdes, and how the serdes responds to an increment/decrement request when either bound is reached.
 
     """
@@ -487,8 +462,6 @@ class PL1_LT_PHYTXEQ_RANGE:
 @dataclass
 class PL1_LT_PHYTXEQ_RANGE_COEFF:
     """
-    .. versionadded:: 2.9
-    
     Configure the lower and the upper bound of transmit equalizer (IEEE coefficient value) of the serdes, and how the serdes responds to an increment/decrement request when either bound is reached.
     
     Whenever <response> == AUTO (the default), min and max will have their default values, which can be read with “get”. Any value that attempt to set the min and max when <response> == AUTO will be ignored by the chassis.
@@ -559,8 +532,6 @@ class PL1_LT_PHYTXEQ_RANGE_COEFF:
 @dataclass
 class PL1_CTRL:
     """
-    .. versionadded:: 2.5
-
     The Signal Integrity feature offers the equivalent of an Equivalent Time oscilloscope trace of the RX PAM4 signal (later, also PAM2). The trace is done with the A/D converter in the GTM receiver also doing the data sampling / CDR function, i.e. the trace is taken after the RX equalizer.
 
     The HW characteristics of the Versal GTM used in Freya are: Trace length = 2000 samples, sample resolution = 7 bits 2's complement, i.e. range = -64..63.
@@ -600,8 +571,6 @@ class PL1_CTRL:
 @dataclass
 class PL1_GET_DATA:
     """
-    .. versionadded:: 2.5
-
     The Signal Integrity feature offers the equivalent of an Equivalent Time oscilloscope trace of the RX PAM4 signal (later, also PAM2). The trace is done with the A/D converter in the GTM receiver also doing the data sampling / CDR function, i.e. the trace is taken after the RX equalizer.
 
     The HW characteristics of the Versal GTM used in Freya are: Trace length = 2000 samples, sample resolution = 7 bits 2’s complement, i.e. range = -64..63.
@@ -664,8 +633,6 @@ class PL1_GET_DATA:
 @dataclass
 class PL1_PRESET_CONFIG:
     """
-    .. versionadded:: 2.9
-    
     Configure the preset values (native values) of a serdes and the response to the received IC request.
 
     """
@@ -723,8 +690,6 @@ class PL1_PRESET_CONFIG:
 @dataclass
 class PL1_PRESET_RESET:
     """
-    .. versionadded:: 2.9
-    
     Reset the preset of the serdes to its default values.
 
     """
@@ -753,8 +718,6 @@ class PL1_PRESET_RESET:
 @dataclass
 class PL1_PRESET_CONFIG_LEVEL:
     """
-    .. versionadded:: 2.9
-    
     Configure the preset values (mV/dB values) of a serdes and the response to the received IC request.
 
     """
@@ -812,8 +775,6 @@ class PL1_PRESET_CONFIG_LEVEL:
 @dataclass
 class PL1_PRESET_CONFIG_COEFF:
     """
-    .. versionadded:: 2.9
-    
     Configure the preset values (IEEE coefficient values) of a serdes and the response to the received IC request.
 
     """
@@ -871,8 +832,6 @@ class PL1_PRESET_CONFIG_COEFF:
 @dataclass
 class PL1_PHYTXEQ_LEVEL:
     """
-    .. versionadded:: 2.5
-    
     Control and monitor the equalizer settings of the on-board PHY in the transmission direction (towards the transceiver cage).
 
     .. note::
@@ -927,8 +886,6 @@ class PL1_PHYTXEQ_LEVEL:
 @dataclass
 class PL1_PHYTXEQ_COEFF:
     """
-    .. versionadded:: 2.5
-    
     Control and monitor the equalizer settings of the on-board PHY in the transmission direction (towards the transceiver cage).
 
     .. note::
@@ -993,8 +950,6 @@ class PL1_PHYTXEQ_COEFF:
 @dataclass
 class PL1_AUTONEG_STATUS:
     """
-    .. versionadded:: 2.5
-
     Returns received technology abilities, FEC abilities, pause abilities, HCD technology ability, FEC mode result, and pause mode result.
     """
 
@@ -1033,8 +988,6 @@ class PL1_AUTONEG_STATUS:
 @dataclass
 class PL1_AUTONEG_ABILITIES:
     """
-    .. versionadded:: 2.5
-
     Return the supported technology abilities, FEC abilities, and pause abilities of the port.
     """
 
@@ -1063,8 +1016,6 @@ class PL1_AUTONEG_ABILITIES:
 @dataclass
 class PL1_PCS_VARIANT:
     """
-    .. versionadded:: 2.5
-
     PCS variant configuration.
     """
 
@@ -1097,8 +1048,6 @@ class PL1_PCS_VARIANT:
 @dataclass
 class PL1_CWE_CYCLE:
     """
-    .. versionadded:: 2.7
-
     Configure the FEC codeword error injection cycle.
     """
 
@@ -1142,8 +1091,6 @@ class PL1_CWE_CYCLE:
 @dataclass
 class PL1_CWE_ERR_SYM_INDICES:
     """
-    .. versionadded:: 2.7
-
     Configure the positions of the errored symbols in errored codewords.
     """
 
@@ -1193,8 +1140,6 @@ class PL1_CWE_ERR_SYM_INDICES:
 @dataclass
 class PL1_CWE_BIT_ERR_MASK:
     """
-    .. versionadded:: 2.7
-
     Configure the bit error mask for the errored symbols.
     """
 
@@ -1236,8 +1181,6 @@ class PL1_CWE_BIT_ERR_MASK:
 @dataclass
 class PL1_CWE_FEC_ENGINE:
     """
-    .. versionadded:: 2.7
-
     Configure which FEC engines to use.
     """
 
@@ -1283,8 +1226,6 @@ class PL1_CWE_FEC_ENGINE:
 @dataclass
 class PL1_CWE_FEC_STATS:
     """
-    .. versionadded:: 2.7
-
     FEC error injection statistics.
     """
 
@@ -1316,8 +1257,6 @@ class PL1_CWE_FEC_STATS:
 @dataclass
 class PL1_AUTONEG_CONFIG:
     """
-    .. versionadded:: 2.5
-
     Auto-negotiation configuration for Freya
     """
 
@@ -1350,8 +1289,6 @@ class PL1_AUTONEG_CONFIG:
 @dataclass
 class PL1_ANLT:
     """
-    .. versionadded:: 2.5
-
     ANLT action
     """
 
@@ -1408,8 +1345,6 @@ class PL1_ANLT:
 @dataclass
 class PL1_PHYTXEQ:
     """
-    .. versionadded:: 2.5
-    
     Control and monitor the equalizer settings of the on-board PHY in the transmission direction (towards the transceiver cage).
 
     .. note::
@@ -1464,8 +1399,6 @@ class PL1_PHYTXEQ:
 @dataclass
 class PL1_LINKTRAIN_CONFIG:
     """
-    .. versionadded:: 2.5
-
     Per-port link training settings
     """
 
@@ -1528,8 +1461,6 @@ class PL1_LINKTRAIN_STATUS:
 @dataclass
 class PL1_CWE_CONTROL:
     """
-    .. versionadded:: 2.7
-
     Control the FEC codeword error injection.
     """
 
@@ -1567,8 +1498,6 @@ class PL1_CWE_CONTROL:
 @dataclass
 class PL1_CWE_FEC_STATS_CLEAR:
     """
-    .. versionadded:: 2.7
-
     Clear FEC codeword injection TX stats
     """
 
@@ -1586,3 +1515,99 @@ class PL1_CWE_FEC_STATS_CLEAR:
         """Clear FEC codeword injection TX stats
         """
         return Token(self._connection, build_set_request(self, module=self._module, port=self._port))
+
+
+@register_command
+@dataclass
+class PL1_PNSWAP_TX:
+    """
+    Enable/disable P/N polarity swap of the SerDes in the transmission direction
+    """
+
+    code: typing.ClassVar[int] = 532
+    pushed: typing.ClassVar[bool] = False
+
+    _connection: 'interfaces.IConnection'
+    _module: int
+    _port: int
+    _serdes_xindex: int
+
+    class GetDataAttr(ResponseBodyStruct):
+        on_off: OnOff = field(XmpByte())
+
+    class SetDataAttr(RequestBodyStruct):
+        on_off: OnOff = field(XmpByte())
+
+    def get(self) -> Token[GetDataAttr]:
+        """Get the P/N polarity swap setting of the SerDes in the transmission direction.
+
+        :return: P/N polarity swap setting of the SerDes in the transmission direction
+        :rtype: PL1_PNSWAP_TX.GetDataAttr
+        """
+
+        return Token(self._connection, build_get_request(self, module=self._module, port=self._port, indices=[self._serdes_xindex]))
+
+    def set(self, on_off: OnOff) -> Token[None]:
+        """Set the P/N polarity swap setting of the SerDes in the transmission direction.
+
+        :param on_off: P/N polarity swap setting of the SerDes in the transmission direction.
+        :type on_off: OnOff
+        """
+
+        return Token(self._connection, build_set_request(self, module=self._module, port=self._port, on_off=on_off, indices=[self._serdes_xindex])) 
+    
+    set_on = functools.partialmethod(set, OnOff.ON)
+    """Set P/N polarity swap of the SerDes in the transmission direction to ON
+    """
+
+    set_off = functools.partialmethod(set, OnOff.OFF)
+    """Set P/N polarity swap of the SerDes in the transmission direction to OFF
+    """
+    
+
+@register_command
+@dataclass
+class PL1_PNSWAP_RX:
+    """
+    Enable/disable P/N polarity swap of the SerDes in the receiving direction
+    """
+
+    code: typing.ClassVar[int] = 533
+    pushed: typing.ClassVar[bool] = False
+
+    _connection: 'interfaces.IConnection'
+    _module: int
+    _port: int
+    _serdes_xindex: int
+
+    class GetDataAttr(ResponseBodyStruct):
+        on_off: OnOff = field(XmpByte())
+
+    class SetDataAttr(RequestBodyStruct):
+        on_off: OnOff = field(XmpByte())
+
+    def get(self) -> Token[GetDataAttr]:
+        """Get the P/N polarity swap setting of the SerDes in the receiving direction.
+
+        :return: P/N polarity swap setting of the SerDes in the receiving direction
+        :rtype: PL1_PNSWAP_RX.GetDataAttr
+        """
+
+        return Token(self._connection, build_get_request(self, module=self._module, port=self._port, indices=[self._serdes_xindex]))
+
+    def set(self, on_off: OnOff) -> Token[None]:
+        """Set the P/N polarity swap setting of the SerDes in the receiving direction.
+
+        :param on_off: P/N polarity swap setting of the SerDes in the receiving direction.
+        :type on_off: OnOff
+        """
+
+        return Token(self._connection, build_set_request(self, module=self._module, port=self._port, on_off=on_off, indices=[self._serdes_xindex])) 
+    
+    set_on = functools.partialmethod(set, OnOff.ON)
+    """Set P/N polarity swap of the SerDes in the receiving direction to ON
+    """
+
+    set_off = functools.partialmethod(set, OnOff.OFF)
+    """Set P/N polarity swap of the SerDes in the receiving direction to OFF
+    """

xoa_driver/internals/commands/pr_commands.py

@@ -509,8 +509,6 @@ class PR_UAT_TIME:
 @dataclass
 class PR_TOTALEXT:
     """
-    .. versionadded: v1.1
-
     An extension of :class:`PR_TOTAL` that also includes a calculation of bytes received in the last second, as well as a number of port error counters.
     PR_TOTALEXT returns list of long integers. This list may be expanded in future software releases.
     """
@@ -565,8 +563,6 @@ class PR_TOTALEXT:
 @dataclass
 class PR_NOTPLDEXT:
     """
-    .. versionadded: v1.1
-
     An extension of :class:`PR_NOTPLD` that also includes a calculation of bytes received in the last second.
     PR_NOTPLDEXT returns list of long integers. This list may be expanded in future software releases.
     """
@@ -610,8 +606,6 @@ class PR_NOTPLDEXT:
 @dataclass
 class PR_TPLDTRAFFICEXT:
     """
-    .. versionadded: v1.1
-
     An extension of :class:`PR_TPLDTRAFFIC` that also includes a calculation of bytes received in the last second.
     PR_TPLDTRAFFICEXT returns list of long integers. This list may be expanded in future software releases.
     """
@@ -657,8 +651,6 @@ class PR_TPLDTRAFFICEXT:
 @dataclass
 class PR_FILTEREXT:
     """
-    .. versionadded: v1.1
-
     An extension of :class:`PR_FILTER` that also includes a calculation of bytes received in the last second.
     PR_FILTEREXT returns list of long integers. This list may be expanded in future software releases.
     """

xoa_driver/internals/commands/ps_commands.py

@@ -405,8 +405,6 @@ class PS_INSERTFCS:
 @dataclass
 class PS_AUTOADJUST:
     """
-    .. versionadded:: v2.0
-
     Executing PS_AUTOADJUST will adjust the packet length distribution (:class:`PS_PACKETLENGTH`) of the stream:
 
         (1) Set the type of packet length distribution (:class:`PS_PACKETLENGTH` ``<length_type>``) to ``FIXED``.

xoa_driver/internals/commands/pt_commands.py

@@ -183,8 +183,6 @@ class PT_EXTRA:
 @dataclass
 class PT_TOTALEXT:
     """
-    .. versionadded: v1.1
-
     An extension to :class:`PT_TOTAL` that also includes a calculation of bytes transmitted in the last second.
     It returns list of long integers; this list may be expanded in future software releases.
     """
@@ -224,8 +222,6 @@ class PT_TOTALEXT:
 @dataclass
 class PT_NOTPLDEXT:
     """
-    .. versionadded: v1.1
-
     An extension to :class:`PT_NOTPLD` that also includes a calculation of bytes transmitted in the last second.
     It returns list of long integers; this list may be expanded in future software releases.
     """
@@ -265,8 +261,6 @@ class PT_NOTPLDEXT:
 @dataclass
 class PT_STREAMEXT:
     """
-    .. versionadded: v1.1
-
     An extension to :class:`PT_STREAM` that also includes a calculation of bytes transmitted in the last second.
     It returns list of long integers; this list may be expanded in future software releases.
     """

xoa_driver/internals/hli_v1/ports/port_l23/bases/port_l23.py

@@ -51,6 +51,7 @@ from xoa_driver.internals.commands import (
     P_TXBURSTPERIOD,
     P_CAPABILITIES_EXT,
     P_IGMPV3_GROUP_RECORD_BUNDLE,
+    P_USED_TPLDID,
 )
 if typing.TYPE_CHECKING:
     from xoa_driver.internals.core import interfaces as itf
@@ -520,6 +521,12 @@ class BasePortL23(base_port.BasePort[ports_state.PortL23LocalState]):
         :type: MatchTermIndices
         """
 
+        self.used_tpld_ids = P_USED_TPLDID(conn, module_id, port_id)
+        """TG port's used TPLD IDs.
+
+        :type: P_USED_TPLDID
+        """
+
     on_speed_change = functools.partialmethod(utils.on_event, P_SPEED)
     """Register a callback to the event that the port's speed changes."""