# WalleCube UPS: Home Assistant control through a reconstructed BLE protocol

> WalleCube UPS provides local Home Assistant monitoring and control for the W150 mini-UPS through a reconstructed BLE GATT protocol. The author used Android app strings, Frida captures, and Dart disassembly to map telemetry and encrypted settings; PROTOCOL.md records the wire format. The integration exposes power and battery readings and selected settings, with writes checked by reading them back.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/jeburks2/wallecube-bt-ha>
- Primary source: <https://github.com/jeburks2/wallecube-bt-ha/blob/339b144267861b6459b46f9f134b22cb794fa88f/README.md>
- Catalog page: <https://awesomerea.org/resources/wallecube-bt-ha-case/>
- Record JSON: <https://awesomerea.org/resources/wallecube-bt-ha-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/wallecube-bt-ha-case/index.md)

## Requirements & limits

- **Prerequisites:** A WalleCube W150 within range of Home Assistant or an ESPHome Bluetooth proxy; W180 compatibility is unconfirmed.
- **Prerequisites:** Reading settings requires the device’s AES key; writing also requires its auth code.
- **Limits:** Wi-Fi configuration and runtime-remaining reporting are not implemented.
- **License:** GPL-3.0 license.

## Primary sources

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

## More in Protocols

- [toppingctl: reconstructing Topping DAC control over USB HID](https://awesomerea.org/resources/toppingctl-case/index.md) · Case study
- [tuya-ipc-p2p-sdk: Python camera client for Tuya’s P2P protocol](https://awesomerea.org/resources/tuya-ipc-p2p-sdk-case/index.md) · Case study
- [SYNA8002: reconstructing a ThinkPad fingerprint reader's SPI protocol](https://awesomerea.org/resources/x1-tablet-gen3-fingerprint-case/index.md) · Case study
- [fx_lcd_software: reconstructing ID-COOLING FX display transfers](https://awesomerea.org/resources/fx-lcd-software-case/index.md) · Case study
- [ti83-link: reconstructing TI-83 Plus link-port transfers](https://awesomerea.org/resources/ti83-link-case/index.md) · Case study
- [catbus99: reconstructing Epomaker TH99 Pro screen control over USB-HID](https://awesomerea.org/resources/catbus99-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.