tdl-xoa-driver 1.6.1__py3-none-any.whl → 1.6.2__py3-none-any.whl

{tdl_xoa_driver-1.6.1.dist-info → tdl_xoa_driver-1.6.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tdl-xoa-driver
-Version: 1.6.1
+Version: 1.6.2
 Summary: TDL XOA Python API is a Python library providing user-friendly communication interfaces to Teledyne LeCroy Xena Ethernet traffic generation test equipment. It provides a rich collection of APIs that can be used to either write test scripts or develop applications.
 Home-page: https://github.com/xenanetworks/tdl-xoa-driver
 Author: Leonard Yu, Zoltan Hanisch

{tdl_xoa_driver-1.6.1.dist-info → tdl_xoa_driver-1.6.2.dist-info}/RECORD

@@ -1,5 +1,5 @@
-tdl_xoa_driver-1.6.1.dist-info/licenses/LICENSE,sha256=KcCGoRYa8BS0KGUIHDIAeebClL6sX1uRWVrtESwpjOo,11351
-xoa_driver/__init__.py,sha256=VGXV1qm2o5PJQrsepEL8glKxft4RffI9DqK34uuOO24,47
+tdl_xoa_driver-1.6.2.dist-info/licenses/LICENSE,sha256=KcCGoRYa8BS0KGUIHDIAeebClL6sX1uRWVrtESwpjOo,11351
+xoa_driver/__init__.py,sha256=BJtNZvzVxeMeeNgbM1nJZfXQM5-92oTAzf7iLMPcM5g,47
 xoa_driver/enums.py,sha256=qmRAxCh_nYCP-Va5YeGR7PO3d3Dueg44vtnzUohuGS0,8579
 xoa_driver/exceptions.py,sha256=baNpophPmeNujMTSfL9TsYHa3Gju2-ozNOg78n8tqN8,1957
 xoa_driver/hlfuncs.py,sha256=tfyhbYX86XWpc4yFoBrj1OYqVJJfDnoxC6tHLlWTHkQ,311
@@ -148,6 +148,10 @@ xoa_driver/internals/hli/ports/port_l23/layer1_edun.py,sha256=JjC56MUwie5qq1DtPZ
 xoa_driver/internals/hli/ports/port_l23/layer1_freya.py,sha256=bpYGVQZSh1Xroz734cWPiF2LVW-2MFreUlMB-L4GmF8,3259
 xoa_driver/internals/hli/ports/port_l23/layer1_loki.py,sha256=NvvwpDIRfizv5sDjTsuwyZGrvkL-nvsu8c5YXpBl0Yk,2229
 xoa_driver/internals/hli/ports/port_l23/layer1_thor.py,sha256=_D6VgDzMfCIHK6yNRebHUjpn6KiI3MllAVxh3CRKzBU,2220
+xoa_driver/internals/hli/ports/port_l23/bases/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xoa_driver/internals/hli/ports/port_l23/bases/port_l23.py,sha256=Yp2_7NI7dnki2C01Jr2kGZQ0mcxZJhzx4mHm_qt_tv0,6761
+xoa_driver/internals/hli/ports/port_l23/bases/port_l23_genuine.py,sha256=h_IbIwOehkqkTzVw8cXoXOFJNZGBRFOpyeG6A07KLKw,5115
+xoa_driver/internals/hli/ports/port_l23/bases/port_l23ve.py,sha256=BeTQG9ehAcrg0rfR1SSMvN9L-UoAIYDdiA175sDINlM,2973
 xoa_driver/internals/hli/ports/port_l23/chimera/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xoa_driver/internals/hli/ports/port_l23/chimera/pe_custom_distribution.py,sha256=hQ7IbqWjMuLqhtdBiN2rUSJpNmaaqfcZn6ZP2qA6gPM,3763
 xoa_driver/internals/hli/ports/port_l23/chimera/pe_distribution.py,sha256=o4JrDRm83ict_uJHTDgOrd_Q6ru-Q6GdKnPSqhr5PAg,5970
@@ -224,7 +228,7 @@ xoa_driver/internals/utils/managers/abc.py,sha256=M3XgI2FVQLUXixS5SKnZTm0MweHY6D
 xoa_driver/internals/utils/managers/exceptions.py,sha256=fqLSin-OQCIKuhpzvK6RZThF3FJ8FsHers4EmqM9gSs,628
 xoa_driver/internals/utils/managers/modules_manager.py,sha256=sCEhqUu7Waot16rucJ5nI9FyHuFEeU_sBx1JjZdhDJg,3236
 xoa_driver/internals/utils/managers/ports_manager.py,sha256=cmXGWMVbHB27E7e0t-K9mUDessdU_t_v-6WUtpqbIho,3554
-tdl_xoa_driver-1.6.1.dist-info/METADATA,sha256=2X5n3CG84-6BXaSWRfGP1Oy1G3xuGMQweDhTEN0FJb0,4176
-tdl_xoa_driver-1.6.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-tdl_xoa_driver-1.6.1.dist-info/top_level.txt,sha256=sBbN3hwpa4s2VxsUBoWJ5jIqqDr50vgcEb-V8kL7pvE,11
-tdl_xoa_driver-1.6.1.dist-info/RECORD,,
+tdl_xoa_driver-1.6.2.dist-info/METADATA,sha256=-oC1ibfLF2P3oodLq3pCePMCgzL9H54WwixWlf6sJbo,4176
+tdl_xoa_driver-1.6.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+tdl_xoa_driver-1.6.2.dist-info/top_level.txt,sha256=sBbN3hwpa4s2VxsUBoWJ5jIqqDr50vgcEb-V8kL7pvE,11
+tdl_xoa_driver-1.6.2.dist-info/RECORD,,

xoa_driver/__init__.py

@@ -1,2 +1,2 @@
-__version__ = "1.6.1"
+__version__ = "1.6.2"
 __short_version__ = "1.6"

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

@@ -0,0 +1,267 @@
+import functools
+import typing
+from xoa_driver.internals.commands import (
+    P_CAPABILITIES,
+    P_SPEED,
+    P_SPEEDREDUCTION,
+    P_INTERFRAMEGAP,
+    P_MACADDRESS,
+    P_IPADDRESS,
+    P_ARPREPLY,
+    P_PINGREPLY,
+    P_PAUSE,
+    P_RANDOMSEED,
+    P_LOOPBACK,
+    P_TRAFFIC,
+    # P_CAPTURE,
+    P_XMITONE,
+    P_LATENCYOFFSET,
+    P_LATENCYMODE,
+    P_AUTOTRAIN,
+    P_MIXWEIGHTS,
+    P_TRAFFICERR,
+    P_GAPMONITOR,
+    P_CHECKSUM,
+    P_MIXLENGTH,
+    P_ARPRXTABLE,
+    P_NDPRXTABLE,
+    P_MULTICAST,
+    P_MULTICASTEXT,
+    P_MCSRCLIST,
+    P_MULTICASTHDR,
+    P_TXMODE,
+    P_RATEFRACTION,
+    P_RATEPPS,
+    P_RATEL2BPS,
+    P_PAYLOADMODE,
+    P_TXENABLE,
+    P_MAXHEADERLENGTH,
+    P_TXTIMELIMIT,
+    P_TXTIME,
+    P_XMITONETIME,
+    P_IPV6ADDRESS,
+    P_ARPV6REPLY,
+    P_PINGV6REPLY,
+    P_ERRORS,
+    P_TXPREPARE,
+    P_TXDELAY,
+    P_TPLDMODE,
+    P_TXPACKETLIMIT,
+    P_PFCENABLE,
+    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
+from xoa_driver.internals.hli.ports import base_port
+from xoa_driver.internals.utils import attributes as utils
+from xoa_driver.internals.utils.indices import index_manager as idx_mgr
+from xoa_driver.internals.state_storage import ports_state
+from xoa_driver.internals.hli.indices.length_term import LengthTermIdx
+from xoa_driver.internals.hli.indices.match_term import MatchTermIdx
+
+from ..trafficgen.capture import PortCapture
+from ..trafficgen.tgen import *
+
+LengthTermIndices = idx_mgr.IndexManager[LengthTermIdx]
+MatchTermIndices = idx_mgr.IndexManager[MatchTermIdx]
+
+
+class BasePortL23(base_port.BasePort[ports_state.PortL23LocalState]):
+    """L23 port layout which is relevant to all L23 ports."""
+
+    def __init__(self, conn: "itf.IConnection", module_id: int, port_id: int) -> None:
+        super().__init__(conn, module_id, port_id)
+        self.capabilities = P_CAPABILITIES(conn, module_id, port_id)
+        """L23 Port capabilities
+
+        :type: P_CAPABILITIES
+        """
+
+        self.capabilities_ext = P_CAPABILITIES_EXT(conn, module_id, port_id)
+        """L23 port capabilities ext.
+
+        :type: P_CAPABILITIES_EXT
+        """
+
+        self.pause = P_PAUSE(conn, module_id, port_id)
+        """L23 port response to Ethernet PAUSE frames.
+
+        :type: P_PAUSE
+        """
+
+        self.loopback = P_LOOPBACK(conn, module_id, port_id)
+        """L23 port loopback mode.
+
+        :type: P_LOOPBACK
+        """
+
+        self.errors_count = P_ERRORS(conn, module_id, port_id)
+        """L23 port errors.
+
+        :type: P_ERRORS
+        """
+
+        self.interframe_gap = P_INTERFRAMEGAP(conn, module_id, port_id)
+        """L23 port interframe gap.
+
+        :type: P_INTERFRAMEGAP
+        """
+
+        self.max_header_length = P_MAXHEADERLENGTH(conn, module_id, port_id)
+        """L23 port maximum header length.
+
+        :type: P_MAXHEADERLENGTH
+        """
+
+        self.tpld_mode = P_TPLDMODE(conn, module_id, port_id)
+        """L23 port test payload mode.
+
+        :type: P_TPLDMODE
+        """
+
+        self.pfc_enable = P_PFCENABLE(conn, module_id, port_id)
+        """L23 port Ethernet Priority Flow Control (PFC).
+
+        :type: P_PFCENABLE
+        """
+
+        self.random_seed = P_RANDOMSEED(conn, module_id, port_id)
+        """L23 port seed value.
+
+        :type: P_RANDOMSEED
+        """
+
+        self.payload_mode = P_PAYLOADMODE(conn, module_id, port_id)
+        """L23 port payload mode.
+
+        :type: P_PAYLOADMODE
+        """
+
+        self.gap_monitor = P_GAPMONITOR(conn, module_id, port_id)
+        """L23 port gap monitor.
+
+        :type: P_GAPMONITOR
+        """
+
+        self.checksum = P_CHECKSUM(conn, module_id, port_id)
+        """L23 port extra payload integrity checksum.
+
+        :type: P_CHECKSUM
+        """
+
+        self.arp_rx_table = P_ARPRXTABLE(conn, module_id, port_id)
+        """L23 port ARP table.
+
+        :type: P_ARPRXTABLE
+        """
+
+        self.ndp_rx_table = P_NDPRXTABLE(conn, module_id, port_id)
+        """L23 port NDP table.
+
+        :type: P_NDPRXTABLE
+        """
+
+        self.capturer = PortCapture(conn, module_id, port_id)
+        """L23 port capturer configuration.
+
+        :type: PortCapture
+        """
+
+        self.speed = Speed(conn, module_id, port_id)
+        """L23 port speed configuration.
+
+        :type: Speed
+        """
+
+        self.traffic = Traffic(conn, module_id, port_id)
+        """L23 port traffic configuration.
+
+        :type: Traffic
+        """
+
+        self.mix = Mix(conn, module_id, port_id)
+        """L23 port IMIX configuration.
+
+        :type: Mix
+        """
+
+        self.latency_config = LatencyConfiguration(conn, module_id, port_id)
+        """L23 port latency configuration.
+
+        self.latency_config = LatencyConfiguration(conn, module_id, port_id)
+        :type:
+        """
+
+        self.rate = TxRate(conn, module_id, port_id)
+        """L23 port rate.
+
+        :type: Rate
+        """
+
+        self.tx_config = TxConfiguration(conn, module_id, port_id)
+        """L23 port TX configuration.
+
+        :type: TxConfiguration
+        """
+
+        self.tx_single_pkt = TxSinglePacket(conn, module_id, port_id)
+        """L23 port single-packet TX configuration.
+
+        :type: TxSinglePacket
+        """
+
+        self.multicast = Multicast(conn, module_id, port_id)
+        """L23 port multicast configuration.
+
+        :type: Multicast
+        """
+
+        self.net_config = NetConfig(conn, module_id, port_id)
+        """L23 port network configuration, including MAC and IP addresses.
+
+        :type: NetConfig
+        """
+
+
+        self.local_states = ports_state.PortL23LocalState()
+        """L23 port local states.
+
+        :type: PortL23LocalState
+        """
+
+        self.length_terms: LengthTermIndices = idx_mgr.IndexManager(
+            conn,
+            LengthTermIdx,
+            module_id,
+            port_id
+        )
+        """L23 port's length term index manager.
+
+        :type: LengthTermIndices
+        """
+
+        self.match_terms: MatchTermIndices = idx_mgr.IndexManager(
+            conn,
+            MatchTermIdx,
+            module_id,
+            port_id
+        )
+        """L23 port's match term index manager.
+
+        :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."""
+
+    on_traffic_change = functools.partialmethod(utils.on_event, P_TRAFFIC)
+    """Register a callback to the event that the port's traffic status changes."""

xoa_driver/internals/hli/ports/port_l23/bases/port_l23_genuine.py

@@ -0,0 +1,180 @@
+import functools
+from typing import TYPE_CHECKING
+if TYPE_CHECKING:
+    from xoa_driver.internals.core import interfaces as itf
+from xoa_driver.internals.commands import (
+    P_FLASH,
+    P_SPEEDSELECTION,
+    P_SPEEDS_SUPPORTED,
+    P_UAT_MODE,
+    P_UAT_FLR,
+    P_STATUS,
+    P_TCVRSTATUS,
+    P_LOADMODE,
+    PP_FECMODE,
+)
+from xoa_driver.internals.utils import attributes as utils
+from xoa_driver.internals.utils.indices import index_manager as idx_mgr
+from xoa_driver.internals.hli.indices.streams.genuine_stream import GenuineStreamIdx
+from xoa_driver.internals.hli.indices.filter.genuine_filter import GenuineFilterIdx
+from xoa_driver.internals.hli.indices.port_dataset import PortDatasetIdx
+from xoa_driver.internals.state_storage import ports_state
+
+from .port_l23 import BasePortL23
+
+from ..tcvr.transceiver import Transceiver
+from ..trafficgen.rx_stats import GenuinePortReceptionStatistics
+from ..trafficgen.tx_stats import GenuinePortTransmissionStatistics
+from ..trafficgen.tgen import *
+
+StreamIndices = idx_mgr.IndexManager[GenuineStreamIdx]
+FilterIndices = idx_mgr.IndexManager[GenuineFilterIdx]
+PortDatasetIndices = idx_mgr.IndexManager[PortDatasetIdx]
+
+
+class GenuineSpeed(Speed):
+    def __init__(self, conn: "itf.IConnection", module_id: int, port_id: int) -> None:
+        super().__init__(conn, module_id, port_id)
+        
+        self.selection = P_SPEEDSELECTION(conn, module_id, port_id)
+        """L23 port speed mode selection.
+
+        :type: P_SPEEDSELECTION
+        """
+
+        self.supported = P_SPEEDS_SUPPORTED(conn, module_id, port_id)
+        """L23 port's supported speed modes.
+
+        :type: P_SPEEDS_SUPPORTED
+        """
+
+
+class UnAvailableTime:
+    """UnAvailable Time"""
+
+    def __init__(self, conn: "itf.IConnection", module_id: int, port_id: int) -> None:
+        self.mode = P_UAT_MODE(conn, module_id, port_id)
+        """L23 port's Unavailable Time mode.
+
+        :type: P_UAT_MODE
+        """
+
+        self.flr = P_UAT_FLR(conn, module_id, port_id)
+        """L23 port's Frame Loss Ratio for UAT.
+
+        :type: P_UAT_FLR
+        """
+
+
+class PortStatistics:
+    """L23 port statistics"""
+
+    def __init__(self, conn: "itf.IConnection", module_id: int, port_id: int) -> None:
+        self.rx = GenuinePortReceptionStatistics(conn, module_id, port_id)
+        """L23 port's RX statistics."""
+
+        self.tx = GenuinePortTransmissionStatistics(conn, module_id, port_id)
+        """L23 port's TX statistics."""
+
+
+class BasePortL23Genuine(BasePortL23):
+    """L23 port basic configuration."""
+
+    def __init__(self, conn: "itf.IConnection", module_id: int, port_id: int) -> None:
+        super().__init__(conn, module_id, port_id)
+
+        self._local_states = ports_state.PortL23GenuineLocalState()
+
+        self.flash = P_FLASH(conn, module_id, port_id)
+        """L23 port flashes.
+
+        :type: P_FLASH
+        """
+
+        self.status = P_STATUS(conn, module_id, port_id)
+        """L23 port's received optical signal level'.
+
+        :type: P_STATUS
+        """
+
+        self.config_load_mode = P_LOADMODE(conn, module_id, port_id)
+        """Chimera Port loading mode.
+
+        :type: P_LOADMODE
+        """
+
+        self.tcvr_status = P_TCVRSTATUS(conn, module_id, port_id)
+        """L23 port transceiver status information.
+
+        :type: P_TCVRSTATUS
+        """
+
+        self.speed = GenuineSpeed(conn, module_id, port_id)
+        """L23 port speed configuration.
+
+        :type: GenuineSpeed
+        """
+
+        self.uat = UnAvailableTime(conn, module_id, port_id)
+        """L23 port UnAvailable Time configuration.
+
+        :type: UnAvailableTime
+        """
+
+        self.transceiver = Transceiver(conn, module_id, port_id)
+        """L23 port transceiver configuration.
+
+        :type: PortTransceiver
+        """
+
+        self.statistics = PortStatistics(conn, module_id, port_id)
+        """L23 port statistics.
+
+        :type: PortStatistics
+        """
+
+        self.streams: StreamIndices = idx_mgr.IndexManager(
+            conn,
+            GenuineStreamIdx,
+            module_id,
+            port_id
+        )
+        """L23 port stream index manager.
+
+        :type: StreamIndices
+        """
+
+        self.filters: FilterIndices = idx_mgr.IndexManager(
+            conn,
+            GenuineFilterIdx,
+            module_id,
+            port_id
+        )
+        """L23 port filter index manager.
+
+        :type: FilterIndices
+        """
+
+        self.datasets: PortDatasetIndices = idx_mgr.IndexManager(
+            conn,
+            PortDatasetIdx,
+            module_id,
+            port_id
+        )
+        """L23 port histogram index manager.
+
+        :type: PortDatasetIndices
+        """
+
+
+    @property
+    def info(self) -> ports_state.PortL23GenuineLocalState:
+        return self._local_states
+
+    async def _setup(self):
+        await self._local_states.initiate(self)
+        self._local_states.register_subscriptions(self)
+        return self
+
+    on_speed_selection_change = functools.partialmethod(utils.on_event, P_SPEEDSELECTION)
+    """Register a callback to the event that the port's speed mode changes."""

xoa_driver/internals/hli/ports/port_l23/bases/port_l23ve.py

@@ -0,0 +1,101 @@
+from typing import TYPE_CHECKING
+from .port_l23 import BasePortL23
+from ..trafficgen.rx_stats import PortReceptionStatistics
+from ..trafficgen.tx_stats import PortTxStats
+
+from xoa_driver.internals.commands import (
+    P_MDIXMODE,
+    # P_ENGINENAMES, # TODO: need to implement
+    # P_ENGINELOAD, # TODO: need to implement
+)
+if TYPE_CHECKING:
+    from xoa_driver.internals.core import interfaces as itf
+from xoa_driver.internals.utils.indices import index_manager as idx_mgr
+from xoa_driver.internals.hli.indices.streams.base_stream import BaseStreamIdx
+from xoa_driver.internals.hli.indices.filter.base_filter import BaseFilterIdx
+from xoa_driver.internals.state_storage import ports_state
+
+VEStreamIndices = idx_mgr.IndexManager[BaseStreamIdx]
+VEFilterIndices = idx_mgr.IndexManager[BaseFilterIdx]
+
+
+class Engine:
+    def __init__(self, conn: "itf.IConnection", module_id: int, port_id: int) -> None:
+        # self.names = P_ENGINENAMES(conn, module_id, port_id)
+        # self.load = P_ENGINELOAD(conn, module_id, port_id)
+        ...
+
+
+class L23VEPortStatistics:
+    """L23 VE port statistics"""
+
+    def __init__(self, conn: "itf.IConnection", module_id: int, port_id: int) -> None:
+        self.rx = PortReceptionStatistics(conn, module_id, port_id)
+        """L23 VE port's RX statistics.
+        
+        :type: PortReceptionStatistics
+        """
+
+        self.tx = PortTxStats(conn, module_id, port_id)
+        """L23 VE port's TX statistics.
+        
+        :type: PortTransmissionStatistics
+        """
+
+
+class PortL23VE(BasePortL23):
+    """L23 VE port"""
+
+    def __init__(self, conn: "itf.IConnection", module_id: int, port_id: int) -> None:
+        super().__init__(conn, module_id, port_id)
+
+        self._local_states = ports_state.PortL23LocalState()
+
+        self.mdix_mode = P_MDIXMODE(conn, module_id, port_id)
+        """MDI/MDIX mode.
+        
+        :type: P_MDIXMODE
+        """
+
+        self.engine = Engine(conn, module_id, port_id)
+        """Engine is not supported yet.
+        
+        :type: Engine
+        """
+
+        self.statistics = L23VEPortStatistics(conn, module_id, port_id)
+        """Port statistics.
+
+        :type: L23VEPortStatistics
+        """
+
+        self.streams: VEStreamIndices = idx_mgr.IndexManager(
+            conn,
+            BaseStreamIdx,
+            module_id,
+            port_id
+        )
+        """L23 VE port's stream index manager.
+        
+        :type: VEStreamIndices
+        """
+
+        self.filters: VEFilterIndices = idx_mgr.IndexManager(
+            conn,
+            BaseFilterIdx,
+            module_id,
+            port_id
+        )
+        """L23 VE port's filter index manager.
+        
+        :type: VEFilterIndices
+        """
+
+    @property
+    def info(self) -> ports_state.PortL23LocalState:
+        return self._local_states
+
+    async def _setup(self):
+        await self._local_states.initiate(self)
+        self._local_states.register_subscriptions(self)
+        return self