benchlab-pycore 0.1.0__tar.gz

benchlab_pycore-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2025 BENCHLAB
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

benchlab_pycore-0.1.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: benchlab-pycore
+Version: 0.1.0
+Summary: BENCHLAB PyCore - Python Interface for BENCHLAB
+Home-page: https://github.com/BenchLab-io/benchlab-pycore
+Author: Pieter Plaisier
+Author-email: Pieter Plaisier <contact@benchlab.io>
+License: MIT
+Project-URL: Homepage, https://github.com/BenchLab-io/benchlab-pycore
+Project-URL: Issues, https://github.com/BenchLab-io/benchlab-pycore/issues
+Keywords: telemetry,hardware,benchlab,sensors
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyserial>=3.5
+Dynamic: license-file
+
+# BENCHLAB Python Core (`benchlab-pycore`)
+
+**BENCHLAB PyCore** provides low-level telemetry, sensor IO, and device communication utilities
+for BENCHLAB. It includes standardized interfaces for reading sensors, handling serial communication, and publishing telemetry data.
+
+## Features
+
+- Read and translate sensor data from BENCHLAB devices  
+- Communicate via serial ports  
+- Designed to be easily integrated into larger telemetry pipelines
+
+## Installation
+
+pip install benchlab-pycore
+
+## Usage Example
+
+import benchlab
+from benchlab.core import get_fleet_info, read_sensors
+
+info = get_fleet_info()
+print(info)
+
+## Project Layout
+
+benchlab/
+├── core/
+│ ├── serial_io.py
+│ ├── sensor_translation.py
+│ └── ...
+
+## Development
+
+Clone and install locally:
+
+git clone https://github.com/BenchLab-io/benchlab-pycore.git
+cd benchlab-pycore
+pip install -e .
+
+## License
+
+MIT License © 2025 BenchLab Contributors

benchlab_pycore-0.1.0/README.md

@@ -0,0 +1,42 @@
+# BENCHLAB Python Core (`benchlab-pycore`)
+
+**BENCHLAB PyCore** provides low-level telemetry, sensor IO, and device communication utilities
+for BENCHLAB. It includes standardized interfaces for reading sensors, handling serial communication, and publishing telemetry data.
+
+## Features
+
+- Read and translate sensor data from BENCHLAB devices  
+- Communicate via serial ports  
+- Designed to be easily integrated into larger telemetry pipelines
+
+## Installation
+
+pip install benchlab-pycore
+
+## Usage Example
+
+import benchlab
+from benchlab.core import get_fleet_info, read_sensors
+
+info = get_fleet_info()
+print(info)
+
+## Project Layout
+
+benchlab/
+├── core/
+│ ├── serial_io.py
+│ ├── sensor_translation.py
+│ └── ...
+
+## Development
+
+Clone and install locally:
+
+git clone https://github.com/BenchLab-io/benchlab-pycore.git
+cd benchlab-pycore
+pip install -e .
+
+## License
+
+MIT License © 2025 BenchLab Contributors

benchlab_pycore-0.1.0/benchlab/__init__.py

@@ -0,0 +1,12 @@
+# benchlab/__init__.py
+
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("benchlab-pycore")
+except PackageNotFoundError:
+    __version__ = "0.0.0-dev"
+
+from . import core
+
+__all__ = ["core", "__version__"]

benchlab_pycore-0.1.0/benchlab/core/__init__.py

@@ -0,0 +1,53 @@
+# benchlab/core/__init__.py
+
+from .serial_io import (
+    get_benchlab_ports,
+    find_benchlab_devices,
+    get_fleet_info,
+    read_uart,
+    read_device,
+    read_sensors,
+    read_uid,
+)
+from .sensor_translation import translate_sensor_struct
+from .structures import (
+    VendorDataStruct,
+    PowerSensor,
+    FanSensor,
+    SensorStruct,
+    BENCHLAB_CMD,
+    BENCHLAB_VENDOR_ID,
+    BENCHLAB_PRODUCT_ID,
+    BENCHLAB_FIRMWARE_VERSION,
+    SENSOR_VIN_NUM,
+    SENSOR_POWER_NUM,
+    FAN_NUM,
+)
+from .utils import format_temp
+
+__all__ = [
+    # serial_io"
+    "get_benchlab_ports",
+    "find_benchlab_devices",
+    "get_fleet_info",
+    "read_uart",
+    "read_device",
+    "read_sensors",
+    "read_uid",
+    # sensor_translation
+    "translate_sensor_struct",
+    # structures
+    "VendorDataStruct",
+    "PowerSensor",
+    "FanSensor",
+    "SensorStruct",
+    "BENCHLAB_CMD",
+    "BENCHLAB_VENDOR_ID",
+    "BENCHLAB_PRODUCT_ID",
+    "BENCHLAB_FIRMWARE_VERSION",
+    "SENSOR_VIN_NUM",
+    "SENSOR_POWER_NUM",
+    "FAN_NUM",
+    # utils
+    "format_temp",
+]

