Case study

Ember Mug: reverse-engineered Bluetooth LE characteristics

Documents the Bluetooth Low Energy GATT interface of Ember smart mugs, worked out from an Ember Mug 2 and a decompiled copy of the Android Ember app. Per-characteristic pages give UUIDs, read, write and notify methods and byte layouts for the mug name, LED colour, current and target temperature, temperature unit, battery and charging status, liquid level and state, date and time zone, firmware and hardware versions, and push events. A separate page lists the analytics fields that the decompiled app sends to Ember’s collection server.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-10-20

Stars: 187
Last commit: 2022-12-14
License (GitHub): MIT

GitHub data as of 2026-11-09

Copy as Markdown View JSON Cite

Requirements & limits

Prerequisites: Applying the findings needs an Ember mug and a BLE client that reads, writes and subscribes to characteristics under service UUID fc543622236c4c948fa9944a3e5353fa. Writing 0000 as target temperature turns the heater off.
Scope: The documentation covers observations from an Ember Mug 2; other Ember mugs may differ. Some characteristic meanings are tentative, including a battery byte likely to be voltage and liquid level that seems to update only while charging.
Testing evidence: The findings were derived from a decompiled Android APK. The repository includes documentation and short excerpts of Ember app code, with no client code or tests.
License: The documentation is MIT-licensed; quoted Ember app code retains Ember’s rights.

Cite

BibTeX

@misc{ember-mug-ble-protocol-case,
  title = {{Ember Mug: reverse-engineered Bluetooth LE characteristics}},
  howpublished = {\url{https://github.com/orlopau/ember-mug}},
  url = {https://github.com/orlopau/ember-mug},
  urldate = {2026-10-20},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/ember-mug-ble-protocol-case/}}
}

Plain text

Ember Mug: reverse-engineered Bluetooth LE characteristics. https://github.com/orlopau/ember-mug (accessed 2026-10-20). Awesome REA entry: https://awesomerea.org/resources/ember-mug-ble-protocol-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 · orlopau/ember-mug · Revision 8a62bd5
docs/target-temp.md GitHub · orlopau/ember-mug · Revision 8a62bd5
docs/battery.md GitHub · orlopau/ember-mug · Revision 8a62bd5
docs/liquid-level.md GitHub · orlopau/ember-mug · Revision 8a62bd5
docs/push-events.md GitHub · orlopau/ember-mug · Revision 8a62bd5
docs/ota.md GitHub · orlopau/ember-mug · Revision 8a62bd5
docs/mug-color.md GitHub · orlopau/ember-mug · Revision 8a62bd5
docs GitHub · orlopau/ember-mug · Revision 8a62bd5
https://github.com/orlopau/ember-mug/commit/401dbb0ea5aea0343457c13f23a21868f740b28e
LICENSE GitHub · orlopau/ember-mug · Revision 8a62bd5