trcc-linux 9.2.3__tar.gz → 9.2.5__tar.gz

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trcc-linux
-Version: 9.2.3
+Version: 9.2.5
 Summary: Linux implementation of Thermalright LCD Control Center
 Project-URL: Homepage, https://github.com/Lexonight1/thermalright-trcc-linux
 Project-URL: Documentation, https://github.com/Lexonight1/thermalright-trcc-linux#readme
@@ -22,7 +22,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: System :: Hardware
 Classifier: Topic :: System :: Monitoring
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Requires-Dist: click>=7.0
 Requires-Dist: fastapi>=0.100
 Requires-Dist: numpy>=1.24.0
@@ -360,7 +360,7 @@ src/trcc/
 ├── core/           # Models, enums, domain constants — zero I/O
 ├── services/       # Business logic — pure Python, no framework deps
 ├── adapters/       # USB device protocols (SCSI, HID, Bulk, LY, LED)
-├── qt_components/  # PySide6 GUI (themes, video, overlay, LED, sensors)
+├── gui/  # PySide6 GUI (themes, video, overlay, LED, sensors)
 ├── cli/            # Typer CLI — 50 commands across 8 modules
 ├── api/            # FastAPI REST API — 53 endpoints across 7 modules
 ├── conf.py         # Settings singleton

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/README.md

@@ -294,7 +294,7 @@ src/trcc/
 ├── core/           # Models, enums, domain constants — zero I/O
 ├── services/       # Business logic — pure Python, no framework deps
 ├── adapters/       # USB device protocols (SCSI, HID, Bulk, LY, LED)
-├── qt_components/  # PySide6 GUI (themes, video, overlay, LED, sensors)
+├── gui/  # PySide6 GUI (themes, video, overlay, LED, sensors)
 ├── cli/            # Typer CLI — 50 commands across 8 modules
 ├── api/            # FastAPI REST API — 53 endpoints across 7 modules
 ├── conf.py         # Settings singleton

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "hatchling.build"
 
 [project]
 name = "trcc-linux"
-version = "9.2.3"
+version = "9.2.5"
 description = "Linux implementation of Thermalright LCD Control Center"
 readme = "README.md"
 license = "GPL-3.0-or-later"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 authors = [
     { name = "TRCC Linux Contributors" }
 ]
@@ -134,7 +134,7 @@ filterwarnings = [
 
 [tool.ruff]
 line-length = 100
-target-version = "py39"
+target-version = "py310"
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I"]
@@ -157,7 +157,7 @@ exclude_lines = [
 ]
 
 [tool.pyright]
-pythonVersion = "3.9"
+pythonVersion = "3.10"
 pythonPlatform = "Linux"
 include = ["src"]
 typeCheckingMode = "basic"

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/__version__.py

@@ -1,4 +1,4 @@
 """TRCC Linux version information. History in doc/CHANGELOG.md."""
 
-__version__ = "9.2.3"
+__version__ = "9.2.5"
 __version_info__ = tuple(int(x) for x in __version__.split("."))

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/adapters/device/scsi.py

@@ -77,7 +77,7 @@ class ScsiDevice(FrameDevice):
     # Track which devices have been initialized (poll + init sent)
     _initialized_devices: Set[str] = set()
 
-    def __init__(self, device_path: str, width: int = 320, height: int = 320):
+    def __init__(self, device_path: str, width: int = 0, height: int = 0):
         self.device_path = device_path
         self.width = width
         self.height = height
@@ -218,7 +218,7 @@ class ScsiDevice(FrameDevice):
         return fbl, response[:64]
 
     @staticmethod
-    def _send_frame(dev: str, rgb565_data: bytes, width: int = 320, height: int = 320):
+    def _send_frame(dev: str, rgb565_data: bytes, width: int, height: int):
         """Send one RGB565 frame in SCSI chunks sized for the resolution."""
         chunks = ScsiDevice._get_frame_chunks(width, height)
         total_size = sum(size for _, size in chunks)

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/adapters/infra/data_repository.py

@@ -398,14 +398,39 @@ class DataManager:
         )
 
     @staticmethod
