superx-goes-arch/docs/research-summary.md

Research Summary: OneXplayer Super X / RGB / Frostbay

Stand: 2026-05-25

Kurzfazit

Das brauchbarste Einfallstor ist gerade nicht die interne RGB-Leiste, sondern Frostbay. Dafür gibt es inzwischen:

• ein OEM-Firmware-/Debug-Paket in deinem Downloads-Ordner
• konkrete BLE-UUIDs
• ein frisches Community-Repo mit Linux-/BlueZ-Erkenntnissen
• eine offene hhd-PR für ein Frostbay-Plugin

Für die interne Super-X-RGB-/Keyboard-Steuerung gibt es dagegen noch kein klar bestätigtes fertiges Linux-Tooling. Es gibt aber verwandte OXP-/hhd-/Kernel-Arbeit, die uns beim Reverse Engineering hilft.

Web-Funde mit hoher Relevanz

hhd / laufende Entwicklung

• hhd Issue: Fan Controls for OneXPlayer Super X

  • https://github.com/hhd-dev/hhd/issues/303
  • Aussage: "Everything in HHD works quite well for the new Super X device. However, there are currently no fan controls."
  • Kommentar verweist direkt auf Linux-Kernel-Datei oxpec.c und EC-Registerabgleich.

• hhd PR: Add Frostbay cooling plugin

  • https://github.com/hhd-dev/hhd/pull/321
  • Beschreibung nennt explizit Apex und Super-X/Super-V.
  • Wichtige Probleme laut PR:
    1. eingebauter Bluetooth-Adapter des Apex arbeitet mit BlueZ/Frostbay derzeit unzuverlässig
    2. Frostbay erzeugt unter Linux ein HID-Keyboard/Consumer-Control-artiges Gerät mit nervigem Volume-Down-Fehler

• hhd PR: oxp: enable secondary RGB LED support for hid_v1 protocol

  • https://github.com/hhd-dev/hhd/pull/239
  • zeigt, dass in hhd bereits sekundäre RGB-LEDs bei OXP-nahen Geräten aktiv Thema sind
  • macht aber NICHT automatisch Super-X-internes RGB gelöst

Community-Repo Frostbay

• https://github.com/tbitu/onexplayer-frostbay-bluetooth
• README beschreibt den Frostbay-BLE-Stack als Entwicklerreferenz
• dort festgehalten:
  • FFE0/FFE1-GATT-Pfad
  • BlueZ-/D-Bus-Nutzung unter Linux
  • Problem mit eingebautem BT-Adapter vs. externem Adapter
  • HID-/Volume-Up/Volume-Down-Nebenwirkung und hwdb-Mitigation

Linux-Kernel / OXP-EC-Pfad

• https://github.com/torvalds/linux/blob/master/drivers/platform/x86/oxpec.c
• Datei beschreibt OneXPlayer-/AOKZOE-Platform-Treiber
• nennt u.a.:
  • Fan/PWM-Skalierung für verschiedene Generationen
  • X1 Turbo LED Register
  • DMI-Quirks / EC-Zugriff
• Relevanz: Super-X-Fan-/EC-Themen sind im OXP-Kosmos nicht komplett exotisch

OpenRGB

• Keine belastbaren Treffer für fertigen OpenRGB-Support speziell für OneXplayer Super X.
• Für unser Gerät also aktuell eher nein/unklar als "läuft schon".

Lokale OEM-Artefakte: wichtigste Erkenntnisse

Frostbay-ZIP

Datei:

• /home/nepharius/Downloads/frostbay firmware.zip

Wichtige Inhalte im Archiv:

• BLE-FW-TOOL.exe
• BLEDebug.EXE
• coolingsystem_debugger.html
• CoolingSystem_ONEC1_V08.bin
• FWConfig.ini
• HIDFirmwareUpgrad.exe
• CH375DLL64.dll
• WCHBLEDLL.dll
• 接口.C

Wichtige Befunde:

• Produktname: CoolingSystem_ONEC1
• Firmware enthält String CH32V20x_BLE_LIB_V1.4
  • wirkt sehr nach WCH/CH32V20x-BLE-MCU
• HTML-Debugger nennt:
  • Service UUID 0000ffe0-0000-1000-8000-00805f9b34fb
  • Characteristic UUID 0000ffe1-0000-1000-8000-00805f9b34fb
  • Bluetooth-Gerätename CoolingSystem_ONEC1
• Protokoll ist 64-Byte-orientiert
• RGB-relevante Bytes aus OEM-Code:
  • state[16] = 0xFD für RGB-Schalter/Frequenz/Helligkeit
  • state[16] = 0xFE für Custom RGB
  • state[17..19] für Schalter/Frequenz/Helligkeit oder RGB-Werte je nach Modus
• drei Lichtkanäle/Stripes im Frostbay-Code sichtbar:
  • Bit 0 = Strip 1
  • Bit 1 = Strip 2
  • Bit 2 = Strip 3

Super-X-Driverbundle-ZIP

Datei:

• /home/nepharius/Downloads/HH-GA25-SUPERX-Devices_V1.0.zip

Eindruck:

• normales Windows-Treiberbundle
• kein klarer Frostbay-/ONEC1- oder Keyboard-RGB-Treiber drin gefunden
• WCH dort nur als USB-NIC-Kontext auffällig, nicht als offensichtlicher RGB-Treiber

Einschätzung je Baustelle

1) Frostbay unter Arch/COSMIC

Status: am greifbarsten

Warum:

• OEM-Tool vorhanden
• Community-Protokoll vorhanden
• hhd-Plugin in Arbeit
• Linux-Pfad via BlueZ/D-Bus scheint realistisch

Wahrscheinlichster Linux-Ansatz:

1. BlueZ-Device für CoolingSystem_ONEC1 sauber sichtbar machen
2. ServicesResolved=true und FFE1 finden
3. per D-Bus ReadValue / WriteValue nutzen
4. ggf. eingebauten BT-Adapter meiden und Test mit externem Dongle machen
5. nerviges HID-Volume-Device per hwdb neutralisieren

2) Interne RGB-Stripes / Keyboard-RGB

Status: noch Nebel

Was wir wissen:

• deine Ersatzstripes sind WS2812B
• laut dir vermutlich Board-Anschluss RGB2
• hhd kennt sekundäre RGB-LEDs bei verwandten OXP-Protokollen
• aber: das beweist nichts für Super X

Was noch fehlt:

• welcher Transport ist echt?
  • vendor HID?
  • EC?
  • ACPI/WMI?
  • Hilfs-MCU?
• welche USB-/HID-IDs und Report-Formate nutzt Super X live?
• ob interne RGB und Keyboard über denselben oder getrennte Pfade laufen

Meine ehrliche Priorisierung

1. Frostbay zuerst linuxfähig machen
2. danach Super-X-HID/EC sauber mappen
3. erst dann interne RGB aktiv anfassen

Das ist der Weg mit dem besten Signal-Rausch-Verhältnis. Alles andere wäre eher Voodoo mit LEDs.