rbAmp
FR
Boutique
Docs
Mis à jour le · Modifier sur GitHub [Edit on GitHub]

11 · Journal des modifications

Ce chapitre reflète CHANGELOG.md à la racine du dépôt. Les publications publiques reprennent avec la version 1.7.2 ; les versions intermédiaires n'ont été publiées qu'en interne.

1.7.3 — L'énergie STD reste sur les compteurs, modèles de pince 100 A et 50 A, message de module verrouillé (2026-11-01)

Fixe

  • Les modules STD qui publient à la fois les deux banques d'instantanés (bit de capacité 8) et les compteurs d'énergie embarqués (bit 13), comme l'image de module 0x0001007E : l'énergie et les appels de période restent désormais sur les compteurs persistants. Auparavant, un tel module basculait sur la banque 0 intégrée à l'hôte sans signalement. Les appels aux banques d'instantanés (rbamp_std_arm_banks, rbamp_std_latch, rbamp_std_read_latch) forment un outil distinct, qui ne dépend que du bit 8 et fonctionne sur ces modules comme avant. rbamp_std_info_t.period_source indique la source réellement utilisée.

Ajouté

  • README : section « gamme STD » avec la version minimale du composant pour l'image de module 0x0001007E et les appels aux banques d'instantanés.

  • L'exemple std_meter arme sa propre banque 1 sur chaque module signalant des banques de latch, y compris lorsque l'énergie provient des compteurs.

  • Nom du firmware pour BASIC REG_VERSION 0x0E : rbamp_basic_fw_name() renvoie « 1.4.22 » (toutes les variantes BASIC).

  • Registre des modèles de capteur : les modèles de pince 2000:1 de codes 11 (50 A) et 13 (100 A) sont désormais des modèles caractérisés (nominal 50.0 A / 100.0 A, pleine échelle 62.5 A / 116.5 A, crête 88.4 A / 164.7 A). Le code 12 (80 A) reste pour les modules déjà liés à celui-ci.

Modifié

  • rbamp_set_ct_model_ch_force() sur un module BASIC de classe 2 ou 3 renvoie ESP_ERR_INVALID_STATE avec une ligne de journal nommant la configuration verrouillée lorsque le module refuse l'écriture (le firmware 1.4.22 et ultérieur refuse les écritures de classe et de modèle sur un module appairé en usine, hors mode maintenance). Auparavant, le refus apparaissait comme une erreur générique de paramètre. Le chemin de forçage ne fonctionne sur un tel module qu'en mode maintenance.

1.7.2 — Correction de calibre SCT-013, reprise après panne du maître, lectures de fenêtre en une seule transaction (2026-10-21)

