Skip to main content
本指南面向希望自己的硬件与 Elata SDK 配合使用的设备厂商。 目标很简单:你的设备应接入共享的 Elata 传输层边界,并输出应用可以信赖的稳定数据帧。

从协议开始

在编写适配器代码之前,先查看共享的帧和传输类型。

检查浏览器支持

先确认 Web Bluetooth、浏览器和平台方面的限制。

你要构建的内容

一个可用于生产的集成应做好三件事:
  1. 可靠地连接
  2. 以稳定、可预测的格式输出数据帧
  3. 当设备、浏览器或无线链路异常时能干净地恢复
用 Elata 的术语来说,就是统一采用 HeadbandTransport 和 HeadbandFrameV1,而不是直接暴露厂商特定的数据包格式。
应用应依赖共享的 Elata 传输协议,而不是厂商的原始数据包。这样可以让下游集成保持简单,也让设备支持更易于维护。

快速路径

1

选择集成路径

决定你的设备应放在上游的 eeg-web-ble 中、单独的包中,还是应用本地的适配器中。尽早使用集成路径做出决定。
2

整理协议清单

收集 GATT 服务、特征值、数据包格式、采样率、通道名称、时间戳行为和已知的固件问题。参见协议要求。
3

实现适配器

构建负责发现、会话建立、数据包解码和帧输出的设备层。从适配器实现开始。
4

验证可靠性

在调优下游之前,先测试连接、开始、停止、断开、畸形数据包、重连以及帧的正确性。参见测试与验证。
5

准备交付

将集成与平台说明、已测试的固件版本和支持预期一起打包。参见提交与支持。

开始前需要准备

如果你还没有了解当前的 BLE 流程,请先阅读 EEG BLE 快速上手。

指南地图

集成路径

选择集成代码的存放位置和归属方式。

传输协议

你的设备必须满足的共享接口。

协议要求

编码前需要收集的协议和元数据清单。

适配器实现

构建设备适配器并将其连接到 BleTransport。

测试与验证

确保集成在正常和故障情况下都可靠。

提交与支持

附上合作方所需的文档和注意事项完成交付。

可靠性优先

设备集成并不是在理想情况下能输出一次数据就算完成。 满足以下条件才算完成:

相关文档

下一步

选择集成路径

在编码前选择合适的归属和打包方式。

查看传输协议

确认你的适配器必须满足的帧和生命周期要求。