tlkcore 255.255.255__cp38-none-win_amd64.whl

tlkcore/TMYBeamConfig.py

@@ -0,0 +1,211 @@
+import csv
+import logging
+import os
+
+from tlkcore.TMYPublic import RetCode, RFMode, BeamType
+
+logger = logging.getLogger("TMYBeamConfig")
+
+class TMYBeamConfig():
+    def __init__(self, sn:str, service, path="CustomBatchBeams.csv", delimiter=","):
+        """
+        Test for parsing batch beam configs then apply it,
+        please edit gains to feet available gain range for your BeamForm devices, e.g., BBoxOne
+
+        Args:
+            sn (str): Device serail number
+            service (_type_): TLKCoreService instance
+            path (str, optional): _description_. Defaults to "CustomBatchBeams.csv".
+            delimiter (str, optional): delimiter in csv. Defaults to ",".
+        """
+
+        self.__sn = sn
+        self.__service = service
+        self.__config = None
+        if not os.path.exists(path):
+            logger.error("Not exist: %s" %path)
+            return
+        self.__config = self.__parse(path, delimiter)
+
+    def __parse(self, path:str, delimiter:str):
+        logger.info("Start to parsing...")
+        try:
+            aakit_selected = True if self.__service.getAAKitInfo(self.__sn).RetCode is RetCode.OK else False
+            logger.info("[AppyBatchBeams] AAKit %sselected" %"" if aakit_selected else "NOT ")
+
+            file = open(path)
+            reader = csv.reader((_.replace('\x00', '') for _ in file), delimiter=delimiter)
+            custom = { 'TX': {}, 'RX': {}}
+            # Parsing CSV
+            for col in reader:
+                if len(col) == 0 or len(col[0]) == 0 or col[0] == 'Mode':
+                    continue
+                # print(col)
+                mode_name = col[0]
+                beamID = int(col[1])
+                beam_type = BeamType(int(col[2]))
+
+                if beam_type is BeamType.BEAM:
+                    if not aakit_selected:
+                        logger.warning("PhiA mode not support whole beam config -> skip")
+                        continue
+                    # Fetch col 3~5 for db,theta,phi
+                    config = [col[i] for i in range(3, 6)]
+                else: #CHANNEL
+                    ch = int(col[6])
+                    # Fetch col 7~9 for sw,db,deg
+                    config = {str(ch): [col[i] for i in range(7, 10)]}
+
+                if custom[mode_name].get(str(beamID)) is None:
+                    # Create new beam config
+                    beam = {'beam_type': beam_type.value, 'config': config}
+                    custom[mode_name][str(beamID)] = beam
+                else:
+                    # If exist, replace or add new channel config into beam config
+                    custom[mode_name][str(beamID)]['config'].update(config)
+                    # custom[mode_name][str(beamID)].update(beam)
+
+            # Parsing done
+            logger.info("[CustomCSV] " + str(custom))
+            return custom
+        except:
+            logger.exception("Something wrong while parsing")
+            return None
+
+    def getConfig(self):
+        if self.__config is None:
+            return None
+        return self.__config
+
+    def applyBeams(self):
+        try:
+            if self.__service is None:
+                logger.error("service is None")
+                return False
+            if self.__config is None:
+                logger.error("Beam config is empty!")
+                return False
+
+            service = self.__service
+            sn = self.__sn
+            custom = self.__config
+
+            channel_count = service.getChannelCount(sn).RetData
+            dr = service.getDR(sn).RetData
+            com_dr = service.getCOMDR(sn).RetData
+            # print(com_dr)
+            ele_dr_limit = service.getELEDR(sn).RetData
+            # print(ele_dr_limit)
+
+            # Get Beam then update custom beam
+            for mode_name in [*custom]:
+                mode = getattr(RFMode, mode_name)
+                # print(mode)
+                for id in [*custom[mode_name]]:
+                    beamID = int(id)
+                    ret = service.getBeamPattern(sn, mode, beamID)
+                    beam = ret.RetData
+                    logger.debug("Get [%s]BeamID %02d info: %s" %(mode_name, beamID, beam))
+
+                    beam_type = BeamType(custom[mode_name][str(beamID)]['beam_type'])
+                    value = custom[mode_name][str(beamID)]['config']
+                    logger.info("Get [%s]BeamID %02d custom: %s" %(mode_name, beamID, value))
+
+                    if beam_type is BeamType.BEAM:
+                        if beam['beam_type'] != beam_type.value:
+                            # Construct a new config
+                            beam = {'beam_config': {'db': dr[mode.name][1], 'theta': 0, 'phi':0 }}
+                        config = beam['beam_config']
+                        if len(value[0]) > 0:
+                            config['db'] = float(value[0])
+                        if len(value[1]) > 0:
+                            config['theta'] = int(value[1])
+                        if len(value[2]) > 0:
+                            config['phi'] = int(value[2])
+                    else: #CHANNEL
+                        if beam['beam_type'] != beam_type.value:
+                            # Construct a new config
+                            beam = {'channel_config': {}}
+                            for ch in range(1, channel_count+1):
+                                if ch%4 == 1: # 4 channels in one board
+                                    # First channel in board: construct brd_cfg
+                                    board = int(ch/4) + 1
+                                    brd_cfg = {}
+                                    # Use MAX COMDR - will check with assign gain to adjust
+                                    brd_cfg['common_db'] = com_dr[mode.value][board-1][1]
+                                ch_cfg = {
+                                    'sw': 0,
+                                    # Use MAX ELEDR
+                                    'db': ele_dr_limit[mode.value][board-1],
+                                    'deg': 0
+                                }
+                                brd_cfg['channel_'+str((ch-1)%4 + 1)] = ch_cfg
+                                if ch%4 == 0:
+                                    beam['channel_config'].update({'board_'+str(board): brd_cfg})
+
+                        config = beam['channel_config']
+
+                        # Update each channel
+                        for ch_str, ch_value in value.items():
+                            ch = int(ch_str)
+                            if ch > channel_count:
+                                logger.error("[%s]BeamID %02d - Invalid ch_%s exceeds %d channels! -> skip it"
+                                            %(mode_name, beamID, ch, channel_count))
+                                return False
+                            # logger.debug("Update ch%d info: %s" %(ch, ch_value))
+                            board_idx = int((ch-1)/4)
+                            board_name = 'board_'+str(board_idx + 1)
+                            board_ch = (ch-1)%4 + 1
+                            ch_name = 'channel_'+str(board_ch)
+                            if len(ch_value[0]) > 0:
+                                config[board_name][ch_name]['sw'] = int(ch_value[0])
+                            if len(ch_value[1]) > 0:
+                                db = float(ch_value[1])
+                                ele_gain = db - config[board_name]['common_db']
+                                if ele_gain < 0:
+                                    logger.warning("Ch_%d changed to db:%.1f < com gain:%.1f, adjust com gain later" %(ch, db, config[board_name]['common_db']))
+                                config[board_name][ch_name]['db'] = ele_gain
+                            if len(ch_value[2]) > 0:
+                                config[board_name][ch_name]['deg'] = int(ch_value[2])
+                        logger.debug("Tmp [%s]BeamID %02d custom: %s" %(mode_name, beamID, config))
+
+                        # Simple check each com_gain, ele_gain for board/channel
+                        for brd, brd_cfg in config.items():
+                            brd_idx = int(brd.replace("board_", ""))-1
+                            brd_db = [v['db'] for k, v in brd_cfg.items() if k.startswith("channel_")]
+                            # print(brd_db)
+                            if max(brd_db) - min(brd_db) > ele_dr_limit[mode.value][board_idx]:
+                                logger.error("[%s]BeamID %02d - [%s] Invalid db setting: %s, the max diff of each db field exceeds the limit: %.1f"
+                                            %(mode_name, beamID, brd, [d+brd_cfg['common_db'] for d in brd_db], ele_dr_limit[mode.value][board_idx]))
+                                return False
+                            if min(brd_db) < 0:
+                                # Lower the common gain to min db
+                                new_com = brd_cfg['common_db'] + min(brd_db)
+                                if new_com < com_dr[mode.value][brd_idx][0]:
+                                    logger.error("[%s]BeamID %02d - [%s] Invalid common gain: %.1f < min common gain: %.1f, please tune higher the minimal db field"
+                                                %(mode_name, beamID, brd, new_com, com_dr[mode.value][brd_idx][0]))
+                                    return False
+                                logger.info("[%s]BeamID %02d - Adjust [%s]com gain: %.1f -> %.1f, and ele gain: %s -> %s"
+                                            %(mode_name, beamID, brd, brd_cfg['common_db'], new_com,
+                                            [v['db'] for k, v in brd_cfg.items() if k.startswith("channel_")],
+                                            [v['db']-min(brd_db) for k, v in brd_cfg.items() if k.startswith("channel_")]))
+                                brd_cfg['common_db'] = new_com
+                                for k, v in brd_cfg.items():
+                                    if k.startswith("channel_"):
+                                        v['db'] -= min(brd_db)
+                    logger.info("Set [%s]BeamID %02d info: %s" %(mode_name, beamID, config))
+                    ret = service.setBeamPattern(sn, mode, beamID, beam_type, config)
+                    if ret.RetCode is not RetCode.OK:
+                        logger.error(ret.RetMsg)
+                        return False
+        except:
+            logger.exception("Something wrong while parsing")
+            return False
+        logger.info("Apply beam configs to %s successfully" %sn)
+        return True
+
+# if __name__ == '__main__':
+#     import logging.config
+#     if not os.path.isdir('tlk_core_log/'):
+#         os.mkdir('tlk_core_log/')
+#     logging.config.fileConfig('logging.conf')

