Transport I²C
Le module est un esclave I²C avec la carte de registres complète. Adresse 7 bits par défaut 0x50 (configurable, voir ci-dessous). La vitesse de bus recommandée est de 50 kHz sur les hôtes ESP32 et ESP8266, et de 100 kHz sur les autres hôtes (pas 400 kHz) ; l'esclave prend en charge l'étirement d'horloge et le maître doit le tolérer (voir les limites ci-dessous).
Le transport actif (I²C ou Modbus RTU) est choisi une fois par démarrage par le commutateur de mode d'interface — voir Interface matérielle. Sur le réglage I²C, l'espace de registres Modbus n'est pas servi, et inversement ; les commandes et les données sont les mêmes sur les deux.
Pointeur de registre
- Pointeur de registre sur 16 bits, gros-boutiste sur le fil (octet de poids fort en premier), avec incrémentation automatique.
-
Écriture : le maître envoie 2 octets de pointeur (poids fort, puis faible), puis un flux de données ; chaque octet de données arrive au pointeur, qui s'incrémente ensuite.
-
Lecture : le maître écrit les 2 octets du pointeur, puis émet une reprise de condition de départ (repeated start) et lit ; les octets sont émis à partir du pointeur avec incrémentation automatique.
-
Les champs multi-octets sont petit-boutistes et adressés par octet — aucune exigence d'alignement sur le bus ; un maître peut lire tout champ comme N octets petit-boutistes à partir de son adresse, en une ou plusieurs transactions.
-
Adresses non cartographiées : les lectures renvoient
0xFF, les écritures sont ignorées. Les adresses de blocs de canaux à l'index ≥N_CURRENT/N_VOLTAGEne sont pas spécifiées — conditionnez-les aux nombres, ne les interprétez pas.
Il n'existe aucune sonde au niveau du bus pour distinguer l'adressage sur 8 ou 16 bits (un appareil sur 8 bits lirait le second octet du pointeur comme une donnée). Un maître connaît la convention selon la gamme ; la signature STD après une lecture sur 16 bits de 0x0000 est 'S','T' + VERSION ≥ 0x30 + le bit 9 de CAPABILITIES.
Temporisation et robustesse
-
Disponibilité après réinitialisation : l'interface registres est prête en quelques millisecondes après une réinitialisation, avant le chemin de mesure — le module répond sur le bus même pendant que le chemin capteur démarre encore. Après un redémarrage d'activation du firmware, comptez ~4 s avant que l'appareil ne réapparaisse.
-
Étirement d'horloge : en général négligeable ; pendant les opérations d'écriture flash de la mise à jour du micrologiciel, l'esclave peut maintenir SCL jusqu'à ≈9 ms. Réglez le délai d'expiration SCL du maître à ≥10 ms, sinon les reprises seront journalisées pendant la mise à jour OTA (les données ne sont pas altérées — la transaction attend simplement).
-
Pendant les écritures en flash déclenchées par des commandes (sauvegarde de la configuration/de l'étalonnage, programmation des pages de mise à jour), l'esclave peut aussi ne pas acquitter brièvement. Réessayez jusqu'à écoulement du temps de stabilisation de la commande plutôt que d'abandonner au premier NACK (voir Commandes pour les temps de stabilisation).
-
Cohérence : chaque transaction de lecture est servie depuis un instantané cohérent de 128 octets pris lorsque l'adresse de registre est positionnée — les champs lus dans une transaction d'au plus 128 octets proviennent d'une même publication et ne peuvent pas se déchirer (c'est ainsi qu'il faut lire les champs d'énergie i64 et les blocs entiers). Les champs lus dans des transactions séparées peuvent provenir de fenêtres différentes. Pour détecter un redémarrage du module entre deux lectures, vérifiez la monotonie de
FRAME_CNT(0x0020) etBOOT_COUNT(0x00CE).
Modification de l'adresse I²C
Deux chemins :
Direct (adresse connue) :
- Écrivez la nouvelle adresse I²C 7 bits (0x08..0x77) dans
CFG_I2C_ADDR(0x0073). -
COMMAND= 0x04 (SAVE_CONFIG) — validé ; une adresse illégale est refusée avecERROR0xFD et rien n'est persisté. Les sauvegardes sont limitées en fréquence : une nouvelle demande dans les ~5 s répond 0xF9 — réessayez plus tard. Attendez BUSY = 0 etERROR= 0 avant l'étape suivante. -
COMMAND= 0x02 (RESET). L'adresse s'applique au redémarrage ; le périphérique se réénumère à la nouvelle adresse en ~1 s.
⚠ Après la réinitialisation, chaque maître du bus doit passer à la nouvelle adresse ; prévoyez cette opération comme une intervention d'installation, non comme une opération de routine.
Par UID (plusieurs modules sur une même adresse par défaut) : écrivez l'UID de 12 octets du module cible dans ADDR_UID (0x00E0), la nouvelle adresse I²C dans ADDR_UID_I2C (0x00EC, 0 = conserver) et/ou le nouvel identifiant d'unité Modbus dans ADDR_UID_UNIT (0x00ED, 0 = conserver), puis COMMAND = 0x16 (ADDR_BY_UID). Seul le module dont l'UID correspond persiste la modification — avec toutes les autres valeurs CFG_ en attente, comme un SAVE_CONFIG — puis redémarre ; tous les autres modules ignorent la commande (ERROR 0xFC chez eux). Acceptée aussi en diffusion Modbus — voir Transport Modbus. Si les deux champs de nouvelle adresse sont à zéro → 0xFD ; adresse illégale → 0xFD ; limite de fréquence de sauvegarde → 0xF9. Pas à pas : Séquences D4.