OpenProtocol-HPA

HPA 电子设备的 通用语言。

Open-HPA 是一个开放协议,让 HPA 气动枪的 FCU、遥控器和配件能够通过 Bluetooth 或 WiFi 与任何 App 通信。无需编程器,无需线缆,也不依赖任何封闭工具。

Open-HPA V3 hatBlatCyclope ThermalShieldOpen-HPA Universal LCD

4 款设备均已支持 Open-HPA

已连接 FCU 的详情页,显示模式、配置、电量和射击计数

什么是 Open-HPA

每家 HPA FCU 厂商都有自己的编程器、线缆和 App。Open-HPA 的想法正好相反:一个唯一、开放且有文档的协议,描述每台设备是什么、发布哪些状态、接受哪些设置、支持哪些动作。

这份描述保存在 JSON 目录中。App、遥控器或网页读取目录后,无需更新自身,就知道如何与新的电路板、新的命令或新版本的固件通信。安全逻辑始终保留在设备固件中。

声明式目录

每台设备都在 device.json 中描述:状态、各设置及其上下限、分组、动作、配置和固件。新增支持不需要发布新 App。

Bluetooth LE 与 WiFi

同一套数据模型,可经 GATT 或设备自身 WiFi 传输(REST + WebSocket)。无需联网、无需账号:一切尽在本地。

可移植配置

JSON 配置(open-hpa-config / open-hpa-profile)可导出、分享,并上传到另一台兼容设备。

可信 OTA 更新

每块电路板的固件版本都带有 sha256 和 magic byte,刷写前还要逐项核对安全清单:松开扳机、接好电池并处于保险(SAFE)状态。

整个系统如何协作

  1. 1 · 设备FCU 或配件按照协议发布自身状态并接收命令。
  2. 2 · 目录一个 JSON 文件描述设备:可以读取什么、可以调整什么、上下限是多少。
  3. 3 · 客户端HPA Commander、Apple Watch 或 Universal LCD 都根据目录生成自己的界面。

生态设备档案

已支持 Open-HPA 或已收录进目录的设备,全部由 Sychev-Lab 设计与开发。

App:HPA Commander

协议的官方参考客户端。发现你的设备,实时查看状态,调整参数,并通过 iPhone、Apple Watch 或 Android 更新固件。

即将推出App Store即将推出Google Play

常见问题

什么是 Open-HPA?

一个开放协议和 JSON 目录,描述如何通过 Bluetooth LE 和 WiFi 控制 airsoft HPA 的 FCU、遥控器与配件;此外还有一系列采用它的设备和一款 App。

它是开源的吗?

协议规范发布在 GitHub 上(OpenProtocol-HPA)。每台设备的固件和硬件则遵循各自的许可协议。

需要联网或注册账号吗?

不需要。App 通过 Bluetooth 或设备自建 WiFi 与设备直接通信,只有下载目录和固件时才需要联网。

我可以制作自己的兼容电路板吗?

可以,这正是它的意义所在。只要你的固件实现了该协议并发布对应的 device.json,任何 Open-HPA 客户端都能控制它。

App 什么时候上架?

HPA Commander 正在 App Store 和 Google Play 审核中。审核通过后,下载链接会第一时间出现在本页。

HPA CommanderHPA CommanderBLE · WiFi · OTA