tlkcore/TMYLogging.py

@@ -0,0 +1,112 @@
+from datetime import datetime
+import logging
+import logging.config
+import os
+
+from tlkcore.TMYUtils import _Utils
+
+class TMYLogging():
+    """
+    Customerize your logging setting here
+    """
+    _LOGGING_CONFIG = {
+        "version": 1,
+        "disable_existing_loggers": False,
+        "loggers": {
+            "": { # root logger
+                "handlers": ["console", "file"],
+                "level": logging.DEBUG,
+                "propagate": False,
+            },
+            "TLKCoreService": {
+                "handlers": ["console", "libFile"],
+                "qualname": "TLKCoreService",
+                "propagate": False,
+            },
+            "Comm":{
+                "handlers": ["libConsole", "libFile"],
+                "qualname": "Comm",
+                "propagate": False,
+            },
+            "Device":{
+                "handlers": ["libConsole", "libFile"],
+                "qualname": "Device",
+                "propagate": False,
+            },
+            "DFU":{
+                "handlers": ["console", "libFile"],
+                "qualname": "DFU",
+                "propagate": False,
+            },
+            "CaliTbl":{
+                "handlers": ["libFile"],
+                "qualname": "CaliTbl",
+                "propagate": False,
+            },
+            "AAKitTbl":{
+                "handlers": ["libFile"],
+                "qualname": "AAKitTbl",
+                "propagate": False,
+            },
+            "BeamTbl":{
+                "handlers": ["libFile"],
+                "qualname": "BeamTbl",
+                "propagate": False,
+            },
+            "UDDeltaTbl":{
+                "handlers": ["libFile"],
+                "qualname": "UDDeltaTbl",
+                "propagate": False,
+            },
+            "TblDB":{
+                "handlers": ["libFile"],
+                "qualname": "TblDB",
+                "propagate": False,
+            },
+        },
+        "handlers": {
+            "console": {
+                "class": "logging.StreamHandler",
+                "level": logging.INFO,
+                "formatter": "default",
+            },
+            "file":{
+                "class": "logging.FileHandler",
+                "level": logging.DEBUG,
+                "filename": datetime.now().strftime("tlk_core_log/main-%Y-%m-%d.log"),
+                "formatter": "default",
+            },
+            "libConsole": {
+                "class": "logging.StreamHandler",
+                "level": logging.ERROR,
+                "formatter": "default",
+            },
+            "libFile":{
+                "class": "logging.FileHandler",
+                "level": logging.DEBUG,
+                "filename": datetime.now().strftime("tlk_core_log/tlkcore-%Y-%m-%d.log"),
+                "formatter": "default",
+            }
+        },
+        "formatters": {
+            "default": {
+                "format": "%(asctime)s.%(msecs)3d - %(name)s - %(levelname)s : %(message)s",
+                "datefmt": "%Y-%m-%d %H:%M:%S"
+            },
+            "plain": {
+                "format": "%(message)s",
+            },
+        },
+    }
+
+    def __init__(self):
+        """TLKCoreService calls TMYLogging.py if change another root path"""
+        print('TMYLogging __init__')
+
+    def applyLogger(self):
+        # Update current dict
+        print("Apply logger path to : %s" %_Utils.root)
+        self._LOGGING_CONFIG["handlers"]["file"]["filename"] = os.path.join(_Utils.root, self._LOGGING_CONFIG["handlers"]["file"]["filename"])
+        self._LOGGING_CONFIG["handlers"]["libFile"]["filename"] = os.path.join(_Utils.root, self._LOGGING_CONFIG["handlers"]["libFile"]["filename"])
+
+        logging.config.dictConfig(self._LOGGING_CONFIG)

