Case study
irca-ble-protocol: reconstructing heater control over Bluetooth LE
irca-ble-protocol documents the Bluetooth LE control protocol observed on an Olle POWER-family towel rail. It describes GATT characteristics, 20-byte command frames, status fields and authentication behavior, and provides Python, Home Assistant and Android implementations.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 0
- Last commit
- 2026-10-28
- Language
- Python
- License (GitHub)
- MIT
GitHub data as of 2026-11-10
Evidence
- Observed
- Code, documentation and a demo observed; no download method found.
- Checked
- 2026-11-08
Requirements & limits
- Prerequisites: A compatible heater and Bluetooth LE access; Home Assistant use requires HA 2024.8 or newer.
- Testing evidence: The author reports hardware checks against one Olle POWER-family unit; the Home Assistant integration and Celsius climate path were not exercised against a real heater.
- License: MIT license.
Cite
BibTeX
@misc{irca-ble-protocol-case,
title = {{irca-ble-protocol: reconstructing heater control over Bluetooth LE}},
howpublished = {\url{https://github.com/niklas-a/irca-ble-protocol}},
url = {https://github.com/niklas-a/irca-ble-protocol},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/irca-ble-protocol-case/}}
}Plain text
irca-ble-protocol: reconstructing heater control over Bluetooth LE. https://github.com/niklas-a/irca-ble-protocol (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/irca-ble-protocol-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- docs/OLLE_BLE_PROTOCOL.md GitHub · niklas-a/irca-ble-protocol · Revision 2711be6
- README.md GitHub · niklas-a/irca-ble-protocol · Revision 2711be6
More in Protocols
- egm6-nixie-clock: reconstructing a nixie clock's Wi-Fi protocol · Case study
- Guoran nixie clock: reconstructing its Bluetooth control protocol · Case study
- 1st Player RT LCD: reconstructing a case-display HID protocol · Case study
- Ecovacs Deebot X1: reconstructing local map and control interfaces · Case study
- MyEnergy Dashboard: reconstructing INFINITY 1000 Bluetooth controls · Case study
- sk700v-linux: a Linux display client for the Sudokoo SK700V · Case study