Pas de YAML, pas de recompilation : ce que vous pouvez changer depuis Home Assistant, et ce que vous ne pouvez pas

  • Testé sur le firmware v1.2.1
  • Intermédiaire

Sur la plupart des compteurs d'énergie ESPHome, modifier la plupart des réglages signifie modifier le YAML, le compiler, flasher le résultat et attendre. La documentation des puces de mesure courantes le dit en toutes lettres : ajustez un nombre, recompilez, installez, regardez la lecture, recommencez. Chaque passage coûte un redémarrage, et un redémarrage coûte des mesures.

Cette boucle est ce que les gens reprochent vraiment — pas le manque de fonctionnalités. La question utile quand on fait tourner un compteur dans Home Assistant est donc une question étroite : qu'est-ce qui peut changer pendant que le compteur continue de tourner, et qu'est-ce qui nécessite encore la boucle ?

Ce qui change pendant que le hub continue de tourner

Tout ceci est une action envoyée à un hub en marche : elle s'applique immédiatement, sans recompilation ni flashage. Deux de ces lignes ont une partie qui attend un redémarrage ; elles sont annotées plus bas.

Où
Points : créer, nommer, lier à une voie, relier, rôle, phase, valeur nominale, groupe, inversion de signe, supprimer et restaurer panneau → Points
Modules : rechercher sur le bus, en ajouter un par son adresse, voir son modèle, son firmware et son état panneau → Points
Quel modèle de pince est sur une voie — par une action, pas par un bouton ; le panneau l'affiche action + panneau → Points
Plan tarifaire : zones par heure, frais de réseau, taxe sur l'énergie, prélèvement, TVA panneau → Tariff
Devise du plan panneau → Tariff
Sources de prix : fournisseur, zone, source de secours, majoration, facteur, planchers, mode de prix de vente, tarification de chaque période d'une heure au prix moyen de cette heure, superposition d'une zone du plan sur le prix spot panneau → Prices
Règles de fenêtres bon marché, jusqu'à huit panneau → Prices
Pointes d'appel : affichées ici ; le jour de début de la période de facturation se définit en appelant l'action de l'intégration depuis une automatisation ou depuis Developer Tools, et non par un formulaire panneau → Prices
Fuseau horaire du hub, avec un bouton pour reprendre celui de Home Assistant panneau → Prices
Nœuds ESP-NOW : appairer, lister, désactiver, activer, retirer, choisir les entrées qu'ils transportent panneau → Network

Un élément de cette liste relève de la topologie plutôt que du réglage : le rôle supply — votre entrée réseau — se définit en créant ou en reliant un point, pas en modifiant un point existant.

Et supprimer un point clôt sa comptabilité au lieu de l'effacer : l'historique reste en flash, et il existe une restauration.

L'unique exception : les broches du bus I²C

Changer les broches utilisées par le bus des modules nécessite un redémarrage du hub. Le panneau l'indique à l'endroit où vous le faites, et il est clair sur la conséquence : les modules sur les anciennes broches se déconnectent jusqu'au redémarrage.

Voilà toute la liste des exceptions. Tout le reste ci-dessus s'applique sur un hub en marche.

Ce qui attend, et pendant combien de temps

Rien de tout cela n'est une recompilation. C'est la différence entre un réglage qui prend effet et un enregistrement qui démarre.

Prend effet Attend
Un point que vous créez, renommez ou reliez immédiatement — valeurs en direct et périodes de 15 minutes son historique flash (les enregistrements horaires) démarre après le prochain redémarrage
Un nœud que vous venez d'appairer l'appairage lui-même ses points apparaissent après un redémarrage
Enregistrer toute la configuration des points d'un coup — un redémarrage ; modifier un seul point ne déclenche rien
Les broches du bus I²C — un redémarrage, et les modules sur les anciennes broches se déconnectent jusqu'à celui-ci

Ce qui nécessite du YAML et une installation

Une clé de chiffrement de l'API l'image prête à l'emploi est construite sans clé ; une clé implique votre propre configuration et une installation
La version du composant, si vous construisez le vôtre augmenter ref: dans external_components, puis installer
Tout le reste de votre propre YAML par définition

Si vous ne construisez pas votre propre configuration, la version du composant arrive de la même façon que le firmware : une nouvelle image prête à l'emploi, installée par voie hertzienne (OTA). Aucun YAML n'intervient.

À savoir d'avance : ces deux lignes sont liées. Dès que vous voulez une clé de chiffrement de l'API, vous construisez votre propre configuration — et à partir de là, chaque installation vous revient à construire, y compris celles qui auraient été une image prête à l'emploi.

⚠️ Installez par voie hertzienne (OTA), pas par USB. Flashé par USB avec les outils d'ESPHome — esphome run vers un port série, ou Manual download → Factory format — votre build atterrit à la mauvaise adresse et la carte ne démarre rien de neuf : une carte vierge ne démarre pas, et une carte avec une ancienne image continue silencieusement de faire tourner l'ancienne. Par voie hertzienne, seule l'application est envoyée, et l'appareil la place selon sa propre table de partitions. Faites la première installation USB avec l'image factory prête à l'emploi, puis installez votre propre build par voie hertzienne.

