À propos du projet

Ce dépôt est un guide d'installation et un script prêt à copier-coller pour un stack de surveillance énergétique domestique sur Raspberry Pi. Il écoute les appareils Bluetooth Victron (SmartShunt, MPPT) et publie les valeurs décodées sur un broker Mosquitto MQTT local, que Home Assistant affiche ensuite sous forme de capteurs tels que tension, courant, état de charge, puissance solaire et état de charge. Le CPU, la température, le Wi-Fi et la durée de fonctionnement du Pi peuvent également être affichés. Un sidecar Modbus en lecture seule optionnel prend en charge un onduleur Sungold SPH302480A via USB (PV, batterie, réseau, charge), et un sidecar VE.Direct optionnel agit comme superviseur de batterie. Les deux sont désactivés par défaut et activés via des drapeaux dans un fichier .env privé. Un deuxième Raspberry Pi (HOST_ROLE=pi5) peut exécuter un DNS LAN via AdGuard et transmettre les données Bluetooth Low Energy de la maison au broker Pi 4. L'installation est pilotée par scripts/deploy.sh, qui configure Docker, Mosquitto, Home Assistant et le lecteur Bluetooth Victron, et peut être relancé en toute sécurité. La configuration se trouve dans .env (hôte MQTT, utilisateur, mot de passe, drapeaux de fonctionnalités) et victron-secrets.env (clés publicitaires de 32 caractères), avec les adresses MAC des appareils définies dans un fichier de paramètres utilisateur. Le README note que le pont Victron valide ses secrets au démarrage et se termine avec une variable manquante nommée plutôt que de fonctionner sans eux. L'accès est prévu pour le réseau local, avec Tailscale optionnel pour consulter le tableau de bord à distance plutôt que de l'exposer publiquement. La documentation couvre l'ajout ou la suppression d'appareils, le rôle edge du Pi 5, Tailscale, les spécificités Sungold, l'équilibre de la puissance solaire et les options du tableau de bord, ainsi que des étapes de dépannage pour les problèmes courants tels que Home Assistant inaccessible, entités Victron manquantes, connexion MQTT refusée et boucles de redémarrage de conteneurs. Sous licence MIT.