danielknng/push3-protocol-docs
GitHub: danielknng/push3-protocol-docs
对 Ableton Push 3 硬件控制器通信协议进行逆向工程的开源技术文档，涵盖 USB 显示屏、MIDI 映射、SysEx 命令等完整协议细节及配套验证工具。
Stars: 13 | Forks: 1
# push3-protocol-docs
Ableton Push 3 的逆向工程协议文档。Ableton 未发布任何官方 API - 本项目涵盖了 USB 显示屏协议、MIDI 映射、打击垫灵敏度曲线、SysEx 命令、MPE 以及音频接口配置。
## 文档
- [快速入门](docs/quickstart.md) - 打开端口，进入用户模式，点亮打击垫，记录按压事件
- [显示屏协议](docs/display-protocol.md) - USB framebuffer、加密、图像准备、发送帧
- [按钮映射](docs/buttons.md) - 全部 70 多个按钮及其 CC 值
- [旋钮映射](docs/encoders.md) - 10 个旋钮、触摸检测、旋转值、触摸条
- [SysEx 协议](docs/sysex.md) - 打击垫灵敏度曲线、MPE、触摸条模式、音频接口
## 工具
[tools/](tools/) 中的研究与测试脚本。需要 `pyusb`、`pillow`、`mido`、`python-rtmidi`。
- `display_test.py` - 将图像推送到显示屏
- `text_renderer.py` - 生成带有文本的显示屏帧
- `midi_monitor.py` - 实时记录传入的 MIDI 信息
- `midi_test.py` - 测试 LED 输出和 SysEx
有关设置和使用方法，请参阅 [tools/README.md](tools/README.md)。
感谢。
Push 2 信息参考了 [DrivenByMoss](https://github.com/git-moss/DrivenByMoss) 和 Ableton 官方的 Push 2 文档。
标签：Ableton Push 3, MIDI控制器, MIDI映射, mido, MPE, pillow, Python, python-rtmidi, pyusb, SysEx, USB通信, 云资产清单, 协议分析, 嵌入式开发, 帧缓冲, 开发文档, 开源文档, 数据解密, 无后门, 权限提升, 硬件接口, 硬件黑客, 逆向工具, 逆向工程, 音乐技术, 音频接口