thevoltagesource/eagle-mqtt-bridge

Rainforest Eagle to MQTT桥接应用

镜像概述

本应用作为Rainforest Eagle设备与MQTT broker之间的桥接工具，通过创建HTTP监听器捕获Rainforest Eagle发送的XML格式能源数据，解析后将关键信息发布到指定的MQTT主机。Home Assistant用户可启用自动发现功能，无需手动配置YAML即可在MQTT集成下自动创建桥接和Eagle设备，简化能源数据集成流程。

核心功能与特性

• 数据捕获与解析：创建HTTP监听器接收Rainforest Eagle发送的XML数据并解析
• MQTT数据发布：将解析后的能源数据发布到指定MQTT主题
• Home Assistant集成：支持自动发现，自动创建设备实体
• 状态跟踪：实时监控设备和桥接服务的在线/离线状态（通过MQTT主题）
• 灵活配置：通过环境变量自定义MQTT连接参数、监听端口、日志级别等
• 单位转换：支持总电能数据在千瓦时(kWh)和瓦时(Wh)之间切换

使用场景

适用于智能家居用户，特别是使用Rainforest Eagle能源监测设备和Home Assistant的用户，需将电力使用数据（如即时功率、总用电量）集成到MQTT生态系统中，实现能源监控、自动化控制或数据记录。

配置说明

应用通过环境变量进行配置，参数说明如下：

状态跟踪主题

• 设备状态（在线/离线）：${MQTT_TOPIC}/availability
• 桥接服务状态（在线/离线，保留消息）：${MQTT_TOPIC}/bridge/status

支持的消息类型

注意：Meter Reading主题已被Summation Delivered主题取代

使用方法

Docker运行示例

基本运行命令（包含必填参数）：

bash
docker run -d \
  --name eagle-mqtt-bridge \
  -e MQTT_HOST=192.168.1.100 \
  -p 3000:3000 \
  rainforest-eagle-mqtt-bridge

带Home Assistant发现的配置：

bash
docker run -d \
  --name eagle-mqtt-bridge \
  -e MQTT_HOST=192.168.1.100 \
  -e MQTT_USER=mqtt_user \
  -e MQTT_PASS=mqtt_pass \
  -e MQTT_TOPIC=home/energy/eagle \
  -e HA_DISCOVERY=true \
  -e LOG_LEVEL=debug \
  -e SUMMATION_WATTS=true \
  -p 3000:3000 \
  --restart unless-stopped \
  rainforest-eagle-mqtt-bridge

Docker Compose配置示例

yaml
version: '3'
services:
  eagle-mqtt-bridge:
    image: rainforest-eagle-mqtt-bridge
    container_name: eagle-mqtt-bridge
    environment:
      - MQTT_HOST=192.168.1.100
      - MQTT_USER=mqtt_user
      - MQTT_PASS=mqtt_pass
      - MQTT_TOPIC=home/energy/eagle
      - LISTEN_PORT=3000
      - HA_DISCOVERY=true
      - LOG_LEVEL=info
      - SUMMATION_WATTS=false
    ports:
      - "3000:3000"
    restart: unless-stopped