Initial HyperX Eve 1800 SignalRGB plugin and protocol tools

Working 10-zone plugin using the 0x44 live colour reports on the 0xFF90 vendor interface (data then commit). Includes Python tools used to identify the device, confirm the protocol and map zones. Output is dimmer than onboard effects; investigation pending. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01EcbUcbNpyPn7cGpe4t6y5y
2026-10-25 16:45:27 -07:00
commit 5f36610a60
@@ -0,0 +1,20 @@
+# HyperX Eve 1800 — SignalRGB plugin
+
+Work-in-progress SignalRGB plugin for the HyperX Eve 1800 (USB `03F0:08C2`).
+
+**Status:** working — all 10 zones respond to SignalRGB effects. Known issue: lighting is much dimmer than the keyboard's onboard effects (cause not yet found; see below).
+
+## Install (manual)
+Copy `HyperX_Eve_1800.js` to `Documents\WhirlwindFX\Plugins\` and restart SignalRGB.
+
+## Protocol (as found so far)
+Vendor HID interface 2, usage page `0xFF90`, 64-byte reports.
+- `44 02 <chunk> 00` + 10 × RGB — colour data (zones left → right)
+- `44 01 <chunk count>` — apply; must be sent **after** the data
+- Live/volatile only — nothing is written to onboard memory.
+
+## Open issues
+- **Dim output.** Not SignalRGB's global brightness. Next step: run `tools/brightness_ab.py` (SignalRGB closed) to see if update rate affects brightness; check Fn+arrow brightness keys; else capture NGENUITY's brightness command with USBPcap.
+
+## tools/
+Python test scripts (`pip install hidapi`): `enumerate.py`, `descriptor.py`, `test_color.py`, `zone_probe.py`, `zone_walk.py` (results in `zone_map.json`), `brightness_ab.py`, shared helpers in `eve.py`.