Thermaltake TT Premium X1 RGB support

hda_gitlabrequested to merge
hda_gitlab/OpenRGB:master into master

Initial commit for Thermaltake TT Premium X1 RGB

This merge request adds native OpenRGB support for the Thermaltake TT Premium X1 RGB keyboard.

Changes:

  • Adds detection for USB VID 0x264A / PID 0x3013.
  • Selects the RGB HID collection on interface 1, usage page 0xFF00, usage 0x0001.
  • Implements the validated X1 connection initialization sequence.
  • Implements Static RGB mode.
  • Implements Direct per-key RGB mode for 110 protocol LED slots.
  • Implements brightness control for Static mode.
  • Adds the physically validated X1 LED naming and protocol order.
  • Adds X1-only “Import Layout” and “Reset Layout” actions to the OpenRGB device page.
  • Layout JSON import accepts the Thermaltake TT Premium X1 RGB 110-LED format and applies colors through Direct mode.
  • Adds generated udev metadata for 264A:3013 through OpenRGB’s standard udev-rule generator.

Protocol evidence:

  • Based on public USB captures from OpenRGB issue #753: #753
  • Static RGB and Direct per-key behavior were validated on physical Linux hardware.
  • Brightness levels were validated on physical Linux hardware.
  • The controller avoids PID 0x3012 and does not implement firmware update or recovery operations.

Testing:

  • Linux physical testing performed on Ubuntu with the Thermaltake TT Premium X1 RGB.
  • Static Red, Green, Blue, White, and Off were verified.
  • Direct mode was verified with independent colors on multiple physical keys.
  • Brightness levels were verified.
  • The controller builds successfully on Linux using Qt6/QMake.
  • A Linux AppImage was built from this backported source tree.

Known limitations:

  • Hardware effects other than Static, Direct, and brightness are not claimed as fully verified.
  • Full Windows hardware validation has not been performed by this development environment.
  • Physical LED mapping contains unrecorded/unknown entries documented in the controller source.

Related references:

Checklist:

  • The source branch of the merge request is not protected.
  • The New Device issue is linked to this MR with a keyword such as “Implements”.
  • There is a device protocol page in the Developer Wiki or sufficient protocol captures in the issue.
  • Metadata for the device is included in the RGBController file.
  • This device is detected and working on Windows 10 and/or 11.
  • This device is detected and working on Linux. Tested with the physical keyboard on Ubuntu Linux.
  • Logging for Info, Warnings, and Errors has been added for troubleshooting purposes.

Merge request reports