{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/holofermes/orba-protocol/blob/055610bc357fb5abf1fbb539f97fdb679e9d240c/README.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "orba-protocol reconstructs the Artiphon Orba 2 control protocol across USB-MIDI and BLE-MIDI. Its specification maps SysEx framing, codec, CRC and device registers, while Python and JavaScript libraries decode messages and build commands for device settings. The author reports comparing the implementation with captured traffic and live responses.",
  "description_zh": "orba-protocol 重建 Artiphon Orba 2 在 USB-MIDI 和 BLE-MIDI 上使用的控制协议。规范记录 SysEx 帧格式、编解码、CRC 和设备寄存器；Python 与 JavaScript 库可解码消息并构造设置命令。作者报告曾与抓包和设备实时响应进行比对。",
  "entry_url": "https://awesomerea.org/resources/orba-protocol-artiphon-orba-2-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/orba-protocol-artiphon-orba-2-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/holofermes/orba-protocol/blob/055610bc357fb5abf1fbb539f97fdb679e9d240c/spec/SPEC.md",
  "group": "cases",
  "id": "orba-protocol-artiphon-orba-2-case",
  "json_url": "https://awesomerea.org/resources/orba-protocol-artiphon-orba-2-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/orba-protocol-artiphon-orba-2-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/orba-protocol-artiphon-orba-2-case/index.md",
  "name": "orba-protocol: reconstructing Artiphon Orba 2 control messages",
  "name_zh": "orba-protocol：重建 Artiphon Orba 2 控制消息",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "An Artiphon Orba 2 is required for live device control.",
    "The Python reference requires Python 3.8 or later; the JavaScript module runs in a browser or Node.",
    "Some specification items marked snoop still require an in-app capture to determine exact enum bytes.",
    "Code is MIT licensed; the specification is additionally CC BY 4.0 licensed."
  ],
  "requirements_zh": [
    "实时控制需要 Artiphon Orba 2 设备。",
    "Python 实现需要 Python 3.8 或更新版本；JavaScript 模块可在浏览器或 Node 中运行。",
    "规范中标为 snoop 的项目仍需应用内抓包才能确定准确的枚举字节。",
    "代码采用 MIT 许可证，规范另以 CC BY 4.0 授权。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/holofermes/orba-protocol",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}