Première version publique depuis la 1.5.0. Elle regroupe les versions 1.6.0 à 1.7.2 : la gamme de modules STD derrière le même handle, la ligne data-ready, les événements, l'énergie en µWh et les grandeurs de phase, un nombre de canaux qui suit le module (1, 2, 3, 5 ou 7), le registre des modèles de capteurs avec limites d'écrêtage, les lectures de fenêtre en une seule transaction, la reprise après une panne du maître, et la correction de calibre SCT-013 pour les modules de la ligne courant dont le firmware conserve la calibration 30 A (un firmware déclarant la capacité d'autocorrection se corrige lui-même). La validation matérielle de cette gamme a été faite sur un hôte exécutant ESP-IDF 5.4.1.

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.
  • Bascule de calibre SCT-013 : un module à capteur de courant de classe 1 est calibré avec le capteur 30 A, et le firmware jusqu'à 1.4.19 conserve cette calibration après que l'utilisateur a lié un autre modèle. La bibliothèque lit désormais le gain que le module applique à rbamp_begin(), après une écriture de modèle et après chaque redémarrage de module détecté, et met à l'échelle le courant, le courant de crête, la puissance active, la puissance moyenne de période, l'énergie intégrée, le digest et les seuils d'événements selon le modèle choisi. La tension et le facteur de puissance ne sont pas mis à l'échelle. rbamp_sct_correction() rapporte l'issue par canal (rbamp_sct_correction_t : statut, modèle, échelle, gain appliqué) et rbamp_sct_refresh() réévalue à la demande. Un gain encore égal au préréglage brut (modèle changé dans ce démarrage sans redémarrage) déclenche un seul CMD_RESET ; un gain appliqué inattendu, un modèle inconnu, ou un préréglage brut qui survit à la réinitialisation laissent les lectures non mises à l'échelle avec un avertissement. Un module qui déclare la capacité d'autocorrection (firmware 1.4.20 et ultérieur) se corrige lui-même et reçoit l'échelle 1 — détecté par la capacité, jamais par VERSION. CONFIG_RBAMP_SCT_RATING_CORRECTION (activé par défaut) désactive le mécanisme.

  • rbamp_begin_resume() — rbamp_begin() sans l'amorçage latch. Un module BASIC continue de moyenner jusqu'au prochain latch, si bien qu'après un redémarrage du maître ou une panne, le premier instantané consommé intègre sur la fenêtre propre du module et récupère l'énergie de la période d'indisponibilité. Les instantanés suivants utilisent l'horloge du maître comme avant. Les modules STD se comportent exactement comme avec rbamp_begin().

  • rbamp_period_snapshot_t : module_window_ms (la longueur propre au module de la fenêtre latchée, 0 sur STD ; le module compte des validations de 100 ms sur le firmware actuel et de 200 ms sur le firmware antérieur à v1.2 — la bibliothèque le détermine à partir de l'instantané lui-même et l'indique dans module_commit_ms), module_uptime_s, window_from_boot (la fenêtre a commencé au démarrage du module : un redémarrage, ou le premier latch depuis le démarrage) et window_long (plus de 6 h, où la moyenne du module perd en précision). Sur le premier instantané après rbamp_begin_resume(), module_restarted = window_from_boot.

  • rbamp_read_uptime_s() — secondes depuis le démarrage du module (BASIC et STD). Lit 0 sur un firmware BASIC qui ne le publie pas ; alors window_from_boot reste faux.

  • rbamp_read_digest() — une fenêtre d'un module BASIC en une seule transaction : état, séquence de fenêtre et les champs choisis (courant, tension, puissance active signée en watts entiers, facteur de puissance) pour les canaux 0-2. Conçu pour lire chaque fenêtre publiée sur la ligne de disponibilité des données. rbamp_set_digest_fields() choisit les champs ; la bibliothèque écrit ce choix dans le module et le réécrit après un redémarrage détecté du module. Nécessite un firmware BASIC avec la capacité de condensé ; non disponible sur STD.

  • rbamp_basic_fw_name() — le nom de publication du firmware pour un octet de version BASIC (« 1.4.19 » pour 0x0B, et ainsi de suite).

  • rbamp_read_sensor_class() — la classe de capteur actuelle du module.

  • rbamp_sensor_model_limits() — le courant efficace nominal d'un modèle de capteur, le courant efficace auquel une sinusoïde commence à écrêter, et le plafond d'écrêtage instantané, en A, issus du registre de modèles généré (0 si inconnu). rbamp_sensor_model_rated_a() est le raccourci du courant nominal ; notez que la valeur nominale peut différer des ampères indiqués dans le nom du modèle.

  • Registre des modèles de capteurs généré, actualisé avec ces limites.

  • rbamp_set_ct_model_ch_force() — chemin de maintenance qui règle le modèle d'un canal quelle que soit la classe du module et son modèle actuel. Il remplace la calibration que l'appareil porte pour ce canal par le préréglage générique du modèle ; faites-le suivre d'une calibration.

Modifié

  • rbamp_set_ct_model(), rbamp_set_ct_model_ch() et rbamp_configure_channels() sur un module de classe 1 sans la capacité d'auto-correction (firmware jusqu'à 1.4.19) se terminent par un redémarrage du module (CMD_RESET, même UID vérifié, environ une seconde) : seul moyen pour le module de revenir à son gain étalonné après une écriture de modèle. La bibliothèque réapplique ce qui lui appartient (amorçage latch, masque de condensé à la prochaine utilisation) ; les accumulateurs de période repartent de zéro comme après toute réinitialisation du module.

  • Le transport n'appelle plus i2c_master_bus_reset() de sa propre initiative avant la dernière tentative d'une transaction échouée. Le pilote réinitialise déjà sa machine d'état après chaque transaction échouée, et la réinitialisation explicite ne prend aucun verrou de bus : lorsqu'une autre tâche a une transaction en vol, elle émet un STOP sur les broches actives, que le gestionnaire d'interruption du pilote peut prendre pour la fin d'une lecture et planter dans l'ISR (constaté sur un hôte à module branché à chaud). CONFIG_RBAMP_BUS_RESET_ON_RETRY_EXHAUSTION rétablit l'ancien comportement pour un maître mono-tâche.

  • rbamp_set_sensor_class(), rbamp_set_ct_model(), rbamp_set_ct_model_ch() et rbamp_configure_channels() lisent avant d'écrire. Une classe ou un modèle que le module détient déjà n'est pas réécrit (aucune écriture sur le bus) : sur le module, une écriture de classe efface les modèles de CT même si la valeur ne change pas, et une écriture de modèle réapplique le préréglage générique par-dessus l'étalonnage propre à l'appareil même si le modèle ne change pas ; réappliquer donc une configuration mémorisée à chaque reconnexion dégradait les mesures. Un module de classe 2 ou 3 (livré et étalonné avec son capteur) n'est pas reconfiguré : ESP_ERR_INVALID_STATE. rbamp_configure_channels() décide de toute la requête avant sa première écriture, donc sur un tel module rien n'est appliqué à moitié.

  • Documentation de latch_ms : diagnostic uniquement, peut être trop court sous charge ; la fenêtre d'intégration de l'énergie est master_dt_ms ou module_window_ms.

  • La documentation et l'aide Kconfig indiquent désormais la fenêtre de publication du module comme étant de 100 ms pour toute la famille (images anciennes : 200 ms). Les 300 ms de stabilisation appliqués par la bibliothèque après un verrou STD sont décrits comme la borne supérieure sûre qu'ils sont. Aucun comportement n'a changé.

