Documentation · 3.8.1
Mes appareils
Onduleurs et batteries, leurs connexions, le compteur d'électricité et les équipements de la maison (borne de recharge, ballon, pompe à chaleur…).
Documentation à jour avec TedEnergy 3.8.1.
Les onduleurs : piloté, surveillé, solaire
La page Appareils › Onduleurs liste tout ce que TedEnergy connaît. Chaque onduleur à batterie y a un rôle :
- Piloté : TedEnergy règle sa charge et sa décharge.
- Surveillé : TedEnergy le lit seulement. Il sert quand un autre système (le HEMS d'un fabricant) garde les commandes : c'est la base du mode Assisté.
- Solaire : onduleur de panneaux sans batterie (micro-onduleurs…) : sa production est mesurée et affichée.
- Brouillon : appareil en cours de configuration, jamais utilisé tant qu'il n'est pas activé.
Chaque ligne montre la batterie, la puissance, l'état et, en triphasé, la phase. Un interrupteur active ou désactive l'onduleur ; le menu ⋮ propose les actions utiles (reprendre la main, forcer un essai, retirer de la régulation…). Un onduleur peut être retiré de la régulation sans que sa fiche d'appareil disparaisse.
Déclarer un appareil
Dans Paramètres › Appareils, un appareil est déclaré une seule fois, avec un nom et une référence uniques. On y choisit la marque (une fiche par marque, ou « Autre marque ») et le modèle. La page Onduleurs ne sert ensuite qu'à lui donner un rôle, une phase, une priorité de décharge et à l'activer : aucune entité n'y est saisie.
La fiche d'un appareil réunit plusieurs onglets : les connexions, les commandes, les mesures, les niveaux de batterie, les batteries et les valeurs lues. Pour une marque connue, un remplissage automatique propose les entités ; pour les autres, une loupe aide à les choisir. Dans tous les cas, on teste la fiche avant de l'enregistrer : TedEnergy vérifie que les mesures arrivent et que les commandes sont acceptées.
- Commande : deux consignes (charge et décharge, avec ou sans sélecteur de mode), une consigne et un sélecteur de sens, une consigne signée, ou des actions de Home Assistant ; en W, kW, % ou A.
- Mesures : seul le niveau de batterie est obligatoire. La puissance, le solaire, la puissance de la batterie, la sortie AC… sont facultatives : chaque fonction qui en a besoin est désactivée, avec une explication, si la mesure manque.
- Contrôles de cohérence : TedEnergy refuse d'enregistrer une fiche qui réutilise la commande ou le niveau de batterie d'un autre appareil, vérifie que les actions demandées existent et signale un appareil dont les entités ne correspondent pas.
- Inhibition de l'erreur 01 / 02 : case de la fiche pour un appareil dont le comportement est légitime (voir Comment TedEnergy règle).
Un nouvel onduleur piloté est enregistré désactivé, et le test de validation (Diagnostic › Test des onduleurs) vous est proposé à l'activation.
Les connexions d'un appareil
Un même appareil peut être joint de plusieurs façons. TedEnergy utilise la première disponible dans l'ordre : MQTT local, API locale, cloud du fabricant, Home Assistant (ordre modifiable pour chaque appareil). Si la connexion utilisée ne répond plus pendant un certain temps, la suivante prend le relais ; la connexion préférée revient quand elle est de nouveau stable.
- API locale : l'appareil est interrogé directement sur le réseau de la maison (adresse IP), sans Internet. Disponible pour des modèles récents (par exemple Zendure SolarFlow, Indevolt, IsyPower).
- MQTT local : l'appareil publie ses valeurs vers le serveur MQTT intégré à TedEnergy (voir plus bas), sans Internet.
- Cloud du fabricant : TedEnergy se connecte au compte du fabricant (Zendure, EcoFlow). Pratique, mais un seul accès cloud est possible par compte Zendure : TedEnergy ou l'intégration Zendure de Home Assistant.
- Home Assistant : pour toutes les marques que Home Assistant sait lire, avec des entités.
La page Diagnostic a une page par type de connexion (Home Assistant, cloud, API locale, MQTT) : valeurs reçues, rythme des relevés, consignes envoyées et confirmées, événements. Un appareil qui reste sur une connexion de secours est signalé.
Un appareil du tableau des onduleurs garde toujours au moins une connexion utilisable : on ne peut pas retirer la dernière.
Marques et modèles
Les marques et modèles pris en charge, avec leur niveau (Opérationnel, Compatible, Surveillance seulement) et leurs connexions possibles, sont listés et tenus à jour sur la page Compatibilité.
En résumé : Zendure est le plus complet (cloud, API locale, MQTT) ; EcoFlow est relié par son cloud ; Indevolt et IsyPower par leur API locale ; les autres marques passent par Home Assistant ou par MQTT, avec la fiche « Autre marque » ouverte à tous. Si votre marque n'y figure pas, demandez-la sur la communauté.
Les connecteurs d'appareils
Paramètres › Connecteurs d'appareils relie TedEnergy aux marques qui ont un accès direct :
- Zendure : collez le jeton de l'application Zendure pour le cloud, ou ajoutez l'appareil par son adresse IP pour l'API locale ; le serveur MQTT intégré accueille les appareils en « contrôle MQTT ».
- EcoFlow : par le compte développeur du fabricant.
- Indevolt et IsyPower : adresse IP de l'appareil ; une recherche sur le réseau aide à le trouver.
- D'autres marques sont à l'étude ; la page indique pourquoi (par exemple un accès local trop lent).
Les appareils ainsi ajoutés se choisissent ensuite dans la fiche de l'appareil, comme une entité de Home Assistant.
Le serveur MQTT intégré
TedEnergy contient un serveur MQTT que les appareils compatibles peuvent utiliser à la place du cloud. Paramètres › Connexion MQTT guide la mise en service pas à pas : démarrage du serveur, ouverture du port (avec un bouton pour les installations Home Assistant OS), test, valeurs à saisir dans l'appareil, vérification que l'appareil est connecté. Les appareils qui s'y connectent apparaissent avec leurs valeurs et se rattachent à une fiche d'appareil.
Home Assistant
Home Assistant est une connexion parmi d'autres : il n'est obligatoire que pour les appareils sans connexion directe. Avec l'application Home Assistant OS, la connexion est automatique. Avec Docker, saisissez l'adresse de Home Assistant (avec son port) et un jeton d'accès longue durée dans Paramètres › Connexion Home Assistant.
TedEnergy lit les valeurs en groupe, ou en temps réel quand la liaison le permet, pour ne pas surcharger Home Assistant. Ces réglages fins sont dans Communication avancée ; les valeurs par défaut conviennent.
Les batteries et leurs niveaux
- Les batteries d'un onduleur se déclarent dans l'onglet Batteries de sa fiche (détection automatique ou saisie) : nombre, capacité en kWh, tension. Elles servent aux widgets d'énergie, à la préparation de la charge et à l'alerte d'écart de tension entre cellules.
- Les niveaux minimal et maximal protègent la batterie : l'onduleur ne se décharge pas sous le minimum ni ne se charge au-dessus du maximum. Ils se règlent globalement (Paramètres › Batteries et puissances maximales, avec une jauge à glisser, une flèche par onduleur) et peuvent être propres à chaque onduleur.
- Un interrupteur peut appliquer les niveaux généraux à tous les onduleurs qui ont l'entité correspondante : TedEnergy écrit puis contrôle et corrige les niveaux. Les niveaux d'origine sont gardés en mémoire et remis quand on désactive l'interrupteur.
- Une marge de redémarrage évite les va-et-vient aux extrémités : une batterie presque pleine ne recommence pas à charger, une batterie presque vide ne recommence pas à décharger, avant d'avoir quitté sa zone limite de quelques points. Elle se règle globalement et par onduleur.
- Une automatisation peut imposer un niveau pendant un temps ; le niveau imposé est alors verrouillé et signalé.
Clusters, zones et phases
- Un cluster réunit des onduleurs qui se comportent comme un seul (consigne commune, niveau moyen). Pratique pour plusieurs batteries derrière le même point de raccordement.
- Une zone fixe un plafond de puissance commun à plusieurs onduleurs (par exemple le disjoncteur qu'ils partagent).
- En triphasé, chaque onduleur est rattaché à sa phase (L1, L2, L3). Pour un onduleur piloté, TedEnergy peut identifier la phase tout seul : un bouton fait varier sa puissance par paliers et observe la phase qui réagit. Pour les autres, la phase se saisit.
Tester un onduleur
Diagnostic › Test des onduleurs vérifie qu'un appareil applique réellement les consignes de charge et de décharge, hors de la régulation, avec une petite puissance au choix. Le résultat s'affiche sur la fiche (une pastille signale les appareils jamais testés, à revalider ou en échec). Le test sert aussi, si besoin, à détecter la phase de l'onduleur.
Le compteur d'électricité
Toute la régulation repose sur la puissance échangée avec le réseau. Paramètres › Compteur électrique indique d'où elle vient :
- une entité de Home Assistant (positive à l'achat, négative à l'injection) ;
- un Shelly lu directement par son adresse IP (monophasé ou triphasé ; un test affiche la puissance de chaque phase et propose la bonne) ;
- la valeur d'un appareil relié à TedEnergy (par exemple un compteur Zendure).
Vous pouvez déclarer plusieurs compteurs classés par priorité : si le premier ne répond plus, le suivant prend le relais, et le premier revient quand il est stable. Le signe de la mesure peut être inversé.
Les équipements de la maison
Appareils › Équipements déclare ce qui consomme ou charge : borne de recharge de voiture, ballon d'eau chaude, pompe à chaleur ou climatisation, piscine, lave-linge, radiateur, prise domotique, autre. Les équipements sont suivis (puissance, énergie par jour), affichés dans la maison animée et ajoutés aux rapports PDF. Ils n'agissent pas sur la régulation, sauf la borne si vous la faites piloter par TedEnergy.
Comment TedEnergy mesure l'équipement est au choix : une mesure de puissance (W ou kW), un compteur d'énergie (Wh ou kWh : la puissance est calculée à partir de sa variation), un courant (A) ou une puissance fixe quand l'appareil est en marche. Plusieurs entités peuvent être additionnées. Chaque équipement peut être masqué de la scène (seuil d'affichage) ou exclu des rapports.
- Le bilan d'un équipement donne son énergie, sa part de la consommation de la maison, l'origine de cette énergie (solaire, batteries, réseau) et son coût au prix de chaque moment.
- Un équipement déjà compté dans un autre peut être marqué « compris dans… » pour éviter un double compte.
La borne de recharge pilotée
Une borne peut être pilotée par TedEnergy (case dans sa fiche). Vous choisissez dans la fiche ses objectifs, écrits comme des phrases :
- recharge sur le surplus solaire (avec un courant minimal et maximal) ;
- recharge pendant les heures avantageuses de l'abonnement ;
- une heure de départ avec un niveau à atteindre ;
- un niveau de secours, et les boutons Charger maintenant, Pause, Automatique.
La voiture ne reçoit jamais l'énergie des batteries de la maison. La borne respecte la puissance souscrite (et la régulation sur la somme des phases si elle est triphasée).
Une décharge de la voiture vers la maison (V2G) est possible à titre expérimental : TedEnergy crée alors un onduleur virtuel, géré par la fiche de la borne. Il est de priorité basse et son niveau minimal est protégé.
La fiche de la borne explique l'effet d'un mauvais réglage sur la durée de vie de la batterie de la voiture. Les réglages de la borne sont uniquement dans sa fiche, jamais dans la page Paramètres.
Questions fréquentes
Combien d'onduleurs puis-je piloter ?
Le nombre d'onduleurs pilotés dépend de votre licence : il est indiqué dans Paramètres › Licence. Voir Licence et compte. Au-delà, les onduleurs en trop sont traités comme désactivés.
Puis-je mélanger plusieurs marques ?
Oui, c'est le point fort de TedEnergy : chaque marque garde sa connexion, la régulation répartit entre tous les onduleurs pilotés.
Mon onduleur n'est pas dans la liste.
Choisissez « Autre marque » : la fiche accepte les entités de tout appareil exposé par Home Assistant ou par MQTT. Faites ensuite le test de validation.
Pourquoi une fiche refuse-t-elle de s'enregistrer ?
Probablement parce qu'elle réutilise la commande ou le niveau de batterie d'un autre appareil, ou parce qu'une action demandée n'existe pas dans Home Assistant. Le message indique le champ concerné.
Prêt à faire travailler toutes vos batteries ensemble ?
Téléchargement gratuit : votre licence gratuite arrive dès que votre adresse email est confirmée, sans carte bancaire.