Mark-A-Richardson/activ8rlives-body-analyser-protocol
GitHub: Mark-A-Richardson/activ8rlives-body-analyser-protocol
针对已停产的 Activ8rlives 体脂秤的净室 BLE 协议文档，旨在解决官方应用不可用后硬件设备的持续互操作问题。
Stars: 0 | Forks: 0
# Activ8rlives Body Analyser 协议
[](LICENSE)
这是一份关于 Activ8rlives Body Analyser 体重秤所使用的 Bluetooth Low Energy 协议的独立、净室描述。
## 本项目存在的原因
最初的配套应用程序已无法通过英国 iOS App Store 安装，导致原本功能正常的体重秤失去了上传新读数的支持方式。与 Activ8rlives 产品线相关的公司 Aseptika Limited 已于 [2026 年 1 月 19 日解散](https://find-and-update.company-information.service.gov.uk/company/06425174)。
体重秤本身仍然可以完美工作：它们会唤醒，通过 BLE 进行广播，接收用户配置数据包，进行测量，并返回体重和身体成分数据。本项目旨在保持与这类旧硬件的互操作性。其目标是进行协议文档化，而不是重新分发或重建专有软件或云服务。
## 当前状态
基本的通信序列已在物理硬件上重现：
1. 扫描体重秤并连接。
2. 发现厂商服务 `FFF0`。
3. 订阅 `FFF4` 上的通知。
4. 将八字节的配置文件帧写入 `FFF1`。
5. 接收以 `CF` 开头的 16 字节测量通知。
体重解码已与体重秤显示屏进行核对。其余身体成分字段名称是合理的初步解释，并在[协议规范](docs/protocol.md)中根据置信度进行了明确标注。欢迎提供额外的受控抓包数据。
## BLE 快速参考
| 角色 | UUID | 属性 |
| --- | --- | --- |
| 体重秤服务 | `FFF0` | 主服务 |
| 手机到体重秤 | `FFF1` | 写入 |
| 体重秤到手机 | `FFF4` | 通知 |
```
sequenceDiagram
participant C as "Compatible client"
participant S as "Body Analyser scale"
S-->>C: Advertise while awake
C->>S: Connect and discover FFF0
C->>S: Subscribe to FFF4 notifications
Note over S: Bluetooth indicator becomes solid
C->>S: Write profile frame to FFF1
Note over S: User stands barefoot and measurement stabilizes
S-->>C: Notify FFF4 with CF measurement frame
C->>S: Disconnect
```
## 文档
- [协议规范](docs/protocol.md)
- [逆向工程方法论](docs/methodology.md)
- [已清理的抓包数据与合成示例](captures/README.md)
- [实施路线图](docs/implementation-roadmap.md)
- [法律与净室声明](docs/legal.md)
- [贡献规则](CONTRIBUTING.md)
## 未来的净室实现
- [ ] 发现并连接兼容的体重秤。
- [ ] 在开始测量前订阅 `FFF4`。
- [ ] 构建并发送 `FFF1` 配置数据包。
- [ ] 解码并验证测量数据包。
- [ ] 通过受控抓包确认每个身体成分字段。
- [ ] 在获得明确许可的情况下，将支持的测量结果保存到 Apple Health。
- [ ] 将所有处理过程保留在本地设备上。
- [ ] 无需账户、分析、订阅或云服务。
- [ ] 添加仅基于合成数据或经贡献者批准的数据包的可回放测试。
## 仓库结构
```
.
├── captures/ Sanitized observations and synthetic examples
├── docs/
│ ├── implementation-roadmap.md
│ ├── legal.md
│ ├── methodology.md
│ └── protocol.md
├── .github/ Issue and pull-request templates
├── CONTRIBUTING.md
├── LICENSE
├── README.md
└── SECURITY.md
```
## 法律声明
这是一个独立的社区互操作性项目。它不隶属于 Activ8rlives、Aseptika 或其继承者，也未获得其授权、赞助或认可。产品和公司名称仅用于识别兼容硬件。请参阅[完整的法律声明](docs/legal.md)。
本项目不是医疗设备，也不提供任何医疗建议。请勿将实验性软件作为健康或治疗决策的唯一依据。
## 许可证
本仓库中的原创材料基于 [MIT License](LICENSE) 提供。该许可证涵盖本项目的原创文档和未来的原创代码；它不授予任何第三方商标或专有软件的权利。
标签：云资产清单, 协议文档, 智能体脂秤, 物联网, 硬件互操作, 蓝牙低功耗, 逆向工程, 防御加固