Séquences — flux de contrôle pas à pas
Procédures canoniques côté hôte. Chaque étape nomme le registre (adresse I²C ; Modbus entre crochets) et ce qu'il faut vérifier. Les règles d'interrogation des commandes utilisées partout ici sont définies une fois pour toutes dans D2.
D1 — Mise sous tension / découverte
-
Lisez 12 octets à 0x0000 en une seule transaction :
ID= 'S','T' ·VERSION≥ 0x36 ·CAPABILITIES(bit 9 attendu activé ; THD bit 2 = 0, banque d'instantanés bit 8 = 1 lorsque des banques sont présentes, énergie embarquée bit 13 = 1) ·STATUS·N_VOLTAGE/N_CURRENT·VARIANT(UI1 0x11 = 1/1, 0x63 = 3/3) ·HW_REV/FW_VERSION. -
Lisez
UID0x00F4 (12 o) — l'identité du périphérique pour votre base de données ;FW_VER0x0114 (version d'image u32) ;BOARD_ID0x017C. -
Attendez les données en direct :
WIN_SEQ(0x0016) ≠ 0 et évolutif, bit 1 deSTATUS(sensor_ok) = 1 — comptez ~1 s après un démarrage (disponibilité au démarrage). -
Si
STATUSbit 4 (time_valid) = 0 → réglez l'horloge (D2, SET_TIME). - Condition de santé : cal_ok ou
CAL_SRC(0x0872) ∈ {1, 2} ;LTA_STATUS(0x0870) ≤ 1. - Réarmer l'état en RAM :
EVENT_MASK(0x00C1),THRESH_I/P(0x00C4/0x00C8) ; acquittez le démarrage en effaçant RESET_OCCURRED — écrivez 0x20 dansEVENT_FLAGS(0x00C0).
Modbus : le même jeu d'identité est en entrée 0x6000–0x601F (miroir) ; FW_VER en maintien 0x8315–16, BOARD_ID en maintien 0x831B–1C.
D2 — Exécution d'une commande
- Contrôle d'inactivité :
CMD_STATE(0x006A ; maintien 0x8116) bit 0 = 0. -
Écrivez les registres de paramètres de la commande, puis le code d'opération dans
COMMAND(0x0060 ; maintien 0x8113 — pour un code d'opération conditionné Modbus, envoyez un FC16{0x8112 = 0xA5C3, 0x8113 = code}; exception 06 = occupé, exception 03 = code inconnu ou déverrouillage absent). -
Interrogez
CMD_STATEbit 0 → 0. Délais : ≥ 1 s pour les commandes simples et les sauvegardes · ≥ 0.5 s pour l'écriture de page de mise à jour · ≥ 3 s pour le COMMIT de mise à jour. Sur I²C, tolérez ≥ 10 ms d'étirement d'horloge ; réessayez les lectures NACKées ; ne renvoyez jamais aveuglément une écriture COMMAND (un doublon serait ignoré comme OVERRUN, mais vous perdriez la trace de l'écriture retenue). -
Lisez
ERROR(0x0002 ; holding 0x8114) après BUSY = 0 : 0x00 = OK, codes dans Commandes. Vérifiez éventuellement queCMD_SEQ(0x0067) a avancé de 1 et que OVERRUN (bit 1) = 0.
Réglage de l'heure (la commande la plus courante) : écrire l'epoch u32 LE dans TIME_SET 0x08C0 (Modbus FC16 0x8100 = mot de poids fort, 0x8101 = mot de poids faible — en diffusion, c'est sa propre trame, la commande suit en seconde trame) → COMMAND 0x06 → interroger → ERROR 0xFC = epoch inférieur à 1600000000. Le bit 4 de STATUS passe immédiatement à l'état levé.
D3 — Configuration
- Écrivez les registres
CFG_*souhaités (0x0070–0x0085 ; maintien 0x8000–0x800C). -
COMMAND0x04 SAVE_CONFIG (non soumis à UNLOCK) → D2.ERROR0xFD = valeur illégale, rien enregistré · 0xF9 = limite de débit, réessayer après ~5 s · 0xF6 = erreur d'E/S de stockage. -
Si la modification exige un redémarrage (adresse I²C, unité/bauds/trame/délai d'émission Modbus,
CFG_VIRTUAL_IDS) :COMMAND0x02 RESET (protégé par UNLOCK sur Modbus ; attendez-vous à une réponse Modbus absente ou tronquée) puis interrogez de nouveau l'appareil après ~1 s.
CFG_LED / CFG_WORD_ORDER prennent effet à l'écriture mais reviennent au démarrage sans sauvegarde. CFG_CLASS, CFG_CT_MODEL, CFG_TZ_OFFSET_MIN, CFG_TIME_AUTH, CFG_ENERGY_PERSIST_S sont des métadonnées conservées.
D4 — Changement d'adresse / de série
Adresse I²C (module connu) : CFG_I2C_ADDR 0x0073 = 0x08..0x77 → SAVE_CONFIG → BUSY 0 et ERROR 0 → RESET → attendre ~1 s → sonder ID = 'S','T' à la nouvelle adresse.
Série Modbus : maintien 0x8000 unité (1–247) / 0x8001 débit (0–10) / 0x8002 trame / 0x8003 délai d'émission (validé à l'écriture — exception 03) → FC06 0x8113 = 0x0004 → interroger 0x8114 = 0 → FC16 {0x8112 = 0xA5C3, 0x8113 = 0x0002} (la réponse peut se perdre) → reconnectez-vous avec les nouveaux paramètres.
Par UID (plusieurs modules sur une même adresse, les deux transports) :
-
I²C : une écriture de 0x00E0 : UID (12 o) + nouvelle adresse I²C (0x00EC, ou 0) + nouvelle unité Modbus (0x00ED, ou 0). Modbus : FC16 0x8118–0x811E (paires d'octets d'UID + 0x811E = adresse<<8 | unité) — diffusion autorisée.
-
COMMAND0x16 (FC06 0x8113 = 0x0016 ; diffusion autorisée). -
Le module concerné enregistre (avec les valeurs CFG_ en attente éventuelles) puis redémarre ; tout autre module répond
ERROR0xFC. Si les deux champs de nouvelle adresse valent 0 ou une adresse illégale → 0xFD ; limite de débit d'enregistrement → 0xF9. -
Sondez le module à sa nouvelle adresse / unité ; identifiez-le par UID.
D5 — Énergie : lecture, remise à zéro, adoption
Lecture (à chaque frontière d'intervalle, selon votre horloge) :
-
Une transaction I²C ≤ 128 o sur 0x0800–0x0843 : compteurs Wh, compteurs mWh,
LT_GEN(instantané cohérent). PlusUPTIME0x08A0. Modbus : entrée 0x6B00/0x6B14 + maintien 0x8140. Bit 15 de capacité : les mêmes compteurs en résolution µWh — total à 0x08D0 (3×i64 ; entrée Modbus 0x6BB0), par canal à 0x0C80 + g·0x10 (Modbus 0x6BC0 + g·8) — même instantané que les champs mWh (imp/exp mWh = plancher(µWh/1000) ; net = imp − exp dans la même unité), mêmes règles de delta/génération/redémarrage. Le module publie également les µvarh réactifs totaux à 0x08E8/0x08F0 (Modbus 0x6BAC/0x6BBC, non contigus) : la lecture cohérente en haute résolution est une transaction sur 0x08D0–0x08F7 (40 o). -
Énergie d'intervalle = delta des compteurs mWh (compteurs µWh lorsqu'une résolution plus fine est souhaitée).
LT_GENmodifié → ne pas prendre le delta ; réancrer (quelqu'un a réinitialisé ou adopté — voir le journal d'événements).UPTIMEa diminué → module redémarré : delta =max(0, Δ)(il peut manquer jusqu'à environ la dernière seconde d'énergie), remettre l'heure (D2).
Réinitialisation (volontaire, journalisée) : LT_KEY 0x0844 = 0x4C545253 (« LTRS » ; Modbus FC16 0x8142–43, mot de poids fort en premier) → immédiatement COMMAND 0x0A (toute commande consomme la clé) → D2. ERROR 0xFB = clé incorrecte ou absente · 0xFA = FAULT du stockage. Aucun UNLOCK Modbus n'est nécessaire — la clé est la condition d'accès. (L'opcode de famille 0x07 ENERGY_RESET n'est pas utilisé : 0xFE / exception 03.)
Adoption (échange de carte / migration) : préparer 4×i64 dans LT_ADOPT 0x0848 (Modbus 0x8144–0x8153) dans l'ordre import Wh · export Wh · import réactif varh · export réactif varh → LT_KEY = 0x4C544150 (« LTAP ») → COMMAND 0x0B. Valeur négative → 0xFA. La réinitialisation comme l'adoption font avancer LT_GEN et s'inscrivent dans le journal d'événements avec les valeurs avant/après.
D6 — Historique et journal d'événements
-
HIST_PERIOD0x0C00 (maintien 0x8160) : 0 = dernier 15 min (alorsHIST_BACKdoit être 0) · 1 = anneau horaire · 2 = journal d'événements. -
HIST_BACK0x0C04 (maintien 0x8163) = n, 0 = le plus récent. COMMAND0x08 HIST_READ → D2.ERROR0xFC = aucun enregistrement de ce type.-
En cas de succès :
HIST_FLAGS0x0C02 bit 0 = 1 ; lisezHIST_COUNT/HIST_RECSZ(80 historique / 32 événement) /HIST_OLDEST/HIST_NEWESTpour associer les horodatages aux indices. -
Lisez l'enregistrement à 0x0C20 (
HIST_RECSZoctets, en une seule transaction ; paires d'octets Modbus maintien 0x8180+). Dispositions : Mesure et énergie. -
Parcourez
HIST_BACK= 0 … COUNT−1 pour lire les enregistrements ; règles de différence selon les FLAGS de l'enregistrement.
D7 — Mise à jour du micrologiciel
FW_ACTIVE_BANK0x0156 (holding 0x8301) → choisissez le fichier de version pour l'autre banque.-
Condition :
BOARD_ID0x017C == le mot de carte du fichier ; version du fichier ≥FW_VER0x0114 ; lisezOTA_BANK_SIZE0x014C (ne le codez jamais en dur). -
(Modbus : UNLOCK)
COMMAND0x10 BEGIN → D2 →OTA_STATUS0x0140 (maintien 0x8300) = 1. -
Par page non vide de 256 o, dans l'ordre croissant, page 0 en premier :
OTA_IDX0x0144 = k · charge utile → 0x0500 (Modbus : deux FC16 de 64 registres à 0x8380/0x83C0) · facultatifOTA_PCRC_EXP0x0170 = CRC-32 de la page ·COMMAND0x11 (non conditionné) · interrogez BUSY (≤ ~0.5 s) ·ERROR0xFC → réécrivez la charge utile, répétez la page · vérifiez queOTA_STATUSreste à 1 (3 → lisezOTA_DIAG0x0180, reprenez depuis BEGIN). -
(UNLOCK)
COMMAND0x12 COMMIT → interroger BUSY ≥ 3 s →OTA_STATUS: 2 = armé (FW_STAGED_VERSION0x0150 = nouvelle version) · 3 = refusé (raisons 7–15 dansOTA_DIAG) · 4 = version inférieure. -
Uniquement lorsque status = 2 : (UNLOCK)
COMMAND0x13 ACTIVATE — réponse Modbus absente ou tronquée ; le module revient en ~4 s. Ou (UNLOCK)COMMAND0x14 FW_ABORT pour abandonner l'image armée. -
Ne réinitialisez pas le module pendant ~10 s (essai + auto-confirmation), puis vérifiez :
FW_ACTIVE_BANKa basculé ·FW_VER= nouvelle version ·SWAP_PENDING0x011C = 0. SiFW_VERest l'ancienne, il y a eu retour arrière — lisezOTA_DIAG.
D8 — Déverrouillage Modbus
FC06 holding 0x8112 = 0xA5C3 → valide 10 s, consommé par une commande protégée ; une mauvaise valeur annule un déverrouillage actif ; absent/expiré → exception 03 sur la commande protégée. La clé et l'opcode peuvent partager un FC16 sur 0x8112–0x8113.
Protégées : 0x01 · 0x02 · 0x07 · 0x10 · 0x12 · 0x13 · 0x14 · 0x15. Non protégées : 0x04 · 0x06 · 0x08–0x0F · 0x11 · 0x16.