Guides d'installation → Enphase

Enphase

Enphase est le système que j'ai chez moi, et celui que Sunplug lit le mieux. L'IQ Gateway est sur votre réseau et répond en une seconde environ — pas de cloud, pas de quota, pas d'abonnement.

Éprouvé sur le terrain

Fait tourner la maison de l'auteur, en dialoguant avec une passerelle Enphase IQ toutes les trente secondes.

À quelle fréquenceToutes les 30 secondes

Voit la consommationOui, si les pinces de consommation sont posées

Voit la batterieOui, puissance et niveau de charge

Temps d'installationUne dizaine de minutes

Ce qu'il vous faut

Une IQ Gateway (une Envoy sur les installations plus anciennes) sur votre réseau
Une machine qui reste allumée — un NAS, un Raspberry Pi, une box Home Assistant
Vos identifiants Enlighten, utilisés une seule fois

Pourquoi ça tourne sur votre réseau

Enphase a bien une API cloud, et Sunplug ne l'utilise pas. Deux raisons, qui valent la peine d'être connues avant qu'on vous suggère le contraire.

Elle sert des moyennes sur quinze minutes, et le plan développeur gratuit autorise environ mille appels par mois — soit à peu près un relevé toutes les quarante-cinq minutes. On ne suit pas le bord d'un nuage avec ça. Les formules payantes reviennent à trente ou quarante dollars par site et par mois, soit plus que ce que ce produit entier peut raisonnablement coûter.

Les conditions de l'API Enphase précisent par ailleurs qu'elle n'est pas destinée aux applications grand public. Lire votre propre passerelle, sur votre propre réseau, n'est concerné par rien de tout cela.

C'est pour ça que Sunplug gère Enphase. ChargeHQ ne l'a jamais fait — leur documentation invoquait des « contraintes techniques et commerciales », ce qui ressemble beaucoup aux deux paragraphes ci-dessus.

Installation

Docker

Sur n'importe quelle machine allumée en permanence et sur le même réseau que la passerelle — un NAS, un NUC, un Raspberry Pi. L'image est publiée pour x86 et pour ARM.

Docker Hubsunplugapp/sunplug-agent

GitHubghcr.io/sunplug/sunplug-agent

docker run -d --name sunplug-agent --network host \
  -v sunplug-agent:/data --restart unless-stopped \
  sunplugapp/sunplug-agent:latest

Puis ouvrez http://<cette machine>:8787 depuis n'importe quel navigateur de votre réseau — votre téléphone fait l'affaire.

La page scanne votre réseau, trouve la passerelle et lit son numéro de série pour vous, demande vos identifiants Enlighten, puis le code à six caractères affiché dans l'application. Ensuite l'agent démarre avec la machine et se débrouille seul. Aucun terminal, à aucun moment.

--network host n'est pas optionnel. L'agent balaie votre sous-réseau local pour trouver la passerelle, et un conteneur sur un réseau bridge ne la voit pas. Sur un NAS dont l'interface Docker ne permet pas de le régler, passez par sa fonction Compose ou Projets — le dépôt contient un compose.yml qui s'en charge.

Home Assistant

Si vous avez déjà Home Assistant, c'est deux clics plutôt qu'un terminal.

Paramètres → Modules complémentaires → Boutique → ⋮ → Dépôts
Ajoutez https://github.com/sunplug/sunplug
Installez Sunplug agent et démarrez-le
Cliquez sur Ouvrir l'interface web et suivez la page

Il vous faudra le code à six caractères de Sunplug : Réglages → Système solaire → Agent Sunplug.

Sans Docker

pip install "git+https://github.com/sunplug/sunplug.git#subdirectory=agent"
sunplug-agent run

À propos de ce mot de passe

Enphase ne délivre pas de jeton pour la passerelle sans identifiants Enlighten. L'agent utilise les vôtres pour exactement une requête, reçoit un jeton limité à votre passerelle et valable environ un an, et conserve celui-ci. Le mot de passe lui-même n'est jamais écrit sur le disque et ne quitte jamais votre réseau — il n'atteint pas du tout les serveurs de Sunplug.

Vérifier que ça marche

docker logs -f sunplug-agent

Une ligne toutes les trente secondes, du genre pv=2.62kW grid=-0.31kW load=2.31kW soc=0.47. Dans l'application, l'indicateur de fraîcheur du tableau de bord doit se stabiliser à quelques secondes.

Quand ça ne marche pas

Rien trouvé sur le réseau

La machine qui fait tourner l'agent est probablement sur un segment de réseau différent de la passerelle — le Wi-Fi invité et les VLAN IoT sont les coupables habituels. Vous pouvez sauter la recherche : sunplug-agent setup --host 192.168.1.50, avec l'adresse de votre passerelle.

La passerelle refuse le jeton

Les jetons durent environ un an et l'agent les renouvelle un mois avant l'échéance. Si l'un est refusé plus tôt, il en refabrique un automatiquement. Des échecs répétés signifient en général que le mot de passe Enlighten a changé.

La consommation de la maison semble fausse, ou absente

La consommation nécessite les pinces ampèremétriques posées sur votre arrivée. Beaucoup d'installations Enphase ne mesurent que la production. Sans elles, Sunplug voit ce que vos panneaux produisent mais pas ce qui est disponible — associez un compteur Shelly au point de livraison et il en déduit le reste.

La recharge ne démarre jamais par temps ensoleillé

Presque toujours le signe du réseau. L'injection doit apparaître en négatif. Si le schéma de flux du tableau de bord montre l'énergie qui va dans le mauvais sens entre votre maison et le réseau, c'est la première chose à corriger.

Bloqué ? Écrivez-moi — joignez les logs et je vous dirai ce qu'ils veulent dire.