# Xiaomi Kettle BLE protocol：重建智能电水壶的控制接口 > 记录 Xiaomi 电水壶封闭的低功耗蓝牙 GATT 协议；作者通过反编译 Mi Home Android 应用并反汇编其负责加密的原生库重建了该协议。文档涵盖连接与认证握手、状态通知的数据布局以及可写入的设置特征值，并附有用 Go 重新实现的少量加密辅助函数。作者据此开发了接入 Home Assistant 的水壶–MQTT 桥接程序，但未公开其代码，也不保证这些笔记对他人同样适用。 - 类型：案例 - 目标：协议 - 类别：独立重建案例 - 关联：独立重建项目 - 来源复核于：2026-10-27 - 收录于：2026-11-03 - 原始资源： - 一手来源： - 目录页面： - 记录 JSON： - 英文版：[English](https://awesomerea.org/resources/xiaomi-kettle-ble-protocol-case/index.md) ## 使用条件与局限 - 在 2018-11-29 的最后一次提交处审阅；仓库已归档，只包含一份 README 和一个 Go 文件。README 称该水壶基于 QN9020 MCU，但未指明具体型号或固件版本。 - 使用这些笔记需要使用者自己的水壶，以及任意能读写并订阅特征值的 BLE 库；作者使用 Go 与 currantlabs/ble。仓库未收录 Mi Home 应用、其原生库或任何反编译产物；握手使用客户端自行生成的令牌，因此既没有提交也不需要任何厂商密钥。 - README 列出了作者观察到的设备限制：除非保温模式已开启，否则无法通过 BLE 启动加热；保温模式只能用实体按键重新开启；保温时限最长为 12 小时。 - cipher.go 只包含加密与字节混排辅助函数，并非完整客户端。仓库没有测试、抓包或验证记录，因此协议说明为作者报告；README 致谢了 jadx-gui 和 IDA Pro。 - 采用 WTFPL 第 2 版许可（LICENSE.txt）。Xiaomi 与 Mi Home 仍为其权利人的商标。 ## 一手来源 1. 2. 3. ## 同分区更多条目：协议 - [Ford Fiesta MK5 MS-CAN：解码仪表盘与收音机总线](https://awesomerea.org/zh/resources/ford-fiesta-mk5-ms-can-case/index.md) · 案例 - [uniden-r8-ble：重建 Uniden R8 雷达探测器的蓝牙遥测](https://awesomerea.org/zh/resources/uniden-r8-ble-telemetry-case/index.md) · 案例 - [opendash：重建 Scanmatik SM3 J2534 适配器协议](https://awesomerea.org/zh/resources/opendash-scanmatik-sm3-protocol-case/index.md) · 案例 - [OWL：开源的 Apple 无线直连（AWDL）实现](https://awesomerea.org/zh/resources/owl-awdl-open-implementation-case/index.md) · 案例 - [QuestPad：利用 Quest Touch 无线协议构建 USB 手柄](https://awesomerea.org/zh/resources/questpad-case/index.md) · 案例 - [Stadiacast：重建 Stadia 手柄的 Wi-Fi 服务](https://awesomerea.org/zh/resources/stadiacast-case/index.md) · 案例 ## 关于此条目 说明已依据一手来源复核。 原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。