benchlab_pycore-0.1.0/benchlab/core/sensor_translation.py

@@ -0,0 +1,68 @@
+# benchlab/core/sensor_translation.py
+
+from .structures import SENSOR_VIN_NUM
+from .utils import format_temp
+
+
+def translate_sensor_struct(sensor_struct):
+    """Return a flat dict of interpreted sensor values
+        suitable for CSV, graphs, MQTT, etc."""
+    data = {}
+
+    # Power
+    power = sensor_struct.PowerReadings
+    power_cpu = (power[0].Power + power[1].Power) / 1000
+    power_gpu = sum([power[i].Power for i in range(6, 11)]) / 1000
+    power_mb = sum([power[i].Power for i in range(2, 6)]) / 1000
+    power_system = power_cpu + power_gpu + power_mb
+    data.update({
+        "SYS_Power": power_system,
+        "CPU_Power": power_cpu,
+        "GPU_Power": power_gpu,
+        "MB_Power": power_mb,
+    })
+
+    # EPS, ATX, PCIe
+    eps_labels = ["EPS1", "EPS2"]
+    atx_labels = ["12V", "5V", "5VSB", "3.3V"]
+    pcie_labels = ["PCIE8_1", "PCIE8_2", "PCIE8_3", "HPWR1", "HPWR2"]
+
+    for i, label in enumerate(eps_labels):
+        data[f"{label}_Voltage"] = power[i].Voltage / 1000
+        data[f"{label}_Current"] = power[i].Current / 1000
+        data[f"{label}_Power"] = power[i].Power / 1000
+
+    for i, label in enumerate(atx_labels):
+        idx = [5, 3, 4, 2][i]
+        data[f"{label}_Voltage"] = power[idx].Voltage / 1000
+        data[f"{label}_Current"] = power[idx].Current / 1000
+        data[f"{label}_Power"] = power[idx].Power / 1000
+
+    for i, label in enumerate(pcie_labels):
+        idx = 6 + i
+        data[f"{label}_Voltage"] = power[idx].Voltage / 1000
+        data[f"{label}_Current"] = power[idx].Current / 1000
+        data[f"{label}_Power"] = power[idx].Power / 1000
+
+    # Voltage
+    vin_names = [f"VIN_{i}" for i in range(SENSOR_VIN_NUM)]
+    for name, value in zip(vin_names, sensor_struct.Vin):
+        data[name] = value / 1000
+    data["Vdd"] = sensor_struct.Vdd / 1000
+    data["Vref"] = sensor_struct.Vref / 1000
+
+    # Temperature
+    data["Chip_Temp"] = format_temp(sensor_struct.Tchip)
+    data["Ambient_Temp"] = format_temp(sensor_struct.Tamb)
+    data["Humidity"] = sensor_struct.Hum / 10
+    for i, t in enumerate(sensor_struct.Ts):
+        data[f"Temp_Sensor_{i+1}"] = format_temp(t)
+
+    # Fans
+    for i, f in enumerate(sensor_struct.Fans):
+        data[f"Fan{i+1}_Duty"] = f.Duty
+        data[f"Fan{i+1}_RPM"] = f.Tach
+        data[f"Fan{i+1}_Status"] = f.Enable
+    data["FanExtDuty"] = sensor_struct.FanExtDuty
+
+    return data

benchlab_pycore-0.1.0/benchlab/core/serial_io.py

