druidus/brompton-electric-ble — explained in plain English
Analysis updated 2026-05-18
Monitor a Brompton Electric e-bike's battery level and health from a Home Assistant dashboard.
Automatically turn off a smart plug once the bike's battery reaches eighty percent.
Track ride distance and motor usage statistics for the bike over time.
Get notified when the bike's battery is low or fully charged.
| druidus/brompton-electric-ble | achanana/mavsdk | alange/llama.cpp | |
|---|---|---|---|
| Stars | 0 | — | 0 |
| Language | C++ | C++ | C++ |
| Last pushed | — | 2024-05-20 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | hard | moderate | moderate |
| Complexity | 4/5 | 4/5 | 4/5 |
| Audience | ops devops | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires an ESP32 board, a working Home Assistant and MQTT broker setup, and the bike's frame number engraved on the frame.
This project lets you build a small hardware monitor for a Brompton Electric Mk1 folding e-bike using a cheap ESP32 microcontroller board. The ESP32 connects to the bike over Bluetooth Low Energy, reads its battery charge level, voltage, battery health, and ride statistics, and then sends all of that information to Home Assistant, a popular home automation system, so it can show up on a dashboard or trigger automations. The Brompton Electric Mk1 uses its own private Bluetooth protocol with an encrypted pairing code generated from the bike's frame number. An earlier open-source project figured out how to talk to the bike over Bluetooth but did not connect it to any home automation system. This project builds on that earlier work and adds WiFi and MQTT support so sensors appear automatically in Home Assistant, a keepalive signal so the bike does not fall asleep while charging, and saved Bluetooth pairing that survives power cycles, along with a fuller set of diagnostic readings like battery cycle count and motor distance. Setup involves finding the six digit frame number engraved on the bike, copying a template file to fill in your WiFi and MQTT details along with that frame number, then flashing the code onto the ESP32 board using PlatformIO, a tool for programming microcontrollers. Once running, the ESP32 publishes its readings to Home Assistant automatically, and the README includes an example automation for turning a smart plug off once the battery reaches eighty percent charge. The README notes some rough edges: the bike only accepts one Bluetooth connection at a time, so the official phone app must be unpaired first, some sensor readings are unreliable or return no data at all, and one health reading does not clearly match any obvious unit yet. Several Bluetooth services on the bike remain unexplored. This is a hobbyist hardware project built for a specific bike model, not a general purpose tool.
A DIY ESP32 device that reads a Brompton Electric e-bike's battery and ride data over Bluetooth and sends it to Home Assistant for dashboards and charge automation.
Mainly C++. The stack also includes C++, ESP32, PlatformIO.
Setup difficulty is rated hard, with roughly 1h+ to a first successful run.
Mainly ops devops.
This repo across BitVibe Labs
double-check against the repo, no cap.