PyPI - trcc-linux - Versions diffs - 9.3.2__tar.gz → 9.3.4__tar.gz - Mend

trcc-linux 9.3.2tar.gz → 9.3.4tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1028) hide show

{trcc_linux-9.3.2 → trcc_linux-9.3.4}/.gitignore RENAMED Viewed

@@ -78,7 +78,8 @@ src/trcc/data/ui_*.json
 # ──────────────────────────────────────────────
 # Dev / reference files (not for distribution)
 # ──────────────────────────────────────────────
-dev*
+/dev/
+/dev_*
 # Dev scripts at root
 /test_*.py
 /probe_*.py

{trcc_linux-9.3.2 → trcc_linux-9.3.4}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trcc-linux
-Version: 9.3.2
+Version: 9.3.4
 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
@@ -83,7 +83,7 @@ Description-Content-Type: text/markdown
 [![Platform](https://img.shields.io/badge/platform-Linux-FCC624?logo=linux&logoColor=black)](https://github.com/Lexonight1/thermalright-trcc-linux)
 [![CI](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml/badge.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
-[![Tests](https://img.shields.io/badge/tests-5325_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
+[![Tests](https://img.shields.io/badge/tests-5577_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
 [![Coverage](https://img.shields.io/badge/coverage-72%25-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
 [![Python](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://python.org)
 [![Code Style](https://img.shields.io/badge/code_style-ruff-D7FF64?logo=ruff&logoColor=black)](https://docs.astral.sh/ruff/)
@@ -229,7 +229,7 @@ trcc setup                # Interactive setup wizard
 trcc uninstall            # Remove TRCC completely
 ```
-60 commands total — see the **[CLI Reference](doc/REFERENCE_CLI.md)** for the full list.
+See the **[CLI Reference](doc/REFERENCE_CLI.md)** for the full command list.
 ### REST API
@@ -242,7 +242,7 @@ trcc serve --tls              # HTTPS with auto-generated self-signed cert
 trcc serve --host 0.0.0.0     # Listen on all interfaces (LAN access)
 ```
-55 endpoints covering devices, display, LED, themes, and system metrics. Use `trcc api` to list all endpoints.
+49 endpoints covering devices, display, LED, themes, and system metrics. Use `trcc api` to list all endpoints.
 ```bash
 # Examples with curl
@@ -266,14 +266,14 @@ Set the angle to **90°** (or 270°) in the GUI, then open **Cloud Themes** —
 | [Install Guide](doc/GUIDE_INSTALL.md) | Installation for all major distros |
 | [CLI Reference](doc/REFERENCE_CLI.md) | All CLI commands with options and examples |
 | [User Guide](doc/GUIDE_USER.md) | How to use everything — GUI, themes, overlays, media, LED |
-| [API Reference](doc/REFERENCE_API.md) | All 55 REST API endpoints with request/response models |
+| [API Reference](doc/REFERENCE_API.md) | All 49 REST API endpoints with request/response models |
 | [Troubleshooting](doc/GUIDE_TROUBLESHOOTING.md) | Common issues and fixes |
 | [New to Linux](doc/GUIDE_NEW_TO_LINUX.md) | Guide for Linux beginners |
 | [Changelog](doc/CHANGELOG.md) | Version history |
 | [Supported Devices](doc/REFERENCE_DEVICES.md) | Full device list with USB IDs and protocols |
 | [Testers Wanted](doc/TESTERS_WANTED.md) | Devices that need hardware validation |
 | [Device Testing Guide](doc/GUIDE_DEVICE_TESTING.md) | How to test and report device compatibility |
-| [Architecture](doc/GUIDE_ARCHITECTURE.md) | Project layout and design |
+| [Architecture](doc/ARCHITECTURE.md) | Project layout and design |
 | [Technical Reference](doc/REFERENCE_TECHNICAL.md) | SCSI protocol and file formats |
 ### Protocol documentation (reverse-engineered from Windows TRCC)
@@ -289,8 +289,8 @@ Set the angle to **90°** (or 270°) in the GUI, then open **Cloud Themes** —
 | Category | What you get |
 |----------|-------------|
 | **GUI** | Full PySide6 desktop app — theme browser, video player, overlay editor, LED control panel, 38 languages |
-| **CLI** | 60 commands — `trcc gui`, `trcc send`, `trcc video`, `trcc led-color`, `trcc screencast`, `trcc shell`, and more |
-| **REST API** | 55 endpoints — control everything remotely, build integrations, automate your setup |
+| **CLI** | `trcc gui`, `trcc send`, `trcc video`, `trcc led-color`, `trcc screencast`, `trcc shell`, and more |
+| **REST API** | 49 endpoints — control everything remotely, build integrations, automate your setup |
 | **Themes** | Local, cloud, and masks — carousel mode, export/import as `.tr` files, custom mask upload with X/Y positioning, 5 starters + 120 masks per resolution |
 | **Media** | Video/GIF playback on LCD, video trimmer, image cropper, screen cast (X11 + Wayland), mic audio visualization |
 | **Overlay Editor** | Text, sensors, date/time overlays — font picker, dynamic scaling, color picker |
@@ -300,12 +300,12 @@ Set the angle to **90°** (or 270°) in the GUI, then open **Cloud Themes** —
 | **Multi-device** | Per-device config, auto-detect, multi-device with device selection |
 | **Security** | udev rules, polkit policy, SELinux support, no root required after setup |
-**Under the hood**: 147 source files, ~49K lines of Python, 5323 tests across 89 test files in 9 directories. Hexagonal architecture with strict dependency injection — GUI, CLI, and API all talk to the same core services. 6 USB protocols reverse-engineered from the Windows C# app.
+**Under the hood**: 147 source files, ~49K lines of Python, 5577 tests across 96 test files in 9 directories. Hexagonal architecture with strict dependency injection — GUI, CLI, and API all talk to the same core services. 6 USB protocols reverse-engineered from the Windows C# app.
 ### What we do better than Windows TRCC
 - **38 languages** — Windows has 10 (baked into PNGs). We render text at runtime, community can add more
-- **CLI + REST API** — Windows is GUI-only. We have 60 CLI commands and 55 API endpoints for automation
+- **CLI + REST API** — Windows is GUI-only. We have full CLI and 49 API endpoints for automation
 - **Custom mask upload** — upload your own PNG overlay, position with X/Y controls, saved to `~/.trcc-user/`
 - **No admin required** — udev rules handle permissions. Windows needs "Run as Administrator"
 - **Open source** — read the code, fix bugs, add features. Windows TRCC is closed-source .NET
@@ -365,8 +365,8 @@ src/trcc/
 ├── services/       # Business logic — pure Python, no framework deps
 ├── adapters/       # USB device protocols (SCSI, HID, Bulk, LY, LED)
 ├── gui/  # PySide6 GUI (themes, video, overlay, LED, sensors)
-├── cli/            # Typer CLI — 60 commands across 8 modules
-├── api/            # FastAPI REST API — 55 endpoints across 7 modules
+├── cli/            # Typer CLI — 56 commands across 8 modules
+├── api/            # FastAPI REST API — 49 endpoints across 7 modules
 ├── conf.py         # Settings singleton
 └── assets/         # GUI images, desktop entry, polkit policy, systemd service
 ```

{trcc_linux-9.3.2 → trcc_linux-9.3.4}/README.md RENAMED Viewed

@@ -15,7 +15,7 @@
 [![Platform](https://img.shields.io/badge/platform-Linux-FCC624?logo=linux&logoColor=black)](https://github.com/Lexonight1/thermalright-trcc-linux)
 [![CI](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml/badge.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
-[![Tests](https://img.shields.io/badge/tests-5325_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
+[![Tests](https://img.shields.io/badge/tests-5577_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
 [![Coverage](https://img.shields.io/badge/coverage-72%25-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
 [![Python](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://python.org)
 [![Code Style](https://img.shields.io/badge/code_style-ruff-D7FF64?logo=ruff&logoColor=black)](https://docs.astral.sh/ruff/)
@@ -161,7 +161,7 @@ trcc setup                # Interactive setup wizard
 trcc uninstall            # Remove TRCC completely
 ```
-60 commands total — see the **[CLI Reference](doc/REFERENCE_CLI.md)** for the full list.
+See the **[CLI Reference](doc/REFERENCE_CLI.md)** for the full command list.
 ### REST API
@@ -174,7 +174,7 @@ trcc serve --tls              # HTTPS with auto-generated self-signed cert
 trcc serve --host 0.0.0.0     # Listen on all interfaces (LAN access)
 ```
-55 endpoints covering devices, display, LED, themes, and system metrics. Use `trcc api` to list all endpoints.
+49 endpoints covering devices, display, LED, themes, and system metrics. Use `trcc api` to list all endpoints.
 ```bash
 # Examples with curl
@@ -198,14 +198,14 @@ Set the angle to **90°** (or 270°) in the GUI, then open **Cloud Themes** —
 | [Install Guide](doc/GUIDE_INSTALL.md) | Installation for all major distros |
 | [CLI Reference](doc/REFERENCE_CLI.md) | All CLI commands with options and examples |
 | [User Guide](doc/GUIDE_USER.md) | How to use everything — GUI, themes, overlays, media, LED |
-| [API Reference](doc/REFERENCE_API.md) | All 55 REST API endpoints with request/response models |
+| [API Reference](doc/REFERENCE_API.md) | All 49 REST API endpoints with request/response models |
 | [Troubleshooting](doc/GUIDE_TROUBLESHOOTING.md) | Common issues and fixes |
 | [New to Linux](doc/GUIDE_NEW_TO_LINUX.md) | Guide for Linux beginners |
 | [Changelog](doc/CHANGELOG.md) | Version history |
 | [Supported Devices](doc/REFERENCE_DEVICES.md) | Full device list with USB IDs and protocols |
 | [Testers Wanted](doc/TESTERS_WANTED.md) | Devices that need hardware validation |
 | [Device Testing Guide](doc/GUIDE_DEVICE_TESTING.md) | How to test and report device compatibility |
-| [Architecture](doc/GUIDE_ARCHITECTURE.md) | Project layout and design |
+| [Architecture](doc/ARCHITECTURE.md) | Project layout and design |
 | [Technical Reference](doc/REFERENCE_TECHNICAL.md) | SCSI protocol and file formats |
 ### Protocol documentation (reverse-engineered from Windows TRCC)
@@ -221,8 +221,8 @@ Set the angle to **90°** (or 270°) in the GUI, then open **Cloud Themes** —
 | Category | What you get |
 |----------|-------------|
 | **GUI** | Full PySide6 desktop app — theme browser, video player, overlay editor, LED control panel, 38 languages |
-| **CLI** | 60 commands — `trcc gui`, `trcc send`, `trcc video`, `trcc led-color`, `trcc screencast`, `trcc shell`, and more |
-| **REST API** | 55 endpoints — control everything remotely, build integrations, automate your setup |
+| **CLI** | `trcc gui`, `trcc send`, `trcc video`, `trcc led-color`, `trcc screencast`, `trcc shell`, and more |
+| **REST API** | 49 endpoints — control everything remotely, build integrations, automate your setup |
 | **Themes** | Local, cloud, and masks — carousel mode, export/import as `.tr` files, custom mask upload with X/Y positioning, 5 starters + 120 masks per resolution |
 | **Media** | Video/GIF playback on LCD, video trimmer, image cropper, screen cast (X11 + Wayland), mic audio visualization |
 | **Overlay Editor** | Text, sensors, date/time overlays — font picker, dynamic scaling, color picker |
@@ -232,12 +232,12 @@ Set the angle to **90°** (or 270°) in the GUI, then open **Cloud Themes** —
 | **Multi-device** | Per-device config, auto-detect, multi-device with device selection |
 | **Security** | udev rules, polkit policy, SELinux support, no root required after setup |
-**Under the hood**: 147 source files, ~49K lines of Python, 5323 tests across 89 test files in 9 directories. Hexagonal architecture with strict dependency injection — GUI, CLI, and API all talk to the same core services. 6 USB protocols reverse-engineered from the Windows C# app.
+**Under the hood**: 147 source files, ~49K lines of Python, 5577 tests across 96 test files in 9 directories. Hexagonal architecture with strict dependency injection — GUI, CLI, and API all talk to the same core services. 6 USB protocols reverse-engineered from the Windows C# app.
 ### What we do better than Windows TRCC
 - **38 languages** — Windows has 10 (baked into PNGs). We render text at runtime, community can add more
-- **CLI + REST API** — Windows is GUI-only. We have 60 CLI commands and 55 API endpoints for automation
+- **CLI + REST API** — Windows is GUI-only. We have full CLI and 49 API endpoints for automation
 - **Custom mask upload** — upload your own PNG overlay, position with X/Y controls, saved to `~/.trcc-user/`
 - **No admin required** — udev rules handle permissions. Windows needs "Run as Administrator"
 - **Open source** — read the code, fix bugs, add features. Windows TRCC is closed-source .NET
@@ -297,8 +297,8 @@ src/trcc/
 ├── services/       # Business logic — pure Python, no framework deps
 ├── adapters/       # USB device protocols (SCSI, HID, Bulk, LY, LED)
 ├── gui/  # PySide6 GUI (themes, video, overlay, LED, sensors)
-├── cli/            # Typer CLI — 60 commands across 8 modules
-├── api/            # FastAPI REST API — 55 endpoints across 7 modules
+├── cli/            # Typer CLI — 56 commands across 8 modules
+├── api/            # FastAPI REST API — 49 endpoints across 7 modules
 ├── conf.py         # Settings singleton
 └── assets/         # GUI images, desktop entry, polkit policy, systemd service
 ```

{trcc_linux-9.3.2 → trcc_linux-9.3.4}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 [project]
 name = "trcc-linux"
-version = "9.3.2"
+version = "9.3.4"
 description = "Linux implementation of Thermalright LCD Control Center"
 readme = "README.md"
 license = "GPL-3.0-or-later"

{trcc_linux-9.3.2 → trcc_linux-9.3.4}/src/trcc/__version__.py RENAMED Viewed

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

trcc_linux-9.3.4/src/trcc/adapters/device/__init__.py ADDED Viewed

	@@ -0,0 +1 @@
1	+ """Device protocol adapters — SCSI, HID, LED, Bulk."""

trcc_linux-9.3.4/src/trcc/adapters/device/_usb_helpers.py ADDED Viewed

@@ -0,0 +1,262 @@
+"""Shared USB device lifecycle helpers for bulk-class transports.
+Eliminates duplication between BulkDevice and LyDevice — both use the same
+find → detach → configure → claim sequence, endpoint discovery, and close().
+BulkFrameDevice is the shared base class; subclasses implement only
+handshake() and send_frame().
+"""
+from __future__ import annotations
+import logging
+import time
+from typing import Any
+log = logging.getLogger(__name__)
+# ---------------------------------------------------------------------------
+# Internal helpers (not exported — used only by open_usb_device)
+# ---------------------------------------------------------------------------
+_ERR_NOT_FOUND = "USB device {vid:04x}:{pid:04x} not found"
+def _err_interface_busy() -> str:
+    """Platform-aware error for USB interface claim failure after driver detach."""
+    from trcc.core.platform import LINUX
+    if LINUX:
+        return (
+            "USB interface busy — SELinux may be blocking USB device access. "
+            "Run 'sudo trcc setup-selinux' to install the policy module, "
+            "then unplug and replug the device."
+        )
+    return (
+        "USB interface busy — the kernel driver could not be detached. "
+        "Ensure no other application is using the device and try again."
+    )
+_ERR_EBUSY = (
+    "USB device {vid:04x}:{pid:04x} interface is in use by another process. "
+    "Close any other TRCC instances and try again."
+)
+def _disable_autosuspend(dev: Any) -> None:
+    """Disable USB autosuspend for this device so the kernel doesn't reset it.
+    Linux USB autosuspend can reset idle devices after ~30 seconds,
+    causing the LCD to drop to its splash screen.  Writes -1 to the
+    sysfs power/autosuspend attribute to keep the device always on.
+    """
+    from pathlib import Path
+    try:
+        bus = dev.bus
+        addr = dev.address
+        sysfs = Path(f"/sys/bus/usb/devices/{bus}-{addr}/power/autosuspend")
+        if not sysfs.exists():
+            # Try alternate path format
+            for p in Path("/sys/bus/usb/devices/").glob("*/power/autosuspend"):
+                devnum = p.parent.parent / "devnum"
+                busnum = p.parent.parent / "busnum"
+                if (devnum.exists() and busnum.exists()
+                        and int(busnum.read_text().strip()) == bus
+                        and int(devnum.read_text().strip()) == addr):
+                    sysfs = p
+                    break
+        if sysfs.exists():
+            sysfs.write_text("-1")
+            log.debug("USB autosuspend disabled: %s", sysfs)
+        else:
+            log.debug("sysfs autosuspend path not found for bus=%d addr=%d", bus, addr)
+    except (OSError, ValueError) as e:
+        log.debug("Could not disable USB autosuspend: %s", e)
+def _find_vendor_interface(cfg: Any) -> Any:
+    """Prefer vendor-specific interface (bInterfaceClass=255), fallback to (0,0)."""
+    for candidate in cfg:
+        if candidate.bInterfaceClass == 255:  # type: ignore[union-attr]
+            return candidate
+    return cfg[(0, 0)]  # type: ignore[index]
+def _detach_kernel_drivers(dev: Any, count: int = 4) -> bool:
+    """Detach kernel drivers from interfaces 0..count-1.
+    Returns True if the driver could not be detached (driver still active
+    after detach attempt -- on Linux this typically means SELinux blocking).
+    """
+    import usb.core  # type: ignore[import-untyped]
+    detach_blocked = False
+    for i in range(count):
+        try:
+            if not dev.is_kernel_driver_active(i):  # type: ignore[union-attr]
+                continue
+            dev.detach_kernel_driver(i)  # type: ignore[union-attr]
+            # Verify detach actually worked
+            if dev.is_kernel_driver_active(i):  # type: ignore[union-attr]
+                detach_blocked = True
+                log.warning("Kernel driver still active on interface %d after "
+                            "detach — the OS may be blocking USB ioctls", i)
+            else:
+                log.debug("Detached kernel driver from interface %d", i)
+        except usb.core.USBError as e:
+            log.debug("Could not detach kernel driver from interface %d: %s", i, e)
+            try:
+                if dev.is_kernel_driver_active(i):  # type: ignore[union-attr]
+                    detach_blocked = True
+                    log.warning("Kernel driver still active on interface %d "
+                                "after detach error — the OS may be blocking", i)
+            except (usb.core.USBError, NotImplementedError):
+                pass
+        except NotImplementedError:
+            pass
+    return detach_blocked
+def _reset_and_refind(dev: Any, vid: int, pid: int) -> Any:
+    """Reset USB device, wait, re-find, detach drivers. Returns new handle."""
+    import usb.core  # type: ignore[import-untyped]
+    dev.reset()  # type: ignore[union-attr]
+    time.sleep(0.5)
+    new_dev = usb.core.find(idVendor=vid, idProduct=pid)
+    if new_dev is None:
+        raise RuntimeError(_ERR_NOT_FOUND.format(vid=vid, pid=pid))
+    _detach_kernel_drivers(new_dev)
+    return new_dev
+# ---------------------------------------------------------------------------
+# Public API
+# ---------------------------------------------------------------------------
+def open_usb_device(vid: int, pid: int) -> tuple[Any, Any]:
+    """Find, configure, and claim a vendor-class USB device.
+    Handles the full USB lifecycle:
+      find -> detach kernel drivers -> configure
+      -> find vendor interface -> claim (with EBUSY retry) -> return
+    Returns:
+        (device, interface) tuple ready for endpoint detection.
+    Raises:
+        RuntimeError: Device not found, or kernel driver could not be detached.
+        usb.core.USBError: Permission denied (errno 13).
+    """
+    import usb.core  # type: ignore[import-untyped]
+    import usb.util  # type: ignore[import-untyped]
+    dev = usb.core.find(idVendor=vid, idProduct=pid)
+    if dev is None:
+        raise RuntimeError(_ERR_NOT_FOUND.format(vid=vid, pid=pid))
+    # 1. Detach kernel drivers (post-verification included)
+    detach_blocked = _detach_kernel_drivers(dev)
+    # 2. Configure device (skip if already configured)
+    try:
+        cfg = dev.get_active_configuration()  # type: ignore[union-attr]
+        log.debug("Device already configured, skipping set_configuration()")
+    except usb.core.USBError as e:
+        if e.errno == 13:  # EACCES — permission denied
+            raise
+        log.debug("No active configuration, calling set_configuration()")
+        try:
+            dev.set_configuration()  # type: ignore[union-attr]
+        except usb.core.USBError:
+            log.warning("set_configuration() failed, resetting device and retrying")
+            dev = _reset_and_refind(dev, vid, pid)
+            dev.set_configuration()  # type: ignore[union-attr]
+        cfg = dev.get_active_configuration()  # type: ignore[union-attr]
+    # 3. Find vendor-specific interface
+    intf = _find_vendor_interface(cfg)
+    # 4. Claim interface
+    try:
+        usb.util.claim_interface(dev, intf.bInterfaceNumber)  # type: ignore[union-attr]
+    except usb.core.USBError as e:
+        if e.errno != 16:  # Not EBUSY
+            raise
+        if detach_blocked:
+            raise RuntimeError(_err_interface_busy()) from e
+        raise RuntimeError(_ERR_EBUSY.format(vid=vid, pid=pid)) from e
+    return dev, intf
+# ---------------------------------------------------------------------------
+# BulkFrameDevice — shared base for BulkDevice + LyDevice
+# ---------------------------------------------------------------------------
+class BulkFrameDevice:
+    """Shared base for USB bulk-transport LCD devices (Bulk + LY).
+    Provides: __init__, _open() (endpoint discovery), close().
+    Subclasses implement: handshake(), send_frame().
+    """
+    def __init__(self, vid: int, pid: int, usb_path: str = ""):
+        self.vid = vid
+        self.pid = pid
+        self.usb_path = usb_path
+        self._dev: Any = None
+        self._ep_out: Any = None
+        self._ep_in: Any = None
+        self._intf: int = 0
+        self.pm: int = 0
+        self.sub_type: int = 0
+        self.width: int = 0
+        self.height: int = 0
+        self.use_jpeg: bool = True
+        self._raw_handshake: bytes = b""
+    def _open(self) -> None:
+        """Find and claim the USB device, discover bulk IN/OUT endpoints."""
+        import usb.util
+        dev, intf = open_usb_device(self.vid, self.pid)
+        self._ep_out = usb.util.find_descriptor(
+            intf,
+            custom_match=lambda e: (
+                usb.util.endpoint_direction(e.bEndpointAddress) == usb.util.ENDPOINT_OUT
+                and usb.util.endpoint_type(e.bmAttributes) == usb.util.ENDPOINT_TYPE_BULK
+            ),
+        )
+        self._ep_in = usb.util.find_descriptor(
+            intf,
+            custom_match=lambda e: (
+                usb.util.endpoint_direction(e.bEndpointAddress) == usb.util.ENDPOINT_IN
+                and usb.util.endpoint_type(e.bmAttributes) == usb.util.ENDPOINT_TYPE_BULK
+            ),
+        )
+        if self._ep_out is None or self._ep_in is None:
+            raise RuntimeError("Could not find bulk IN/OUT endpoints")
+        self._intf = intf.bInterfaceNumber  # type: ignore[union-attr]
+        self._dev = dev
+        log.info("Opened %s %04x:%04x (EP OUT=0x%02x, EP IN=0x%02x)",
+                 type(self).__name__, self.vid, self.pid,
+                 self._ep_out.bEndpointAddress,  # type: ignore[union-attr]
+                 self._ep_in.bEndpointAddress)  # type: ignore[union-attr]
+        _disable_autosuspend(dev)
+    def close(self) -> None:
+        """Release USB device."""
+        if self._dev is not None:
+            import usb.util
+            try:
+                usb.util.release_interface(self._dev, self._intf)
+            except Exception:
+                pass
+            usb.util.dispose_resources(self._dev)
+            self._dev = None
+            self._ep_out = None
+            self._ep_in = None
+            log.info("%s closed", type(self).__name__)

trcc_linux-9.3.4/src/trcc/adapters/device/bsd/detector.py ADDED Viewed

@@ -0,0 +1,33 @@
+"""FreeBSD USB device detection utilities.
+Device detection on FreeBSD uses the cross-platform DeviceDetector
+(pyusb-based) via BSDPlatform.create_detect_fn(). SCSI devices are
+addressed by VID:PID through pyusb — no /dev/pass* mapping needed.
+This module provides diagnostic utilities only.
+Requires: pkg install py-pyusb (libusb is in base FreeBSD)
+"""
+from __future__ import annotations
+import logging
+import subprocess
+log = logging.getLogger(__name__)
+def get_usb_list() -> list[str]:
+    """Get USB device list via usbconfig (for diagnostics).
+    Returns raw output lines from `usbconfig list`.
+    """
+    try:
+        result = subprocess.run(
+            ['usbconfig', 'list'],
+            capture_output=True, text=True, timeout=5,
+        )
+        if result.returncode == 0:
+            return result.stdout.splitlines()
+    except Exception:
+        log.debug("usbconfig list failed")
+    return []

trcc-linux 9.3.2__tar.gz → 9.3.4__tar.gz

trcc-linux 9.3.2tar.gz → 9.3.4tar.gz