@@ -0,0 +1,170 @@
+"""
+Serial communication helpers for BENCHLAB devices
+"""
+
+import os
+import sys
+import time
+import logging
+import serial
+import serial.tools.list_ports
+from ctypes import sizeof
+from benchlab.core.structures import (
+    VendorDataStruct,
+    SensorStruct,
+    BENCHLAB_CMD,
+)
+
+# --- Logger setup ---
+LOG_LEVEL = os.getenv("LOG_LEVEL", "INFO").upper()
+logger = logging.getLogger("mqtt_bridge.serial_io")
+logger.setLevel(getattr(logging, LOG_LEVEL, logging.INFO))
+
+if not logger.handlers:
+    handler = logging.StreamHandler(sys.stdout)
+    formatter = logging.Formatter("%(asctime)s [%(levelname)s] %(message)s")
+    handler.setFormatter(formatter)
+    logger.addHandler(handler)
+
+
+# --- Serial port helpers ---
+def get_benchlab_ports():
+    """Return all Benchlab COM ports without opening them."""
+    ports = serial.tools.list_ports.comports()
+    benchlab_ports = []
+    for p in ports:
+        hwid = p.hwid.upper()
+        if "VID:PID=0483:5740" in hwid:
+            benchlab_ports.append({"port": p.device})
+    return benchlab_ports
+
+
+def find_benchlab_devices():
+    """Scan and return all connected BENCHLAB devices."""
+    devices = []
+    for port, desc, hwid in serial.tools.list_ports.comports():
+        if hwid.startswith("USB VID:PID=0483:5740"):
+            try:
+                ser = serial.Serial(port, baudrate=115200, timeout=1)
+                ser.write(b"i\n")
+                uid = ser.readline().decode(errors="ignore").strip()
+                fw = ser.readline().decode(errors="ignore").strip()
+                ser.close()
+                logger.info("Found device on %s: UID=%s, FW=%s", port, uid, fw)
+            except Exception as e:
+                uid, fw = "?", "?"
+                logger.warning("Failed to read device on %s: %s", port, e)
+            devices.append({"port": port, "uid": uid, "fw": fw})
+    return devices
+
+
+def get_fleet_info():
+    """Return a list of all BENCHLAB devices with UID and firmware info."""
+    fleet = []
+    benchlab_ports = [p["port"] for p in get_benchlab_ports()]
+
+    for port in benchlab_ports:
+        try:
+            ser = serial.Serial(port, 115200, timeout=1)
+            device_info = read_device(ser)
+            uid = read_uid(ser)
+            fleet.append(
+                {
+                    "port": port,
+                    "firmware": (
+                        device_info.get("FwVersion") if device_info else "?"
+                    ),
+                    "uid": uid,
+                }
+            )
+            ser.close()
+            logger.debug("Added device to fleet: %s", uid)
+        except Exception as e:
+            logger.warning("Failed to get device info from %s: %s", port, e)
+    return fleet
+
+
+def open_serial_connection(port=None):
+    """Open and return a serial connection to the given port."""
+    if not port:
+        return None
+    try:
+        ser = serial.Serial(port, baudrate=115200, timeout=1)
+        logger.info("Opened serial port %s", port)
+        return ser
+    except serial.SerialException as e:
+        logger.error("Could not open port %s: %s", port, e)
+        return None
+
+
+# --- UART helpers ---
+def read_uart(ser, cmd, size):
+    """Send a command and read bytes from the device."""
+    ser.write(cmd.toByte())
+    buffer = ser.read(size)
+    if len(buffer) != size:
+        logger.warning(
+            "UART read incomplete: expected %d, got %d bytes",
+            size,
+            len(buffer)
+        )
+        return None
+    return buffer
+
+
+def read_device(ser):
+    """Read vendor info from the device."""
+    try:
+        buffer = read_uart(
+            ser,
+            BENCHLAB_CMD.UART_CMD_READ_VENDOR_DATA,
+            sizeof(VendorDataStruct)
+        )
+        if buffer is None:
+            logger.warning("Failed to read vendor data from device")
+            return None
+        vendor_struct = VendorDataStruct.from_buffer_copy(buffer)
+        return {
+            "VendorId": vendor_struct.VendorId,
+            "ProductId": vendor_struct.ProductId,
+            "FwVersion": vendor_struct.FwVersion,
+        }
+    except (serial.SerialException, OSError, ValueError) as e:
+        logger.warning("Failed to read device: %s", e)
+        return None
+
+
+def read_sensors(ser):
+    """Read all sensors from the device."""
+    buffer = read_uart(
+        ser,
+        BENCHLAB_CMD.UART_CMD_READ_SENSORS,
+        sizeof(SensorStruct)
+    )
+    if buffer is None:
+        logger.warning("Failed to read sensors from device")
+        return None
+    return SensorStruct.from_buffer_copy(buffer)
+
+
+def read_uid(ser, retries=3, delay=0.2):
+    """Read UID from device with optional retries."""
+    for attempt in range(1, retries + 1):
+        buffer = read_uart(
+            ser,
+            BENCHLAB_CMD.UART_CMD_READ_UID,
+            12
+        )
+        if buffer:
+            uid_hex = buffer.hex().upper()
+            logger.debug("Raw UID bytes: %s", buffer)
+            logger.debug("UID read: %s", uid_hex)
+            return uid_hex
+        else:
+            logger.warning(
+                "Attempt %d: Failed to read UID from device",
+                attempt
+            )
+            time.sleep(delay)
+    logger.error("Failed to read UID after %d attempts", retries)
+    return None

