tdl-xoa-driver 1.4.0__py3-none-any.whl → 1.5.0b1__py3-none-any.whl

xoa_driver/functions/exceptions.py

@@ -1,3 +1,5 @@
+"""The exception high-level function module."""
+
 from __future__ import annotations
 
 from xoa_driver.ports import GenericAnyPort

xoa_driver/functions/headers.py

@@ -1,3 +1,5 @@
+"""The packet headers high-level function module."""
+
 from ipaddress import IPv4Address, IPv6Address
 from binascii import hexlify
 from xoa_driver.misc import Hex

xoa_driver/functions/mgmt.py

@@ -1,13 +1,23 @@
+"""
+The resource management high-level function module, 
+including testers, modules, ports, and streams.
+"""
+
 from __future__ import annotations
 import asyncio
-import typing as t
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Union,
+)
 from xoa_driver import enums, testers
 from xoa_driver.utils import apply
-from xoa_driver.internals.hli.ports.port_l23.family_l import FamilyL
-from xoa_driver.internals.hli.ports.port_l23.family_l1 import FamilyFreya
-from xoa_driver.ports import GenericAnyPort, GenericL23Port
-from xoa_driver.modules import GenericAnyModule, GenericL23Module, ModuleChimera, Z800FreyaModule
-from xoa_driver.testers import GenericAnyTester, L23Tester
+if TYPE_CHECKING:
+    from xoa_driver.internals.hli.ports.port_l23.family_l import FamilyL
+    from xoa_driver.internals.hli.ports.port_l23.family_l1 import FamilyFreya
+    from xoa_driver.ports import GenericAnyPort, GenericL23Port
+    from xoa_driver.modules import GenericAnyModule, GenericL23Module, ModuleChimera, Z800FreyaModule, Z1600EdunModule
+    from xoa_driver.testers import GenericAnyTester, L23Tester
 from .exceptions import (
     NotSupportMedia,
     NotSupportPortSpeed,
@@ -18,10 +28,6 @@ from itertools import chain  # type: ignore[Pylance false warning]
 from datetime import datetime
 import json
 
-PcsPmaSupported = (FamilyL, FamilyFreya)
-AutoNegSupported = (FamilyL, FamilyFreya)
-LinkTrainingSupported = FamilyL
-
 
 # region Testers
 async def reserve_tester(tester: GenericAnyTester, force: bool = True) -> None:
@@ -150,14 +156,14 @@ async def release_module(
 
 def get_module_supported_media(
     module: GenericL23Module | ModuleChimera,
-) -> list[dict[str, t.Any]]:
+) -> list[dict[str, Any]]:
     """
     Get a list of supported media, port speed and count of the module.
 
     :param module: The module object
     :type module: GenericAnyModule
     :return: List of supported media, port speed and count
-    :rtype: list[dict[str, t.Any]]
+    :rtype: list[dict[str, Any]]
     """
     supported_media_list = []
     item = {}
@@ -174,7 +180,7 @@ def get_module_supported_media(
 
 
 async def set_module_media_config(
-    module: t.Union[GenericL23Module, ModuleChimera],
+    module: Union[GenericL23Module, ModuleChimera],
     media: enums.MediaConfigurationType,
     force: bool = True,
 ) -> None:
@@ -210,7 +216,7 @@ async def set_module_media_config(
 
 
 async def set_module_port_config(
-    module: t.Union[GenericL23Module, ModuleChimera],
+    module: Union[GenericL23Module, ModuleChimera],
     port_count: int,
     port_speed: int,
     force: bool = True,
@@ -219,7 +225,7 @@ async def set_module_port_config(
     Set module's port-speed configuration
 
     :param module: The module object
-    :type module: t.Union[GenericL23Module, ModuleChimera]
+    :type module: Union[GenericL23Module, ModuleChimera]
     :param port_count: The port count
     :type port_count: int
     :param port_speed: The port speed in Mbps, e.g. 40000 for 40G
@@ -258,7 +264,7 @@ async def set_module_port_config(
 
 
 async def set_module_config(
-    module: t.Union[GenericL23Module, ModuleChimera],
+    module: Union[GenericL23Module, ModuleChimera],
     media: enums.MediaConfigurationType,
     port_count: int,
     port_speed: int,
@@ -267,7 +273,7 @@ async def set_module_config(
     """Change the module configuration to the target media, port count and port speed.
 
     :param module: the module object
-    :type module: t.Union[GenericL23Module, ModuleChimera]
+    :type module: Union[GenericL23Module, ModuleChimera]
     :param media: the target media for the module
     :type media: enums.MediaConfigurationType
     :param port_count: the target port count
@@ -332,12 +338,13 @@ async def get_module_eol_days(module: GenericAnyModule) -> int:
     return timedelta.days
 
 
-async def get_module_cage_insertion_count(module: Z800FreyaModule, cage_index: int) -> int:
+    from xoa_driver.modules import GenericAnyModule, GenericL23Module, ModuleChimera, Z800FreyaModule, Z1600EdunModule
+async def get_module_cage_insertion_count(module: Union[Z800FreyaModule, Z1600EdunModule], cage_index: int) -> int:
     """
     Get module cage insertion count
 
     :param module: The Z800 Freya module object
-    :type module: Z800FreyaModule
+    :type module: Union[Z800FreyaModule, Z1600EdunModule]
     :param cage_index: The cage index
     :type module: int
     :return: Insertion count of the cage
@@ -355,6 +362,22 @@ async def get_module_cage_insertion_count(module: Z800FreyaModule, cage_index: i
     return result
 
 
+async def get_module_cage_count(module: Union[Z800FreyaModule, Z1600EdunModule]) -> int:
+    """
+    Get module cage count
+
+    :param module: The Z800 Freya module object
+    :type module: Union[Z800FreyaModule, Z1600EdunModule]
+    :return: The number of cages in the module
+    :rtype: int
+    """
+    resp = await module.health.cage_insertion.get()
+    info_js = resp.info
+    info_dict = json.loads(info_js)
+    result = len(info_dict['1']['data'])
+    return result
+
+
 # endregion
 
 

xoa_driver/functions/tools.py

@@ -1,14 +1,20 @@
 from __future__ import annotations
-from typing import Any
+from typing import (
+    TYPE_CHECKING,
+    Any,
+)
+
+if TYPE_CHECKING:
+    from xoa_driver.ports import GenericAnyPort
 
-from xoa_driver.ports import GenericAnyPort
 from xoa_driver.internals.core import interfaces as itf
 from xoa_driver.lli import commands
 from xoa_driver import enums
 
 
 def get_ctx(port: GenericAnyPort) -> tuple["itf.IConnection", int, int]:
-    return (port._conn, *port.kind)
+    module_id, port_id = port.kind  # Explicitly unpack to two ints
+    return (port._conn, module_id, port_id)
 
 
 def dictionize_autoneg_status(

xoa_driver/hlfuncs.py

@@ -1,11 +1,14 @@
 #: High-level functions
+"""High-level functions."""
+
 from xoa_driver.functions import (
     anlt,
-    cli,
+    cli as config_io,
     mgmt,
     anlt_ll_debug,
     exceptions,
     headers,
+    cmis,
 )
 
 __all__ = (
@@ -13,6 +16,7 @@ __all__ = (
     "mgmt",
     "anlt_ll_debug",
     "exceptions",
-    "cli",
+    "config_io",
     "headers",
+    "cmis",
 )

xoa_driver/internals/commands/c_commands.py

@@ -23,7 +23,8 @@ from xoa_driver.internals.core.transporter.protocol.payload import (
     XmpMacAddress,
     XmpSequence,
     XmpStr,
-    Hex
+    Hex,
+    XmpJson,
 )
 from .enums import (
     ReservedStatus,
@@ -1239,7 +1240,7 @@ class C_WATCHDOG:
 @dataclass
 class C_DEBUGCMD:
     """
-    Chassis debug command
+    Chassis debug command for internal use only.
     """
 
     code: typing.ClassVar[int] = 37
@@ -1249,16 +1250,11 @@ class C_DEBUGCMD:
     _cmd_xindex: int
 
     class GetDataAttr(ResponseBodyStruct):
-        data: typing.List[int] = field(XmpSequence(types_chunk=[XmpInt()]))
-
-    class SetDataAttr(RequestBodyStruct):
-        data: typing.List[int] = field(XmpSequence(types_chunk=[XmpInt()]))
+        data: dict = field(XmpJson(min_len=2))
 
     def get(self) -> Token[GetDataAttr]:
         return Token(self._connection, build_get_request(self, indices=[self._cmd_xindex]))
     
-    def set(self, data: typing.List[int]) -> Token[None]:
-        return Token(self._connection, build_set_request(self, indices=[self._cmd_xindex], data=data))
     
 
 @register_command
@@ -2028,8 +2024,8 @@ class C_MODEL_NUMBER:
     _connection: 'interfaces.IConnection'
 
     class GetDataAttr(ResponseBodyStruct):
-        number:  ChassisModelNumber = field(XmpInt())
-        """ChassisModelNumber, the model of the Xena tester"""
+        number:  str = field(XmpStr())
+        """str, the model of the Xena tester"""
 
     def get(self) -> Token[GetDataAttr]:
         """Get the Xena chassis model number.

xoa_driver/internals/commands/enums.py

@@ -1069,6 +1069,18 @@ class MediaConfigurationType(IntEnum):
     QSFP28_NRZ_ANLT = 123
     """QSFP28, 25G serdes, L1/ANLT"""
 
+    SMPX_112 = 124
+    """SMPX 112Gbps serdes"""
+
+    SMPX_224 = 125
+    """SMPX 224Gbps serdes"""
+
+    OSFP_1600 = 126
+    """OSFP 1.6T"""
+    
+    OSFP_1600_ANLT = 127
+    """OSFP 1.6T, L1/ANLT"""
+
     UNKNOWN = 255
 
 
@@ -3165,7 +3177,13 @@ class ChassisModelName(IntEnum):
     Z_800_Q_A_C_FREYA   = 16
     Z_800_O_A_C_FREYA   = 17
     E_100_Q_C_CHIMERA   = 18
-
+    Z_100_Q_X_C_LOKI = 19
+    Z_400_Q_X_C_THOR = 20
+    Z_800_Q_X_C_FREYA = 21
+    Z_1604_S_C_EDUN = 22
+    Z_1608_O_C_EDUN = 23
+    B_6400 = 24
+    
 class ModuleModelName(IntEnum):
     NA              = 0
     Z_01_T_ODIN     = 1
@@ -3180,6 +3198,12 @@ class ModuleModelName(IntEnum):
     Z_800_Q_FREYA   = 10
     Z_800_O_FREYA   = 11
     E_100_Q_CHIMERA = 12
+    Z_100_Q_X_LOKI = 13
+    Z_400_Q_X_THOR = 14
+    Z_800_Q_X_FREYA = 15
+    Z_1604_S_EDUN = 16
+    Z_1608_O_EDUN = 17
+    Z_1616_O_EDUN = 18
 
 class ModuleConfigStatus(IntEnum):
     UNKNOWN = 0

xoa_driver/internals/commands/pr_commands.py

@@ -284,21 +284,21 @@ class PR_TPLDERRORS:
     class GetDataAttr(ResponseBodyStruct):
         dummy: int = field(XmpLong())
         """long integer, not in use."""
-        non_incre_seq_event_count: int = field(XmpLong())
-        """long integer, number of non-incrementing-sequence-number events."""
-        swapped_seq_misorder_event_count: int = field(XmpLong())
-        """long integer, number of swapped-sequence-number misorder events."""
-        non_incre_payload_packet_count: int = field(XmpLong())
-        """long integer, number of packets with non-incrementing payload content."""
+        packet_loss_by_seq: int = field(XmpLong())
+        """long integer, Number of packet loss calculated by detecting gaps in received sequence numbers from test payload, where each missing number indicates a lost packet."""
+        misorder_by_seq: int = field(XmpLong())
+        """long integer, Number of misordered packets calculated by detecting packets that arrive with a sequence number lower than the highest seen so far, indicating out-of-order delivery."""
+        payload_err_packets: int = field(XmpLong())
+        """long integer, Number of packets with payload integrity errors."""
 
     def get(self) -> Token[GetDataAttr]:
         """Get statistics concerning errors in the packets with a particular test payload id received on a port.
 
         :return:
             dummy value not in use,
-            number of non-incrementing-sequence-number events,
-            number of swapped-sequence-number misorder events,
-            number of packets with non-incrementing payload content
+            Number of packet loss by sequence number,
+            Number of misordered packets by sequence number,
+            Number of packets with payload integrity errors.
 
         :rtype: PR_TPLDERRORS.GetDataAttr
         """
@@ -532,12 +532,13 @@ class PR_TOTALEXT:
         packet_count_since_cleared: int = field(XmpLong())
         """long integer, number of packets received since statistics were cleared."""
         fcs_error_count: int = field(XmpLong())
-
+        """long integer, number of Rx packets with a bad FCS."""
         oversize_count: int = field(XmpLong())
-
+        """long integer, number of oversize packets (>1518 bytes) received since last clear (-1 if this counter is not supported by the tester)."""
         undersize_count: int = field(XmpLong())
-
+        """long integer, number of undersize packets (<64 bytes) received since last clear (-1 if this counter is not supported by the tester)."""
         jabber_count: int = field(XmpLong())
+        """long integer, number of jabber packets (oversized with a bad FCS) received since last clear (-1 if this counter is not supported by the tester)."""
 
     def get(self) -> Token[GetDataAttr]:
         """Get statistics concerning all the packets received on a port.
@@ -548,10 +549,10 @@ class PR_TOTALEXT:
             number of packets received in the last second,
             number of bytes received since statistics were cleared,
             number of packets received since statistics were cleared,
-            number of packets received with fcs error frames,
-            number of oversize packets received since last clear (-1 if this counter is not supported by the tester),
-            number of undersize packets received since last clear (-1 if this counter is not supported by the tester),
-            number of jabber packets received since last clear (-1 if this counter is not supported by the tester).
+            number of packets received with a bad FCS,
+            number of oversize packets (>1518 bytes) received since last clear (-1 if this counter is not supported by the tester),
+            number of undersize packets (<64 bytes) received since last clear (-1 if this counter is not supported by the tester),
+            number of jabber packets (oversized with a bad FCS) received since last clear (-1 if this counter is not supported by the tester).
 
         :rtype: PR_TOTALEXT.GetDataAttr
         """