I²C-Transport
Das Modul ist ein I²C-Slave mit der vollständigen Registerübersicht. Standard-7-Bit-Adresse 0x50 (konfigurierbar, siehe unten). Empfohlene Busgeschwindigkeit ist 50 kHz bei ESP32- und ESP8266-Hosts und 100 kHz bei anderen Hosts (nicht 400 kHz); der Slave unterstützt Clock-Stretching, und ein Master muss es tolerieren (siehe Grenzen unten).
Der aktive Übertragungsweg (I²C oder Modbus RTU) wird pro Boot einmal durch den Umschalter für den Schnittstellenmodus gewählt — siehe Hardware-Schnittstelle. In der I²C-Einstellung wird der Modbus-Registerraum nicht bedient und umgekehrt; Befehle und Daten sind auf beiden gleich.
Registerzeiger
- 16-Bit-Registerzeiger, auf der Leitung Big-Endian (höheres Byte zuerst), mit Auto-Inkrement.
-
Schreiben: Der Master sendet 2 Zeigerbytes (hoch, niedrig), dann einen Datenstrom; jedes Datenbyte landet am Zeiger, der danach erhöht wird.
-
Lesen: Der Master schreibt die 2 Zeigerbytes, sendet dann einen wiederholten Start und liest; Bytes werden ab dem Zeiger mit automatischer Erhöhung gestreamt.
-
Mehrbyte-Felder sind Little-Endian und adressiert als Bytes — keine Ausrichtungsanforderung auf dem Bus; ein Master darf jedes Feld als N Little-Endian-Bytes ab seiner Adresse lesen, in einer oder mehreren Transaktionen.
-
Nicht zugeordnete Adressen: Lesevorgänge liefern
0xFF, Schreibvorgänge werden ignoriert. Kanal-Adressen ab Index ≥N_CURRENT/N_VOLTAGEsind nicht festgelegt — anhand der Anzahlen prüfen, nicht interpretieren.
Es gibt keine busweite Prüfung auf 8- gegenüber 16-Bit-Adressierung (ein 8-Bit-Gerät würde das zweite Zeigerbyte als Daten missdeuten). Ein Master kennt die Konvention je Produktlinie; die STD-Signatur nach einem 16-Bit-Lesevorgang von 0x0000 ist 'S','T' + VERSION ≥ 0x30 + CAPABILITIES Bit 9.
Timing und Robustheit
-
Bereitschaft nach dem Reset: Die Registerschnittstelle ist innerhalb von Millisekunden nach einem Reset betriebsbereit, noch vor dem Messpfad — das Modul antwortet auf dem Bus, auch während der Sensorpfad noch anläuft. Nach einem Neustart durch Firmware-Aktivierung ca. 4 s abwarten, bevor das Gerät wieder erscheint.
-
Clock Stretching: normalerweise vernachlässigbar; während Flash-Operationen des Firmware-Updates kann der Slave SCL bis zu ≈9 ms halten. Stellen Sie den SCL-Timeout des Masters auf ≥10 ms, sonst werden Wiederholungen während des OTA protokolliert (die Daten werden nicht beschädigt — die Übertragung wartet lediglich).
-
Während Flash-Schreibvorgängen, die durch Befehle ausgelöst werden (Speichern von Konfiguration/Kalibrierung, OTA-Seitenprogrammierung), kann der Slave kurzzeitig ebenfalls nicht bestätigen. Wiederholen Sie, bis die Einschwingzeit des Befehls abgelaufen ist, statt beim ersten NACK abzubrechen (Einschwingzeiten siehe Befehle).
-
Kohärenz: jede Lesetransaktion wird aus einem kohärenten 128-Byte-Snapshot bedient, der beim Setzen der Registeradresse genommen wird — Felder, die in einer Transaktion von bis zu 128 Byte gelesen werden, stammen aus einer Veröffentlichung und können nicht auseinanderlaufen (so lesen Sie i64-Energiefelder und ganze Blöcke). Felder, die in getrennten Transaktionen gelesen werden, können aus verschiedenen Fenstern stammen. Um einen Modul-Neustart zwischen Lesevorgängen zu erkennen, prüfen Sie die Monotonie von
FRAME_CNT(0x0020) undBOOT_COUNT(0x00CE).
I²C-Adresse ändern
Zwei Wege:
Direkt (Adresse bekannt):
- Schreiben Sie die neue 7-Bit-Adresse (0x08..0x77) nach
CFG_I2C_ADDR(0x0073). -
COMMAND= 0x04 (SAVE_CONFIG) — validiert; eine ungültige Adresse wird mitERROR0xFD abgelehnt, und nichts wird gespeichert. Speichervorgänge sind ratenbegrenzt: eine Wiederholung innerhalb von ca. 5 s beantwortet 0xF9 — später erneut versuchen. Warten Sie auf BUSY = 0 undERROR= 0, bevor Sie den nächsten Schritt ausführen. -
COMMAND= 0x02 (RESET). Die Adresse wirkt beim Neustart; das Gerät meldet sich in ca. 1 s unter der neuen Adresse neu an.
⚠ Nach dem Reset muss jeder Master am Bus auf die neue Adresse umstellen; planen Sie dies als Installationsvorgang, nicht als Routinevorgang.
Über UID (mehrere Module auf derselben Standardadresse): Schreiben Sie die 12-Byte-UID des Zielmoduls nach ADDR_UID (0x00E0), die neue I²C-Adresse nach ADDR_UID_I2C (0x00EC, 0 = beibehalten) und/oder die neue Modbus-Unit-ID nach ADDR_UID_UNIT (0x00ED, 0 = beibehalten), dann COMMAND = 0x16 (ADDR_BY_UID). Nur das Modul, dessen UID übereinstimmt, speichert die Änderung — zusammen mit allen anderen vorgemerkten CFG_-Werten, wie bei einem SAVE_CONFIG — und startet neu; jedes andere Modul ignoriert den Befehl (dort ERROR 0xFC). Auch über einen Modbus-Broadcast akzeptiert — siehe Modbus-Übertragungsweg. Beide neuen Adressfelder null → 0xFD; ungültige Adresse → 0xFD; Speicher-Ratenbegrenzung → 0xF9. Schritt für Schritt: Abläufe D4.