benchlab_pycore-0.1.0/benchlab/core/structures.py

@@ -0,0 +1,79 @@
+"""
+Core structures, enums, and constants for BENCHLAB
+"""
+
+from ctypes import Structure, c_uint8, c_uint16, c_int16, c_int32
+from enum import IntEnum
+
+# --- BENCHLAB Constants ---
+BENCHLAB_VENDOR_ID = 0xEE
+BENCHLAB_PRODUCT_ID = 0x10
+BENCHLAB_FIRMWARE_VERSION = 0x01
+SENSOR_VIN_NUM = 13
+SENSOR_POWER_NUM = 11
+FAN_NUM = 9
+
+
+# --- Structures ---
+class VendorDataStruct(Structure):
+    _fields_ = [
+        ('VendorId', c_uint8),
+        ('ProductId', c_uint8),
+        ('FwVersion', c_uint8),
+    ]
+
+
+class PowerSensor(Structure):
+    _fields_ = [
+        ('Voltage', c_int16),
+        ('Current', c_int32),
+        ('Power', c_int32),
+    ]
+
+
+class FanSensor(Structure):
+    _fields_ = [
+        ('Enable', c_uint8),
+        ('Duty', c_uint8),
+        ('Tach', c_uint16),
+    ]
+
+
+class SensorStruct(Structure):
+    _fields_ = [
+        ('Vin', c_int16 * SENSOR_VIN_NUM),
+        ('Vdd', c_uint16),
+        ('Vref', c_uint16),
+        ('Tchip', c_int16),
+        ('Ts', c_int16 * 4),
+        ('Tamb', c_int16),
+        ('Hum', c_int16),
+        ('FanSwitchStatus', c_uint8),
+        ('RGBSwitchStatus', c_uint8),
+        ('RGBExtStatus', c_uint8),
+        ('FanExtDuty', c_uint8),
+        ('PowerReadings', PowerSensor * SENSOR_POWER_NUM),
+        ('Fans', FanSensor * FAN_NUM),
+    ]
+
+
+# --- Enums ---
+class BENCHLAB_CMD(IntEnum):
+    UART_CMD_WELCOME = 0
+    UART_CMD_READ_SENSORS = 1
+    UART_CMD_ACTION = 2
+    UART_CMD_READ_NAME = 3
+    UART_CMD_WRITE_NAME = 4
+    UART_CMD_READ_FAN_PROFILE = 5
+    UART_CMD_WRITE_FAN_PROFILE = 6
+    UART_CMD_READ_RGB = 7
+    UART_CMD_WRITE_RGB = 8
+    UART_CMD_READ_CALIBRATION = 9
+    UART_CMD_WRITE_CALIBRATION = 10
+    UART_CMD_LOAD_CALIBRATION = 11
+    UART_CMD_STORE_CALIBRATION = 12
+    UART_CMD_READ_UID = 13
+    UART_CMD_READ_VENDOR_DATA = 14
+
+    def toByte(self):
+        return self.value.to_bytes(1, 'little')

benchlab_pycore-0.1.0/benchlab/core/utils.py

