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 banquestdArmBanks()/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+), renvoieRB_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 (image0x0001007Bou 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 classeWiredCT/BuiltinCTn'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à renvoientRB_ERR_PARAM) ; les tests unitaires hôte (extras/host_tests) exécutent les vraies sources contre un bus simulé. -
RbAmpStdEnergya 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 nouveauxreadReactivePower()/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()) renvoientRB_ERR_NOT_IMPLEMENTEDsur 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é commeRB_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(constantesRBAMP_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).RbAmpCTModelest 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_CHANNELSporté de 3 à 7. Les croquis existants qui utilisent des tableauxRbAmpSnapshotvont grossir — recompilation nécessaire (aucune modification du code source, sauf si vous avez figé des tailles de tableaux). -
03_MultiModuleBroadcastréé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(), etprovision()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) etreadCTModelCh()(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.implausiblemasque par champ : un champ qui échoue au filtre physique de cohérence est mis àNaNet 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_msde 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 —
Sct013accepte{005, 010, 030, 050, 100, 020, 060}.REG_CT_MODELest 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 estSingle(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 :
doublefait 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 àdoublede 32/64 bits (ESP32, SAMD, STM32, RP2040). -
Bus marginal / ESP32 : le
Wirede 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)