Fixe

  • rbamp_read_all() / rbamp_read_all_ready() sur un module de plus de trois canaux (UI5/UI7, BASIC ou STD) écrivaient les canaux 3+ au-delà des tableaux de trois entrées de rbamp_snapshot_t : frequency, topology et channels étaient écrasés (l'hôte voyait alors channels = 0) et le dernier canal atterrissait quatre octets après la structure, sur la pile de l'appelant. L'appel ne remplit désormais que les canaux 0-2 (RBAMP_SNAPSHOT_CHANNELS), exactement comme le fait l'instantané de période ; les canaux 3+ restent sur rbamp_read_channel() / rbamp_read_all_channels(). Trouvé sur un hôte équipé d'un module à 7 canaux. Une simulation hôte de tout le composant face à une image de registres factice exécute désormais read_all pour 1/3/5/7 canaux avec des mots de garde après la structure.

1.7.1 — Le nombre de canaux suit le module (2026-10-18)

Fixe

  • rbamp_new() créait un handle dont le nombre de canaux était fixé à trois, si bien qu'un module à canal unique (UI1, I1) signalait encore trois canaux après rbamp_begin(). Le constructeur par défaut adopte désormais le nombre de canaux et la présence de tension à partir du registre de variante du module ; trois canaux ne restent que comme solution de repli pour un firmware qui ne publie pas de variante. rbamp_new_with_topology() continue de figer le nombre comme avant (un avertissement est journalisé si le module est en désaccord). Signalé depuis un hôte équipé d'un UI1 ; validé là-bas : un module UI1 signale un canal et la variante UI1 après rbamp_begin().

  • rbamp_read_variant() sur la gamme BASIC renvoyait UNKNOWN pour les codes UI5 / UI7 ; il les reconnaît désormais tous.

Ajouté

  • rbamp_variant_t rbamp_variant(rbamp_handle_t dev) — la variante mise en cache par rbamp_begin(), sans trafic de bus. RBAMP_VARIANT_UNKNOWN avant rbamp_begin() ou lorsque le module ne publie pas sa variante.

  • Tests unitaires hôtes de la politique de variante des deux constructeurs (test/host/test_std_decode.c).

1.7.0 — énergie en µWh, courant de démarrage, angles de phase et séquence (2026-10-17)

Prise en charge de la version d'image de module 0x0001007A / 0x0001007B. Chaque ajout est conditionné par ce que le module déclare ; les modules plus anciens se comportent exactement comme avant.

Validé sur les modules STD de version d'image 0x0001007B sur une application hôte : lecture / écriture et relecture du courant de démarrage, angles de phase et séquence de phases sur un module triphasé, drapeaux d'énergie fine, différence d'énergie à travers les redémarrages de module.

Ajouté

  • Énergie en résolution µWh / µvarh dans rbamp_std_energy_t : act_import_uwh, act_export_uwh, act_net_uwh, rea_import_uvarh, rea_export_uvarh, ch_import_uwh[], ch_export_uwh[], plus fine / fine_reactive. Les champs sont renseignés sur chaque module : à partir de ses propres compteurs µ lorsqu'il les publie (version d'image 0x0001007A ; réactif à partir de 0x0001007B), sinon mis à l'échelle depuis les compteurs grossiers avec fine à false — les appelants peuvent utiliser les champs µ sans condition. Lus comme des instantanés cohérents (une transaction par bloc). rbamp_std_energy_delta applique les mêmes règles (changement de génération → pas de delta ; baisse du temps de fonctionnement = redémarrage ; un compteur inférieur à la lecture précédente → 0 ; net = import − export). rbamp_read_period_snapshot sur le chemin des compteurs utilise la différence en µWh lorsqu'elle est disponible.

  • Courant de démarrage pour l'énergie : rbamp_std_get_start_current / rbamp_std_set_start_current (µA ; 0 = désactivé ; une valeur hors de l'ensemble accepté par le module → ESP_ERR_INVALID_ARG sans écriture sur le bus ; relue et confirmée ; rbamp_save_user_config la persiste). En dessous de ce courant de canal, le module ne compte aucune énergie ; les lectures ne sont pas affectées. Également dans rbamp_std_config_t (start_ua, start_ua_supported). ESP_ERR_NOT_SUPPORTED sans trafic de bus avant la version d'image de module 0x0001007B.

  • Angle de phase de tension : rbamp_std_voltage_t.angle_deg / angle_valid (degrés par rapport à l'entrée de tension 0 ; version d'image de module 0x0001007A+, modules triphasés ; sinon angle_valid à faux). Même lecture en une seule rafale qu'auparavant.

  • Séquence de phases : rbamp_std_read_phase_seq → rbamp_std_phase_seq_t (RBAMP_STD_PHASE_SEQ_NA / FORWARD / REVERSE / ABNORMAL) ; ESP_ERR_NOT_SUPPORTED sans trafic sur le bus avant la version d'image de module 0x0001007A.

  • Test unitaire hôte des fonctions pures de décodage : test/host/run.sh (gcc, sans ESP-IDF). Les règles de delta d'énergie vivent désormais dans src/rbamp_std_decode.c.

