# 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.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-10-20
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/orlopau/ember-mug>
- Primary source: <https://github.com/orlopau/ember-mug/blob/8a62bd582c97b124cce8701f04098294b1e3865f/README.md>
- Catalog page: <https://awesomerea.org/resources/ember-mug-ble-protocol-case/>
- Record JSON: <https://awesomerea.org/resources/ember-mug-ble-protocol-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/ember-mug-ble-protocol-case/index.md)

## 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.

## Primary sources

1. <https://github.com/orlopau/ember-mug/blob/8a62bd582c97b124cce8701f04098294b1e3865f/README.md>
2. <https://github.com/orlopau/ember-mug/blob/8a62bd582c97b124cce8701f04098294b1e3865f/docs/target-temp.md>
3. <https://github.com/orlopau/ember-mug/blob/8a62bd582c97b124cce8701f04098294b1e3865f/docs/battery.md>
4. <https://github.com/orlopau/ember-mug/blob/8a62bd582c97b124cce8701f04098294b1e3865f/docs/liquid-level.md>
5. <https://github.com/orlopau/ember-mug/blob/8a62bd582c97b124cce8701f04098294b1e3865f/docs/push-events.md>
6. <https://github.com/orlopau/ember-mug/blob/8a62bd582c97b124cce8701f04098294b1e3865f/docs/ota.md>
7. <https://github.com/orlopau/ember-mug/blob/8a62bd582c97b124cce8701f04098294b1e3865f/docs/mug-color.md>
8. <https://github.com/orlopau/ember-mug/tree/8a62bd582c97b124cce8701f04098294b1e3865f/docs>
9. <https://github.com/orlopau/ember-mug/commit/401dbb0ea5aea0343457c13f23a21868f740b28e>
10. <https://github.com/orlopau/ember-mug/blob/8a62bd582c97b124cce8701f04098294b1e3865f/LICENSE>

## More in Protocols

- [BM2 Battery Monitor: reconstructing an encrypted BLE voltage protocol](https://awesomerea.org/resources/bm2-battery-monitor-ble-case/index.md) · Case study
- [Smart ring protocol: documenting the Oura Ring BLE protocol and event format](https://awesomerea.org/resources/ringverse-oura-ring-protocol-case/index.md) · Case study
- [openrsync: an ISC implementation of rsync protocol 27](https://awesomerea.org/resources/openrsync-protocol-case/index.md) · Case study
- [Thermal Master P3: a browser client for the vendor USB protocol](https://awesomerea.org/resources/thermal-master-p3-protocol-case/index.md) · Case study
- [SNX-VPN: reconstructing Check Point browser login for SNX](https://awesomerea.org/resources/snxvpn-case/index.md) · Case study
- [OpenDS: reconstructing an FRC Driver Station client](https://awesomerea.org/resources/opends-frc-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.