fmartinou/teleinfo-mqtt

teleinfo-mqtt

镜像概述

teleinfo-mqtt 是一个用于从串口读取 teleinfo 数据并通过 MQTT 协议发布的工具镜像。请注意：此镜像已重命名为 https://hub.docker.com/r/fmartinou/teleinfo2mqtt%EF%BC%8C%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%E6%96%B0%E9%95%9C%E5%83%8F%E5%90%8D%E7%A7%B0%E8%BF%9B%E8%A1%8C%E9%83%A8%E7%BD%B2%E5%92%8C%E7%BB%B4%E6%8A%A4%E3%80%82

核心功能

• 从指定串口读取 teleinfo 格式的电力计量数据
• 将解析后的 teleinfo 数据通过 MQTT 协议发布到指定的 MQTT 服务器
• 支持标准 teleinfo 数据格式解析与转换

使用场景

适用于需要采集和传输电力计量数据（如法国电力公司 Enedis 的 teleinfo 协议数据）的场景，可集成到智能家居系统、能源监控平台、数据采集网关等应用中，实现电力数据的实时监控与远程传输。

使用方法

镜像拉取

由于原镜像已重命名，建议直接拉取新镜像：

bash
docker pull docker.xuanyuan.run/fmartinou/teleinfo2mqtt

基本运行示例

使用 docker run 命令运行新镜像：

bash
docker run -d \
  --name teleinfo2mqtt \
  --device=/dev/ttyUSB0:/dev/ttyUSB0 \  # 映射串口设备
  -e MQTT_BROKER=mqtt://your-mqtt-broker:1883 \  # MQTT 服务器地址
  -e MQTT_TOPIC=teleinfo/data \  # MQTT 发布主题
  -e SERIAL_PORT=/dev/ttyUSB0 \  # 串口设备路径
  -e SERIAL_BAUDRATE=1200 \  # 串口波特率（teleinfo 通常为 1200）
  fmartinou/teleinfo2mqtt

环境变量配置

Docker Compose 配置示例

yaml
version: '3'
services:
  teleinfo2mqtt:
    image: docker.xuanyuan.run/fmartinou/teleinfo2mqtt
    container_name: teleinfo2mqtt
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0
    environment:
      - MQTT_BROKER=mqtt://mqtt-server:1883
      - MQTT_TOPIC=home/energy/teleinfo
      - MQTT_USER=mqtt-user
      - MQTT_PASSWORD=mqtt-password
      - SERIAL_PORT=/dev/ttyUSB0
      - SERIAL_BAUDRATE=1200
      - LOG_LEVEL=info
    restart: unless-stopped

注意事项

• 确保宿主机的串口设备路径正确，并在容器中正确映射（使用 --device 参数）
• teleinfo 协议通常使用 1200 波特率、偶校验、1 停止位的串口配置，需根据实际设备调整
• 原 teleinfo-mqtt 镜像已停止维护，所有功能已迁移至 teleinfo2mqtt，建议立即更新镜像名称以获取最新功能和安全更新