USB-REA

•
153
•

Reverse-engineer USB gadget traffic, infer proprietary protocols from packet captures, and automatically generate open-source Python and libusb drivers.

USB-REA streamlines the process of reverse engineering proprietary USB peripherals by analyzing packet captures recorded via usbmon or USBPcap. By diffing host-device traffic against labeled user actions, it automatically infers command layouts, linear values, lookup tables, bitfields, rolling counters, handshakes, and checksums. The tool generates comprehensive Markdown reports linking each conclusion to frame numbers, crafts standalone pyusb drivers, and exports Wireshark Lua dissectors, providing developers and hardware hackers with an automated pipeline available via a CLI or an integrated MCP server.

主要功能

01Bidirectional traffic decoding to pair host queries with device responses, status polls, and named sensor readings
02Automatic protocol inference for linear values, bitfields, lookup tables, counters, and various checksum algorithms
03Automated driver generation producing standalone, working pyusb and libusb Python drivers
04Dual interface operating as a headless CLI utility or an interactive Model Context Protocol (MCP) server
05Wireshark Lua dissector generation to simplify future capture analysis directly within Wireshark
0615 GitHub stars

使用案例

01Developing open-source Linux drivers for Windows-only USB peripherals like AIO coolers, RGB controllers, and input devices
02Decoding proprietary status polling mechanisms and sensor telemetry such as RPM, temperatures, and battery levels
03Analyzing unknown USB hardware protocols from pcap or pcapng packet captures without physical hardware access