rbAmp
FR
Boutique
Docs
Mis à jour le

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

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

  2. Lisez UID 0x00F4 (12 o) — l'identité du périphérique pour votre base de données ; FW_VER 0x0114 (version d'image u32) ; BOARD_ID 0x017C.

  3. Attendez les données en direct : WIN_SEQ (0x0016) ≠ 0 et évolutif, bit 1 de STATUS (sensor_ok) = 1 — comptez ~1 s après un démarrage (disponibilité au démarrage).

  4. Si STATUS bit 4 (time_valid) = 0 → réglez l'horloge (D2, SET_TIME).

  5. Condition de santé : cal_ok ou CAL_SRC (0x0872) ∈ {1, 2} ; LTA_STATUS (0x0870) ≤ 1.
  6. 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 dans EVENT_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

  1. Contrôle d'inactivité : CMD_STATE (0x006A ; maintien 0x8116) bit 0 = 0.
  2. É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).

  3. Interrogez CMD_STATE bit 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).

  4. Lisez ERROR (0x0002 ; holding 0x8114) après BUSY = 0 : 0x00 = OK, codes dans Commandes. Vérifiez éventuellement que CMD_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

  1. Écrivez les registres CFG_* souhaités (0x0070–0x0085 ; maintien 0x8000–0x800C).
  2. COMMAND 0x04 SAVE_CONFIG (non soumis à UNLOCK) → D2. ERROR 0xFD = valeur illégale, rien enregistré · 0xF9 = limite de débit, réessayer après ~5 s · 0xF6 = erreur d'E/S de stockage.

  3. Si la modification exige un redémarrage (adresse I²C, unité/bauds/trame/délai d'émission Modbus, CFG_VIRTUAL_IDS) : COMMAND 0x02 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) :

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

  2. COMMAND 0x16 (FC06 0x8113 = 0x0016 ; diffusion autorisée).

  3. Le module concerné enregistre (avec les valeurs CFG_ en attente éventuelles) puis redémarre ; tout autre module répond ERROR 0xFC. Si les deux champs de nouvelle adresse valent 0 ou une adresse illégale → 0xFD ; limite de débit d'enregistrement → 0xF9.

  4. 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) :

  1. Une transaction I²C ≤ 128 o sur 0x0800–0x0843 : compteurs Wh, compteurs mWh, LT_GEN (instantané cohérent). Plus UPTIME 0x08A0. 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).

  2. Énergie d'intervalle = delta des compteurs mWh (compteurs µWh lorsqu'une résolution plus fine est souhaitée).

  3. LT_GEN modifié → ne pas prendre le delta ; réancrer (quelqu'un a réinitialisé ou adopté — voir le journal d'événements).
  4. UPTIME a 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

  1. HIST_PERIOD 0x0C00 (maintien 0x8160) : 0 = dernier 15 min (alors HIST_BACK doit être 0) · 1 = anneau horaire · 2 = journal d'événements.

  2. HIST_BACK 0x0C04 (maintien 0x8163) = n, 0 = le plus récent.

  3. COMMAND 0x08 HIST_READ → D2. ERROR 0xFC = aucun enregistrement de ce type.
  4. En cas de succès : HIST_FLAGS 0x0C02 bit 0 = 1 ; lisez HIST_COUNT / HIST_RECSZ (80 historique / 32 événement) / HIST_OLDEST / HIST_NEWEST pour associer les horodatages aux indices.

  5. Lisez l'enregistrement à 0x0C20 (HIST_RECSZ octets, en une seule transaction ; paires d'octets Modbus maintien 0x8180+). Dispositions : Mesure et énergie.

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

  1. FW_ACTIVE_BANK 0x0156 (holding 0x8301) → choisissez le fichier de version pour l'autre banque.
  2. Condition : BOARD_ID 0x017C == le mot de carte du fichier ; version du fichier ≥ FW_VER 0x0114 ; lisez OTA_BANK_SIZE 0x014C (ne le codez jamais en dur).

  3. (Modbus : UNLOCK) COMMAND 0x10 BEGIN → D2 → OTA_STATUS 0x0140 (maintien 0x8300) = 1.

  4. Par page non vide de 256 o, dans l'ordre croissant, page 0 en premier : OTA_IDX 0x0144 = k · charge utile → 0x0500 (Modbus : deux FC16 de 64 registres à 0x8380/0x83C0) · facultatif OTA_PCRC_EXP 0x0170 = CRC-32 de la page · COMMAND 0x11 (non conditionné) · interrogez BUSY (≤ ~0.5 s) · ERROR 0xFC → réécrivez la charge utile, répétez la page · vérifiez que OTA_STATUS reste à 1 (3 → lisez OTA_DIAG 0x0180, reprenez depuis BEGIN).

  5. (UNLOCK) COMMAND 0x12 COMMIT → interroger BUSY ≥ 3 s → OTA_STATUS : 2 = armé (FW_STAGED_VERSION 0x0150 = nouvelle version) · 3 = refusé (raisons 7–15 dans OTA_DIAG) · 4 = version inférieure.

  6. Uniquement lorsque status = 2 : (UNLOCK) COMMAND 0x13 ACTIVATE — réponse Modbus absente ou tronquée ; le module revient en ~4 s. Ou (UNLOCK) COMMAND 0x14 FW_ABORT pour abandonner l'image armée.

  7. Ne réinitialisez pas le module pendant ~10 s (essai + auto-confirmation), puis vérifiez : FW_ACTIVE_BANK a basculé · FW_VER = nouvelle version · SWAP_PENDING 0x011C = 0. Si FW_VER est l'ancienne, il y a eu retour arrière — lisez OTA_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.