Case study

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.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C2 code & docs, no demo or download

Stars: 2
Last commit: 2026-08-25
Language: Python
License (GitHub): GPL-3.0

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code, documentation and a demo observed; no download method found.
Checked: 2026-11-08

How evidence classes are assigned

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.

Cite

BibTeX

@misc{wallecube-bt-ha-case,
  title = {{WalleCube UPS: Home Assistant control through a reconstructed BLE protocol}},
  howpublished = {\url{https://github.com/jeburks2/wallecube-bt-ha}},
  url = {https://github.com/jeburks2/wallecube-bt-ha},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/wallecube-bt-ha-case/}}
}

Plain text

WalleCube UPS: Home Assistant control through a reconstructed BLE protocol. https://github.com/jeburks2/wallecube-bt-ha (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/wallecube-bt-ha-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · jeburks2/wallecube-bt-ha · Revision 339b144
PROTOCOL.md GitHub · jeburks2/wallecube-bt-ha · Revision 339b144