11 · Journal des modifications
Historique des versions du composant externe rbamp pour ESPHome. Cette page reprend CHANGELOG.md du dépôt, qui fait référence.
Les versions publiques reprennent avec la v1.9.0 ; les versions intermédiaires listées ci-dessous n'ont été publiées qu'en interne.
Contents:
- v1.9.1 — 2026-11-01
- v1.9.0 — 2026-10-21
- v1.8.1 — 2026-10-18
- v1.8.0 — 2026-10-17
- v1.7.0 — 2026-09-30
- v1.6.0 — 2026-09-04
- v1.5.0 — 2026-08 (usage interne uniquement)
- v1.4.0
- v1.3.0
- Politique d'obsolescence
- Guide de mise à niveau
v1.9.1 — 2026-11-01
Banques d'instantanés STD dans le YAML, modèles de pince 50 A et 100 A, et message clair lorsqu'un module appairé en usine refuse une écriture de configuration.
Ajouté
-
Bancs d'instantanés (
period_banks:) pour les modules qui les annoncent (ligne 16 bits, image 0x7E et ultérieure) : puissance moyenne par période, énergie, pics et durée de période sur l'un des huit bancs du module, capturés par uninterval:et/ou par la nouvelle actionrbamp.latch_bank. Les énergies par période sont des valeurs par période (state_class: measurement), et non des compteurs. La première capture après le démarrage ou un redémarrage du module ne fait que lancer la période. Exemple :example/std_banks.yaml. -
Tests hôte pour la logique de banc :
tests/host/test_std_bank.cpp(g++simple, sans framework). -
Registre des modèles de capteurs : les codes 11 (50 A, 33 Ω) et 13 (100 A, 20 Ω) sont désormais caractérisés et acceptés sans l'indication « réservé ».
Fixe
- Sur le firmware 1.4.22 et ultérieur, un module appairé en usine (classe
WIRED_CT/BUILTIN_CT) refuse les écritures de classe et de modèle en fonctionnement normal, même avecct_model_force: true(le forçage ne fonctionne qu'en mode usine). Le composant signale désormais « factory-paired module: configuration locked » au lieu d'une erreur générique de paramètre, et une écriture refusée dect_model:n'est plus persistée ni suivie de la correction de calibre.
v1.9.0 — 2026-10-21
Les publications publiques reprennent avec cette version ; les versions intermédiaires n'ont été diffusées qu'en interne.
Changement du calibre SCT sans perdre la précision d'usine (ligne 8 bits), ainsi que les verrous de protection des versions 1.8.x intégrés à cette version publique.
Ajouté
- Le SCT-013-060 et le -100 sont acceptés (ils étaient refusés côté client comme réservés) ; les limites de découpage du modèle de capteur ont été mises à jour avec les valeurs mesurées.
-
Correction du calibre SCT (modules avec la classe de capteur SCT-013, firmware ≤ 1.4.19). Chaque module SCT est calibré en usine avec le capteur -030 ; sélectionner un autre
ct_model:laissait auparavant le courant, la puissance et l'énergie sur l'échelle du -030. Le composant termine désormais l'écriture du modèle avec le redémarrage du module requis par la procédure (sauvegarde → reset → nouvelle détection avec contrôle d'UID), lit le gain réellement appliqué par le module et met à l'échelle le courant, les puissances active et réactive et l'intégration d'énergie sur le calibre du capteur sélectionné — la correction d'usine unitaire est conservée. La tension et le facteur de puissance ne sont pas affectés. Un redémarrage du module (propre ou externe) est détecté et la correction se recalcule automatiquement. Si le gain appliqué sort de ±5 % de la valeur du modèle de calibrage, le composant avertit et ne met pas à l'échelle. Aucune modification YAML n'est nécessaire. -
Le firmware 1.4.20+ effectue la bascule de calibre sur l'appareil et l'annonce — le composant la détecte alors et laisse les relevés intacts (simple écriture de modèle, sans redémarrage).
-
Test hôte de la logique de décision de correction :
tests/host/test_sct_rating.cpp(g++simple, sans framework).
v1.8.1 — 2026-10-18
Fixe
-
Protection de la calibration d'usine pour
sensor_class:/ct_model:(ligne 8 bits). Le firmware efface les modèles de canaux et les formes de linéarité à toute écriture de classe de capteur (même une valeur inchangée) et réapplique le préréglage générique à toute écriture de modèle de pince — le composant n'écrit donc jamais une valeur que l'appareil possède déjà, et refuse les changements de classe/modèle depuis le YAML sur un module calibré en couple avec son capteur intégré (classesWIRED_CT/BUILTIN_CT), avec une ligne de journal explicite. La nouvelle option de servicect_model_force: trueréapplique délibérément le préréglage ; le schéma la rejette sans clé de modèle afin qu'elle ne puisse pas rester armée dans le YAML. -
Lecture hors limites sur les modules à 5/7 canaux (UI5/UI7) : la boucle de publication de restauration au démarrage indexait les tableaux d'export à 3 emplacements jusqu'au canal 6 et pouvait publier une valeur parasite dans le capteur voisin. Corrigé avec la même barrière de canal que les autres points d'export ; les tailles des tableaux sont désormais figées par des assertions à la compilation.
-
Documentation et commentaires alignés sur la fenêtre de mesure de la famille de 100 ms (firmware v1.2+ ; 200 ms uniquement sur les anciennes images).
v1.8.0 — 2026-10-17
Énergie cumulée embarquée pour la ligne 16 bits.
Ajouté
-
Énergie issue des compteurs embarqués (modules à mots de 16 bits qui les annoncent dans leur matrice de capacités) : le composant cesse d'intégrer lui-même les Wh et accumule les compteurs propres du module — les totaux survivent aux redémarrages de l'ESP32 et du module, sans dérive d'intégration. Micro-résolution (µWh/µvarh) sur le firmware qui la publie, repli grossier automatique sinon. Chaque instantané est lu en une seule transaction I²C cohérente, et les sommes publiées restent monotones à travers les redémarrages du module et les remises à zéro des compteurs.
-
Nouveaux capteurs de total général :
energy_total,energy_exported_total,energy_net(import − export, peut diminuer),reactive_energy,reactive_energy_exported. -
Clé de configuration
start_current_ua:(0 = désactivé, 10..2540 par pas de 10 µA) : en dessous de ce courant, un canal n'accumule pas d'énergie — à vide, la puissance mesurée est un bruit de signe quelconque qui s'ajouterait sinon aux compteurs d'import et d'export. Les relevés ne sont pas affectés. Validée par le schéma ; persistée sur l'appareil avec une sauvegarde vérifiée. -
Surfaces triphasées :
voltage_angle_b/voltage_angle_c(degrés, par rapport à la phase A) etphase_sequence(1 direct · 2 inverse · 3 anormal), publiés sur les firmwares qui les fournissent ; « inconnu » sinon. -
Accesseurs lambda :
get_std_image_version(),get_phase_sequence_str(),read_start_current_ua().
v1.7.0 — 2026-09-30
Prise en charge de la nouvelle ligne de modules à table de registres 16 bits, détectée automatiquement avec le même YAML.
Ajouté
-
Prise en charge double ligne : une sonde d'identité au démarrage détecte les modules à mots de 16 bits et bascule le transport (pointeur big-endian, lectures en rafale à incrémentation automatique). Le nombre de canaux, la variante et les fonctions viennent du bloc de découverte de l'appareil —
topology:et les nombres d'emplacements du YAML ne sont plus nécessaires pour dimensionner la surface d'entités. Les modules 8 bits se comportent exactement comme avant. -
Les capteurs temps réel de la ligne 16 bits sont publiés depuis les registres en virgule fixe de l'appareil ; l'énergie utilise les instantanés atomiques de l'appareil avec intégration sur l'horloge maître et la même persistance NVS.
-
Les clés de configuration (
sensor_class:,ct_model:,new_address:) fonctionnent sur la ligne 16 bits via son bloc de configuration en attente, avec une sauvegarde vérifiée de façon synchrone. Lesct_models:par canal sur cette ligne exigent que l'appareil annonce des tables par canal persistantes (bit de capacité) ; le composant refuse bruyamment au lieu de perdre l'écriture en silence. -
Reprise automatique après un redémarrage du module en cours de fonctionnement : le composant détecte la perte de l'armement de l'accumulateur, le réarme et le réamorce, en sautant une fenêtre plutôt que d'arrêter silencieusement l'accumulation d'énergie.
-
Vidage NVS à l'arrêt propre (redémarrage / OTA ne perd plus l'énergie jusqu'à la dernière sauvegarde).
v1.6.0 — 2026-09-04
ct_models: par canal pour tous les canaux (0..15), registre des modèles de capteurs et correctif de persistance. Firmware : v1.4.18+ requis pour les canaux 3+ de niveau supérieur.
v1.5.0 — 2026-08 (usage interne uniquement)
Ajouté
- Prise en charge des références haut de gamme UI5/UI7 : canaux 3–6 lus par la fenêtre d'accès aux canaux (mesures temps réel et énergie par période et par canal), emplacements d'énergie NVS étendus à 7 canaux.
Ajouté
-
Modèles de pince par canal sur tous les canaux.
ct_models:dans le YAML accepte désormais jusqu'à 16 entrées. La variante détectée du module détermine combien sont appliquées ; les entrées en trop génèrent un avertissement, pas un échec. -
Registre des modèles de capteurs — la liste des modèles provient d'un registre unique. Les deux listes codées en dur (dict
CT_MODELS+CT_MODEL_ALLOWED_PER_CLASS) sont remplacées par une seule recherche dans le registre. Ajouter une nouvelle référence de pince CT est désormais une modification du registre, sans publication de bibliothèque.
Fixe
- v1.6.0 ajoute une SAUVEGARDE après le cycle d'application. Les versions précédentes utilisaient un chemin de persistance soumis à l'usine pour le modèle CT et la classe de capteur — sur un module de production, la liaison s'appliquait en RAM mais se perdait au redémarrage. La v1.6.0 persiste via
CMD_SAVE_USER_CONFIG(sans verrou). Les utilisateurs des versions précédentes en production perdaient silencieusement la liaison du modèle CT à chaque redémarrage — mettez à jour avant d'expédier des appareils.
v1.4.0
Détection de la variante à 5/7 canaux, fenêtre d'accès aux canaux pour les métriques temps réel, et la clé facultative latch_interval: qui découple la cadence de verrouillage/énergie de la cadence de lecture (update_interval:). L'énergie reste monotone et exacte : l'intégration utilise le temps mural réel entre les événements de verrouillage.
v1.3.0
Première version publique. Déploiement multi-canaux et multi-modules avec synchronisation par verrouillage General-Call (fleet_gc_enable: + group_id:), commit d'adresse en deux phases (production-OK, sans mode de provisionnement usine), démarrage lecture-comparaison-écriture, détection de fonctions conditionnée par les capacités, surface d'identité pour les lambdas (get_variant_str(), get_uid_hex(), ...), persistance de l'énergie en NVS.
Politique d'obsolescence
Ce que le composant s'engage à ne pas casser sans prévenir, et ce qu'il peut modifier :
| Surface | Stabilité | Ce que nous promettons |
|---|---|---|
Clés YAML du bloc rbamp: |
Stable | La suppression ou le renommage n'est possible qu'à une montée de version majeure. Un avertissement d'obsolescence apparaît dans le journal avant la suppression. broadcast_latch: et topology: sont conservés dans le schéma pour la rétrocompatibilité. |
Clés YAML de sensor.platform: rbamp (slots) |
Stable | Mêmes règles. Les noms voltage/current/power/energy/frequency/power_factor sont figés comme contrat avec le tableau de bord Énergie de HA. |
L'ensemble des entités HA et leurs device_class / state_class |
Stable | Nous n'y toucherons pas sans annonce préalable ; cela affecte l'entity_id dans HA. |
Méthodes RbAmpComponent::* accessibles depuis lambda |
Instable | Ces éléments peuvent changer dans les versions mineures. Si vous écrivez des actions lambda qui s'y rapportent, figez la version du composant (ref: dans external_components:). |
| Format de structure NVS | Versionné | Les changements s'accompagnent d'une montée de version de la disposition — les anciennes données sont écartées, jamais mal interprétées. |
Noms et comportement du bloc i2c: |
Externe | Il s'agit du cœur d'ESPHome, pas du nôtre — suivez la politique en amont. |
Guide de mise à niveau
Vers la v1.9.0 (depuis toute version antérieure)
- Définissez
ref: v1.9.0dansexternal_components:. - Aucune modification YAML n'est requise. Le même YAML fonctionne pour les deux gammes de modules ; le composant identifie le module connecté au démarrage.
topology:n'est pas nécessaire. - Si vous voulez les totaux d'énergie sur tous les canaux d'un module STANDARD (STD), ajoutez
energy_total/energy_exported_total/energy_net(voir 09 §2.3). - Si votre YAML définit
sensor_class:ouct_model:sur un module fourni étalonné avec son capteur monté, le composant refuse désormais le changement et le journalise. Supprimez ces clés pour ces modules. - Si vous avez changé le calibre SCT via
ct_model:, les relevés restent désormais précis ; un redémarrage du module pendant le changement est normal sur le firmware jusqu'à 1.4.19. ct_model_force: truen'est qu'une option de service ; le schéma la rejette sansct_model:/ct_models:.- Les valeurs d'énergie NVS par canal sont conservées lors de la mise à jour ; les nouveaux capteurs de totaux généraux repartent de 0 au premier démarrage puis s'incrémentent (leur emplacement NVS est séparé).
À partir de v1.3 / v1.4
- Mettez à jour
ref:. SCT_013_100(code 5) etSCT_013_060(code 7) sont acceptés.- Vous pouvez ajouter
fleet_gc_enable:/group_id:pour des instantanés synchronisés dans un déploiement multi-modules (modules BASIC).
Source et problèmes : rb-amp/rbamp-esphome · cette page dans le dépôt : docs/11_changelog.md (v1.9.1)