sanderdw/ha-dsmr-reader-amd64 Docker 镜像 - 轩辕镜像

Home Assistant DSMR Reader Add-on 文档

镜像概述和主要用途

Home Assistant DSMR Reader Add-on是专为Home Assistant生态系统设计的附加组件，旨在实现与DSMR（Dutch Smart Meter Requirements）协议智能电表的通信。该组件通过读取电表P1端口输出的实时电力数据（如当前用电量、电压、电流、累计能耗等），将数据标准化后集成到Home Assistant中，支持用户构建能源监控仪表盘、设置用电阈值警报及创建基于电力使用的自动化规则，适用于家庭和小型商业场所的能源管理。

核心功能和特性

• DSMR协议兼容性：支持DSMR v2.2至v5.0主流协议版本，可自动识别或手动指定电表版本，适配不同年代的智能电表设备。

• 实时数据采集：通过串口（USB/RS-485）或网络连接实时获取电表数据，采样频率可配置（默认10秒/次），覆盖电流、电压、有功功率、无功功率等关键参数。

• Home Assistant深度集成：自动创建标准传感器实体（如sensor.dsmr_current_power、sensor.dsmr_total_energy），数据直接接入Home Assistant状态系统，支持历史数据查询与可视化。

• 配置简化：提供Web UI配置界面，支持串口设备自动检测、波特率自适应（默认***），减少手动参数配置步骤。

• 稳定性优化：内置数据校验与断线重连机制，支持本地数据缓存，防止临时通信故障导致数据丢失；日志系统可实时监控连接状态与数据解析过程。

使用场景和适用范围

适用场景

• 家庭能源监控：实时跟踪家庭电力消耗，结合Home Assistant Lovelace仪表盘展示用电趋势，分析高耗能设备使用模式。
• 商业能源管理：小型办公室、商铺等场景，通过累计能耗数据计算用电成本，优化设备运行时间以降低费用。
• 自动化联动：作为Home Assistant自动化触发条件（如“当功率超过3000W时自动关闭空调”），实现智能负载控制。

适用范围

• 地域限制：主要适用于采用DSMR协议的地区（如荷兰、比利时及部分欧洲国家），需电表支持P1标准通信端口。
• 硬件要求：智能电表需配备P1接口，通过串口线（如USB转RJ12/RJ11适配器）连接到Home Assistant主机；支持Home Assistant OS、Supervised及Container版本（需手动映射串口设备）。

使用方法和配置说明

前提条件

• 已部署Home Assistant（推荐Home Assistant OS或Supervised版本，原生支持Add-on商店）。
• 智能电表P1端口通过串口线连接至Home Assistant主机，设备路径通常为/dev/ttyUSB0（USB转串口）或/dev/ttyACM0（内置串口）。
• Home Assistant主机用户需具备串口访问权限（加入dialout用户组）。

安装步骤

1. 在Home Assistant中进入设置 > 加载项 > 加载项商店。
2. 搜索“DSMR Reader”（官方或社区版本），点击安装并等待完成。
3. 进入Add-on配置页面，根据电表参数调整核心配置。

核心配置参数说明

启动与验证

1. 配置完成后点击启动，通过日志确认连接状态（如显示“Successfully connected to DSMR meter”表示成功）。
2. 进入Home Assistant开发者工具 > 状态，搜索sensor.dsmr_前缀实体，验证数据更新（如sensor.dsmr_current_power显示当前功率值）。

高级功能配置

• 历史数据存储：默认使用Home Assistant内置数据库，需长期存储可启用database_enabled: true，配置MySQL/PostgreSQL连接参数（db_host、db_name、db_user、db_password）。
• 数据导出：设置export_enabled: true，通过export_interval（如86400秒=1天）定期导出CSV文件至export_path指定目录。
• 自动化规则示例：当sensor.dsmr_current_power超过2000W时，关闭switch.air_conditioner并发送通知：

  yaml
  trigger:
    platform: numeric_state
    entity_id: sensor.dsmr_current_power
    above: 2000
  action:
    - service: switch.turn_off
      target:
        entity_id: switch.air_conditioner
    - service: notify.mobile_app_your_phone
      data:
        message: "电力负荷过高，已关闭空调"
  

故障排除

• 串口访问失败：日志显示“Permission denied”时，在Add-on配置中开启privileged: true，或在主机执行usermod -aG dialout homeassistant添加用户组权限。
• 数据解析错误：提示“Invalid ***”时，检查dsmr_version是否与电表匹配（参考电表说明书），或降低baudrate至9600尝试。
• 连接不稳定：更换屏蔽串口线，远离强电磁干扰源，或在配置中增加reconnect_interval: 30（30秒自动重连）。