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

11 · Journal des modifications

Cette page reprend CHANGELOG.md du dépôt.

1.6.1 — 2026-11-01

La mesure de période fonctionne désormais sur les modules STD avec les mêmes appels que sur BASIC ; les appels de latch banks sont ajoutés, et les appels réservés à BASIC sont refusés proprement sur les modules STD.

Ajouté

  • Mesure par période sur les modules STD (read_period_snapshot, read_period_avg_power / read_period_avg_p, read_period_max_power, is_period_valid, latch_period, dev.energy). La source est décidée une fois à begin() : un module avec des compteurs embarqués utilise la différence de deux lectures de compteurs selon le calendrier du maître (aucune commande de latch n'est envoyée) ; un module ne disposant que de banques de latch verrouille la banque 0 (latch à latch, au moins 300 ms de stabilisation) ; un module sans aucun des deux lève RbAmpNotSupportedError. Un changement de génération de compteur, ou une banque ayant perdu son armement après une réinitialisation du module, est réancrée et cette période est ignorée (RbAmpStaleError). L'instantané de période gagne avg_p_total, wh_net et module_restarted. Une période à compteurs n'a pas de puissance de crête, et une moyenne par voie seulement sur un module mono-voie.
  • Appels de latch banks, disponibles dès que le module expose des bancs : dev.std_arm_banks(mask), dev.std_latch(bank), dev.std_read_latch(bank) (un RbAmpStdLatch : P/Q/S, crêtes, énergie en mW·échantillons, énergie et puissance moyenne par canal) et RbAmp.std_latch_wh(snap, dt_ms, ch). Le drapeau de validité d'un banc est collant, ce n'est pas un drapeau de fraîcheur : lisez un banc au moins 300 ms après l'avoir verrouillé.
  • Les modèles de capteur 11 (50 A) et 13 (100 A) de la classe pince sont caractérisés, avec leurs limites nominale / pleine échelle / crête. Le modèle 12 (80 A) est inchangé.

Fixe

  • Les appels qui n'existent que sur la carte de registres BASIC (configuration du type de capteur / modèle de CT, réinitialisation et changement d'adresse, registres d'identité, canal erreur / événement, aides de flotte et de General-Call, read_period_latch_ms, wait_ready) lèvent désormais RbAmpNotSupportedError sur un module STD au lieu de lire ou d'écrire la mauvaise adresse.
  • set_ct_model_ch_force() sur un module appairé en usine renvoie RbAmpModeError (« module appairé en usine : configuration verrouillée ») lorsque le firmware refuse l'écriture. Le chemin de forçage ne fonctionne qu'en mode usine.

1.6.0 — 2026-10-22

Remarque

Les versions publiques reprennent avec cette version ; les versions intermédiaires (1.4.x, 1.5.x) n'ont été publiées qu'en interne.

Ajoute la gamme de modules STD (carte de registres 16 bits) aux modules existants, l'énergie par période et par voie sur les modules à 5/7 voies, et la correction de changement de calibre SCT-013. Une seule classe RbAmp couvre les deux gammes ; le type de module est détecté automatiquement à begin().

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.
  • Gamme de modules STD (carte de registres 16 bits), détectée automatiquement. Les lectures communes (voltage, current, power, power_factor, frequency) fonctionnent sur tous les modules ; les appels réservés à STD lèvent RbAmpNotSupportedError sur un module qui ne les fournit pas.
  • Énergie embarquée : dev.read_std_energy() (import/export/net actifs + réactif, Wh/mWh/µWh, par voie) ; RbAmp.std_energy_delta(prev, now) (sûre en cas de coupure de courant).
  • Multiphasé : dev.read_voltage_angle(phase), dev.read_phase_sequence(), dev.read_reactive(ch), dev.read_apparent(ch).
  • Courant de démarrage : dev.get_start_current() / dev.set_start_current(µA) + dev.save_config().
  • dev.read_std_voltage/channel/totals/config/health(), dev.set_time(), dev.is_std ; objets de valeur RbAmpStdEnergy/Voltage/Channel/Config/Health ; RbAmpNotSupportedError.
  • Validé sur CPython (smbus2) ; le chemin 16 bits MicroPython est implémenté mais pas encore validé sur matériel.
  • Énergie de période par canal sur les modules à 5/7 canaux : dev.read_period_avg_power(ch) résout chaque canal ; l'instantané de période et l'accumulateur de Wh couvrent tous les canaux.
  • Correction du changement de calibre du capteur SCT-013 : lorsqu'un canal passe à un autre modèle de capteur, courant / puissance / énergie sont corrigés vers le modèle choisi, par rapport au gain que le module applique ; facteur de puissance et tension inchangés. Automatique ; dev.set_rating_correction(), dev.ct_rating_scale(ch), dev.ct_rating_status(ch). Un firmware qui réalise cette correction lui-même est détecté et laissé tel quel.
  • Garde de lecture avant écriture sur les écritures de classe de capteur / modèle de CT ; dev.set_ct_model_ch_force(), dev.read_sensor_class().

Fixe

  • La mesure par période sur les modules à 5/7 voies ne lève plus d'erreur sur les voies au-delà de la troisième.

1.5.0 — 2026-09-04

Affectation du modèle de CT par canal pour tous les canaux, prise en charge des références haut de gamme (UI5/UI7), registre des modèles de capteurs et correctif de persistance. Firmware : v1.4.18+.

Ajouté

  • Prise en charge UI5 / UI7 (références haut de gamme) : détectée automatiquement via REG_TOPOLOGY + REG_HW_VARIANT ; dev.channels renvoie 5 ou 7 ; toutes les lectures temps réel et de période fonctionnent uniformément pour ch 0..channels-1.

  • Modèle de pince par voie, n'importe quelle voie : dev.set_ct_model_ch(channel, code) et dev.read_ct_model_ch(channel) acceptent désormais channel 0..channels-1. Les voies 0 à 2 utilisent le chemin de registres à plat ; les voies 3 et plus utilisent la fenêtre d'accès aux voies (champ 15).

  • Validation des modèles pilotée par le registre : le registre des modèles est désormais la source unique des codes de modèle de CT. Généré automatiquement dans rbamp/_sensor_models.py ; l'ancien dict _CT_ACCEPTED maintenu à la main a disparu.

  • RbAmpWindowField.CT_MODEL = 15 (énumération publique).

  • RbAmpFleet.aligned_snapshot() remplit les listes par voie pour toute la largeur de voies du module.

Fixe

  • Le modèle de CT et la classe de capteur persistent désormais en production. Les versions précédentes les persistaient via CMD_SAVE_GAINS, réservée à l'usine — sur un module de production la sauvegarde était un no-op silencieux, si bien que la liaison s'appliquait en RAM mais se perdait au redémarrage. Elle persiste désormais via CMD_SAVE_USER_CONFIG (sans restriction). Les utilisateurs des versions précédentes en production ont silencieusement perdu la liaison du modèle de CT à chaque redémarrage — mettez à jour avant d'expédier des appareils.

1.4.0 — 2026-08-19

Prise en charge des références de la gamme supérieure (UI5/UI7), mesures RT des voies supérieures, instantanés alignés sur la flotte pour les modules multi-voies.

1.3.1 — 2026-07-30

Modifié

  • Mise à jour des exemples multi-modules (examples_cpython/03_multi_module_broadcast.py, examples_upy/03_multi_module.py) et des exemples de bilan énergétique de l'habitation (examples_cpython/07_home_energy_balance.py, examples_upy/08_home_energy_balance.py) vers le latch General-Call cohérent v1.3 (CAP_GC_LATCH) : RbAmpFleet.enable_gc_all() → gc_latch() → check_sync(), en remplacement du latch séquentiel par appareil d'avant la v1.3. L'exemple de bilan de l'habitation publie désormais aussi un sujet MQTT home/energy/sync/in_sync. Correctif des seuls exemples — API de la bibliothèque inchangée.

1.3.0 — Parc + protocole v1.3

Mise en conformité du paquet rbamp avec le contrat de fil rbAmp v1.3 et le modèle de référence multiplateforme (Arduino / ESP-IDF / ESPHome / STM32 HAL). Suite de tests simulés : 179/179 réussis.

Ajouté

  • RbAmpFleet — gestionnaire multi-modules côté hôte : scan() (avec détection de conflit + sentinelle de blocage Tier-2), add(), find(), count, itération ; poll_all() groupé (isolation des pannes, tolérant aux MISS) ; total_power() / total_energy_wh() / poll_errors() à l'échelle de la flotte ; synchronisation General-Call (enable_gc_all() / gc_latch() / check_sync()) ; assign_address() / check_conflict(). Plafond souple RBAMP_FLEET_MAX_MODULES = 16.

  • Structures POD : RbAmpFleetPoll (résultat d'interrogation par membre), RbAmpFleetSync (témoin de synchronisation GC par membre).

  • Identité / capacité : read_variant() (octet HW_VARIANT 0x55, 1..6 = UI1/UI2/UI3/I1/I2/I3), read_capability() (carte de bits de fonctionnalités u16 LE ; brancher sur les bits, pas sur des heuristiques de version), read_product_id() (0x01 = famille de capteurs rbAmp), read_uid() (12 octets), read_label() / set_label() (ASCII sur 8 octets via écriture octet par octet).

  • Canal d'événements / d'erreurs (modèle à deux canaux v1.3) : read_last_error() (octet REG_ERROR de l'appareil, une lecture sur le fil), read_event_flags(), clear_event_flags(mask), has_error() (aide sticky bit3), clear_error() (CMD_CLEAR_ERROR).

  • Configuration des CT par canal : configure_channels(class, models, n) (par lots, une seule sauvegarde terminale en flash ; limité à la variante ; validation côté client par classe _validate_ct_code) ; read_ct_model_ch(ch) (relecture du miroir du modèle appliqué, depuis 0x51-0x53).

  • Primitives de flotte par appareil : enable_gc(enable=True) (lecture-modification-écriture du drapeau GC_ENABLE de FLEET_CONFIG + enregistrement + réinitialisation ; ~1 s bloquant ; sans effet si déjà correct), read_fleet_config(), set_group_id() / read_group_id(), read_gc_tick() (témoin u16 ; 0xFFFF = jamais reçu), RbAmp.broadcast_latch_group(bus, group, tick) statique (trame GC de 5 octets A5 27 g tl th).

  • Hiérarchie d'exceptions : base RbAmpError + RbAmpIOError, RbAmpTimeoutError, RbAmpStaleError, RbAmpParamError, RbAmpModeError, RbAmpVersionError.

Modifié

  • L'énergie est intégrée sur l'horloge murale du maître, jamais sur le latch_ms de diagnostic du module (une minuterie de diagnostic, pas pour l'énergie). Sur CPython, utilisez time.monotonic() ; sur MicroPython, time.ticks_ms() + time.ticks_diff(). Sur une lecture obsolète (PERIOD_VALID = 0), la bibliothèque lève RbAmpStaleError et ne réinitialise PAS l'ancrage ; l'instantané valide suivant couvre tout l'intervalle, et le firmware conserve l'accumulateur → le calcul d'intégration reste exact, sans double comptage ni sous-comptage.

  • Les codes de modèle de CT sont un ensemble admis par classe (SCT_013 {1,2,3,4,5,6,7}, WIRED_CT {1,2,3}, BUILTIN_CT ∅) ; un code hors de l'ensemble de la classe fait lever à la bibliothèque RbAmpParamError avant toute opération I²C. REG_CT_MODEL n'est qu'une mise en attente : la liaison se fait par une commande par canal, et les liaisons multi-canaux sont indépendantes de l'ordre sur le firmware v1.3 (sur les anciens v1.x, le schéma défensif en ordre décroissant est conservé dans le cycle set_ct_model_ch).

  • Le changement d'adresse est une validation magique en deux phases compatible production ; le mode usine n'est pas requis. prepare_address_change() arme le candidat + la fenêtre magique 0xA5 de 5 secondes ; commit_address_change() émet CMD_COMMIT_ADDR + réinitialisation. La bibliothèque garantit que l'état d'armement est effacé via try/finally en cas d'échec partiel ; une fenêtre expirée → RbAmpTimeoutError. Compatible avec les anciens firmwares v1.x via un repli conditionné par les capacités.

  • Détection de la variante — read_variant() lit REG_HW_VARIANT (l'octet SKU canonique de la v1.3). Le chemin de sondage par NACK a été supprimé (le firmware ne renvoie jamais de NACK en lecture ; les lectures non mappées → 0x00).

  • Écriture multi-octets octet par octet . La fonction set_label() de la bibliothèque écrit les 8 octets de LABEL par une boucle sur octets automatiquement (rbAmp n'incrémente pas les écritures).

Robustesse au banc (étape 1B)

  • CPython SMBusBackend expose une nouvelle tentative générique après NACK (retry_attempts=3, retry_gap_ms=2) avec les diagnostics retry_count_total + retry_exhaustion_count. Elle sert à toutes les opérations filaires (les écritures de configuration suivent la même discipline que les lectures — sinon une écriture de configuration silencieusement perdue sur un bus disputé resterait invisible).

  • MicroPython sur ESP32 : MachineI2CBackend conserve la discipline de boucle à 50 kHz de l'IDF i2c_master (nouvelle tentative après NACK avec une attente serrée entre les essais, afin qu'un bus disputé n'abandonne pas silencieusement une écriture). Voir 09 · Référence API → « Détails du protocole filaire » pour le contrat complet.

Remarques

  • Bus fragile / hôtes à base d'ESP32 : le même pilote IDF i2c_master que dans les projets ESP-IDF natifs — il peut se bloquer sur un bus maintenu bas sous le niveau de la bibliothèque. Nous recommandons des pull-ups externes d'environ 4.7 kΩ, pas de débogueur NRST en production, et un chien de garde de tâche au niveau applicatif sur la tâche de scrutation comme posture de rétablissement. Voir le chapitre 10 · Dépannage.

1.1.0 — instantané de période étendu

Instantané de période étendu (puissance max, diagnostic latch_ms), comptabilité des Wh côté maître.

1.0.0 — Version initiale

Mesure temps réel d'un seul appareil (U / I / P / PF / fréquence efficaces), intégration de l'énergie de période (Wh), configuration de la classe de capteur et du modèle de CT, et changement d'adresse I²C. Double backend (CPython smbus2 / MicroPython machine.I2C).


Source et signalements : rb-amp/rbamp-python · cette page dans le dépôt : docs/11_changelog.md (v1.6.1)