@@ -0,0 +1,10 @@
+"""
+Utility helpers for BENCHLAB
+"""
+
+
+def format_temp(value):
+    temp_c = value / 10
+    if temp_c > 1000 or temp_c < -1000:
+        return None
+    return round(temp_c, 1)

benchlab_pycore-0.1.0/benchlab_pycore.egg-info/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: benchlab-pycore
+Version: 0.1.0
+Summary: BENCHLAB PyCore - Python Interface for BENCHLAB
+Home-page: https://github.com/BenchLab-io/benchlab-pycore
+Author: Pieter Plaisier
+Author-email: Pieter Plaisier <contact@benchlab.io>
+License: MIT
+Project-URL: Homepage, https://github.com/BenchLab-io/benchlab-pycore
+Project-URL: Issues, https://github.com/BenchLab-io/benchlab-pycore/issues
+Keywords: telemetry,hardware,benchlab,sensors
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyserial>=3.5
+Dynamic: license-file
+
+# BENCHLAB Python Core (`benchlab-pycore`)
+
+**BENCHLAB PyCore** provides low-level telemetry, sensor IO, and device communication utilities
+for BENCHLAB. It includes standardized interfaces for reading sensors, handling serial communication, and publishing telemetry data.
+
+## Features
+
+- Read and translate sensor data from BENCHLAB devices  
+- Communicate via serial ports  
+- Designed to be easily integrated into larger telemetry pipelines
+
+## Installation
+
+pip install benchlab-pycore
+
+## Usage Example
+
+import benchlab
+from benchlab.core import get_fleet_info, read_sensors
+
+info = get_fleet_info()
+print(info)
+
+## Project Layout
+
+benchlab/
+├── core/
+│ ├── serial_io.py
+│ ├── sensor_translation.py
+│ └── ...
+
+## Development
+
+Clone and install locally:
+
+git clone https://github.com/BenchLab-io/benchlab-pycore.git
+cd benchlab-pycore
+pip install -e .
+
+## License
+
+MIT License © 2025 BenchLab Contributors

benchlab_pycore-0.1.0/benchlab_pycore.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+LICENSE
+README.md
+pyproject.toml
+setup.cfg
+benchlab/__init__.py
+benchlab/version.py
+benchlab/core/__init__.py
+benchlab/core/sensor_translation.py
+benchlab/core/serial_io.py
+benchlab/core/structures.py
+benchlab/core/utils.py
+benchlab_pycore.egg-info/PKG-INFO
+benchlab_pycore.egg-info/SOURCES.txt
+benchlab_pycore.egg-info/dependency_links.txt
+benchlab_pycore.egg-info/requires.txt
+benchlab_pycore.egg-info/top_level.txt
+tests/__init__.py
+tests/test_core.py

benchlab_pycore-0.1.0/benchlab_pycore.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

benchlab_pycore-0.1.0/benchlab_pycore.egg-info/requires.txt

@@ -0,0 +1 @@
+pyserial>=3.5

benchlab_pycore-0.1.0/benchlab_pycore.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+benchlab
+tests

benchlab_pycore-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+# 👇 The name people install from PyPI
+name = "benchlab-pycore"
+version = "0.1.0"
+description = "BENCHLAB PyCore - Python Interface for BENCHLAB"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+  {name = "Pieter Plaisier", email = "contact@benchlab.io"}
+]
+keywords = ["telemetry", "hardware", "benchlab", "sensors"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent"
+]
+dependencies = [
+  "pyserial >= 3.5"
+]
+
+[project.urls]
+Homepage = "https://github.com/BenchLab-io/benchlab-pycore"
+Issues = "https://github.com/BenchLab-io/benchlab-pycore/issues"

benchlab_pycore-0.1.0/setup.cfg

@@ -0,0 +1,36 @@
+[metadata]
+name = benchlab-pycore
+version = 0.1.0
+author = Pieter Plaisier
+author_email = contact@benchlab.io
+description = BENCHLAB PyCore - Python Interface for BENCHLAB
+long_description = file: README.md
+long_description_content_type = text/markdown
+license = MIT
+url = https://github.com/BenchLab-io/benchlab-pycore
+project_urls = 
+	Bug Tracker = https://github.com/BenchLab-io/benchlab-pycore/issues
+classifiers = 
+	Programming Language :: Python :: 3
+	License :: OSI Approved :: MIT License
+	Operating System :: OS Independent
+
+[options]
+packages = find:
+python_requires = >=3.8
+install_requires = 
+	pyserial
+
+[options.package_data]
+* = *.md, *.txt
+
+[options.extras_require]
+dev = 
+	build
+	twine
+	pytest
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

