# xbloom-ble：xBloom Studio 蓝牙协议客户端

> xbloom-ble 是针对 xBloom Studio 咖啡机已解析 Bluetooth LE 协议的 Python 客户端。作者记录了采集手机应用流量、比较 GATT 命令帧的过程；命令行与终端界面可加载配方、设置旋钮预设、按明确指令启动冲煮，并显示实时称重数据。

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

## 使用条件与局限

- **前提条件：**需要 xBloom Studio 咖啡机及 Bluetooth LE 连接；写入前须断开手机应用，因为机器一次只接受一个蓝牙连接。
- **前提条件：**需要 Python 3.10 或更新版本，以及 bleak 和 PyYAML；Linux 还需要 BlueZ。
- **前提条件：**远程启动会放出接近沸腾的热水，须先确保机器已做好物理准备。
- **测试证据：**作者仅在一台运行 V12.0D.500 固件的机器上测试。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/Janczykkkko/xbloom-ble/blob/cfa29daa771fdd147de78c1844d2251ca81ea583/docs/REVERSE-ENGINEERING.md>
2. <https://github.com/Janczykkkko/xbloom-ble/blob/cfa29daa771fdd147de78c1844d2251ca81ea583/README.md>

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

- [ak820：在 macOS 上重建 AJAZZ AK820 Pro 的 HID 控制协议](https://awesomerea.org/zh/resources/ajazz-ak820-pro-mac-case/index.md) · 案例
- [GameTrak Liberation：基于控制器 HID 协议的客户端](https://awesomerea.org/zh/resources/gametrak-liberation-case/index.md) · 案例
- [Cooper Hunter AC：UART 与红外协议调查](https://awesomerea.org/zh/resources/cooper-hunter-ac-protocol-case/index.md) · 案例
- [aw5d-linux：依据 USB-HID 协议研究驱动 iBUYPOWER 散热器屏幕](https://awesomerea.org/zh/resources/aw5d-linux-case/index.md) · 案例
- [MyJBxHeadsetControl：通过 USB HID 控制 JBL Quantum 950](https://awesomerea.org/zh/resources/myjbxheadsetcontrol-case/index.md) · 案例
- [zlt：MTN ZLT T10D MAX 路由器 API 还原](https://awesomerea.org/zh/resources/zltrouter-case/index.md) · 案例

## 关于此条目

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