# mqtt-energi: reconstructing myenergi device traffic

> mqtt-energi investigates myenergi device-to-device Ethernet traffic and bridges decoded readings to MQTT. Its documentation records multicast frames with ethertype 0x88b5 and packet layouts, while a Python decoder extracts voltage, power, energy and heater state from Eddi V2.1 messages.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-07
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/PeterTM/mqtt-energi>
- Primary source: <https://github.com/PeterTM/mqtt-energi/blob/9aa07aee7adf549e2c7918738bfb2048370a712e/README.md>
- Catalog page: <https://awesomerea.org/resources/mqtt-energi-case/>
- Record JSON: <https://awesomerea.org/resources/mqtt-energi-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/mqtt-energi-case/index.md)

## Requirements & limits

- **Prerequisites:** Requires a network-connected Eddi V2.1 device, a promiscuous-mode network interface and an MQTT broker.
- **Prerequisites:** The bridge is described as likely to work only on Linux in its current form; Python needs paho.mqtt, and the script needs root permissions to configure the network interface.
- **Limits:** V1 devices are unsupported, and operation with V5 firmware is unknown.
- **License:** Unlicense.

## Primary sources

1. <https://github.com/PeterTM/mqtt-energi/blob/9aa07aee7adf549e2c7918738bfb2048370a712e/README.md>
2. <https://github.com/PeterTM/mqtt-energi/blob/9aa07aee7adf549e2c7918738bfb2048370a712e/docs/communication.md>
3. <https://github.com/PeterTM/mqtt-energi/blob/9aa07aee7adf549e2c7918738bfb2048370a712e/docs/data_packets.md>
4. <https://github.com/PeterTM/mqtt-energi/blob/9aa07aee7adf549e2c7918738bfb2048370a712e/docs/mqtt_bridge.md>

## More in Protocols

- [RedFIS: reconstructing the Audi A3 8P display protocol](https://awesomerea.org/resources/a3-8p-redfis-case/index.md) · Case study
- [GalaxyBuds-rs: implementing the Galaxy Buds Bluetooth protocol](https://awesomerea.org/resources/galaxybuds-rs-case/index.md) · Case study
- [ETEKCITY Smart Nutrition Scale: mapping the ESN00 BLE packets](https://awesomerea.org/resources/metekcity-case/index.md) · Case study
- [mi-scale-2: decoding Mi Smart Scale 2 weight messages](https://awesomerea.org/resources/mi-scale-2-case/index.md) · Case study
- [PSA VAN Bus: documenting Peugeot and Citroën packet formats](https://awesomerea.org/resources/psa-van-bus-packets-case/index.md) · Case study
- [Apple Wi-Fi Password Sharing: reconstructing the sharing protocol](https://awesomerea.org/resources/apple-wifi-password-sharing-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.