这个项目能做什么

该仓库是一份可复制粘贴的安装指南和安装程序，用于在Raspberry Pi上搭建家庭能源监控方案。它会监听Victron蓝牙设备（SmartShunt、MPPT），并将解码后的数值发布到本地Mosquitto MQTT代理，随后Home Assistant会将其显示为传感器，例如电压、电流、荷电状态、太阳能功率和充电状态。Pi自身的CPU、温度、Wi-Fi和运行时间也可以被展示。 一个可选的只读Modbus sidecar通过USB支持Sungold SPH302480A逆变器（PV、电池、电网、负载），另一个可选的VE.Direct分流器sidecar充当电池监控器。两者默认禁用，并通过私有.env文件中的标志启用。第二台Raspberry Pi（HOST_ROLE=pi5）可以通过AdGuard运行局域网DNS，并将家庭蓝牙低功耗数据转发到Pi 4代理。 安装由scripts/deploy.sh驱动，它会设置Docker、Mosquitto、Home Assistant和Victron蓝牙读取器，并且可以安全地重复运行。配置位于.env（MQTT主机、用户、密码、功能标志）和victron-secrets.env（32字符广播密钥）中，设备MAC地址则在用户设置文件中设置。README指出，Victron桥接会在启动时验证其密钥，如果缺少某个变量，会以命名缺失变量的方式退出，而不是在没有这些密钥的情况下运行。 访问面向本地网络，可选使用Tailscale在外出时查看仪表板，而不是将其公开暴露。文档涵盖添加或移除设备、Pi 5边缘角色、Tailscale、Sungold细节、太阳能功率平衡和仪表板选项，以及常见问题的故障排除步骤，例如Home Assistant无法访问、缺少Victron实体、MQTT连接被拒绝和容器重启循环。采用MIT许可证。