trcc-linux 1.2.0__tar.gz → 1.2.2__tar.gz

{trcc_linux-1.2.0 → trcc_linux-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trcc-linux
-Version: 1.2.0
+Version: 1.2.2
 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
@@ -54,7 +54,7 @@ Description-Content-Type: text/markdown
 
 [![Tests](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/tests.yml/badge.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/tests.yml)
 [![Coverage](https://img.shields.io/badge/coverage-96%25-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/tests.yml)
-[![Version](https://img.shields.io/badge/version-1.2.0-blue.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/releases/tag/v1.2.0)
+[![PyPI](https://img.shields.io/pypi/v/trcc-linux)](https://pypi.org/project/trcc-linux/)
 [![Python](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://python.org)
 [![License](https://img.shields.io/badge/license-GPL--3.0-green.svg)](LICENSE)
 
@@ -102,11 +102,20 @@ Run `lsusb` to find your USB ID (`xxxx:xxxx` after `ID`), then match it below.
 |--------|---------|
 | `0416:8001` | AX120 DIGITAL, PA120 DIGITAL, Peerless Assassin 120 DIGITAL, HR10 2280 PRO DIGITAL, and others (model auto-detected via handshake) |
 
-> HID devices are auto-detected. See the [HID Testing Guide](doc/HID_TESTING.md) if you have one — I need testers.
+> HID devices are auto-detected. See the [Device Testing Guide](doc/DEVICE_TESTING.md) if you have one — I need testers.
 
 ## Install
 
-### Automatic (recommended)
+### Quick install (PyPI)
+
+```bash
+pip install trcc-linux
+sudo trcc setup-udev
+```
+
+Then **unplug and replug the USB cable** and run `trcc gui`.
+
+### Automatic (recommended for full setup)
 
 ```bash
 git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git
@@ -129,43 +138,43 @@ Find your distro, copy the block, paste in terminal. After it finishes: **unplug
 ### Fedora / Nobara
 
 ```bash
-sudo dnf install sg3_utils python3-pyqt6 ffmpeg && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo dnf install sg3_utils python3-pyqt6 ffmpeg && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### Ubuntu / Debian / Mint / Pop!_OS / Zorin / elementary OS
 
 ```bash
-sudo apt install sg3-utils python3-pyqt6 ffmpeg python3-pip python3-venv && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo apt install sg3-utils python3-pyqt6 ffmpeg python3-pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### Arch / Manjaro / EndeavourOS / CachyOS / Garuda
 
 ```bash
-sudo pacman -S sg3_utils python-pyqt6 ffmpeg python-pip && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo pacman -S sg3_utils python-pyqt6 ffmpeg python-pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### openSUSE
 
 ```bash
-sudo zypper install sg3_utils python3-qt6 ffmpeg python3-pip && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo zypper install sg3_utils python3-qt6 ffmpeg python3-pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### Void Linux
 
 ```bash
-sudo xbps-install sg3_utils python3-PyQt6 ffmpeg python3-pip && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo xbps-install sg3_utils python3-PyQt6 ffmpeg python3-pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### Gentoo
 
 ```bash
-sudo emerge --ask sg3_utils dev-python/PyQt6 media-video/ffmpeg dev-python/pip && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo emerge --ask sg3_utils dev-python/PyQt6 media-video/ffmpeg dev-python/pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### Alpine
 
 ```bash
-sudo apk add sg3_utils py3-pyqt6 ffmpeg py3-pip python3 && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo apk add sg3_utils py3-pyqt6 ffmpeg py3-pip python3 && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### Bazzite / Fedora Atomic / Aurora / Bluefin
@@ -175,7 +184,7 @@ rpm-ostree install sg3_utils && echo "Reboot now, then run the next block" && sy
 ```
 After reboot:
 ```bash
-([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && python3 -m venv ~/trcc-env && source ~/trcc-env/bin/activate && pip install -e . && trcc setup-udev && trcc install-desktop
+python3 -m venv ~/trcc-env && source ~/trcc-env/bin/activate && pip install trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 Launch: `source ~/trcc-env/bin/activate && trcc gui`
 
@@ -183,7 +192,7 @@ Launch: `source ~/trcc-env/bin/activate && trcc gui`
 
 Switch to Desktop Mode, open Konsole:
 ```bash
-sudo steamos-readonly disable && sudo pacman -S --needed sg3_utils python-pip python-pyqt6 ffmpeg && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop && sudo steamos-readonly enable
+sudo steamos-readonly disable && sudo pacman -S --needed sg3_utils python-pip python-pyqt6 ffmpeg && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop && sudo steamos-readonly enable
 ```
 
 ### NixOS
@@ -202,7 +211,7 @@ services.udev.extraRules = ''
 ```
 Then:
 ```bash
-([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc install-desktop
+pip install --break-system-packages trcc-linux && trcc install-desktop
 ```
 
 ## Usage
@@ -231,7 +240,7 @@ See the **[CLI Reference](doc/CLI_REFERENCE.md)** for all 15 commands, options,
 | [USBLCDNEW Protocol](doc/USBLCDNEW_PROTOCOL.md) | USB bulk protocol reverse-engineered from USBLCDNEW.exe |
 | [USBLED Protocol](doc/USBLED_PROTOCOL.md) | HID LED protocol reverse-engineered from FormLED.cs |
 | [Testers Wanted](doc/TESTERS_WANTED.md) | Devices that need hardware validation |
-| [HID Testing Guide](doc/HID_TESTING.md) | HID device support and troubleshooting |
+| [Device Testing Guide](doc/DEVICE_TESTING.md) | Device support and troubleshooting |
 | [Supported Devices](doc/SUPPORTED_DEVICES.md) | Full device list with USB IDs |
 
 ## Contributors

{trcc_linux-1.2.0 → trcc_linux-1.2.2}/README.md

@@ -2,7 +2,7 @@
 
 [![Tests](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/tests.yml/badge.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/tests.yml)
 [![Coverage](https://img.shields.io/badge/coverage-96%25-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/tests.yml)
-[![Version](https://img.shields.io/badge/version-1.2.0-blue.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/releases/tag/v1.2.0)
+[![PyPI](https://img.shields.io/pypi/v/trcc-linux)](https://pypi.org/project/trcc-linux/)
 [![Python](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://python.org)
 [![License](https://img.shields.io/badge/license-GPL--3.0-green.svg)](LICENSE)
 
@@ -50,11 +50,20 @@ Run `lsusb` to find your USB ID (`xxxx:xxxx` after `ID`), then match it below.
 |--------|---------|
 | `0416:8001` | AX120 DIGITAL, PA120 DIGITAL, Peerless Assassin 120 DIGITAL, HR10 2280 PRO DIGITAL, and others (model auto-detected via handshake) |
 
-> HID devices are auto-detected. See the [HID Testing Guide](doc/HID_TESTING.md) if you have one — I need testers.
+> HID devices are auto-detected. See the [Device Testing Guide](doc/DEVICE_TESTING.md) if you have one — I need testers.
 
 ## Install
 
-### Automatic (recommended)
+### Quick install (PyPI)
+
+```bash
+pip install trcc-linux
+sudo trcc setup-udev
+```
+
+Then **unplug and replug the USB cable** and run `trcc gui`.
+
+### Automatic (recommended for full setup)
 
 ```bash
 git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git
@@ -77,43 +86,43 @@ Find your distro, copy the block, paste in terminal. After it finishes: **unplug
 ### Fedora / Nobara
 
 ```bash
-sudo dnf install sg3_utils python3-pyqt6 ffmpeg && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo dnf install sg3_utils python3-pyqt6 ffmpeg && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### Ubuntu / Debian / Mint / Pop!_OS / Zorin / elementary OS
 
 ```bash
-sudo apt install sg3-utils python3-pyqt6 ffmpeg python3-pip python3-venv && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo apt install sg3-utils python3-pyqt6 ffmpeg python3-pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### Arch / Manjaro / EndeavourOS / CachyOS / Garuda
 
 ```bash
-sudo pacman -S sg3_utils python-pyqt6 ffmpeg python-pip && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo pacman -S sg3_utils python-pyqt6 ffmpeg python-pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### openSUSE
 
 ```bash
-sudo zypper install sg3_utils python3-qt6 ffmpeg python3-pip && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo zypper install sg3_utils python3-qt6 ffmpeg python3-pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### Void Linux
 
 ```bash
-sudo xbps-install sg3_utils python3-PyQt6 ffmpeg python3-pip && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo xbps-install sg3_utils python3-PyQt6 ffmpeg python3-pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### Gentoo
 
 ```bash
-sudo emerge --ask sg3_utils dev-python/PyQt6 media-video/ffmpeg dev-python/pip && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo emerge --ask sg3_utils dev-python/PyQt6 media-video/ffmpeg dev-python/pip && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### Alpine
 
 ```bash
-sudo apk add sg3_utils py3-pyqt6 ffmpeg py3-pip python3 && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop
+sudo apk add sg3_utils py3-pyqt6 ffmpeg py3-pip python3 && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 
 ### Bazzite / Fedora Atomic / Aurora / Bluefin
@@ -123,7 +132,7 @@ rpm-ostree install sg3_utils && echo "Reboot now, then run the next block" && sy
 ```
 After reboot:
 ```bash
-([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && python3 -m venv ~/trcc-env && source ~/trcc-env/bin/activate && pip install -e . && trcc setup-udev && trcc install-desktop
+python3 -m venv ~/trcc-env && source ~/trcc-env/bin/activate && pip install trcc-linux && sudo trcc setup-udev && trcc install-desktop
 ```
 Launch: `source ~/trcc-env/bin/activate && trcc gui`
 
@@ -131,7 +140,7 @@ Launch: `source ~/trcc-env/bin/activate && trcc gui`
 
 Switch to Desktop Mode, open Konsole:
 ```bash
-sudo steamos-readonly disable && sudo pacman -S --needed sg3_utils python-pip python-pyqt6 ffmpeg && ([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc setup-udev && trcc install-desktop && sudo steamos-readonly enable
+sudo steamos-readonly disable && sudo pacman -S --needed sg3_utils python-pip python-pyqt6 ffmpeg && pip install --break-system-packages trcc-linux && sudo trcc setup-udev && trcc install-desktop && sudo steamos-readonly enable
 ```
 
 ### NixOS
@@ -150,7 +159,7 @@ services.udev.extraRules = ''
 ```
 Then:
 ```bash
-([ -d thermalright-trcc-linux ] && git -C thermalright-trcc-linux pull || git clone -b stable https://github.com/Lexonight1/thermalright-trcc-linux.git) && cd thermalright-trcc-linux && pip install --break-system-packages -e . && trcc install-desktop
+pip install --break-system-packages trcc-linux && trcc install-desktop
 ```
 
 ## Usage
@@ -179,7 +188,7 @@ See the **[CLI Reference](doc/CLI_REFERENCE.md)** for all 15 commands, options,
 | [USBLCDNEW Protocol](doc/USBLCDNEW_PROTOCOL.md) | USB bulk protocol reverse-engineered from USBLCDNEW.exe |
 | [USBLED Protocol](doc/USBLED_PROTOCOL.md) | HID LED protocol reverse-engineered from FormLED.cs |
 | [Testers Wanted](doc/TESTERS_WANTED.md) | Devices that need hardware validation |
-| [HID Testing Guide](doc/HID_TESTING.md) | HID device support and troubleshooting |
+| [Device Testing Guide](doc/DEVICE_TESTING.md) | Device support and troubleshooting |
 | [Supported Devices](doc/SUPPORTED_DEVICES.md) | Full device list with USB IDs |
 
 ## Contributors

{trcc_linux-1.2.0 → trcc_linux-1.2.2}/pyproject.toml

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

{trcc_linux-1.2.0 → trcc_linux-1.2.2}/src/trcc/__version__.py

@@ -1,6 +1,6 @@
 """TRCC Linux version information."""
 
-__version__ = "1.2.0"
+__version__ = "1.2.2"
 __version_info__ = tuple(int(x) for x in __version__.split("."))
 
 # Version history:
@@ -15,3 +15,7 @@ __version_info__ = tuple(int(x) for x in __version__.split("."))
 #         scan, os.system→subprocess.run
 # 1.2.0 - Autostart on login, reference theme save (config.json), resume command,
 #         ruff linting, protocol reverse engineering docs, 1836 tests
+# 1.2.1 - Fix RGB565 byte order for non-320x320 SCSI devices, fix GUI crash on
+#         HID handshake failure, add verbose debug logging (trcc -vv gui)
+# 1.2.2 - Fix local themes not loading from pip install (Custom_ dirs blocked
+#         on-demand download), bump for PyPI

{trcc_linux-1.2.0 → trcc_linux-1.2.2}/src/trcc/core/controllers.py

@@ -9,6 +9,7 @@ Controllers are GUI-framework independent. They:
 from __future__ import annotations
 
 import json
+import logging
 import shutil
 import tempfile
 import threading
@@ -40,9 +41,18 @@ from .models import (
     VideoState,
 )
 
+log = logging.getLogger(__name__)
 
-def image_to_rgb565(img: Any) -> bytes:
-    """Convert PIL Image to RGB565 bytes (big-endian, masked)."""
+
+def image_to_rgb565(img: Any, byte_order: str = '>') -> bytes:
+    """Convert PIL Image to RGB565 bytes.
+
+    Windows TRCC ImageTo565: big-endian for 320x320, little-endian otherwise.
+
+    Args:
+        img: PIL Image.
+        byte_order: '>' for big-endian, '<' for little-endian.
+    """
     if img.mode != 'RGB':
         img = img.convert('RGB')
 
@@ -51,7 +61,7 @@ def image_to_rgb565(img: Any) -> bytes:
     g = (arr[:, :, 1] >> 2) & 0x3F
     b = (arr[:, :, 2] >> 3) & 0x1F
     rgb565 = (r << 11) | (g << 5) | b
-    return rgb565.astype('>u2').tobytes()
+    return rgb565.astype(f'{byte_order}u2').tobytes()
 
 
 def apply_rotation(image: Any, rotation: int) -> Any:
@@ -390,6 +400,7 @@ class OverlayController:
 
     def enable(self, enabled: bool = True):
         """Enable or disable overlay rendering."""
+        log.debug("Overlay %s", "enabled" if enabled else "disabled")
         self.model.enabled = enabled
 
     def is_enabled(self) -> bool:
@@ -569,9 +580,11 @@ class LCDDeviceController:
 
         Sets up theme directories and detects devices.
         """
+        log.debug("Initializing controller, data_dir=%s", data_dir)
         self._data_dir = data_dir
 
         # Set LCD target size for video and overlay
+        log.debug("LCD target: %dx%d", self.lcd_width, self.lcd_height)
         self.video.set_target_size(self.lcd_width, self.lcd_height)
         self.overlay.set_target_size(self.lcd_width, self.lcd_height)
 
@@ -603,6 +616,7 @@ class LCDDeviceController:
         """Set LCD resolution, update sub-controllers, and optionally persist to config."""
         if width == self.lcd_width and height == self.lcd_height:
             return
+        log.info("Resolution changed: %dx%d → %dx%d", self.lcd_width, self.lcd_height, width, height)
         self.lcd_width = width
         self.lcd_height = height
         self.video.set_target_size(width, height)
@@ -658,6 +672,7 @@ class LCDDeviceController:
         loads resources by reference — no file copying. Otherwise falls back
         to the original copy-to-working-dir approach.
         """
+        log.info("Loading local theme: %s", theme.path)
         # Stop any running video/animation first
         self.video.stop()
 
@@ -1083,20 +1098,31 @@ class LCDDeviceController:
 
     def _send_frame_to_lcd(self, image: Any):
         """Send PIL Image to LCD device (with rotation and brightness applied)."""
-        if not self.devices.get_selected():
+        device = self.devices.get_selected()
+        if not device:
+            log.debug("Send skipped — no device selected")
             return
 
         try:
             adjusted = self._apply_brightness(image)
             rotated = self._apply_rotation(adjusted)
             rgb565_data = self._image_to_rgb565(rotated)
+            log.debug("Sending %d bytes to %s (%dx%d)", len(rgb565_data), device.path, self.lcd_width, self.lcd_height)
             self.devices.send_image_async(rgb565_data, self.lcd_width, self.lcd_height)
         except Exception as e:
             self._handle_error(f"LCD send error: {e}")
 
     def _image_to_rgb565(self, img: Any) -> bytes:
-        """Convert PIL Image to RGB565 bytes."""
-        return image_to_rgb565(img)
+        """Convert PIL Image to RGB565 bytes.
+
+        Byte order matches Windows TRCC ImageTo565:
+        big-endian for 320x320, little-endian for other resolutions.
+        """
+        byte_order = '>'
+        device = self.devices.get_selected()
+        if device and device.protocol == 'scsi' and device.resolution != (320, 320):
+            byte_order = '<'
+        return image_to_rgb565(img, byte_order)
 
     # =========================================================================
     # Callbacks from sub-controllers

{trcc_linux-1.2.0 → trcc_linux-1.2.2}/src/trcc/core/models.py

@@ -4,11 +4,14 @@ TRCC Models - Pure data classes with no GUI dependencies.
 These models can be used by any GUI framework (Tkinter, PyQt6, etc.)
 """
 
+import logging
 from dataclasses import dataclass, field
 from enum import Enum, auto
 from pathlib import Path
 from typing import Any, Callable, Dict, List, Optional, Tuple
 
+log = logging.getLogger(__name__)
+
 # =============================================================================
 # Theme Model
 # =============================================================================
@@ -271,6 +274,7 @@ class DeviceModel:
 
     def detect_devices(self) -> List[DeviceInfo]:
         """Detect connected LCD devices."""
+        log.debug("DeviceModel: scanning for devices...")
         try:
             from ..scsi_device import find_lcd_devices
             raw_devices = find_lcd_devices()
@@ -289,12 +293,17 @@ class DeviceModel:
                     device_index=d.get('device_index', 0),
                     protocol=d.get('protocol', 'scsi'),
                     device_type=d.get('device_type', 1),
+                    implementation=d.get('implementation', 'generic'),
                 )
                 for d in raw_devices
             ]
         except ImportError:
             self.devices = []
 
+        log.info("DeviceModel: found %d device(s)", len(self.devices))
+        for d in self.devices:
+            log.debug("  %s [%04X:%04X] %s res=%s", d.name, d.vid, d.pid, d.protocol, d.resolution)
+
         if self.on_devices_changed:
             self.on_devices_changed()
 

{trcc_linux-1.2.0 → trcc_linux-1.2.2}/src/trcc/device_detector.py

@@ -17,6 +17,7 @@ Supported devices (HID LED — RGB controllers, auto-detected when plugged in):
 - Winbond:      VID=0x0416, PID=0x8001  (64-byte reports)
 """
 
+import logging
 import os
 import re
 import subprocess
@@ -25,6 +26,8 @@ from typing import List, Optional
 
 from .paths import find_scsi_devices as _find_sg_entries
 
+log = logging.getLogger(__name__)
+
 
 @dataclass
 class DetectedDevice:
@@ -164,9 +167,11 @@ def run_command(cmd: List[str]) -> str:
 def find_usb_devices() -> List[DetectedDevice]:
     """Find all USB LCD devices using lsusb"""
     devices = []
+    log.debug("Scanning USB devices via lsusb...")
     output = run_command(['lsusb'])
 
     if not output:
+        log.debug("lsusb returned no output")
         return devices
 
     # Parse lsusb output
@@ -192,6 +197,8 @@ def find_usb_devices() -> List[DetectedDevice]:
         # Get USB path
         usb_path = f"{int(bus)}-{device}"
 
+        log.debug("Found known device: %04X:%04X %s (%s)",
+                  vid, pid, device_info["vendor"], device_info.get("protocol", "scsi"))
         devices.append(DetectedDevice(
             vid=vid,
             pid=pid,
@@ -205,6 +212,7 @@ def find_usb_devices() -> List[DetectedDevice]:
             device_type=int(device_info.get("device_type", 1)),
         ))
 
+    log.debug("USB scan found %d known device(s)", len(devices))
     return devices
 
 
@@ -322,23 +330,29 @@ def find_scsi_usblcd_devices() -> List[DetectedDevice]:
 
 def detect_devices() -> List[DetectedDevice]:
     """Detect all USB LCD devices and their SCSI mappings"""
+    log.debug("Starting device detection...")
     devices = find_usb_devices()
 
     for device in devices:
         scsi_dev = find_scsi_device_by_usb_path(device.usb_path)
         device.scsi_device = scsi_dev
+        if scsi_dev:
+            log.debug("Mapped %04X:%04X → %s", device.vid, device.pid, scsi_dev)
 
     # If we found USB devices but none have SCSI mappings, try sysfs fallback
     if devices and not any(d.scsi_device for d in devices):
-        # Try to find sg device via sysfs and assign to first device
+        log.debug("No SCSI mappings found, trying sysfs fallback...")
         scsi_devices = find_scsi_usblcd_devices()
         if scsi_devices and scsi_devices[0].scsi_device:
             devices[0].scsi_device = scsi_devices[0].scsi_device
 
     # Fallback: scan SCSI devices directly for USBLCD if no USB devices found
     if not devices:
+        log.debug("No USB devices found, scanning SCSI directly...")
         devices = find_scsi_usblcd_devices()
 
+    log.info("Detected %d device(s): %s", len(devices),
+             ", ".join(f"{d.vendor_name} {d.product_name} [{d.protocol}]" for d in devices) or "none")
     return devices
 
 

{trcc_linux-1.2.0 → trcc_linux-1.2.2}/src/trcc/device_factory.py

@@ -18,10 +18,13 @@ Usage::
     protocol.send_led_data(colors, is_on, True, 100)     # LED devices
 """
 
+import logging
 from abc import ABC, abstractmethod
 from dataclasses import dataclass, field
 from typing import Callable, Dict, List, Optional, Tuple
 
+log = logging.getLogger(__name__)
+
 # =========================================================================
 # DeviceProtocol ABC — the contract both SCSI and HID implement
 # =========================================================================
@@ -134,6 +137,7 @@ class ScsiProtocol(DeviceProtocol):
     def send_image(self, image_data: bytes, width: int, height: int) -> bool:
         try:
             from .scsi_device import send_image_to_device
+            log.debug("SCSI send: %d bytes to %s (%dx%d)", len(image_data), self._path, width, height)
             success = send_image_to_device(self._path, image_data, width, height)
             self._notify_send_complete(success)
             return success
@@ -197,6 +201,7 @@ class HidProtocol(DeviceProtocol):
         """
         try:
             if self._transport is None:
+                log.debug("Opening HID transport: %04X:%04X (type %d)", self._vid, self._pid, self._device_type)
                 self._transport = self._create_transport()
                 self._transport.open()
                 self._notify_state_changed("transport_open", True)
@@ -207,9 +212,16 @@ class HidProtocol(DeviceProtocol):
             elif self._device_type == 3:
                 handler = HidDeviceType3(self._transport)
             else:
+                log.warning("Unknown HID device type: %d", self._device_type)
                 return None
 
             self._handshake_info = handler.handshake()
+            if self._handshake_info:
+                log.info("HID handshake OK: PM=%s, FBL=%s, resolution=%s",
+                         self._handshake_info.mode_byte_1, self._handshake_info.fbl,
+                         self._handshake_info.resolution)
+            else:
+                log.warning("HID handshake returned None")
             self._notify_state_changed("handshake_complete", True)
             return self._handshake_info
         except Exception as e:
@@ -518,14 +530,18 @@ class DeviceProtocolFactory:
         implementation = getattr(device_info, 'implementation', '')
 
         if protocol == 'scsi':
+            log.info("Creating ScsiProtocol for %s", device_info.path)
             return ScsiProtocol(device_info.path)
         elif protocol == 'hid':
             # LED devices use a different protocol than LCD HID devices
             if implementation == 'hid_led':
+                log.info("Creating LedProtocol for %04X:%04X", device_info.vid, device_info.pid)
                 return LedProtocol(
                     vid=device_info.vid,
                     pid=device_info.pid,
                 )
+            log.info("Creating HidProtocol for %04X:%04X (type %d)",
+                     device_info.vid, device_info.pid, getattr(device_info, 'device_type', 2))
             return HidProtocol(
                 vid=device_info.vid,
                 pid=device_info.pid,

{trcc_linux-1.2.0 → trcc_linux-1.2.2}/src/trcc/device_implementations.py

@@ -73,11 +73,21 @@ class LCDDeviceImplementation(ABC):
         """Delay between frames (seconds)"""
         return 0.0
 
+    @property
+    def pixel_byte_order(self) -> str:
+        """RGB565 byte order: '>' big-endian or '<' little-endian.
+
+        Windows TRCC ImageTo565 uses big-endian only for 320x320 (is320x320)
+        and SPIMode=2 (FBL 51/53). All other resolutions use little-endian.
+        """
+        if (self.width, self.height) == (320, 320):
+            return '>'
+        return '<'
+
     def rgb_to_bytes(self, r: int, g: int, b: int) -> bytes:
-        """Convert RGB to device pixel format"""
-        # RGB565 big-endian (default)
+        """Convert RGB to device pixel format (RGB565)."""
         pixel = ((r & 0xF8) << 8) | ((g & 0xFC) << 3) | (b >> 3)
-        return struct.pack('>H', pixel)
+        return struct.pack(f'{self.pixel_byte_order}H', pixel)
 
     def detect_resolution(self, device_path: str, verbose: bool = False) -> bool:
         """

{trcc_linux-1.2.0 → trcc_linux-1.2.2}/src/trcc/lcd_driver.py

@@ -5,12 +5,15 @@ Combines device detection with implementation-specific protocols.
 """
 
 import binascii
+import logging
 import os
 import struct
 import subprocess
 import tempfile
 from typing import Optional
 
+log = logging.getLogger(__name__)
+
 try:
     from .device_detector import DetectedDevice, detect_devices, get_default_device
     from .device_implementations import LCDDeviceImplementation, get_implementation
@@ -149,18 +152,23 @@ class LCDDriver:
         if self.initialized:
             return
         assert self.implementation is not None
+        log.debug("Initializing LCD device at %s", self.device_path)
 
         # Step 1: Poll device
         poll_cmd, poll_size = self.implementation.get_poll_command()
         poll_header = self._build_header(poll_cmd, poll_size)
+        log.debug("Poll: cmd=0x%X, size=0x%X", poll_cmd, poll_size)
         self._scsi_read(poll_header[:16], poll_size)
 
         # Step 2: Init
         init_cmd, init_size = self.implementation.get_init_command()
         init_header = self._build_header(init_cmd, init_size)
+        log.debug("Init: cmd=0x%X, size=0x%X", init_cmd, init_size)
         self._scsi_write(init_header, b'\x00' * init_size)
 
         self.initialized = True
+        log.info("LCD device initialized: %s (%s)", self.device_path,
+                 self.implementation.name if self.implementation else "unknown")
 
     def send_frame(self, image_data: bytes, force_init: bool = False):
         """
@@ -186,6 +194,7 @@ class LCDDriver:
             image_data += b'\x00' * (total_size - len(image_data))
 
         # Send chunks
+        log.debug("Sending frame: %d bytes in %d chunks", total_size, len(chunks))
         offset = 0
         for cmd, size in chunks:
             header = self._build_header(cmd, size)