Draft: Add Acer Predator Helios 16 (PH16-7x) keyboard, light bar and LampArray controllers

Raya Elena Solanorequested to merge
TensorRaya/OpenRGB:acer-predator-helios-16 into master

Summary

Adds controllers for all four lighting zones of the Acer Predator Helios 16 (PH16-71/72/73). Tested on a PH16-73.

Zone Device Protocol Modes
Keyboard 05AF:667B Jing-Mold/Sunrex (or 04F2:0117 Chicony), interface 3 Acer vendor feature reports + 512 B per-key frame Direct (128 LEDs), Static, Breathing, Rainbow, Snake, Ripple, Neon, Rain, Explosion, Pulse, Stars, Meteor, Aura, Off
Front light bar "InfiniteRing" 0D62:A20A Darfon, interface 0 same vendor protocol Static, Breathing, effects, Off
Lid logo 0D62:A00A Darfon "Cover Logo", interface 1 standard HID LampArray (14 lamps) Direct, Firmware
Rear glass bar 0D62:A00A Darfon "Cover Logo", interface 2 HID LampArray (16 lamps) Direct, Firmware

The vendor protocol is taken byte-for-byte from the PredatorSense USBPcap captures @roosterduck posted in #4158 (88 begin, B1/12 mode, 14 colour, 08 apply, inverted-sum checksum). Speed byte (1 fast … 9 slow) and brightness verified on hardware.

Full protocol write-up, descriptor dumps and a stand-alone Python reference: https://github.com/TensorRaya/acer-predator-helios-rgb

Notes for review

  • Detectors are interface-specific (REGISTER_HID_DETECTOR_I / _IPU) so the keyboard's HID interfaces 0–2 are not picked up.
  • The Darfon LampArray firmware NAKs GET_REPORT for a short window after a write, so the attributes read retries with back-off (0/40 failures vs. ~1/10 without).
  • Per-key cell → key mapping is not known yet; Direct mode exposes the 128 cells as a linear zone. Happy to add a keyboard layout once someone maps it.
  • Not touched: the WMI path (acer-wmi four-zone) — accepted by firmware but drives nothing on this model — and the ENE 0CF2:5130 that the Nitro controller uses; it exists on the Helios but no LED is attached to it.

Testing

  • All four devices detected and colour-verified on a PH16-73 (Linux 6.17, hidapi/hidraw)
  • Static / Breathing / speed / brightness / Off on keyboard and light bar
  • Direct + Firmware on logo and glass bar
  • Per-key frame (all cells one colour)
  • Windows / macOS — not available to me

Closes #4158

Merge request reports