Documentation · 3.8.1
Dépannage et glossaire
Les problèmes courants et comment les résoudre, les outils de diagnostic, les sauvegardes et le glossaire des mots à connaître.
Documentation à jour avec TedEnergy 3.8.1.
Par où commencer
- Lisez le bandeau d'état du tableau de bord et la ligne d'état de l'onduleur concerné : TedEnergy dit en clair ce qui se passe et pourquoi.
- Ouvrez la page Diagnostic : liaisons, valeurs reçues par type de connexion, temps de démarrage des onduleurs, tests, journaux.
- Regardez Notifications et journal › Avertissements et erreurs.
- Une IA peut analyser vos journaux : Paramètres › Régler avec une IA.
- Pour demander de l'aide, joignez le dossier de diagnostic (Diagnostic › Journaux : un .zip avec les journaux des derniers jours et la configuration, jetons et mots de passe masqués).
L'interface ne s'ouvre pas
- Vérifiez que TedEnergy tourne : conteneur démarré dans Container Manager ou Docker, application démarrée dans Home Assistant.
- Vérifiez l'adresse et le port : avec Docker, c'est le port publié de la machine (par exemple 5002) ; avec Home Assistant OS, ouvrez TedEnergy dans la barre latérale.
- Un port déjà pris par un autre service empêche le démarrage : choisissez-en un autre.
- Après une mise à jour, rechargez la page : un bandeau vous le propose.
Home Assistant injoignable ou jeton refusé
- Utilisez l'adresse IP de Home Assistant avec son port (
http://192.168.1.50:8123), pashomeassistant.local, qui ne fonctionne pas toujours depuis un conteneur. - Un « jeton refusé » vient d'un jeton incomplet ou supprimé : recopiez-le en entier ou créez-en un nouveau.
- TedEnergy et Home Assistant doivent être sur le même réseau local.
Le compteur n'est pas lu
- Vérifiez la source dans Paramètres › Compteur électrique : entité, adresse du Shelly, ou valeur d'un appareil. Le bouton de test affiche la mesure.
- Un compteur illisible met la régulation en veille : aucune consigne n'est envoyée tant qu'il manque.
- Avec plusieurs compteurs, le suivant prend le relais après un court délai ; la page Diagnostic montre lequel est utilisé.
- Vérifiez le signe : positif quand la maison achète, négatif quand elle injecte (réglage d'inversion possible).
Une batterie ne charge pas ou ne décharge pas
Dans l'ordre :
- L'onduleur est-il activé et piloté (page Onduleurs) ? Un nouvel onduleur est enregistré désactivé.
- Le niveau de batterie est-il à son minimum (décharge) ou à son maximum (charge) ? La marge de redémarrage peut aussi retenir quelques points.
- Une pause est-elle indiquée (consigne changée par un autre système, erreur 01, calibration) ? La fiche le dit en clair.
- Un mode actif empêche-t-il l'action ? Une automatisation ou une fonction du Store (vacances, réserve, injection) peut bloquer la charge ou la décharge.
- Le compteur est-il lu ? Sans mesure, rien n'est envoyé.
- Les mesures de l'onduleur arrivent-elles ? Sinon la fiche indique « mesures non reçues » : voir la section dédiée.
- Faites le test de validation de l'onduleur (Diagnostic › Test des onduleurs).
Erreur 01 ou 02 qui revient
- Une erreur 01 signale un onduleur qui n'applique pas sa consigne. TedEnergy le teste régulièrement : en général, il se débloque tout seul.
- Si elle revient souvent, regardez si l'appareil est en cours de calibration, trop froid, ou limité par sa batterie ; vérifiez ses puissances maximales dans la fiche.
- Une marque dont la réponse est lente peut avoir besoin d'un délai de détection plus long (Paramètres › Surveillance et sécurité).
- Pour un appareil dont le comportement est normal, la case Inhibition de l'erreur 01 / 02 de sa fiche coupe la détection.
« Consigne changée par un autre système »
TedEnergy a vu que la consigne ou le mode d'un onduleur a été modifié en dehors de lui : application du fabricant, intégration de Home Assistant, automatisation tierce. L'onduleur est mis en pause quelques minutes puis repris. Pour que cela cesse, coupez l'autre source de commande ; si c'est voulu, la pause se règle (0 la supprime). Le bouton Reprendre la main reprend la main tout de suite.
« Mesures non reçues »
Les valeurs d'un onduleur n'arrivent plus. Pour une connexion cloud, vérifiez qu'un seul accès existe pour le compte (TedEnergy ou l'intégration du fabricant dans Home Assistant), puis la page Diagnostic de la connexion. Pour une API locale ou MQTT, vérifiez l'adresse, le Wi-Fi de l'appareil et que le serveur MQTT est démarré. TedEnergy bascule seul vers une autre connexion de l'appareil si vous en avez déclaré une.
Licence impossible à obtenir ou à valider
- La machine doit pouvoir joindre
https://ted-energy.fr. - Vérifiez votre boîte e-mail (courrier indésirable compris) : le lien de confirmation est nécessaire.
- Sans accès à Internet, téléchargez le fichier de licence sur le site et importez-le (Paramètres › Licence).
- Voir Licence et compte.
Sauvegarde, restauration et versions
- Paramètres › Sauvegarde et versions exporte la configuration en un fichier étiqueté avec les versions qui peuvent l'utiliser, et la restaure après vérification. Une restauration refusée explique pourquoi (version trop ancienne ou trop récente).
- TedEnergy peut revenir à une version précédente embarquée dans l'image (page Versions), en gardant vos réglages quand c'est possible. Un bandeau rappelle qu'une version précédente est en service ; si la version choisie ne démarre pas, TedEnergy revient automatiquement à la précédente.
- Téléchargez votre configuration avant toute modification importante.
Demander de l'aide
La communauté répond sur Discord et Facebook. Pour une aide efficace, indiquez : la version de TedEnergy (page Aide), votre type d'installation (Home Assistant OS, Docker, Synology), la marque et le modèle de l'onduleur concerné, ce que vous attendiez et ce qui s'est passé, avec l'heure. Le support peut aussi se connecter à votre interface si vous l'autorisez (voir Licence et compte).
Glossaire
- HEMS : gestionnaire d'énergie de la maison. Il décide quand charger ou décharger les batteries. TedEnergy en est un ; beaucoup de fabricants fournissent le leur (HEMS constructeur).
- Onduleur piloté : onduleur qui reçoit les consignes de charge et de décharge de TedEnergy.
- Onduleur surveillé : onduleur géré par un autre système, que TedEnergy mesure sans le commander ; il guide le mode Assisté.
- Brouillon : appareil en cours de configuration, jamais utilisé tant qu'il n'est pas activé.
- Mode Autonome : TedEnergy gère seul toutes les batteries en lisant le compteur.
- Mode Assisté : TedEnergy complète le HEMS d'un fabricant (HEMS secondaire).
- SOC (état de charge) : niveau d'une batterie, en pourcentage.
- Consigne : puissance demandée à un onduleur.
- Export / injection : électricité envoyée sur le réseau (compteur négatif).
- Autonomie : part de la consommation de la maison qui n'a pas été achetée au réseau.
- Charge planifiée : charge depuis le réseau pendant un créneau choisi.
- Charge sur surplus : charge des batteries avec le surplus solaire.
- Charge optimisée : méthode (expérimentale) où deux onduleurs absorbent chaque variation à petite puissance.
- Cluster : groupe d'onduleurs à consigne commune. Zone : groupe d'onduleurs à plafond de puissance commun.
- Triphasé (L1, L2, L3) : réseau à trois phases ; chaque onduleur est rattaché à sa phase.
- Puissance souscrite : la puissance de votre abonnement (kVA), qui plafonne la charge et la décharge.
- Heures creuses / pleines : périodes tarifaires de votre contrat. Tempo : contrat avec des jours bleus, blancs et rouges.
- Connexion : le moyen de joindre un appareil (API locale, MQTT, cloud, Home Assistant).
- Erreur 01 / 02 : onduleur qui n'applique pas sa consigne / test impossible pour l'instant.
- Store : fonctions prêtes à activer. Widget : carte du tableau de bord.
Questions fréquentes
Où trouver la version de TedEnergy ?
Dans la page Aide de l'interface (« Version du logiciel »), et dans Paramètres › Sauvegarde et versions.
TedEnergy a redémarré, ai-je perdu quelque chose ?
Non : réglages, licence et historique sont dans le dossier de données. Les automatisations reprennent là où elles en étaient.
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.