-    def ensure_all(width: int, height: int) -> None:
-        """Download + extract all archives for a resolution (skips if already done)."""
+    def ensure_all(
+        width: int,
+        height: int,
+        progress_fn: Optional[callable] = None,  # type: ignore[type-arg]
+    ) -> None:
+        """Download + extract all archives for a resolution (skips if already done).
+
+        progress_fn: optional callable(str) — called with a status message at
+        each step so CLI adapters can print progress.  GUI/API pass None.
+        """
         if DataManager.is_resolution_installed(width, height):
             return
+
+        def _report(msg: str) -> None:
+            if progress_fn is not None:
+                progress_fn(msg)
+            else:
+                log.info(msg)
+
+        _report(f"Downloading themes for {width}x{height}...")
         DataManager.ensure_themes(width, height)
+        _report(f"Downloading web previews for {width}x{height}...")
         DataManager.ensure_web(width, height)
+        _report(f"Downloading mask themes for {width}x{height}...")
         DataManager.ensure_web_masks(width, height)
+        if width != height:
+            # Non-square devices support portrait/landscape rotation — ensure both
+            _report(f"Downloading web previews for {height}x{width}...")
+            DataManager.ensure_web(height, width)
+            _report(f"Downloading mask themes for {height}x{width}...")
+            DataManager.ensure_web_masks(height, width)
         DataManager.mark_resolution_installed(width, height)
+        _report(f"Data ready for {width}x{height}.")
 
     # ------------------------------------------------------------------
     # Resolution installation tracking

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/adapters/infra/dc_config.py

@@ -62,8 +62,8 @@ class DcConfig:
         self.overlay_enabled: bool = True
         self.overlay_x: int = 0
         self.overlay_y: int = 0
-        self.overlay_w: int = 320
-        self.overlay_h: int = 320
+        self.overlay_w: int = 0
+        self.overlay_h: int = 0
 
         # Mask
         self.mask_enabled: bool = False
@@ -151,7 +151,7 @@ class DcConfig:
 
     # ── Overlay conversion ──
 
-    def to_overlay_config(self, width: int = 320, height: int = 320) -> dict:
+    def to_overlay_config(self) -> dict:
         """Convert to overlay renderer config dict."""
         parsed = {
             'elements': self.legacy_elements,
@@ -159,7 +159,7 @@ class DcConfig:
             'custom_text': self.custom_text,
             'flags': self.flags,
         }
