# 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`.