benchlab_pycore-0.1.0/tests/__init__.py

@@ -0,0 +1,2 @@
+# tests/__init__.py
+# (Empty — required to make tests a package)

benchlab_pycore-0.1.0/tests/test_core.py

@@ -0,0 +1,116 @@
+# tests/test_core.py
+
+import pytest
+from ctypes import Structure, sizeof
+from unittest.mock import patch, MagicMock
+
+from benchlab.core import (
+    get_benchlab_ports,
+    find_benchlab_devices,
+    get_fleet_info,
+    read_uart,
+    read_device,
+    read_sensors,
+    read_uid,
+    translate_sensor_struct,
+    format_temp,
+    VendorDataStruct,
+    PowerSensor,
+    FanSensor,
+    SensorStruct,
+    BENCHLAB_CMD,
+    SENSOR_VIN_NUM
+)
+
+# -----------------------
+# Test core imports
+# -----------------------
+def test_imports():
+    """Ensure all core functions and classes exist and structures are correct."""
+    # functions
+    assert callable(get_benchlab_ports)
+    assert callable(find_benchlab_devices)
+    assert callable(get_fleet_info)
+    assert callable(read_sensors)
+    assert callable(read_uid)
+    assert callable(read_device)
+    assert callable(translate_sensor_struct)
+    
+    # ctypes structures
+    assert isinstance(VendorDataStruct(), Structure)
+    assert isinstance(PowerSensor(), Structure)
+    assert isinstance(FanSensor(), Structure)
+    assert isinstance(SensorStruct(), Structure)
+
+
+# -----------------------
+# Test mocked serial functions
+# -----------------------
+@patch("benchlab.core.serial_io.read_uart")
+def test_mocked_functions(mock_read_uart):
+    """Test core functions using mocks (no hardware needed)."""
+    
+    # Mock read_uart for read_uid
+    mock_read_uart.return_value = bytes(range(12))
+    uid = read_uid(MagicMock())
+    assert uid == bytes(range(12)).hex().upper()
+    
+    # Mock read_uart for read_device
+    mock_read_uart.return_value = bytes([0xEE, 0x10, 0x01])
+    dev_info = read_device(MagicMock())
+    assert dev_info == {
+        "VendorId": 0xEE,
+        "ProductId": 0x10,
+        "FwVersion": 0x01,
+    }
+    
+    # Mock read_uart for read_sensors
+    mock_read_uart.return_value = bytes([0] * sizeof(SensorStruct))
+    sensors = read_sensors(MagicMock())
+    assert isinstance(sensors, SensorStruct)
+
+
+# -----------------------
+# Test translate_sensor_struct
+# -----------------------
+def test_sensor_translation():
+    """Test translate_sensor_struct with a sample SensorStruct."""
+    s = SensorStruct()
+    # Fill sample values
+    for i in range(SENSOR_VIN_NUM):
+        s.Vin[i] = i * 10
+    s.Vdd = 3300
+    s.Tchip = 42
+
+    translated = translate_sensor_struct(s)
+    
+    # Check keys exist and values are reasonable
+    # Adapt these depending on how translate_sensor_struct formats keys
+    assert isinstance(translated, dict)
+    # Example keys
+    assert "12V_Voltage" in translated
+    assert translated["12V_Voltage"] == 0.0
+    assert "3.3V_Current" in translated
+    assert translated["3.3V_Current"] == 0.0
+
+
+# -----------------------
+# Test format_temp
+# -----------------------
+def test_format_temp():
+    """Test format_temp utility."""
+    val = 0
+    formatted = format_temp(val)
+    assert isinstance(formatted, float)
+    assert formatted == 0.0
+
+    val = 255
+    formatted = format_temp(val)
+    assert isinstance(formatted, float)
+    assert formatted == 25.5
+
+    val = -42
+    formatted = format_temp(val)
+    assert isinstance(formatted, float)
+    assert formatted == -4.2
+