tdl-xoa-driver 1.7.1__tar.gz → 1.7.2__tar.gz

{tdl_xoa_driver-1.7.1/tdl_xoa_driver.egg-info → tdl_xoa_driver-1.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tdl-xoa-driver
-Version: 1.7.1
+Version: 1.7.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.7.1 → tdl_xoa_driver-1.7.2/tdl_xoa_driver.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tdl-xoa-driver
-Version: 1.7.1
+Version: 1.7.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.7.1 → tdl_xoa_driver-1.7.2}/tdl_xoa_driver.egg-info/SOURCES.txt

@@ -26,6 +26,7 @@ xoa_driver/functions/headers.py
 xoa_driver/functions/layer1_adv.py
 xoa_driver/functions/mgmt.py
 xoa_driver/functions/tools.py
+xoa_driver/functions/xcvr.py
 xoa_driver/functions/cli/__init__.py
 xoa_driver/functions/cli/_cli_manager.py
 xoa_driver/functions/cli/_config_block.py

tdl_xoa_driver-1.7.2/xoa_driver/__init__.py

@@ -0,0 +1,2 @@
+__version__ = "1.7.2"
+__short_version__ = "1.7"

tdl_xoa_driver-1.7.2/xoa_driver/functions/xcvr.py

@@ -0,0 +1,196 @@
+"""
+Transceiver R/W functions
+"""
+
+from __future__ import annotations
+import asyncio
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Union,
+    List,
+    Tuple,
+)
+if TYPE_CHECKING:
+    from xoa_driver.ports import Z800FreyaPort, Z1600EdunPort, Z100LokiPort, Z10OdinPort, Z400ThorPort
+
+from ..misc import Hex
+
+
+
+async def get_xcvr_rw_seq_bank(port: "Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort", bank: int, page: int, register: int, length: int) -> str:
+    """Read a number of bytes from transceiver register interface via I2C.
+
+    :param port: The port object
+    :type port: Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort
+    :param bank: The bank address, e.g. 10 or 0xA
+    :type bank: int
+    :param page: The page address, e.g. 10 or 0xA
+    :type page: int
+    :param register: The register address, e.g. 10 or 0xA
+    :type register: int
+    :param length: The number of bytes to read
+    :type length: int
+    :return: The read bytes as a string, e.g. 'DEADBEEF'
+    :rtype: str
+    """
+
+    resp = await port.transceiver.access_rw_seq_bank(bank_address=bank, page_address=page, register_address=register, byte_count=length).get()
+    return resp.value
+
+async def set_xcvr_rw_seq_bank(port: "Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort", bank: int, page: int, register: int, value: str) -> None:
+    """Write a number of bytes to transceiver register interface via I2C.
+
+    :param port: The port object
+    :type port: Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort
+    :param bank: The bank address, e.g. 10 or 0xA
+    :type bank: int
+    :param page: The page address, e.g. 10 or 0xA
+    :type page: int
+    :param register: The register address, e.g. 10 or 0xA
+    :type register: int
+    :param value: The bytes to write as a string, e.g. 'DEADBEEF'
+    :type value: str
+    """
+    await port.transceiver.access_rw_seq_bank(bank_address=bank, page_address=page, register_address=register, byte_count=len(value)//2).set(value=Hex(value))
+
+
+async def get_xcvr_rw_seq(port: "Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort", page: int, register: int, length: int) -> str:
+    """Read a number of bytes from transceiver register interface via I2C.
+
+    :param port: The port object
+    :type port: Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort
+    :param page: The page address, e.g. 10 or 0xA
+    :type page: int
+    :param register: The register address, e.g. 10 or 0xA
+    :type register: int
+    :param length: The number of bytes to read
+    :type length: int
+    :return: The read bytes as a string, e.g. 'DEADBEEF'
+    :rtype: str
+    """
+
+    resp = await port.transceiver.access_rw_seq(page_address=page, register_address=register, byte_count=length).get()
+    return resp.value
+
+async def set_xcvr_rw_seq(port: "Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort", page: int, register: int, value: str) -> None:
+    """Write a number of bytes to transceiver register interface via I2C.
+
+    :param port: The port object
+    :type port: Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort
+    :param page: The page address, e.g. 10 or 0xA
+    :type page: int
+    :param register: The register address, e.g. 10 or 0xA
+    :type register: int
+    :param value: The bytes to write as a string, e.g. 'DEADBEEF'
+    :type value: str
+    """
+    await port.transceiver.access_rw_seq(page_address=page, register_address=register, byte_count=len(value)//2).set(value=Hex(value))
+
+
+async def get_xcvr_rw(port: "Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort", page: int, register: int) -> str:
+    """Read 4 bytes from transceiver register interface.
+
+    :param port: The port object
+    :type port: Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort
+    :param page: The page address, e.g. 10 or 0xA
+    :type page: int
+    :param register: The register address, e.g. 10 or 0xA
+    :type register: int
+    :return: The read bytes as a string, e.g. 'DEADBEEF'
+    :rtype: str
+    """
+
+    resp = await port.transceiver.access_rw(page_address=page, register_address=register).get()
+    return resp.value
+
+async def set_xcvr_rw(port: "Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort", page: int, register: int, value: str) -> None:
+    """Write 4 bytes to transceiver register interface.
+
+    :param port: The port object
+    :type port: Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort
+    :param page: The page address, e.g. 10 or 0xA
+    :type page: int
+    :param register: The register address, e.g. 10 or 0xA
+    :type register: int
+    :param value: The bytes to write as a string, e.g. 'DEADBEEF'
+    :type value: str
+    """
+    await port.transceiver.access_rw(page_address=page, register_address=register).set(value=Hex(value))
+
+async def get_xcvr_mii(port: "Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort", register: int) -> str:
+    """Read 2 bytes from transceiver register interface.
+
+    :param port: The port object
+    :type port: Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort
+    :param register: The register address, e.g. 10 or 0xA
+    :type register: int
+    :return: The read 2 bytes as a string, e.g. 'DEAF'
+    :rtype: str
+    """
+
+    resp = await port.transceiver.access_mii(register_address=register).get()
+    return resp.value
+
+async def set_xcvr_mii(port: "Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort",register: int, value: str) -> None:
+    """Write 2 bytes to transceiver register interface.
+
+    :param port: The port object
+    :type port: Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort
+    :param page: The page address, e.g. 10 or 0xA
+    :type page: int
+    :param register: The register address, e.g. 10 or 0xA
+    :type register: int
+    :param value: The 2 bytes to write as a string, e.g. 'DEAF'
+    :type value: str
+    """
+    await port.transceiver.access_mii(register_address=register).set(value=Hex(value))
+
+async def get_i2c_freq_khz(port: "Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort") -> int:
+    """Read access speed on a transceiver I2C access in the unit of KHz. Default to 100. 
+    
+    When the transceiver is plugged out and in again, the speed will be reset to the default value 100. The speed has a minimum and a maximum, which can be obtained from P_CAPABILITIES. 
+    
+    The I2C speed configuration will not be included in the port configuration file (.xpc). 
+    When you load a port configuration to a port, the transceiver I2C access speed will be reset to default 100.
+
+    :param port: The port object
+    :type port: Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort
+    :return: The current I2C access speed in KHz
+    :rtype: int
+    """
+
+    resp = await port.transceiver.i2c_config.get()
+    return resp.frequency
+
+async def set_i2c_freq_khz(port: "Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort", frequency: int) -> None:
+    """Set access speed on a transceiver I2C access in the unit of KHz.
+    
+    When the transceiver is plugged out and in again, the speed will be reset to the default value 100. The speed has a minimum and a maximum, which can be obtained from P_CAPABILITIES. 
+    
+    The I2C speed configuration will not be included in the port configuration file (.xpc). 
+    When you load a port configuration to a port, the transceiver I2C access speed will be reset to default 100.
+
+    :param port: The port object
+    :type port: Z1600EdunPort | Z800FreyaPort | Z400ThorPort | Z100LokiPort | Z10OdinPort
+    :param frequency: The desired I2C access speed in KHz
+    :type frequency: int
+    """
+
+    await port.transceiver.i2c_config.set(frequency=frequency)
+
+
+
+
+__all__ = (
+    "get_xcvr_rw_seq_bank",
+    "set_xcvr_rw_seq_bank",
+    "get_xcvr_rw_seq",
+    "set_xcvr_rw_seq",
+    "get_xcvr_rw",
+    "set_xcvr_rw",
+    "get_xcvr_mii",
+    "set_xcvr_mii",
+    "get_i2c_freq_khz",
+    "set_i2c_freq_khz",
+)

{tdl_xoa_driver-1.7.1 → tdl_xoa_driver-1.7.2}/xoa_driver/hlfuncs.py

@@ -11,6 +11,7 @@ from xoa_driver.functions import (
     cmis,
     layer1_adv,
     async_wrapper,
+    xcvr,
 )
 
 __all__ = (
@@ -23,4 +24,5 @@ __all__ = (
     "cmis",
     "layer1_adv",
     "async_wrapper",
+    "xcvr",
 )

{tdl_xoa_driver-1.7.1 → tdl_xoa_driver-1.7.2}/xoa_driver/internals/hli/ports/port_l23/tcvr/transceiver.py

@@ -45,7 +45,7 @@ class Transceiver:
         """
 
     def access_rw(self, page_address: int, register_address: int) -> "PX_RW":
-        """Access to register interface by the transceiver.
+        """R/W access (4 bytes) to register interface by the transceiver.
 
         :param page_address: page address
         :type page_address: int
@@ -64,7 +64,7 @@ class Transceiver:
         )
 
     def access_mii(self, register_address: int) -> "PX_MII":
-        """Access to the register interface supported by the media-independent interface (MII) transceiver.
+        """R/W access (2 bytes) to the register interface supported by MII transceiver.
 
         :param register_address: register address
         :type register_address: int
@@ -79,7 +79,7 @@ class Transceiver:
         )
 
     def access_rw_seq(self, page_address: int, register_address: int, byte_count: int) -> "PX_RW_SEQ":
-        """Sequential read/write a number of bytes to the register interface supported by the media-independent interface (MII) transceiver.
+        """Sequential R/W a number of bytes to the register interface.
 
         :param page_address: page address (0-255)
         :type page_address: int
@@ -100,7 +100,7 @@ class Transceiver:
         )
     
     def access_rw_seq_bank(self, bank_address: int, page_address: int, register_address: int, byte_count: int) -> "PX_RW_SEQ_BANK":
-        """Sequential read/write a number of bytes to the register interface supported by the media-independent interface (MII) transceiver.
+        """Sequential R/W a number of bytes to the register interface.
 
         :param bank_address: bank address (0-255)
         :type bank_address: int

tdl_xoa_driver-1.7.1/xoa_driver/__init__.py

@@ -1,2 +0,0 @@
-__version__ = "1.7.1"
-__short_version__ = "1.7"