Modifié

  • rbamp_is_provisioned (gamme STD) documente le marqueur d'étalonnage de la version d'image 0x0001007A : un appareil étalonné avec un firmware plus ancien renvoie false après la mise à jour, jusqu'à un rbamp_save_gains.

Note de mise à niveau

  • La structure d'instantané d'énergie (rbamp_std_energy_t) a gagné des champs dans cette version. Si votre application la sauvegarde comme un blob binaire brut (NVS, fichier), ne stockez que les champs dont vous avez besoin dans votre propre format fixe ; un blob sauvegardé par une version antérieure ne correspondra pas à la nouvelle taille.

1.6.1 — Fin de commande, lectures cohérentes, contrôles de session OTA (2026-10-11)

Corrections côté bibliothèque issues de l'audit firmware / bibliothèque du 2026-10-11. Aucune nouvelle API ; le comportement des appels existants sur la gamme STD est resserré.

Modifié

  • La fin d'une commande est donnée par le registre d'état de commande du module (indicateur d'occupation effacé et compteur de commandes achevées incrémenté), jamais par le seul registre d'erreur ; le verdict n'est lu qu'après la fin. Les sauvegardes (rbamp_save_gains, rbamp_save_user_config), rbamp_std_cal_thd_floor, rbamp_reset, le changement d'adresse et chaque commande OTA l'utilisent — aucune pause de stabilisation fixe sur les modules qui publient le registre, des délais d'au moins 1 s (3 s pour la validation OTA). Une commande écrite pendant que le module est occupé est d'abord attendue ; une commande abandonnée par le module (dépassement) échoue avec ESP_ERR_INVALID_STATE au lieu de renvoyer le verdict de la commande précédente.

  • Une écriture de commande n'est jamais relancée en cas d'erreur de transport (une relance pourrait livrer l'opcode deux fois). Les lectures et écritures de registres de données conservent la relance.

  • Les lectures de blocs sont une seule transaction — le module sert chaque lecture depuis un instantané cohérent, si bien que les compteurs d'énergie, les blocs de canaux et les totaux ne se désynchronisent plus entre les rafales. rbamp_read_all sur un module STD lit le bloc de tension et chaque bloc de canal en entier, au lieu de champ par champ.

  • OTA : après chaque page, la session doit toujours être ouverte (état 1) ; sinon ESP_ERR_INVALID_STATE avec le motif du module journalisé — redémarrez depuis begin. Les interrogations pendant un blocage de flash ne réinitialisent plus le bus. rbamp_std_ota_activate tient pendant la fenêtre d'essai d'environ 10 s du module et confirme que l'image en cours est la version mise en attente et que la bascule n'est plus en attente. rbamp_std_ota_write_image (image construite sur l'hôte, non signée) renvoie ESP_ERR_NOT_SUPPORTED avant de toucher au module — seules les images préparées par le fournisseur sont acceptées par le firmware du module.

  • Changement d'adresse (rbamp_commit_address_change, STD) : la sauvegarde de configuration est synchrone (limitation de débit → ESP_ERR_NOT_FINISHED, réessayer après ~5 s), et le handle ne bascule sur la nouvelle adresse qu'après qu'un module y a répondu ; sinon ESP_ERR_NOT_FOUND et le handle conserve l'ancienne adresse.

  • rbamp_std_read_totals : les champs d'énergie des blocs agrégés valent 0 (non renseignés par le module — utilisez rbamp_std_read_energy).

  • rbamp_read_frequency (STD) : 0 de la part du module signifie pas de secteur → ESP_ERR_INVALID_RESPONSE / NaN (rbamp_read_all le signale comme non plausible).

  • rbamp_is_provisioned (STD) : documenté comme fiable à partir de la version d'image de module 0x00010079 (les images plus anciennes déclarent aussi la calibration valide sur les gains par défaut).

1.6.0 — gamme de modules STD, ligne data-ready, événements (2026-10-11)

Ajouté

  • Gamme de modules STD (table de registres 16 bits) derrière le même handle et la même API que la gamme d'origine : rbamp_std_probe / rbamp_std_identify / rbamp_std_info, lectures temps réel par canal incluant puissance réactive et apparente (rbamp_read_reactive_power, rbamp_read_apparent_power, rbamp_std_read_channel, rbamp_std_read_voltage), totaux par phase et généraux (rbamp_std_read_totals), configuration et harmoniques (rbamp_std_read_config, rbamp_std_set_harmonics, rbamp_std_cal_thd_floor).

  • Énergie sur les modules sans banques de verrouillage : la source de période est choisie à partir des capacités du module à rbamp_begin (rbamp_std_info_t.period_source) ; l'énergie de période est la différence de deux lectures des compteurs persistants, avec les règles de redémarrage et de remise à zéro. rbamp_std_read_energy (Wh / varh, plus mWh par canal et par groupe sur la carte 0x36+), rbamp_std_energy_delta, rbamp_energy_add_wh, RBAMP_ENERGY_CH_TOTAL. rbamp_period_snapshot_t a gagné avg_p_total, wh_net et module_restarted.

  • Banques de latch sur les modules qui en disposent : rbamp_std_arm_banks, rbamp_std_latch, rbamp_std_read_latch, rbamp_std_latch_wh.

  • Horloge du module, historique et journal d'événements : rbamp_std_set_time, rbamp_std_read_time, rbamp_std_read_image_version, rbamp_std_hist_info, rbamp_std_hist_read, rbamp_std_hist_read_raw, rbamp_std_event_read, rbamp_std_hist_flush (l'anneau horaire est persistant ; l'enregistrement de 15 minutes n'est que le dernier).

  • Santé : rbamp_std_read_health étendu avec des bits d'état, les sources de durée de vie et d'étalonnage, les compteurs de trames, le temps de fonctionnement, ainsi que la cause de réinitialisation et le nombre de démarrages (version d'image de module 0x00010076 et ultérieures, RBAMP_STD_RST_*).

  • Commandes et maintenance : rbamp_std_command, rbamp_std_wait_idle, rbamp_std_locate, rbamp_std_read_board_id, rbamp_std_ota_board_ok (contrôle de carte avant un flux OTA), rbamp_std_set_address_by_uid.

  • OTA : mise à jour d'image à double banque, y compris les images signées préparées (rbamp_std_ota_begin … rbamp_std_ota_activate, rbamp_std_ota_write_prepared, rbamp_std_ota_write_prepared_pair, rbamp_std_ota_diag, rbamp_std_ota_staged_version, rbamp_std_ota_abort).

  • Certificat et attestation : rbamp_std_read_certificate, rbamp_std_attest (la vérification de signature relève de l'application).

  • Ligne de disponibilité des données (DRDY), les deux gammes : rbamp_set_drdy_gpio, rbamp_wait_data_ready, rbamp_read_all_ready, rbamp_read_data_seq. Une ligne à collecteur ouvert peut être partagée par plusieurs modules ; la bibliothèque vérifie la séquence de publication, compte les fenêtres manquées, mesure la latence et détecte une alarme maintenue au niveau bas. Repli par interrogation via CONFIG_RBAMP_DRDY_POLL_MS. Les modules STD exigent la version d'image de module 0x00010075 ou ultérieure.

  • Événements sur les deux gammes : rbamp_read_event_mask, rbamp_set_event_mask, rbamp_set_event_thresholds, rbamp_begin_event_flags, RBAMP_EVENT_NVM_FAULT ; rbamp_read_event_flags / rbamp_clear_event_flags / rbamp_has_error / rbamp_clear_error couvrent désormais la gamme STD.

  • Kconfig : RBAMP_I2C_SCL_WAIT_US (budget d'étirement d'horloge, 10 ms par défaut) et RBAMP_DRDY_POLL_MS.

  • Exemple std_meter.

Modifié

  • Les appels de période sur les modules sans banques de verrouillage renvoient ESP_ERR_NOT_SUPPORTED au lieu de signaler silencieusement une période invalide.

  • rbamp_set_ct_model_ch renvoie ESP_ERR_NOT_SUPPORTED sur les modules STD dont la carte de canaux n'est pas inscriptible.

  • rbamp_err_to_str couvre ESP_ERR_NOT_FOUND, ESP_ERR_NOT_FINISHED et ESP_ERR_INVALID_CRC.

  • rbamp_period_snapshot_t et rbamp_std_health_t ont gagné des champs (compatibles à la source ; recompilez les dépendants).

  • Le composant exige désormais esp_driver_gpio (composant IDF intégré).

1.5.0 — Modèle de pince par canal sur chaque canal (2026-09-04)

Ajouté

  • rbamp_set_ct_model_ch / rbamp_read_ct_model_ch / rbamp_configure_channels acceptent tout canal jusqu'au nombre de canaux détecté (canaux 3 et plus, dans la fenêtre de canaux).

  • Les codes de modèle et les descripteurs proviennent du rbamp_sensor_models.h généré (rbamp_sensor_model_lookup) ; les codes inconnus sont rejetés par le module et remontés à l'appelant.

Fixe

  • La classe de capteur et le modèle de CT sont désormais conservés sur les modules de production : la sauvegarde précédente n'écrivait pas en flash sur le firmware de production, si bien que la liaison était appliquée en RAM et perdue au redémarrage suivant. Aucune modification d'API, même délai de stabilisation d'environ 700 ms.

1.4.0 — Modules à cinq et sept canaux

Ajouté

  • Topologie FIVE_CH / SEVEN_CH, variantes UI5 / UI7, RBAMP_MAX_CHANNELS = 7 ; rbamp_read_channel, rbamp_read_all_channels, rbamp_read_commit_seq. L'instantané de période intègre tous les canaux.

1.3.0 (2026-06-16) — Publication publique

Première version publique du composant rbamp pour ESP-IDF v5.x.

Points clés

  • Gestionnaire de flotte : gère un groupe de modules sur un même bus I²C via un unique handle rbamp_fleet_t. Découverte avec détection de conflit et canari de blocage de palier 2, _poll_all résistant aux manques, agrégation de la puissance totale / de l'énergie totale / des erreurs, diffusion de verrou pour la synchronisation serrée. Voir le chapitre 09 · Référence de l'API, section « Fleet manager ».

  • Provisionnement : rbamp_provision — un flux en un seul appel pour réaffecter un module vierge à son adresse de travail, avec sauvegarde facultative de la configuration en flash. Discipline : un seul module vierge à la fois sur le bus (une OBLIGATION normative).

  • Configuration multicanal : rbamp_configure_channels — configuration atomique, canal par canal, des modèles de CT en une seule opération avec un seul cycle terminal d'écriture en flash (ménagé pour la mémoire flash).

  • Modèle d'erreur v1.3 : sépare le résultat de la dernière écriture (REG_ERROR (0x02) — canal synchrone, validé par les setters) du signal asynchrone durable (EVENT_FLAGS.bit3 — persistant, pour les faits à l'exécution). Les fonctions correspondantes sont rbamp_read_last_error, rbamp_has_error, rbamp_clear_error, rbamp_read_event_flags.

  • Identité / détection des fonctionnalités : rbamp_read_variant, rbamp_read_capability (carte des fonctions), rbamp_has_voltage, rbamp_read_product_id, rbamp_read_uid, rbamp_is_provisioned.

Canon reflété dans la documentation

  • La topologie multi-module est le mode de fonctionnement principal de la bibliothèque. Le scénario « un seul module sur le bus » est le cas minimal, non le canon. Le déploiement canonique est un module secteur à l'entrée de service plus N modules sur des charges individuelles, tous sur un bus I²C unique sous un seul handle de flotte.

  • Références prises en charge sur le matériel actuel : UI1 (compteur secteur : tension + courant + puissance + PF + énergie), I1 / I2 / I3 (sous-compteurs : courant seulement, par canal). UI2 / UI3 suivront dans un firmware ultérieur.

  • L'énergie et la puissance ne sont calculées que sur les variantes UI (qui disposent d'un étage d'entrée en tension). Sur les variantes I, rbamp_read_power / _power_factor renvoient 0.0f ; l'agrégation de flotte de la puissance totale / de l'énergie additionne correctement et ignore les contributions nulles.

  • La liaison du CT est une préparation pure (canon v1.3) : écrire REG_CT_MODEL n'applique PAS la valeur automatiquement ; la liaison se fait par le CMD_SET_CT_MODEL_CHn de chaque canal. L'ordre de liaison est indifférent (les anachronismes « ordre croissant/décroissant » d'avant la v1.3 ont été supprimés).

  • Le changement d'adresse est compatible production : commit en deux phases + code magique + réinitialisation fonctionnent en production (aucun mode usine requis).

  • L'horloge murale du maître = base de temps canonique pour les Wh : le timer logiciel de la puce PERIOD_LATCH_MS (0xEC) sert uniquement au diagnostic ; ne l'utilisez pas pour l'énergie. Le maître utilise son propre esp_timer_get_time() ou son horloge murale.

Documentation — chapitres nouveaux / remaniés

  • 01_overview — introduction remaniée pour privilégier le multi-module ; ajout d'un schéma ASCII du scénario des 80 %.

  • 03_sensor_selection — balayage de l'ordre des CT ; nouvelle section « Modules multi-canaux — I2 et I3 (courant seul) » avec un motif de désagrégation UI1+I3.

  • 04_hardware — la section « Multi-module bus — primary topology » promue au rang de mode de fonctionnement principal ; exigence explicite de résistances de tirage externes d'environ 4.7 kΩ sur le bus de la flotte ; provisionnement via rbamp_provision.

  • 09_api_reference — sections ajoutées : « Identity and provisioning » (identité et provisionnement), « Error model v1.3 » (modèle d'erreurs), « Multi-channel configuration » (configuration multicanal), « Fleet manager — managing multiple modules » (gestionnaire de flotte — gestion de plusieurs modules), « Per-device fleet config » (configuration de flotte par appareil).

  • 10_troubleshooting — sections ajoutées « IDF i2c_master hangs on a marginal bus — three-layer mitigation » (le blocage de i2c_master IDF sur un bus marginal — atténuation en trois couches, avec tableau de taux de blocage validé sur matériel), « Fleet: a module ended up excluded », « Fleet: rbamp_fleet_scan returned INVALID_STATE », « Fleet: rbamp_provision returned an error ».

  • 11_changelog — ce fichier.


Source et problèmes : rb-amp/rbamp-esp-idf · cette page dans le dépôt : docs/11_changelog.md (v1.7.3)