{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/PeterTM/mqtt-energi/blob/9aa07aee7adf549e2c7918738bfb2048370a712e/docs/communication.md",
    "https://github.com/PeterTM/mqtt-energi/blob/9aa07aee7adf549e2c7918738bfb2048370a712e/docs/data_packets.md",
    "https://github.com/PeterTM/mqtt-energi/blob/9aa07aee7adf549e2c7918738bfb2048370a712e/docs/mqtt_bridge.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "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.",
  "description_zh": "mqtt-energi 研究 myenergi 设备之间的以太网通信，并将解码后的读数转发到 MQTT。文档记录 ethertype 为 0x88b5 的组播帧和报文布局；Python 解码器提取 Eddi V2.1 的电压、功率、电量及加热器状态。",
  "entry_url": "https://awesomerea.org/resources/mqtt-energi-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/mqtt-energi-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/PeterTM/mqtt-energi/blob/9aa07aee7adf549e2c7918738bfb2048370a712e/README.md",
  "group": "cases",
  "id": "mqtt-energi-case",
  "json_url": "https://awesomerea.org/resources/mqtt-energi-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/mqtt-energi-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/mqtt-energi-case/index.md",
  "name": "mqtt-energi: reconstructing myenergi device traffic",
  "name_zh": "mqtt-energi：重建 myenergi 设备通信格式",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Requires a network-connected Eddi V2.1 device, a promiscuous-mode network interface and an MQTT broker.",
    "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.",
    "V1 devices are unsupported, and operation with V5 firmware is unknown.",
    "Unlicense."
  ],
  "requirements_zh": [
    "需要联网的 Eddi V2.1 设备、可进入混杂模式的网卡及 MQTT 代理。",
    "文档称当前版本可能只能在 Linux 上运行；Python 环境需要安装 paho.mqtt，脚本需要 root 权限来配置网卡。",
    "不支持 V1 设备；能否用于 V5 固件尚不明确。",
    "采用 Unlicense 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/PeterTM/mqtt-energi",
  "verification": "source-reviewed",
  "verified_at": "2026-11-07"
}