# whoop4-ble：重建 Whoop 4.0 传感数据访问

> whoop4-ble 用 Python 客户端重建对 Whoop 4.0 传感记录的直接 BLE 访问。它记录命令帧、CRC 与历史数据导出流程；作者报告五字节 SET_CLOCK 载荷可修复停滞的闪存记录。工具可导出心率、RR 间隔和加速度数据并监看报文。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-06
- 收录于：2026-11-08
- 原始资源：<https://github.com/andyguzmaneth/whoop4-ble>
- 一手来源：<https://github.com/andyguzmaneth/whoop4-ble/blob/a76ad4576bda9ec76cc6347ff9ad18fbcad1cd88/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/whoop4-ble-case/>
- 记录 JSON：<https://awesomerea.org/resources/whoop4-ble-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/whoop4-ble-case/index.md)

## 使用条件与局限

- **前提条件：**需要 Python 3.10 或更新版本及 Whoop 4.0 腕带。
- **前提条件：**直接 BLE 访问前，应先解除腕带与官方应用的配对。
- **局限：**无法取得云端计算的恢复、负荷和睡眠分数；部分传感字段仍只解码了一部分。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/andyguzmaneth/whoop4-ble/blob/a76ad4576bda9ec76cc6347ff9ad18fbcad1cd88/README.md>
2. <https://github.com/andyguzmaneth/whoop4-ble/blob/a76ad4576bda9ec76cc6347ff9ad18fbcad1cd88/docs/PROTOCOL.md>
3. <https://github.com/andyguzmaneth/whoop4-ble/blob/a76ad4576bda9ec76cc6347ff9ad18fbcad1cd88/docs/STATUS.md>

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

- [MSI Mystic Light RGB Web Control Panel：重建 B760M-A 灯效控制](https://awesomerea.org/zh/resources/msi-mystic-light-web-case/index.md) · 案例
- [Open Trofeo LCD：实现 Thermalright Trofeo USB 显示屏控制](https://awesomerea.org/zh/resources/open-trofeo-lcd-case/index.md) · 案例
- [Soundpeats Mini Pro HS Controller：重建耳机蓝牙控制](https://awesomerea.org/zh/resources/soundpeats-mini-pro-hs-controller-case/index.md) · 案例
- [breezyd：重建 Twinfresh Breezy 通风设备的本地控制](https://awesomerea.org/zh/resources/breezyd-twinfresh-protocol-case/index.md) · 案例
- [ebkn-m61-protocol：重建生物识别终端通信协议](https://awesomerea.org/zh/resources/ebkn-m61-protocol-case/index.md) · 案例
- [Divoom Times Frame：云端与本地 API 的部分重建](https://awesomerea.org/zh/resources/divoom-times-frame-research-case/index.md) · 案例

## 关于此条目

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