{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/XavierGeerinck/etrel-load-guard-configurator/blob/6e1fc40bf6a697c0a6a9fbae04f0806ba7acd2c0/docs/PROTOCOL.md"
  ],
  "category": "community-case-studies",
  "class": "hardware",
  "description_en": "Etrel Load Guard Configurator is a Python CLI for discovering, reading and configuring Etrel Load Guard energy meters through a reconstructed UDP protocol. The author reports using REA with Ghidra on LoadGuardConfigurator.exe to recover packet fields and settings, then checking byte order and read-only measurements on a device. The tool includes dry-run writes and a simulator.",
  "description_zh": "Etrel Load Guard Configurator 是通过重建的 UDP 协议发现、读取和配置 Etrel Load Guard 电表的 Python 命令行工具。作者报告使用 REA 与 Ghidra 分析 LoadGuardConfigurator.exe，恢复报文字段和设置，并在设备上核对字节序与只读测量结果。工具提供写入预览和模拟器。",
  "entry_url": "https://awesomerea.org/resources/etrel-load-guard-configurator-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/etrel-load-guard-configurator-case/",
  "evidence_url": "https://github.com/XavierGeerinck/etrel-load-guard-configurator/blob/6e1fc40bf6a697c0a6a9fbae04f0806ba7acd2c0/README.md",
  "group": "rea",
  "id": "etrel-load-guard-configurator-case",
  "json_url": "https://awesomerea.org/resources/etrel-load-guard-configurator-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/etrel-load-guard-configurator-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/etrel-load-guard-configurator-case/index.md",
  "name": "Etrel Load Guard Configurator: reconstructing the meter's UDP protocol",
  "name_zh": "Etrel Load Guard Configurator：重建电表 UDP 协议",
  "record_type": "resource",
  "relationship": "community-reported-mixed-workflow",
  "requirement_facets": [
    "prerequisites",
    "testing",
    "limits",
    "license"
  ],
  "requirements": [
    "Python 3.8 or later and network access to an Etrel Load Guard; discovery requires the same network segment.",
    "The author checked read-only operations on a Load Guard with software version 10 and hardware version 257.",
    "Write commands pass tests and the simulator but have not been exercised on hardware.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 Python 3.8 或更新版本及可访问的 Etrel Load Guard；自动发现要求处于同一网段。",
    "作者在软件版本 10、硬件版本 257 的 Load Guard 上核对了只读操作。",
    "写入命令通过测试和模拟器检查，但尚未在实机上执行。",
    "MIT 许可证。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/XavierGeerinck/etrel-load-guard-configurator",
  "verification": "source-reviewed",
  "verified_at": "2026-11-07"
}
