scootsoftware/ginlong-wifi-mqtt

Ginlong WiFi MQTT Bridge

镜像概述和主要用途

Ginlong WiFi MQTT Bridge是一款数据桥接工具，用于从配备WiFi棒的第二代Ginlong/Solis逆变器收集发电数据，并将数据发布到指定的MQTT broker。该工具解决了逆变器默认仅每6分钟向Ginlong监控网站发送数据的限制，支持本地实时数据采集与MQTT协议集成，适用于构建自定义监控系统。

核心功能和特性

• 本地数据采集：通过逆变器WiFi棒的远程服务器功能（Server B）接收实时发电数据
• MQTT数据发布：将收集的逆变器数据标准化后发布到指定MQTT broker
• 灵活配置：支持自定义客户端ID、MQTT连接参数及本地监听端口
• 协议支持：兼容逆变器WiFi棒的TCP数据传输协议

使用场景和适用范围

适用于拥有第二代Ginlong/Solis逆变器（配备WiFi棒）的用户，尤其适合以下场景：

• 家庭太阳能发电系统本地监控
• 工业光伏电站数据采集与分析
• 太阳能数据与家庭自动化系统集成
• 需要将逆变器数据接入IoT平台的应用

详细使用方法和配置说明

配置逆变器

1. 登录逆变器WiFi棒的Web管理界面（通过浏览器连接逆变器WiFi或局域网访问）
2. 点击"Advanced"（高级设置）菜单
3. 选择"Remote server"（远程服务器）选项
4. 在"Server B"配置区域：
   • 输入运行本应用的设备IP地址
   • 设置端口号（默认9999，需与应用配置一致）
   • 协议选择"TCP"
5. 点击"Test"按钮验证连接，成功后显示勾选标记
6. 点击"Save"保存配置，根据提示重启逆变器使设置生效

应用配置

1. 从镜像中获取配置模板文件config.ini.template
2. 复制模板文件为config.ini并编辑以下核心参数：

   ini
   [mqtt]
   client_id = inverter_001  # 自定义客户端ID，用于标识逆变器
   broker = 192.168.1.100    # MQTT broker地址
   port = 1883               # MQTT broker端口（默认1883）
   username = mqtt_user      # （可选）MQTT认证用户名
   password = mqtt_pass      # （可选）MQTT认证密码
   
   [server]
   port = 9999               # 本地监听端口，需与逆变器配置一致
   

运行方式

Docker部署示例

bash
docker run -d \
  --name ginlong-mqtt-bridge \
  -p 9999:9999 \
  -v /path/to/local/config.ini:/app/config.ini \
  --restart unless-stopped \
  [镜像名称]

说明：/path/to/local/config.ini需替换为本地配置文件路径，[镜像名称]替换为实际Docker镜像名称

手动运行（开发/调试）

若需在非Docker环境运行：

1. 安装依赖：

   bash
   pip install -r requirements.txt
   

2. 启动应用：

   bash
   python ./ginlong-wifi-mqtt.py
   

注意事项

• 确保逆变器与运行本应用的设备在同一局域网内
• 端口配置需保持逆变器Server B设置与应用配置一致
• MQTT broker需提前部署并确保网络可达
• 应用运行后可通过查看日志确认数据接收与发布状态