tlkcore/TMYPublic.py

@@ -0,0 +1,291 @@
+from enum import Enum, Flag, auto, IntEnum
+from typing import Union
+
+class RIS_Dir(dict):
+    """
+    A dict structure for RIS direction includes distance and angle.
+
+    Args:
+        distance (float): Distance from RIS to the source/target
+        angle (tuple): Angle of the target, given in (theta, phi) format or theta only with phi=0, Defaults to (0,0)
+
+    Examples:
+        * For a distance of 1 meter and an angle of (0, 0):
+            >>> RIS_Dir(1)
+        * For a distance of 1 meter and an angle of (0, 0):
+            >>> RIS_Dir(1, (0, 0))
+        * For a distance of 1 meter and an angle of (30, 0):
+            >>> RIS_Dir(1, (30, 0))
+    """
+    def __init__(self, distance, angle:Union[int, tuple]=(0,0)):
+        self['distance'] = distance
+        if isinstance(angle, int):
+            self['angle'] = (angle, 0)
+        # elif isinstance(angle, tuple):
+        #     # TODO: for multiple reflection angle only
+        #     self['angle'] = [angle]
+        else:
+            self['angle'] = angle
+
+class RIS_ModuleConfig(dict):
+    """
+    A data structure for RIS module configuration.
+
+    Args:
+        central_freq_mhz (int): Operating central frequency in MHz.
+        module (Union[int, list]): Specifies the target module partition to control.
+            It can be a single value (e.g. 1), or a list (e.g. [1, 2]),
+            or a nested list (e.g. [[1, 2]] or [[1, 2], [3, 4]]). Defaults to 1.
+        module_rotate (dict): Specifies the clockwise rotation degree for each module, therefore the actual pattern will be counter-clockwise rotation
+            The degree must be a multiple of 90.
+
+    Examples:
+        * 28GHz with only module 1, no rotation:
+            >>> RIS_ModuleConfig(28000, 1)
+        * 28GHz with module 1 and 2 in landscape orientation, no rotation:
+            >>> RIS_ModuleConfig(28000, [1, 2])
+        * 28GHz with module 1 and 2 in portrait orientation, rotate module 1 by 90 degrees:
+            >>> RIS_ModuleConfig(28000, [[1], [2]], {'1': 90})
+        * 28GHz with module 1 and 2 in landscape orientation, rotate module 1 by 90 degrees and module 2 by 180 degrees:
+            >>> RIS_ModuleConfig(28000, [1, 2], {'1': 90, '2': 180})
+        * 28GHz with module 1,2,3,4 in landscape orientation, no rotation:
+            >>> RIS_ModuleConfig(28000, [1, 2, 3, 4])
+        * 28GHz with module 1,2,3,4 in portrait orientation, no rotation:
+            >>> RIS_ModuleConfig(28000, [[1], [2], [3], [4]])
+        * 28GHz with module 1,2,3,4 in square orientation, rotate module 1 by 90 degrees and module 2 by 180 degrees:
+            >>> RIS_ModuleConfig(28000, [[1, 2],
+                                         [3, 4]], {'1': 90, '2': 180})
+    """
+    def __init__(self, central_freq_mhz:float, module:Union[int, list]=1, module_rotate=None):
+        self['central_freq_mhz'] = central_freq_mhz
+        self['module'] = module
+        self['module_rotate'] = module_rotate
+
+class DevInterface(Flag):
+    """
+    Defines device connect interface for scanning.
+    """
+    UNKNOWN = 0
+    LAN     = auto()
+    COMPORT = auto()
+    USB     = auto()
+    ALL     = LAN | COMPORT | USB
+
+class ScanFilter(Flag):
+    NONE    = 0
+    NORMAL  = auto()
+    DFU     = auto()
+    ALL     = NORMAL | DFU
+
+class IPMode(Enum):
+    """
+    Defines device IP mode as DHCP or static IP mode.
+    """
+    DHCP        = 0
+    STATIC_IP   = auto()
+
+class RFMode(Enum):
+    """
+    Defines RF mode of beamform devices series.
+    """
+    TX      = 0
+    RX      = auto()
+
+class CellRFMode(Enum):
+    STANDBY = -1
+    TX      = 0
+    RX      = auto()
+
+class BeamType(Enum):
+    """
+    Defines beam type of beamform devices series for beam configuration.
+    """
+    BEAM    = 0
+    CHANNEL = auto()
+
+class RetCode(Enum):
+    """
+    Error code to represent the status of operations in TLKCore.
+    """
+    def __str__(self):
+        return self.name
+    def __int__(self):
+        return self.value
+    OK                      = 0
+    WARNING                 = auto()
+    ERROR                   = auto()
+    NO_RESPONSE             = auto()
+    # genereal operations
+    ERROR_GET_SN            = 10
+    ERROR_DEV_TYPE          = auto()
+    ERROR_SCAN              = auto()
+    ERROR_INIT_OBJECT       = auto()
+    ERROR_DEV_NOT_INIT      = auto()
+    ERROR_METHOD_NOT_FOUND  = auto()
+    ERROR_METHOD_NOT_SUPPORT= auto()
+    ERROR_REFLECTION        = auto()
+    ERROR_POWER             = auto()
+    ERROR_EXPORT_LOG        = auto()
+    ERROR_FW_NOT_SUPPORT    = auto()
+
+    # Communication interface related
+    ERROR_COMM_NOT_INIT     = 30
+    ERROR_COMM_INIT         = auto()
+    ERROR_DISCONNECT        = auto()
+    ERROR_SOCKET            = auto()
+    ERROR_SEND_CMD          = auto()
+    ERROR_RESP_CMD          = auto()
+    ERROR_SEND_CMD_TIMEOUT  = auto()
+    ERROR_COMPORT           = auto()
+    ERROR_USB               = auto()
+
+    # CMD to device
+    ERROR_CMD               = 40
+    ERROR_CMD_INIT          = auto()
+    ERROR_CMD_PARAM         = auto()
+
+    # WEB - Database related
+    ERROR_DB_SERVER         = 50
+    ERROR_DB_FEEDBACK       = auto()
+
+    # DFU - Device Firmware Update related
+    ERROR_DFU               = 60
+    ERROR_DFU_NOT_SUPPORT   = auto()
+    ERROR_DFU_TYPE          = auto()
+    ERROR_DFU_HEADER        = auto()
+    ERROR_DFU_TRANSMIT      = auto()
+
+    # Beamforming device
+    ERROR_BF_STATE          = 100
+    ERROR_BF_AAKIT          = auto()
+    ERROR_BF_NO_AAKIT       = auto()
+    ERROR_BF_CALI_PATH      = auto()
+    ERROR_BF_BEAM           = auto()
+    ERROR_BF_GAIN           = auto()
+    ERROR_BF_PHASE          = auto()
+    ERROR_BF_RFMODE         = auto()
+    ERROR_BF_CALI_INCOMPLTE = auto()
+    ERROR_BF_CALI_PARSE     = auto()
+    ERROR_BF_TC             = auto()
+    ERROR_BF_BEAM_FILE      = auto()
+    # PD device
+    ERROR_PD_CALI           = 150
+    ERROR_PD_SOURCE         = auto()
+    # RIS device
+    ERROR_RIS_MODULE        = 160
+    ERROR_RIS_CONFIG        = auto()
+    # UDM/UDB device
+    ERROR_FREQ_RANGE        = 240
+    ERROR_LICENSE_LENGTH    = auto()
+    ERROR_LICENSE_KEY       = auto()
+    ERROR_REF_CHANGE        = auto()
+    # UD device
+    ERROR_UD_FREQ           = 245
+    ERROR_FREQ_EQUATION     = 250
+    WARNING_HARMONIC        = auto()
+    ERROR_HARMONIC_BLOCK    = auto()
+    ERROR_PLO_UNLOCK        = 253
+    ERROR_PLO_CRC           = auto()
+    ERROR_UD_STATE          = auto()
+
+class UDFreq(Enum):
+    """
+    UD frequency related categories, also used for key name of dict when calling :func:`~tlkcore.tmydev.DevUDBox.getUDFreq`
+    """
+    def __str__(self):
+        return self.name
+    UDFreq  = 0
+    RFFreq  = auto()
+    IFFreq  = auto()
+
+class UDState(Enum):
+    """
+    The state of UDBox5G
+    """
+    NO_SET          = -1
+    PLO_LOCK        = 0
+    CH1             = auto()
+    CH2             = auto() # ignore it if single UD
+    OUT_10M         = auto()
+    OUT_100M        = auto()
+    SOURCE_100M     = auto() # 0:Internal, 1:External
+    LED_100M        = auto() # 0:OFF, 1:WHITE, 2:BLUE
+    PWR_5V          = auto()
+    PWR_9V          = auto()
+
+class UDMState(Flag):
+    """
+    The state of UDM
+    """
+    NO_SET      = 0
+    SYSTEM      = auto()
+    PLO_LOCK    = auto()
+    REF_LOCK    = auto()
+    LICENSE     = auto()
+    ALL         = SYSTEM | PLO_LOCK | REF_LOCK | LICENSE
+
+class UDM_SYS(Enum):
+    """
+    It defines the :attr:`UDMState.SYSTEM` state of UDM
+    """
+    SYS_ERROR       = -1
+    NORMAL          = 0
+
+class UD_PLO(Enum):
+    """
+    It defines the :attr:`UDMState.PLO_LOCK` state of UD series
+    """
+    UNLOCK          = -1
+    LOCK            = 0
+
+class UD_REF(Enum):
+    """
+    It defines the :attr:`UDMState.REF_LOCK` state of UD series
+    """
+    UNLOCK          = -1
+    INTERNAL        = 0
+    EXTERNAL        = auto()
+
+class UDM_LICENSE(Enum):
+    """
+    It defines the :attr:`UDMState.LICENSE` state of UDM
+    """
+    VERIFY_FAIL_FLASH   = -2
+    VERIFY_FAIL_DIGEST  = -1
+    NON_LICENSE         = 0
+    VERIFY_PASS         = auto()
+
+class UD_SN_TYPE(Flag):
+    """
+    The SN type of UD
+    """
+    UD_BOX      = 1
+    UD_MODULE   = auto()
+    ALL         = UD_BOX | UD_MODULE
+
+class UD_LO_CONFIG(Enum):
+    """
+    It defines the LO config for UDB series
+    """
+    LO_CFG_INTERNAL     = 0
+    LO_CFG_INTERNAL_OUT = auto()
+    LO_CFG_EXTERNAL_IN  = auto()
+    def __str__(self):
+        return self.name
+
+class POLARIZATION(Flag):
+    HORIZON         = 1
+    VERTICAL        = auto()
+    DUAL            = HORIZON | VERTICAL
+    def __str__(self):
+        return self.name.lower()
+
+class POLAR_SYNTHESIS(IntEnum):
+    FORWARD             = 0
+    BACKWARD            = 180
+    RIGHT_HAND_CIRCULAR = 90
+    LEFT_HAND_CIRCULAR  = 270
+    def __str__(self):
+        return self.name
+    def __int__(self):
+        return self.value

