# orba-protocol：重建 Artiphon Orba 2 控制消息

> orba-protocol 重建 Artiphon Orba 2 在 USB-MIDI 和 BLE-MIDI 上使用的控制协议。规范记录 SysEx 帧格式、编解码、CRC 和设备寄存器；Python 与 JavaScript 库可解码消息并构造设置命令。作者报告曾与抓包和设备实时响应进行比对。

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

## 使用条件与局限

- **前提条件：**实时控制需要 Artiphon Orba 2 设备。
- **前提条件：**Python 实现需要 Python 3.8 或更新版本；JavaScript 模块可在浏览器或 Node 中运行。
- **局限：**规范中标为 snoop 的项目仍需应用内抓包才能确定准确的枚举字节。
- **许可：**代码采用 MIT 许可证，规范另以 CC BY 4.0 授权。

## 一手来源

1. <https://github.com/holofermes/orba-protocol/blob/055610bc357fb5abf1fbb539f97fdb679e9d240c/spec/SPEC.md>
2. <https://github.com/holofermes/orba-protocol/blob/055610bc357fb5abf1fbb539f97fdb679e9d240c/README.md>

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

- [TrikiEmu：重建 Żabka Triki BLE 控制器](https://awesomerea.org/zh/resources/trikiemu-zabka-triki-case/index.md) · 案例
- [TrikiScope：解码 Żabka Triki 的 BLE 运动数据流](https://awesomerea.org/zh/resources/trikiscope-zabka-triki-case/index.md) · 案例
- [G2CC：基于蓝牙流量分析重建 Even G2 客户端](https://awesomerea.org/zh/resources/g2cc-even-g2-client-case/index.md) · 案例
- [Melitta Barista & Nivona：重建咖啡机 BLE 控制协议](https://awesomerea.org/zh/resources/melitta-barista-nivona-ha-case/index.md) · 案例
- [OpenHX：重建 Line 6 HX 的 USB 预设控制](https://awesomerea.org/zh/resources/openhx-case/index.md) · 案例
- [BunATV：用 TypeScript 重建 Apple TV 控制协议](https://awesomerea.org/zh/resources/bunatv-apple-tv-protocol-case/index.md) · 案例

## 关于此条目

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