# MacroPad：重建 USB 宏键盘配置协议

> MacroPad 重建了 USB ID 为 1189:8840 的 12 键双旋钮宏键盘的 HID 配置交互，并提供 Linux 图形客户端。作者记录了用 usbmon 抓取 MINI_KEYBOARD.exe 流量、解析配置与提交报告，以及在测试中重放抓包数据的过程。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-06
- 收录于：2026-11-06
- 原始资源：<https://github.com/Probler-Yt/MacroPad>
- 一手来源：<https://github.com/Probler-Yt/MacroPad/blob/2b75543c74727427ea4f3cc1d3c720fbd56fc438/docs/protocol.md>
- 目录页面：<https://awesomerea.org/zh/resources/macropad-usb-protocol-case/>
- 记录 JSON：<https://awesomerea.org/resources/macropad-usb-protocol-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/macropad-usb-protocol-case/index.md)

## 使用条件与局限

- **前提条件：**受支持的配置方式需要 Linux、Python 3.9 及以上和 USB ID 为 1189:8840 的宏键盘。
- **局限：**其他设备 ID 在布局和协议加入前会被标为不支持。
- **许可：**GPL-3.0 许可证。

## 一手来源

1. <https://github.com/Probler-Yt/MacroPad/blob/2b75543c74727427ea4f3cc1d3c720fbd56fc438/docs/protocol.md>
2. <https://github.com/Probler-Yt/MacroPad/blob/2b75543c74727427ea4f3cc1d3c720fbd56fc438/README.md>

## 同分区更多条目：协议

- [Monix：在 Linux 上重建 Audient iD USB 混音器控制](https://awesomerea.org/zh/resources/monix-audient-id-case/index.md) · 案例
- [Scooter Link：基于 BLE 协议研究的小米滑板车客户端](https://awesomerea.org/zh/resources/scooter-link-case/index.md) · 案例
- [Sound Blaster AE-9：通过 Windows 驱动分析重建 Linux 控制](https://awesomerea.org/zh/resources/sb-ae9-case/index.md) · 案例
- [thermalmaster：ThermalMaster 热像仪 USB 协议的 Go 客户端](https://awesomerea.org/zh/resources/thermalmaster-case/index.md) · 案例
- [open-rknpu：Rockchip NPU 任务程序还原](https://awesomerea.org/zh/resources/open-rknpu-case/index.md) · 案例
- [hardsid4u：还原 HardSID 4U USB 协议](https://awesomerea.org/zh/resources/hardsid4u-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。