r/linuxhardware • u/emirdev_mo • 2h ago
Product Announcement Getting Windows-only USB gadgets (AIO LCDs, RGB hubs, case screens) working on Linux from a USB capture
A lot of the hardware I see people ask about here works fine on Linux at the USB level, the only thing missing is the vendor app: AIO coolers with an LCD, RGB controllers, fan hubs, little case screens. Getting one working usually means the same manual routine: capture the vendor app on Windows with USBPcap (or usbmon in a VM), then diff hex until you find which bytes are the brightness, the fan speed or the image header.
I got tired of doing that by hand, so I built usb-rea. You capture while using the vendor app, write down what you changed and when ("brightness 20, 50, 100"), and it groups the packets into commands, finds the constant headers, counters, value fields and checksums, and writes a Markdown protocol report plus a small pyusb driver you can try on Linux. It also tells continuous image streams (JPEG or raw RGB565 frames for LCDs) apart from the actual commands, which was the thing that kept tripping me up on cooler screens.
Before decoding anything, it checks the VID:PID against devices that already have an open source Linux driver (liquidctl, OpenRGB, the Thermalright and Turing screen projects and others), because often the answer is "this is already supported, use X".
A real example: someone on the liquidctl tracker shared a USBPcap capture of an ASUS TUF LC III LCD. usb-rea found the brightness command on EP 0x01 and the JPEG frame stream with its per-frame ack on EP 0x03. That capture also exposed two bugs in my parser, which are now fixed and the trimmed capture is a test case. Write-ups of that and a few other devices are in docs/case-studies.
It is MIT licensed, pip install usb-rea, Linux and Windows captures both work. Honest limits: it is still alpha, it needs labelled captures to infer value fields, and a matching USB ID does not prove your unit speaks the same protocol, so read the report before writing to a device.
Repo: https://github.com/emirmrkaljevic/usb-rea
If you have a Windows-only USB gadget you would like on Linux, I am happy to look at a capture.
