# WalleCube UPS：基于还原的 BLE 协议实现 Home Assistant 控制

> WalleCube UPS 基于还原的 BLE GATT 协议，为 W150 迷你 UPS 提供本地 Home Assistant 监控与控制。作者通过 Android 应用字符串、Frida 捕获和 Dart 反汇编分析遥测数据及加密设置，并在 PROTOCOL.md 中记录通信格式。集成提供电源、电池数据和部分设置，写入后会回读检查。

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

## 使用条件与局限

- **前提条件：**需要处于 Home Assistant 或 ESPHome 蓝牙代理覆盖范围内的 WalleCube W150；W180 兼容性尚未确认。
- **前提条件：**读取设置需要设备的 AES 密钥；写入还需要认证码。
- **局限：**尚未实现 Wi-Fi 配置与剩余运行时间报告。
- **许可：**许可证为 GPL-3.0。

## 一手来源

1. <https://github.com/jeburks2/wallecube-bt-ha/blob/339b144267861b6459b46f9f134b22cb794fa88f/README.md>
2. <https://github.com/jeburks2/wallecube-bt-ha/blob/339b144267861b6459b46f9f134b22cb794fa88f/PROTOCOL.md>

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

- [toppingctl：重建 Topping DAC 的 USB HID 控制](https://awesomerea.org/zh/resources/toppingctl-case/index.md) · 案例
- [tuya-ipc-p2p-sdk：Tuya P2P 协议的 Python 摄像头客户端](https://awesomerea.org/zh/resources/tuya-ipc-p2p-sdk-case/index.md) · 案例
- [SYNA8002：重建 ThinkPad 指纹读取器的 SPI 协议](https://awesomerea.org/zh/resources/x1-tablet-gen3-fingerprint-case/index.md) · 案例
- [fx_lcd_software：重建 ID-COOLING FX 显示屏传输协议](https://awesomerea.org/zh/resources/fx-lcd-software-case/index.md) · 案例
- [ti83-link：TI-83 Plus 链接口传输流程重建](https://awesomerea.org/zh/resources/ti83-link-case/index.md) · 案例
- [catbus99：还原 Epomaker TH99 Pro 屏幕的 USB-HID 控制方式](https://awesomerea.org/zh/resources/catbus99-case/index.md) · 案例

## 关于此条目

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