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

11 · Journal des modifications

L'historique complet et détaillé se trouve dans CHANGELOG.md à la racine du dépôt ; ce chapitre n'en donne que la version courte.

1.6.2 — l'énergie STD reste sur les compteurs, lignes du registre de modèles, erreur de module verrouillé

  • STD, images avec compteurs et banques de latch : un tel module conserve désormais readPeriodSnapshot() / energy() sur ses compteurs persistants (auparavant, il basculait silencieusement sur une énergie intégrée côté hôte depuis la banque 0). Les appels de banque stdArmBanks() / stdLatch() / stdReadLatch() restent disponibles et ne dépendent que de la capacité de banque. La bibliothèque 1.6.2 est la version minimale pour une telle image ; voir Source d'énergie et version minimale de la bibliothèque.

  • Nouvel exemple 12_StdBanks : deux périodes cadencées par le maître, chacune sur sa propre banque d'instantanés.

  • Registre des modèles de capteurs : les pinces 2000:1 pour 50 A (code 11) et 100 A (code 13) sont acceptées.

  • setCTModelChForce() sur un module BASIC appairé en usine, hors mode usine (firmware 1.4.22+), renvoie RB_ERR_MODE (« configuration verrouillée ») et n'enregistre rien ; une écriture forcée ne fonctionne qu'en mode usine.

1.6.1 — énergie STD à micro-résolution, correction de calibre SCT-013, garde de configuration du capteur

