rbAmp
FR
Boutique
Docs
Mis à jour le

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 :

  1. ID (0x0000, 2 octets) doit valoir 'S','T' (0x53, 0x54) — toute autre valeur indique qu'il ne s'agit pas d'un module STD.
  2. 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.

  3. CAPABILITIES (0x0004, u16) — carte de bits des fonctionnalités, voir ci-dessous. Le bit 9 (adressage 16 bits) est toujours activé sur STD.

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

  5. VARIANT (0x0009) — code du membre de la famille.

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

  7. 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 forme majeure.mineure = le mot haut et le mot bas en décimal : 0x0001007E s'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)
Sécurité

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