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èveRbAmpNotSupportedError. 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 gagneavg_p_total,wh_netetmodule_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)(unRbAmpStdLatch: P/Q/S, crêtes, énergie en mW·échantillons, énergie et puissance moyenne par canal) etRbAmp.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ésormaisRbAmpNotSupportedErrorsur un module STD au lieu de lire ou d'écrire la mauvaise adresse. set_ct_model_ch_force()sur un module appairé en usine renvoieRbAmpModeError(« 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
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èventRbAmpNotSupportedErrorsur 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 valeurRbAmpStdEnergy/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.channelsrenvoie 5 ou 7 ; toutes les lectures temps réel et de période fonctionnent uniformément pourch 0..channels-1. -
Modèle de pince par voie, n'importe quelle voie :
dev.set_ct_model_ch(channel, code)etdev.read_ct_model_ch(channel)acceptent désormaischannel 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_ACCEPTEDmaintenu à 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 viaCMD_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 MQTThome/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 soupleRBAMP_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 octetsA5 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_msde diagnostic du module (une minuterie de diagnostic, pas pour l'énergie). Sur CPython, utiliseztime.monotonic(); sur MicroPython,time.ticks_ms()+time.ticks_diff(). Sur une lecture obsolète (PERIOD_VALID = 0), la bibliothèque lèveRbAmpStaleErroret 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èqueRbAmpParamErroravant toute opération I²C.REG_CT_MODELn'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 cycleset_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 magique0xA5de 5 secondes ;commit_address_change()émetCMD_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()litREG_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
SMBusBackendexpose une nouvelle tentative générique après NACK (retry_attempts=3,retry_gap_ms=2) avec les diagnosticsretry_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 :
MachineI2CBackendconserve 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)