Publié en même temps que la 1.6.0 (la ligne STD) comme première version publique de la bibliothèque à deux lignes.

  • Gamme STD : compteurs d'énergie à micro-résolution (µWh / µvarh), courant de démarrage pour l'énergie (stdSetEnergyStartCurrent() / stdReadEnergyStartCurrent()), angle de phase de tension (RbAmpStdVoltage::angle_deg) et séquence de phases (stdReadPhaseSequence()) — pour les modules dont l'image les publie (image 0x0001007B ou ultérieure) ; les modules plus anciens se comportent exactement comme avant. stdEnergyDelta() couvre les nouveaux champs.

  • Ligne BASIC — correction de calibre SCT-013 : sur un firmware jusqu'à 1.4.19, un canal basculé sur un autre modèle SCT-013 est lu par rapport au gain appliqué par le module. begin() lit chaque canal et met à l'échelle le courant / la puissance / la puissance de période (et l'énergie qui en découle) ; le facteur de puissance et la tension ne changent pas. Nouveautés : sctRatingRefresh(), sctRating(), sctRatingScale(), sctPresetGain(). Le firmware 1.4.20 et ultérieurs se corrige seul. Les setters de modèle redémarrent le module après la sauvegarde sur les firmwares qui en ont besoin (~0.5 s de plus par appel).

  • Les setters de classe de capteur et de modèle de CT lisent avant d'écrire (setSensorClass(), setCTModel(), configureChannels()) : une configuration enregistrée peut être réappliquée à chaque démarrage sans toucher à la calibration du module. Un module de classe WiredCT / BuiltinCT n'est pas reconfiguré (RB_ERR_MODE) ; setCTModelChForce() est la voie de service. Nouveautés : readSensorClass(), RbAmp::sensorModel() / RbAmp::sensorModelRatedA() (recherches dans le registre avec les limites actuelles du modèle).

  • 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.

  • Pour les deux lignes : la fenêtre de mesure / la cadence de publication est documentée à 100 ms (200 ms conservées seulement comme note pour les anciennes images) ; le nombre de canaux ne peut jamais dépasser RBAMP_MAX_CHANNELS (les canaux au-delà renvoient RB_ERR_PARAM) ; les tests unitaires hôte (extras/host_tests) exécutent les vraies sources contre un bus simulé.

  • RbAmpStdEnergy a gagné des champs dans cette version : si votre application l'enregistre sous forme de blob binaire brut, ne stockez que les champs dont vous avez besoin dans votre propre format fixe.

1.6.0 — Ligne STD (modèle de registres 16 bits)

Une seule bibliothèque, deux gammes de produits : begin() détecte si le module parle le modèle de registres BASIC (8 bits) ou STD (16 bits, virgule fixe) et route chaque appel en interne — la surface des méthodes est identique sur les deux gammes.

  • line() (RbAmpLine::Basic / RbAmpLine::Std) ; lecteurs unifiés sur STD (readVoltage(phase), readCurrent(), readPower() …) plus les nouveaux readReactivePower() / readApparentPower() (STD uniquement).

  • L'API du bloc STD : stdInfo(), stdReadChannel(), stdReadTotals(), stdReadVoltage(), stdReadHealth(), stdReadConfig(), stdSetHarmonics(), stdCalThdFloor() ; banques de latch (stdArmBanks(), stdLatch(), stdReadLatch(), stdLatchWh()) ; compteurs de durée de vie (stdReadEnergy(), stdEnergyDelta()).

  • La source de période est choisie d'après les capacités du module (banques de latch ou compteurs persistants) ; l'énergie du latch survit à une réinitialisation du module ; l'instantané de période a gagné avg_p_total, wh_net, module_restarted.

  • Identité, horloge, historique : stdIdentify(), RbAmp::stdProbe(), stdReadImageVersion(), stdReadBoardId(), stdSetTime() / stdReadTime(), stdHistInfo() / stdHistRead() / stdHistReadRaw() / stdEventRead() / stdHistFlush(), stdCommand() / stdWaitIdle() / stdLocate(), RbAmp::stdSetAddressByUid().

  • La configuration et les commandes fonctionnent en STD (setSensorClass(), setCTModel(), configureChannels(), saveUserConfig(), saveGains(), changement d'adresse) ; chaque commande attend que le module signale sa fin et vérifie son verdict. En STD, le modèle de CT n'est qu'une étiquette de référence.

  • Mise à jour du firmware par I²C : stdOtaBegin() → stdOtaWritePage() → stdOtaCommit() → stdOtaActivate(), stdOtaWritePreparedImage() (images préparées par le fabricant), stdOtaDiag(), stdOtaAbort(), stdOtaBoardOk().

  • Ligne data-ready et événements sur les deux lignes : setDrdyPin(), waitDataReady(), readAllReady(), readDataSeq(), beginEventFlags(), setEventMask() / readEventMask(), setEventThresholds() ; readEventFlags() / clearEventFlags() / hasError() fonctionnent sur les modules STD qui fournissent le bloc d'événements.

  • Appels réservés à BASIC (factoryReset(), appels General-Call et étiquette, readCapability(), readCommitSeq(), readPeriodLatchMs()) renvoient RB_ERR_NOT_IMPLEMENTED sur une instance STD. Aucune modification de l'API BASIC.

  • Exemple 11_StdLine.

1.5.0 — Modèles de CT par canal + registre des modèles de capteurs

  • setCTModel(channel, code) / configureChannels() lient n'importe quel canal, y compris les canaux 3 et plus de la référence haut de gamme (via la fenêtre de canaux) ; chaque écriture est confirmée par une relecture, et un modèle que le module n'accepte pas est signalé comme RB_ERR_PARAM (le canal conserve son modèle précédent).

  • readCTModelCh() couvre tous les canaux.

  • Registre généré des modèles de capteurs RbAmpSensorModels.h (constantes RBAMP_CT_*, descripteurs, rbamp_sensor_model_lookup()) ; la validation des modèles de TC est pilotée par le registre (le client rejette seulement les codes absents du registre — c'est le module qui décide de l'acceptation). RbAmpCTModel est un alias figé pour les sept codes SCT-013.

  • Les réglages de modèle de CT / de classe de capteur sont désormais persistants sur les modules de production (CMD_SAVE_USER_CONFIG).

  • Exemple 10_PerChannelModels.

1.4.0 — Prise en charge des références senior (UI5/UI7)

Ajoute la prise en charge des modules senior à 7 canaux (UI5, UI7) et rafraîchit l'exemple de diffusion GC. Vérifié au silicium sur un parc hétérogène (UI1/UI2/UI3/UI5/UI7), contrat firmware bd2ad8e.

Ajouté

  • Exemple 09_SeniorSku — interrogation à 7 canaux + intégration de l'énergie pour les modules UI5/UI7.

  • readCommitSeq() — relecture du numéro de séquence de validation du firmware.

Modifié

  • RBAMP_MAX_CHANNELS porté de 3 à 7. Les croquis existants qui utilisent des tableaux RbAmpSnapshot vont grossir — recompilation nécessaire (aucune modification du code source, sauf si vous avez figé des tailles de tableaux).

  • 03_MultiModuleBroadcast réécrit pour la latch de diffusion General-Call v1.3 (la synchronisation cohérente en une seule trame remplace l'ancienne latch séquentielle par appareil).

  • En-têtes de registres régénérés (contrat v1.4.0).

  • Energy/Snapshot : croissance du tableau de la référence senior + distribution selon le nombre de canaux.

1.3.0 — Parc + protocole v1.3

Mise de la bibliothèque Arduino en conformité avec le contrat filaire rbAmp v1.3 et le modèle de référence multiplateforme (STM32 HAL / ESP-IDF / Python). Validée sur matériel avec une flotte hétérogène (UI1 + I2 + I3) via l'API publique, avec vérité terrain des registres bruts (suite de couverture complète 38/38 + test d'endurance WDT applicatif étendu).

Ajouté

  • RbAmpFleet — gestionnaire multi-modules : scan() du bus (avec détection de collision), pollAll() par lots, totalPower() / totalEnergyWh() / pollErrors() à l'échelle du parc, synchronisation General-Call (enableGcAll() / gcLatch() / checkSync()), assignAddress(), checkConflict(), et provision() pour intégrer au bus un module sorti d'usine.

  • Identité / capacité : readVariant(), readCapability(), readProductId(), readUid().

  • Canal d'événements : readEventFlags(), clearEventFlags(), hasError(), clearError(), readLastError().

  • Configuration de CT par canal : configureChannels() (en lot, une seule sauvegarde en flash) et readCTModelCh() (lecture du miroir du modèle appliqué).

  • Primitives de flotte embarquées : enableGc(), setGroupId(), readGroupId(), readGcTick(), readFleetConfig(), readLabel(), writeLabel(), saveUserConfig(), broadcastLatchGroup() statique.

  • Exemple 08_FleetSync (scan → synchronisation GC → agrégation).

  • RbAmpSnapshot.implausible masque par champ : un champ qui échoue au filtre physique de cohérence est mis à NaN et signalé, tandis que le reste de l'instantané reste utilisable (la lecture complète n'échoue qu'en cas d'échec de transport).

Modifié

  • L'énergie est intégrée selon l'horloge murale du maître, jamais selon le latch_ms de diagnostic de la puce (un temporisateur de diagnostic du module, non destiné à l'énergie). Sur une ancre de période périmée, l'intégration est suspendue — la fenêtre valide suivante n'est pas sous-comptée.

  • Les codes de modèle de CT suivent l'ensemble accepté par classe de la v1.3 — Sct013 accepte {005, 010, 030, 050, 100, 020, 060}. REG_CT_MODEL est une simple préparation : la liaison se fait via la commande par canal, les liaisons multi-canaux sont indépendantes de l'ordre et n'écrasent jamais le canal 0.

  • Le changement d'adresse est un commit magique en deux phases, compatible production ; le mode usine n'est pas requis.

  • La détection de la variante lit REG_HW_VARIANT ; l'indication de topologie du constructeur est désormais un repli pour le firmware antérieur à v1.3. L'indication par défaut est Single (sûre — pas de lectures parasites des canaux absents).

  • Les écritures I²C partagent désormais la même discipline de nouvelles tentatives sur NACK que les lectures (une écriture de configuration qui disparaît silencieusement sur un bus encombré serait sinon invisible).

  • setSensorClass() rejette côté client les classes hors énumération (le firmware accepte silencieusement une mauvaise classe, la garde côté client est donc la seule protection).

Remarques

  • AVR : double fait 32 bits (== float) sur la chaîne d'outils AVR classique : l'accumulateur de Wh perd donc en précision lors d'une journalisation longue durée — réinitialisez-le périodiquement, ou utilisez un cœur à double de 32/64 bits (ESP32, SAMD, STM32, RP2040).

  • Bus marginal / ESP32 : le Wire de l'Arduino-ESP32 enveloppe un pilote qui peut se bloquer sur un bus retenu sous le niveau de la bibliothèque. Utilisez des résistances de rappel externes de ~4.7 kΩ appropriées, évitez le débogueur / NRST en production, et armez un chien de garde de tâche au niveau applicatif sur la tâche d'interrogation comme voie de rétablissement.

1.0.0 — Version initiale

Mesure RT d'un seul appareil (U / I / P / FP / fréquence efficaces RMS), intégration de l'énergie par période (Wh), configuration du modèle de TC + classe de capteur, et changement d'adresse I²C.


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