Identité et découverte
Comment un hôte reconnaît un module STD, ce qu'il est et ce qu'il sait faire. Tous les registres de ce chapitre sont en lecture seule sauf mention contraire. Adresses I²C ; les miroirs de découverte Modbus sont listés à la fin.
Séquence de découverte
Au premier contact, un maître lit le bloc d'identité à 0x0000 et conditionne tout le reste à celui-ci :
ID(0x0000, 2 octets) doit valoir'S','T'(0x53, 0x54) — toute autre valeur indique qu'il ne s'agit pas d'un module STD.-
VERSION(0x0003) est la version de disposition de la carte de registres (actuelle :0x36). Chaque ajout de fonction la fait avancer ; un maître conditionne les fonctions de la carte à cette valeur. -
CAPABILITIES(0x0004, u16) — carte de bits des fonctionnalités, voir ci-dessous. Le bit 9 (adressage 16 bits) est toujours activé sur STD. -
N_VOLTAGE(0x0007) /N_CURRENT(0x0008) — nombre de canaux renseignés. Les blocs de canaux d'indice ≥ N sont réservés ; leur valeur n'est pas spécifiée. -
VARIANT(0x0009) — code du membre de la famille. -
UID(0x00F4, 12 octets) — l'identifiant unique de la puce. Les adresses peuvent changer ; l'UID ne le peut pas : utilisez-le comme identité de l'appareil dans toute base de données. -
FW_VER(0x0114, u32) — la version du micrologiciel en cours d'exécution (à utiliser pour l'inventaire et les décisions de mise à jour). Lisez-la sous la formemajeure.mineure= le mot haut et le mot bas en décimal :0x0001007Es'affiche comme micrologiciel STD 1.126. La version de la table de registres (VERSION, 0x0003) est distincte.
Registres d'identité
| Adr | Nom | Type | Signification |
|---|---|---|---|
| 0x0000 | ID | 2×u8 | 'S','T' |
| 0x0002 | ERROR | u8 | résultat de la dernière commande (voir Commandes) |
| 0x0003 | VERSION | u8 | version de la table de registres (0x36) |
| 0x0004 | CAPABILITIES | u16 | carte de bits des fonctionnalités |
| 0x0006 | STATUS | u8 | bits d'état en direct (voir Diagnostic) |
| 0x0007 | N_VOLTAGE | u8 | canaux de tension, 0..8 |
| 0x0008 | N_CURRENT | u8 | canaux de courant, 1..64 |
| 0x0009 | VARIANT | u8 | code de membre de la famille |
| 0x000A | HW_REV | u8 | révision matérielle |
| 0x000B | FW_VERSION | u16 | marqueur de ligne du micrologiciel — non la version de l'image |
| 0x00F4 | UID | 12×u8 | identifiant unique de la puce |
| 0x0114 | FW_VER | u32 | version du micrologiciel en cours : mot de poids fort . mot de poids faible, en décimal (0x0001007E = 1.126) |
| 0x017C | BOARD_ID | u32 | identifiant de carte de l'image en cours (voir ci-dessous) |
⚠ Deux registres de « version du firmware » existent pour des raisons historiques. FW_VERSION (0x000B, u16) ne marque que la lignée du firmware. La version réelle du firmware, croissante, est FW_VER (0x0114, u32), affichée sous la forme major.minor — utilisez-la pour l'inventaire et les décisions de mise à jour.
BOARD_ID (0x017C)
BOARD_ID identifie la carte pour laquelle l'image en cours a été compilée : ("BD" << 16) | channel-count << 8 | VARIANT = 0x4244nnvv — par ex. 0x42440211 pour STD-UI1. Chaque image de version porte le même mot, couvert par les contrôles d'intégrité et de signature de l'image ; une mise à jour de firmware avec un identifiant de carte différent est refusée (voir Mise à jour du firmware). Comparez BOARD_ID avec le fichier de version avant d'envoyer une mise à jour.
Carte de bits CAPABILITIES (0x0004)
| Bit | Nom | Signification |
|---|---|---|
| 0 | SIGNED | puissance/énergie signées (import/export) |
| 1 | REACTIVE | Q et S publiés |
| 2 | THD | champs THD / PF de déplacement en direct (0 → ces champs se lisent 0 sur I²C, la valeur sentinelle sur le natif Modbus) |
| 3 | HARMONICS | spectres par harmonique (niveau industriel) |
| 4 | INDUSTRIAL | version de niveau industriel |
| 5 | HUB_IFACE | côté concentrateur |
| 6 | OTA | mise à jour du micrologiciel par le bus |
| 7 | ENERGY | accumulateurs d'énergie par fenêtre |
| 8 | MULTI_LATCH | huit banques d'instantanés présentes — voir Banques d'instantanés |
| 9 | ADDR16 | adressage de registres sur 16 bits (toujours 1 sur STD) |
| 10 | MULTI_CHANNEL | plus d'un canal de courant |
| 11 | MODBUS_IFACE | Transport Modbus RTU présent |
| 12 | RTC | horloge embarquée sur pile (0 — l'heure vient du maître) |
| 13 | ONDEVICE_ENERGY | compteurs d'énergie cumulés persistés sur le périphérique |
| 14 | CHMAP_PERSIST | la table de modèle de TC par canal persiste (réservé ; 0 tant que non implémenté) |
| 15 | ENERGY_UWH | compteurs d'énergie en résolution µWh publiés (µWh actifs et µvarh réactifs) — voir Mesure et énergie |
Un maître traite les bits inconnus comme « fonction absente » et ne se fie jamais aux champs réservés.
Règle de capacités honnêtes : un module ne déclare que ce que la version en cours fournit réellement. Par exemple, le firmware triphasé rapporte THD = 0 et RTC = 0 (le maître fournit l'horloge) ; les modules sans banques d'instantanés rapportent MULTI_LATCH = 0 (l'énergie se lit depuis les compteurs cumulés).
Codes VARIANT (0x0009)
| Code | Membre | Canaux |
|---|---|---|
| 0x11 | STD-UI1 | 1 V + 1 I |
| 0x63 | STD-U3I3 | 3 V + 3 I (triphasé) |
Les autres codes de l'espace d'énumération sont réservés et ne doivent pas être considérés comme absents à jamais ; un maître décide selon N_VOLTAGE / N_CURRENT + CAPABILITIES, et non en codant en dur les codes de variante.
Miroir de découverte Modbus
Le même jeu d'identité est lisible par Modbus en registres d'entrée à 0x6000 : MAGIC 0x6000 · MAP_VERSION 0x6001 · FW_VERSION 0x6002 · HW_REV 0x6003 · CAPABILITIES 0x6004 · N_VOLTAGE 0x6005 · N_CURRENT 0x6006 · VARIANT 0x6007 · TIER 0x6008 · STATUS 0x6009 · ERROR 0x600A · UID 0x600B–0x6010 (12 octets, gros-boutiste par registre) · FRAME_CNT 0x6011–12 · FREQ 0x6013 · WINDOW_MS 0x6014 · CMD_SEQ 0x6015 · RING_DROP 0x6016 · WIN_NSAMP 0x6017 · WIN_PERIOD 0x6018 · diagnostic CPU 0x6019–0x601C · LOST_FRAMES 0x601D–1E · WIN_SEQ 0x601F. BOARD_ID est au maintien 0x831B–1C ; FW_VER au maintien 0x8315–16.