tlkcore/__init__.py

@@ -0,0 +1 @@
+__version__ = "255.255.255"

tlkcore/db/__init__.py

@@ -0,0 +1,3 @@
+from .TMYDBQueryer import DBQueryer
+
+__all__ = ["DBQueryer"]

tlkcore/tmydev/__init__.py

@@ -0,0 +1,13 @@
+from pathlib import Path
+import sys
+
+__file = Path(__file__).absolute()
+__root = __file.parent.parent.parent
+if sys.path.count(__root) == 0:
+    sys.path.insert(0, __root)
+    # print(sys.path)
+
+fromLib = True
+
+if __file.suffix == '.py':
+    fromLib = False

tlkcore-255.255.255.dist-info/LICENSE.txt

@@ -0,0 +1,9 @@
+This software is proprietary to TMYTEK.
+
+Unauthorized reproduction, reverse engineering, decompilation, modification, or redistribution of this software is strictly prohibited.
+
+The software may only be used for development and operation in conjunction with TLKCore as authorized.
+
+Any usage beyond the licensed scope constitutes a breach of agreement, and TMYTEK reserves all legal rights.
+
+Copyright © 2025 TMYTEK. All rights reserved.

tlkcore-255.255.255.dist-info/METADATA

@@ -0,0 +1,113 @@
+Metadata-Version: 2.1
+Name: tlkcore
+Version: 255.255.255
+Summary: TLKCore library
+Home-page: https://github.com/TMYtek/tlkcore-examples/
+Author: TMYTEK Software Team
+Author-email: rd2_common@tmytek.com
+License: UNKNOWN
+Platform: UNKNOWN
+Classifier: License :: Other/Proprietary License
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Testing
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+Requires-Dist: psutil>=6.1.0
+Requires-Dist: pyserial>=3.5
+Requires-Dist: ft4222>=1.10.0
+Requires-Dist: tftpy==0.8.5
+
+
+Introduction
+============
+
+**TLKCore** is a core service which inside the TMXLAB KIT(TLK/[WEB-TLK](https://web-tlk.tmytek.com/)), it integrates Python built libraries which developing mmWave( n257 / n258 / n260 / n261 ) **beamforming** and **beam steering** applications on **BBox 5G Series(mmwave beamformer)** and **UDBox 5G Series(mmwave Up-down frequency converter)** and other standard products developed by TMYTEK.
+It provides a simple and efficient way to interact with the hardware, allowing developers to focus on building applications without worrying about low-level details.
+
+Installation Troubleshooting
+-----------------------------
+
+* If you encounter any issues during `tlkcore` installation or usage, please check the following:
+
+1. Ensure you have the required dependencies installed.
+2. Check the compatibility of your Python version.
+3. Review the documentation for any specific configuration steps.
+
+* If you meet the error message likes: CERTIFICATE_VERIFY_FAILED,
+    you can try the following steps:
+
+1. Update your `pip` to the latest version:
+    .. code-block:: bash
+
+        pip install --upgrade pip
+
+2. You may need to configure your proxy settings if you are behind a corporate firewall.
+3. You can also try to disable SSL verification (not recommended for production):
+    .. code-block:: bash
+
+        pip install tlkcore --trusted-host pypi.org --trusted-host files.pythonhosted.org
+
+4. Or download cacert.pem from https://curl.se/ca/cacert.pem , then set environment variable `SSL_CERT_FILE` to the path of the downloaded file.
+    .. code-block:: bash
+
+       set SSL_CERT_FILE={$your_path}/cacert.pem
+
+Hardware Prequisites
+=======================
+
+* Architecture:
+
+    .. image:: https://github.com/tmytek/tlkcore-examples/blob/master/images/TLKCore_usage.png
+       :alt: TLKCore usage architecture
+       :width: 600px
+
+* USB driver for scanning/connect device
+
+  - `Installation Guides for all platforms <https://ftdichip.com/document/installation-guides/>`_
+  - Windows
+
+    - Online-Host with external internet capability
+      - Auto detect a new device and install driver
+
+    - Offline-Host
+      - Download `setup executable driver from FTDI <https://ftdichip.com/drivers/d2xx-drivers/>`_ and install it.
+
+  - Linux
+
+    1. Follow `steps <https://gitlab.com/msrelectronics/python-ft4222/-/tree/master#accessrights>`_ to create or extend **/etc/udev/rules.d/99-ftdi.rules** includes::
+
+         SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="601c", GROUP="plugdev", MODE="0666"
+
+    2. Try to reload udev rules or re-plugin USB devices::
+
+         sudo udevadm control --reload-rules
+         sudo udevadm trigger
+
+Examples
+=========
+
+This represents how to use the `tlkcore` API. Please refer to the example from github: https://github.com/tmytek/tlkcore-examples for more details.
+
+Initialize & scanDevices
+------------------------
+
+.. code-block:: python
+
+    from tlkcore.TLKCoreService import TLKCoreService
+    service = TLKCoreService(".")
+    ret = service.scanDevices()
+    print(ret)
+
+

tlkcore-255.255.255.dist-info/RECORD

@@ -0,0 +1,30 @@
+tlkcore/TLKCoreService.cp38-win_amd64.pyd,sha256=4JMv18JBI1f7fzk4IylkJnRj--xQTzMgCBFG5tTYiME,188928
+tlkcore/TMYBeamConfig.py,sha256=r4AC7Pp3lSRVzZefIRlsEuPikH9OHHWQkJAmBykRstw,10970
+tlkcore/TMYCommService.cp38-win_amd64.pyd,sha256=uDC6ql9HL1UbREjlAHPTuxfiazzf2txZjNC029a4OOc,394240
+tlkcore/TMYDFU.cp38-win_amd64.pyd,sha256=S6-j8ZQrjnJrStIvTqq_J7seIjyi3KlT6fvKPmak43Q,272896
+tlkcore/TMYLogging.py,sha256=IfJ3bihGbZqZx9HLX3EMEIJyqmk4Kg9Wu0vBQjcR3Ak,3828
+tlkcore/TMYPublic.py,sha256=tiZkCU4ET_b1DT3F6YdLVtHSkZrcU2t5PcqHTCp30M4,9110
+tlkcore/TMYUtils.cp38-win_amd64.pyd,sha256=2HXBs5FixDtFAiOuq3tv0DvKaLVTMNq6_2Vz_pyWnQk,132096
+tlkcore/__init__.py,sha256=oU1ki7IC-ioCzroJrPr_PNM-FqyoTSi23COec0nfVfU,27
+tlkcore/db/TMYDBQueryer.cp38-win_amd64.pyd,sha256=_S9qsHlCZIXywunG5en_cQK7RMSinmO6Y10tMDhNuZg,59904
+tlkcore/db/__init__.py,sha256=7c0_FWO1wyv9J2X0ZS-AZGI-4fOJFQVQAtJkDf963BE,62
+tlkcore/tmydev/DevBBoard.cp38-win_amd64.pyd,sha256=-cPy3aNlYdiZYUw7XjKwltFFrOEr72ja6Y4FpjM5YZs,87552
+tlkcore/tmydev/DevBBox.cp38-win_amd64.pyd,sha256=6KmRm_Og8Wmi3HsYthgRrj0eMfeU5f-BoX65TqS9LSE,583168
+tlkcore/tmydev/DevBBoxLite.cp38-win_amd64.pyd,sha256=2kdLdyxP49Fu3dkB7C1dlyUGn8ppOkJeyEinCfQaY2Y,72704
+tlkcore/tmydev/DevBBoxOne.cp38-win_amd64.pyd,sha256=1EVbwHMne1LFbcMX1eBe9ZtamvPayDa8XwyA1gaxHmc,70656
+tlkcore/tmydev/DevCloverCell.cp38-win_amd64.pyd,sha256=WoQCmnXZnqI5vIjcIHGg95QE7LWt_Y7uyqdf2wf7q8A,439296
+tlkcore/tmydev/DevPD.cp38-win_amd64.pyd,sha256=O5G-qVRJC4cn__Wh6kGYqzBeb2avg1GoHYg1ujZSbeM,107520
+tlkcore/tmydev/DevRIS.cp38-win_amd64.pyd,sha256=S6RgDbg681kcojdyofFi1QXupmHVR_RO6fahMoKQllc,243712
+tlkcore/tmydev/DevUDB.cp38-win_amd64.pyd,sha256=FVjf6mKwsYc_7w6tuj92L8Xkf-Vq9TwyU1EEjcPwMDQ,82432
+tlkcore/tmydev/DevUDBox.cp38-win_amd64.pyd,sha256=sD1mcqlyf4YS1SnE3u_MpEzxBaTFzmjjY4J9sM6gMls,135168
+tlkcore/tmydev/DevUDC.cp38-win_amd64.pyd,sha256=fbnBMcgSzx0i5kUJN6JuAE-IryZLRkSEJHIgdtJwitY,237568
+tlkcore/tmydev/DevUDM.cp38-win_amd64.pyd,sha256=g98B29pw2ET_2aCi3P-KjOG76ejyZTLS-wYpdKZ6MSQ,138240
+tlkcore/tmydev/RIS_pattern_generator.cp38-win_amd64.pyd,sha256=4aO7A_KpPXmG_IRj1NP7ansm0kPTWFEOBAaBYV3-aPE,174080
+tlkcore/tmydev/TMYTableManager.cp38-win_amd64.pyd,sha256=Nh--zCZrY7SALkoOc3HdtdfksRk9dtAtGmbGW8GzAkU,645632
+tlkcore/tmydev/__init__.py,sha256=8ksasd6qXYtFXfv7JehWF_xCHllYtmAlDTLho53Xts0,269
+tlkcore/tmydev/device.cp38-win_amd64.pyd,sha256=s_GT8ZMfyea7Is0R37AWoz8id66NdchUZjy43U4s1bU,202752
+tlkcore-255.255.255.dist-info/LICENSE.txt,sha256=6_K8eSrAQ-FGMhnjUnh9X_ZtghXE8DOa6TJNaYACAIE,448
+tlkcore-255.255.255.dist-info/METADATA,sha256=XIDgXs_sDdt4zyvQnBZ7ykuA_NkGGPThQC9UP76AZK4,4406
+tlkcore-255.255.255.dist-info/WHEEL,sha256=od_9EmQVrRx-JFmipR6J48h0F4WT4MdLLqLKdbBMHiM,99
+tlkcore-255.255.255.dist-info/top_level.txt,sha256=a5TMUMf1qbFol7Px5jWhx6ZvMZke2kKrwYbrUCjcOQ4,8
+tlkcore-255.255.255.dist-info/RECORD,,

tlkcore-255.255.255.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.45.1)
+Root-Is-Purelib: true
+Tag: cp38-none-win_amd64
+

tlkcore-255.255.255.dist-info/top_level.txt

@@ -0,0 +1 @@
+tlkcore