mangavalkandClaude Opus 5.5 ba56c6f8de Add Womier K87 SignalRGB plugin and LED mapping tools
Per-key RGB for the wired Womier K87 (EVision firmware, 320F:502A) using the
EVision protocol, with the 87-key LED map found by hand.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-28 23:05:05 +01:00

Womier K87 SignalRGB plugin

SignalRGB plugin for the wired Womier K87 with EVision firmware (USB 320F:502A). SignalRGB's built-in EVision plugin speaks the same protocol but does not list this product ID or have a K87 layout, so the keyboard is ignored without this plugin.

Install

Copy Womier_K87_EVision.js to %USERPROFILE%\Documents\WhirlwindFX\Plugins\ and restart SignalRGB.

Protocol

  • HID interface 1, usage page 0xFF1C, usage 0x92 (collection 4), 64-byte output reports.
  • Colour frame: packets of [0x04, sumLo, sumHi, 0x12, len(56), offLo, offHi, 0x00, ...56 RGB bytes], where the checksum is the 16-bit sum of bytes 3..63. 7 packets cover LED slots 0..127.
  • The keyboard falls back to its own effect when frames stop, so colours must be streamed.

LED map

LED index = column * 8 + row (same scheme as SignalRGB's Redragon K557 layout, minus the numpad). Exceptions: Page Up 115, Page Down 123, bottom row Space 45, Right Alt 77, Fn 85, Menu 93, Right Ctrl 101, arrows 109 / 117 / 125.

Tools

  • tools/hidcaps.ps1 lists the keyboard's HID collections with usage page/usage and report sizes.
  • tools/evision_led.ps1 sends test frames straight to the keyboard, e.g. evision_led.ps1 -Leds "0=ff0000,21=00ff00" -Seconds 60 lights LED 0 red and 21 green for a minute. Used to map the LEDs; quit SignalRGB first so the two don't fight over the device.
S
Description
No description provided
Readme
57 KiB
0 Stars 1 Watchers 0 Forks
Languages
JavaScript 51.6%
PowerShell 48.4%