Uni-Meter项目Shelly Pro3EM设备配对问题解决方案

Uni-Meter项目Shelly Pro3EM设备配对问题解决方案

问题背景

在使用Uni-Meter项目与Shelly Pro3EM设备进行配对时，部分用户遇到了设备无法被发现的问题。该问题主要表现为Uni-Meter无法自动发现Shelly设备，即使手动配置了设备信息也无法建立连接。

问题分析

经过技术分析，发现该问题主要与mDNS（多播DNS）服务配置有关。Uni-Meter项目依赖mDNS协议来发现网络中的Shelly设备，而mDNS通常运行在5353/UDP端口上。当主机系统上未正确配置mDNS服务时，容器内的Uni-Meter应用将无法接收到设备的广播信息。

解决方案

方法一：在主机系统安装并配置Avahi服务

1. 在主机系统上安装Avahi-daemon服务：

   sudo apt-get install avahi-daemon
   

2. 将Shelly设备的服务描述文件放置到正确位置：

   • shellypro3em.http.tcp.service文件
   • shellypro3em.shelly.tcp.service文件

   这两个文件需要放置在主机系统的/etc/avahi/services/目录下。

3. 确保Avahi服务正常运行：

   sudo systemctl start avahi-daemon
   

方法二：正确配置Docker容器网络

如果希望在容器内直接处理mDNS请求，需要确保：

1. 在docker-compose.yml中正确映射5353/UDP端口：

   ports:
     - 5353:5353/udp
   

2. 确保主机系统没有运行其他mDNS服务（如Avahi-daemon），以避免端口冲突。

配置验证

无论采用哪种方法，都可以通过以下方式验证配置是否生效：

1. 检查Uni-Meter日志中是否显示成功发现设备
2. 使用网络工具检查5353/UDP端口是否正常监听
3. 确认Shelly设备的状态API可以正常访问

技术原理

mDNS协议是零配置网络的重要组成部分，它允许设备在局域网内广播自己的服务信息。Shelly设备会定期通过mDNS广播自己的存在和服务端口信息。Uni-Meter项目通过监听这些广播信息来发现设备并建立连接。

当mDNS服务未正确配置时，这些广播信息无法被正确接收和处理，导致设备发现失败。通过正确配置Avahi服务或确保mDNS端口正确映射，可以解决这一问题。

最佳实践建议

1. 对于生产环境，建议采用主机系统运行Avahi-daemon的方案，稳定性更高
2. 开发测试环境可以使用容器直接处理mDNS的方式，便于快速验证
3. 定期检查服务描述文件是否与设备固件版本兼容
4. 在配置变更后，建议重启相关服务以确保配置生效

通过以上方法，可以确保Uni-Meter项目与Shelly Pro3EM设备建立稳定可靠的连接，实现电力数据的准确采集和传输。