Case study
Fluval Plant Pro 4.0: reconstructing BLE light control
The Fluval Plant Pro 4.0 project reconstructs the light's CBOR-over-BLE control protocol from the FluvalConnect Android app. An ESP32 ESPHome configuration sends commands through vendor service FFF0 and exposes power, five color channels, schedules and state updates to Home Assistant.
- Targets
- App · Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Stars
- 2
- Last commit
- 2026-08-24
- License (GitHub)
- MIT
GitHub data as of 2026-11-09
Requirements & limits
- Prerequisites: Fluval Plant Pro 4.0, an ESP32 with BLE and Wi-Fi, Home Assistant with ESPHome, and the light's Bluetooth MAC address.
- Limits: The light permits only one Bluetooth connection at a time; remaining status keys 14–22 are undecoded.
- License: MIT license.
Cite
BibTeX
@misc{fluval-plant-pro-4-ble-case,
title = {{Fluval Plant Pro 4.0: reconstructing BLE light control}},
howpublished = {\url{https://github.com/cryystyy/fluval-plant-pro-4-homeassistant}},
url = {https://github.com/cryystyy/fluval-plant-pro-4-homeassistant},
urldate = {2026-11-08},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/fluval-plant-pro-4-ble-case/}}
}Plain text
Fluval Plant Pro 4.0: reconstructing BLE light control. https://github.com/cryystyy/fluval-plant-pro-4-homeassistant (accessed 2026-11-08). Awesome REA entry: https://awesomerea.org/resources/fluval-plant-pro-4-ble-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- README.md GitHub · cryystyy/fluval-plant-pro-4-homeassistant · Revision dbc1c14
- docs/PROTOCOL.md GitHub · cryystyy/fluval-plant-pro-4-homeassistant · Revision dbc1c14
- LICENSE GitHub · cryystyy/fluval-plant-pro-4-homeassistant · Revision dbc1c14
More in Apps
- xtractedott: reconstructing the OTT compressor DSP core · Case study
- OpenApe: reconstructing the Call of Duty 4 Asset Manager · Case study
- EOO: a Nintendo DS Wii-connection utility decompilation · Case study
- PictoChat: a matching DSi system-title decompilation · Case study
- LibrePods: AirPods features on Android and Linux through a reverse-engineered protocol · Case study
- OpenHaystack: tracking tags that use Apple Find My · Case study