Modifier le Wi-Fi du hub

Pas dans le panneau, et pour l'image prête à l'emploi pas non plus dans le YAML.

Quand le hub ne peut pas rejoindre le réseau enregistré — un nouveau routeur, un déménagement — il ouvre son propre point d'accès de configuration environ une minute plus tard, avec un portail captif : rejoignez-le et choisissez le nouveau réseau. Le point d'accès s'appelle rbgrid-hub-xxxxxx et son mot de passe est RBGRID123 ; changez ce mot de passe une fois le hub configuré, comme vous le feriez pour n'importe quel mot de passe par défaut livré. Improv via USB fonctionne aussi : web.esphome.io → Connect → Change Wi-Fi.

La mesure ne s'arrête pas quand le hub est hors réseau. Il continue de mesurer et de clore ses périodes ; ce qui est coupé, ce sont Home Assistant et la récupération des prix, jusqu'au retour de la liaison.

Ce qui n'est pas du tout un réglage

C'est ici que la réponse honnête diffère de celle que vous attendez peut-être.

Il n'existe pas de champ de calibration — sur aucune des deux voies, et pas parce qu'il aurait été oublié du panneau. Le module rbAmp est l'appareil de mesure : il renvoie tension, courant et puissance déjà calibrés, et cette calibration est faite sur le module en usine. RBgrid n'écrit jamais dedans, volontairement — le hub collecte, enregistre et tarife ce que le module rapporte.

Donc si vous êtes habitué à ajuster une pince par rapport à un compteur de référence : il n'existe pas de correction par voie, ni d'outil pour en faire une. Les registres de gain ne sont inscriptibles qu'en mode usine ; sur un module que vous avez acheté, l'écriture est refusée.

La raison tient à l'endroit où se fait la calibration. Chaque voie de chaque module est calibrée en production, et le choix du modèle de pince convertit cette calibration à la valeur nominale de votre pince. Ce qui reste est la tolérance de votre SCT-013 particulier, qui est une propriété du capteur et figure sur sa propre ligne dans la fiche technique du capteur — non quelque chose que le module prétend éliminer.

Et si vous voulez corriger pour votre propre installation, la place pour cela est votre propre logiciel : un capteur template dans Home Assistant qui multiplie la lecture est une chose parfaitement raisonnable à faire. Le module ne le fera pas pour vous, et rien dans le hub ne prétend le faire.

Ce modèle est un réglage, et il change pendant l'exécution — depuis le panneau, dans la boîte Edit du point, où « CT clamp model » liste les modèles que le hub propose lui-même. Le sélecteur n'apparaît que lorsque le module permet d'en choisir un ; un module non calibré refuse le changement et le dit dans les propres termes du hub.

⚠️ Si vous ne voyez pas ce sélecteur, votre intégration est antérieure à la version qui l'a ajouté — sur les anciennes, le panneau affichait le modèle de pince sans pouvoir le changer, et la façon de le définir était un appel de service plutôt qu'un champ. Mettre à jour est la réponse courte ; l'appel fonctionne toujours si vous préférez ne pas le faire.

Changer de modèle ne vous coûte pas la calibration. Réglez-le quand vous branchez une pince, et réglez-le à nouveau quand vous la remplacez ; sur le chemin qu'utilise le hub, la calibration de la voie survit au changement comme au redémarrage.

Ce qu'une installation coûte en mesure

Une installation par voie hertzienne est un redémarrage planifié. L'heure en cours et les totaux depuis l'origine y survivent — mesuré sur un S3 lors de quatre installations alternant deux images.

L'interruption est de quelques secondes : pendant le téléversement lui-même, le hub continue de mesurer, et le cœur est de retour quelques secondes après le redémarrage. Aucune période de 15 minutes n'est perdue — même si celle dans laquelle tombe le redémarrage est plus courte de ces quelques secondes.

Ce que ces secondes coûtent dépend des modules que vous avez, et c'est la partie qu'il vaut la peine de préciser :

  • Modules STD — modules de mesure qui tiennent leurs propres compteurs d'énergie : rien. L'énergie est comptée dans le module, et le hub lit la différence de compteur après le redémarrage.
  • Modules Basic — le type qui lit une pince, où le module mesure la puissance et le hub l'intègre en énergie : ces quelques secondes ne sont pas comptées. C'est une quantité d'énergie négligeable. Elle n'est pas nulle.

Donc : quelques secondes pendant le redémarrage, plutôt qu'un enregistrement sans interruption.

Ce que cela ne fait pas

  • Cela ne retire pas ESPHome du tableau. L'appareil est un appareil ESPHome ; le côté réseau, les installations et votre propre YAML, si vous en gardez un, relèvent d'ESPHome.
  • Cela n'allume et n'éteint rien. Chaque réglage ci-dessus concerne la mesure et la tarification ; ce qu'on fait d'une fenêtre bon marché relève de la décision de votre automatisation.
  • Cela ne rend pas un redémarrage gratuit. Cela le rend rare, et dit ce que coûte le rare.

Pour en savoir plus