-        return DcParser.to_overlay_config(parsed, width, height)
+        return DcParser.to_overlay_config(parsed)
 
     @classmethod
     def from_overlay_config(cls, overlay_config: dict,

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/adapters/infra/dc_parser.py

@@ -8,6 +8,7 @@ Based on decompiled Windows TRCC code:
 - FormCZTV.cs - Config file read/write
 """
 
+import logging
 import struct
 from pathlib import Path
 from typing import List, Optional, Tuple
@@ -23,6 +24,8 @@ from trcc.core.models import (
 
 from .binary_reader import BinaryReader
 
+log = logging.getLogger(__name__)
+
 
 class DcParser:
     """Parser for TRCC config1.dc binary configuration files."""
@@ -51,6 +54,7 @@ class DcParser:
 
         Based on C# BinaryReader pattern from FormCZTV.ReadSystemConfiguration.
         """
+        log.debug("parse: filepath=%s", filepath)
         with open(filepath, 'rb') as f:
             data = f.read()
 
@@ -445,7 +449,7 @@ class DcParser:
         return elements
 
     @staticmethod
-    def to_overlay_config(dc_config: dict, display_width: int = 320, display_height: int = 320) -> dict:
+    def to_overlay_config(dc_config: dict) -> dict:
         """Convert parsed .dc config to overlay renderer config format."""
         elements = dc_config.get('elements', {})
         display_elements = dc_config.get('display_elements', [])
@@ -571,6 +575,7 @@ class DcParser:
     @staticmethod
     def load_json(filepath: str) -> Optional[Tuple[dict, dict]]:
         """Load theme config from a JSON file (config.json)."""
+        log.debug("load_json: filepath=%s", filepath)
         import json
 
         try:
@@ -629,7 +634,7 @@ class DcParser:
         return sorted(str(dc_file) for dc_file in base.rglob('config1.dc'))
 
     @staticmethod
-    def validate_theme(theme_path: str, display_width: int = 320, display_height: int = 320) -> dict:
+    def validate_theme(theme_path: str, display_width: int | None = None, display_height: int | None = None) -> dict:
         """Validate a theme's config and return any issues found."""
         import os
 
@@ -668,17 +673,18 @@ class DcParser:
                     result['issues'].append('Time in config but not in display_elements (0xDD bug)')
                     result['valid'] = False
 
-            for key, cfg in overlay.items():
-                x, y = cfg.get('x', 0), cfg.get('y', 0)
-                if x < 0 or x > display_width or y < 0 or y > display_height:
-                    result['warnings'].append(
-                        f'{key}: position ({x}, {y}) outside {display_width}x{display_height}')
-
-            mask = parsed.get('mask_settings', {})
-            if mask.get('mask_enabled'):
-                pos = mask.get('mask_position', (0, 0))
-                if pos[0] < 0 or pos[0] > display_width or pos[1] < 0 or pos[1] > display_height:
-                    result['warnings'].append(f'Mask position {pos} may be outside bounds')
+            if display_width is not None and display_height is not None:
+                for key, cfg in overlay.items():
+                    x, y = cfg.get('x', 0), cfg.get('y', 0)
+                    if x < 0 or x > display_width or y < 0 or y > display_height:
+                        result['warnings'].append(
+                            f'{key}: position ({x}, {y}) outside {display_width}x{display_height}')
+
+                mask = parsed.get('mask_settings', {})
+                if mask.get('mask_enabled'):
+                    pos = mask.get('mask_position', (0, 0))
+                    if pos[0] < 0 or pos[0] > display_width or pos[1] < 0 or pos[1] > display_height:
+                        result['warnings'].append(f'Mask position {pos} may be outside bounds')
 
             mask_file = os.path.join(theme_path, '01.png')
             bg_file = os.path.join(theme_path, '00.png')

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/adapters/infra/dc_writer.py

@@ -44,6 +44,7 @@ Export Format (.tr files):
     Followed by embedded binary data for images
 """
 
+import logging
 import os
 import struct
 from pathlib import Path
@@ -59,11 +60,14 @@ from trcc.core.models import (
 
 from .binary_reader import BinaryReader
 
+log = logging.getLogger(__name__)
+
 # ── Core binary writing ──────────────────────────────────────────────────
 
 
 def write(config: ThemeConfig, filepath: str) -> None:
     """Write a config1.dc file in Windows-compatible binary format."""
+    log.debug("write: filepath=%s elements=%d", filepath, len(config.elements))
     with open(filepath, 'wb') as f:
         f.write(struct.pack('B', 0xDD))
         f.write(struct.pack('?', config.system_info_enabled))
@@ -79,6 +83,7 @@ def write_tr(config: ThemeConfig, theme_path: str, export_path: str) -> None:
     The .tr format is a config1.dc with magic header 0xDD,0xDC,0xDD,0xDC
     followed by embedded image data.
     """
+    log.debug("write_tr: theme_path=%s export_path=%s", theme_path, export_path)
     with open(export_path, 'wb') as f:
         f.write(struct.pack('BBBB', 0xDD, 0xDC, 0xDD, 0xDC))
         f.write(struct.pack('?', config.system_info_enabled))
@@ -277,6 +282,7 @@ def save_theme(theme_path: str,
 
     Creates: 00.png, 01.png (mask), config1.dc, Theme.png (preview), config.json.
     """
+    log.debug("save_theme: theme_path=%s display=%dx%d", theme_path, display_width, display_height)
     os.makedirs(theme_path, exist_ok=True)
 
     if background_image:
@@ -399,6 +405,7 @@ def write_json(theme_path: str,
 
 def export_theme(theme_path: str, export_path: str) -> None:
     """Export a theme as a .tr file for sharing."""
+    log.debug("export_theme: theme_path=%s export_path=%s", theme_path, export_path)
     from .dc_parser import DcParser
 
     config_file = os.path.join(theme_path, "config1.dc")
@@ -442,6 +449,7 @@ def _parsed_to_theme_config(parsed: dict) -> ThemeConfig:
 
 def import_theme(tr_path: str, theme_path: str) -> None:
     """Import a .tr file to create a theme directory."""
+    log.debug("import_theme: tr_path=%s theme_path=%s", tr_path, theme_path)
     os.makedirs(theme_path, exist_ok=True)
 
     with open(tr_path, 'rb') as f:

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/adapters/infra/diagnostics.py

@@ -1469,8 +1469,9 @@ class DebugReport:
             hid_devs  = [d for d in self._detected_devices if d.protocol == "hid"]
             bulk_devs = [d for d in self._detected_devices if d.protocol == "bulk"]
             ly_devs   = [d for d in self._detected_devices if d.protocol == "ly"]
+            led_devs  = [d for d in self._detected_devices if d.protocol == "led"]
 
-            if not any([scsi_devs, hid_devs, bulk_devs, ly_devs]):
+            if not any([scsi_devs, hid_devs, bulk_devs, ly_devs, led_devs]):
                 sec.lines.append("  (no devices to handshake)")
                 return
 
@@ -1482,14 +1483,17 @@ class DebugReport:
                     sec.lines.append(f"    FAILED: {e}")
 
             for dev in hid_devs:
-                is_led = dev.implementation == "hid_led"
-                kind = "LED" if is_led else f"HID-LCD (Type {dev.device_type})"
+                kind = f"HID-LCD (Type {dev.device_type})"
                 sec.lines.append(f"\n  {dev.vid:04x}:{dev.pid:04x} — {kind}")
                 try:
-                    if is_led:
-                        self._handshake_led(dev, sec)
-                    else:
-                        self._handshake_hid_lcd(dev, sec)
+                    self._handshake_hid_lcd(dev, sec)
+                except Exception as e:
+                    sec.lines.append(f"    FAILED: {e}")
+
+            for dev in led_devs:
+                sec.lines.append(f"\n  {dev.vid:04x}:{dev.pid:04x} — LED")
+                try:
+                    self._handshake_led(dev, sec)
                 except Exception as e:
                     sec.lines.append(f"    FAILED: {e}")
 

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/adapters/infra/media_player.py

@@ -22,31 +22,11 @@ from trcc.core.ports import RawFrame
 log = logging.getLogger(__name__)
 
 
-def _check_ffmpeg() -> bool:
-    """Check if ffmpeg is available in PATH."""
-    try:
-        result = subprocess.run(
-            ['ffmpeg', '-version'], capture_output=True, timeout=5,
-            creationflags=_NO_WINDOW,
-        )
-        return result.returncode == 0
-    except Exception:
-        return False
-
-
-FFMPEG_AVAILABLE = _check_ffmpeg()
-
-
 class VideoDecoder:
     """Decode video frames via FFmpeg pipe. No playback state."""
 
-    def __init__(self, video_path: str, target_size: tuple[int, int] = (320, 320),
+    def __init__(self, video_path: str, target_size: tuple[int, int],
                  fit_mode: str = 'fill') -> None:
-        if not FFMPEG_AVAILABLE:
-            from trcc.core.builder import ControllerBuilder
-            raise RuntimeError(
-                ControllerBuilder.for_current_os().build_setup().ffmpeg_install_help()
-            )
         self.frames: list[RawFrame] = []
         self.fps: int = 16  # Windows: originalImageHz = 16
 
@@ -155,14 +135,10 @@ class VideoDecoder:
     def extract_frames(
         video_path: str,
         output_dir: str,
-        target_size: tuple[int, int] = (320, 320),
+        target_size: tuple[int, int],
         max_frames: int | None = None,
     ) -> int:
         """Extract video frames to PNG files via FFmpeg."""
-        if not FFMPEG_AVAILABLE:
-            log.warning("FFmpeg not available for video extraction")
-            return 0
-
         os.makedirs(output_dir, exist_ok=True)
         w, h = target_size
 
@@ -205,7 +181,7 @@ class ThemeZtDecoder:
     - for each frame: int32 size + JPEG bytes
     """
 
-    def __init__(self, zt_path: str, target_size: tuple[int, int] | None = None) -> None:
+    def __init__(self, zt_path: str, target_size: tuple[int, int]) -> None:
         self.frames: list[RawFrame] = []
         self.timestamps: list[int] = []
         self.delays: list[int] = []
@@ -236,12 +212,10 @@ class ThemeZtDecoder:
 
     @staticmethod
     def _decode_jpeg(jpeg_bytes: bytes,
-                     target_size: tuple[int, int] | None) -> RawFrame:
+                     target_size: tuple[int, int]) -> RawFrame:
         """Decode JPEG bytes → RawFrame via ffmpeg pipe."""
-        vf_args: list[str] = []
-        if target_size:
-            tw, th = target_size
-            vf_args = ['-vf', f'scale={tw}:{th}']
+        tw, th = target_size
+        vf_args = ['-vf', f'scale={tw}:{th}']
         cmd = [
             'ffmpeg', '-f', 'jpeg_pipe', '-i', 'pipe:0',
             *vf_args,
@@ -256,10 +230,10 @@ class ThemeZtDecoder:
                 raise ValueError(f"ffmpeg decode failed: {result.stderr[:100]!r}")
         except Exception as exc:
             log.warning("ThemeZtDecoder: JPEG decode failed (%s), returning blank", exc)
-            w, h = target_size if target_size else (320, 320)
+            w, h = target_size
             return RawFrame(bytes(w * h * 3), w, h)
 
-        w, h = target_size if target_size else (320, 320)
+        w, h = target_size
         return RawFrame(result.stdout[:w * h * 3], w, h)
 
     @property

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/adapters/infra/network.py

@@ -1,7 +1,10 @@
 """Network infrastructure — LAN IP detection for API server."""
 
+import logging
 import socket
 
+log = logging.getLogger(__name__)
+
 
 def get_lan_ip() -> str:
     """Auto-detect LAN IP by probing default route interface.
@@ -9,9 +12,13 @@ def get_lan_ip() -> str:
     Opens a UDP socket to a public DNS (no data sent) to determine
     which local interface the OS would route through.
     """
+    log.debug("get_lan_ip: probing default route interface")
     try:
         with socket.socket(socket.AF_INET, socket.SOCK_DGRAM) as s:
             s.connect(("8.8.8.8", 80))
-            return s.getsockname()[0]
+            ip = s.getsockname()[0]
+            log.debug("get_lan_ip: detected ip=%s", ip)
+            return ip
     except OSError:
+        log.debug("get_lan_ip: OSError, falling back to 127.0.0.1")
         return "127.0.0.1"

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/adapters/infra/theme_cloud.py

@@ -40,6 +40,8 @@ from typing import Callable, Dict, List, Optional
 from urllib.error import HTTPError, URLError
 from urllib.request import Request, urlopen
 
+from trcc.core.models import CLOUD_SERVERS, CLOUD_THEME_URL_KEYS
+
 log = logging.getLogger(__name__)
 
 # Category definitions matching Windows FormCZTV.CheakWebFile
@@ -58,46 +60,9 @@ CATEGORIES = [
 # Category name lookup
 CATEGORY_NAMES = {cat[0]: cat[1] for cat in CATEGORIES}
 
-# Server URLs (Windows pattern: http://www.czhorde.com/tr/bj{resolution}/)
-SERVERS = {
-    'international': 'http://www.czhorde.cc/tr/bj{resolution}/',
-    'china': 'http://www.czhorde.com/tr/bj{resolution}/',
-}
-
-# Resolution URL suffixes — full C# v2.1.2 GifWebDir* parity
-RESOLUTION_URLS = {
-    "240x240": "bj240240",
-    "240x320": "bj240320",
-    "320x240": "bj320240",
-    "320x320": "bj320320",
-    "360x360": "bj360360",
-    "480x480": "bj480480",
-    "640x172": "bj640172",
-    "640x480": "bj640480",
-    "800x480": "bj800480",
-    "854x480": "bj854480",
-    "960x320": "bj960320",
-    "960x540": "bj960540",
-    "1280x480": "bj1280480",
-    "1600x720": "bj1600720",
-    "1600x720u": "bj1600720u",
-    "1600x720l": "bj1600720l",
-    "1920x440": "bj1920440",
-    "1920x462": "bj1920462",
-    # Portrait variants
-    "172x640": "bj172640",
-    "320x960": "bj320960",
-    "440x1920": "bj4401920",
-    "462x1920": "bj4621920",
-    "480x640": "bj480640",
-    "480x800": "bj480800",
-    "480x854": "bj480854",
-    "480x1280": "bj4801280",
-    "540x960": "bj540960",
-    "720x1600": "bj7201600",
-    "720x1600u": "bj7201600u",
-    "720x1600l": "bj7201600l",
-}
+# Re-export for backward compatibility
+SERVERS = CLOUD_SERVERS
+RESOLUTION_URLS = CLOUD_THEME_URL_KEYS
 
 
 class CloudThemeDownloader:
@@ -138,7 +103,7 @@ class CloudThemeDownloader:
 
     def __init__(
         self,
-        resolution: str = "320x320",
+        resolution: str = '',
         cache_dir: Optional[str] = None,
         server: str = 'international'
     ):
@@ -466,7 +431,7 @@ get_themes_by_category = CloudThemeDownloader.get_themes_by_category
 
 def download_theme(
     theme_id: str,
-    resolution: str = "320x320",
+    resolution: str,
     cache_dir: Optional[str] = None,
 ) -> Optional[str]:
     """Quick download of a single theme (convenience wrapper)."""

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/adapters/render/factory_render.py

@@ -1,10 +1,15 @@
 """Renderer factory — creates QtRenderer."""
 from __future__ import annotations
 
+import logging
+
 from trcc.core.ports import Renderer
 
+log = logging.getLogger(__name__)
+
 
 def create_renderer() -> Renderer:
     """Create QtRenderer (primary renderer using C++ QPainter)."""
+    log.debug("create_renderer: instantiating QtRenderer")
     from trcc.adapters.render.qt import QtRenderer
     return QtRenderer()

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/adapters/system/bsd/platform.py

@@ -1,6 +1,7 @@
 """BSD platform adapter — implements PlatformAdapter for FreeBSD."""
 from __future__ import annotations
 
+import logging
 from typing import Any, Callable, List
 
 from trcc.core.models import DetectedDevice
@@ -13,25 +14,31 @@ from trcc.core.ports import (
     SensorEnumerator,
 )
 
+log = logging.getLogger(__name__)
+
 
 class BSDPlatform(PlatformAdapter):
     """All BSD-specific adapter wiring in one place."""
 
     def create_detect_fn(self) -> Callable[[], List[DetectedDevice]]:
+        log.debug("create_detect_fn: building BSD SCSI detect fn")
         from trcc.adapters.device.bsd.scsi import bsd_scsi_resolver
         from trcc.adapters.device.detector import DeviceDetector
         return DeviceDetector.make_detect_fn(scsi_resolver=bsd_scsi_resolver)
 
     def create_sensor_enumerator(self) -> SensorEnumerator:
+        log.debug("create_sensor_enumerator: creating BSDSensorEnumerator")
         from trcc.adapters.system.bsd.sensors import BSDSensorEnumerator
         return BSDSensorEnumerator()
 
     def create_autostart_manager(self) -> AutostartManager:
         # BSD uses XDG .desktop — same as Linux
+        log.debug("create_autostart_manager: creating LinuxAutostartManager (BSD)")
         from trcc.adapters.system.linux.autostart import LinuxAutostartManager
         return LinuxAutostartManager()
 
     def create_setup(self) -> PlatformSetup:
+        log.debug("create_setup: creating BSDSetup")
         from trcc.adapters.system.bsd.setup import BSDSetup
         return BSDSetup()
 

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/adapters/system/linux/hardware.py

@@ -5,11 +5,14 @@ Used by LED memory/disk info panels (C# UCLEDMemoryInfo, UCLEDHarddiskInfo).
 """
 from __future__ import annotations
 
+import logging
 import os
 import shutil
 import subprocess
 from typing import Optional
 
+log = logging.getLogger(__name__)
+
 # Fields to extract from dmidecode -t memory (Type 17: Memory Device)
 _DMI_MEMORY_FIELDS = {
     'manufacturer', 'part_number', 'type', 'speed',
@@ -47,6 +50,7 @@ def get_memory_info() -> list[dict[str, str]]:
     speed, configured_memory_speed, size, form_factor (DIMM/SODIMM),
     rank, data_width, configured_voltage, memory_technology.
     """
+    log.debug("get_memory_info: querying dmidecode")
     slots: list[dict[str, str]] = []
     try:
         result = subprocess.run(
@@ -72,6 +76,7 @@ def get_memory_info() -> list[dict[str, str]]:
     except Exception:
         pass
 
+    log.debug("get_memory_info: found %d populated slots", len(slots))
     # Fallback: at least report total from psutil
     if not slots:
         try:
@@ -91,6 +96,7 @@ def get_disk_info() -> list[dict[str, str]]:
     Returns one dict per physical disk with model, size, type (SSD/HDD),
     and health status (PASSED/FAILED) from SMART if available.
     """
+    log.debug("get_disk_info: querying lsblk")
     disks: list[dict[str, str]] = []
     try:
         import json as _json
@@ -117,6 +123,7 @@ def get_disk_info() -> list[dict[str, str]]:
                 disks.append(disk)
     except Exception:
         pass
+    log.debug("get_disk_info: found %d disks", len(disks))
     return disks
 
 

{trcc_linux-9.2.3 → trcc_linux-9.2.5}/src/trcc/adapters/system/linux/platform.py

@@ -1,6 +1,7 @@
 """Linux platform adapter — implements PlatformAdapter for Linux."""
 from __future__ import annotations
 
+import logging
 from typing import Any, Callable, List
 
 from trcc.core.models import DetectedDevice
@@ -13,24 +14,30 @@ from trcc.core.ports import (
     SensorEnumerator,
 )
 
+log = logging.getLogger(__name__)
+
 
 class LinuxPlatform(PlatformAdapter):
     """All Linux-specific adapter wiring in one place."""
 
     def create_detect_fn(self) -> Callable[[], List[DetectedDevice]]:
+        log.debug("create_detect_fn: building linux SCSI detect fn")
         from trcc.adapters.device.detector import DeviceDetector
         from trcc.adapters.device.linux.detector import linux_scsi_resolver
         return DeviceDetector.make_detect_fn(scsi_resolver=linux_scsi_resolver)
 
     def create_sensor_enumerator(self) -> SensorEnumerator:
+        log.debug("create_sensor_enumerator: creating LinuxSensorEnumerator")
         from trcc.adapters.system.linux.sensors import SensorEnumerator as LinuxSensorEnumerator
         return LinuxSensorEnumerator()
 
     def create_autostart_manager(self) -> AutostartManager:
+        log.debug("create_autostart_manager: creating LinuxAutostartManager")
         from trcc.adapters.system.linux.autostart import LinuxAutostartManager
         return LinuxAutostartManager()
 
     def create_setup(self) -> PlatformSetup:
+        log.debug("create_setup: creating LinuxSetup")
         from trcc.adapters.system.linux.setup import LinuxSetup
         return LinuxSetup()