Fehlerverhalten

Die Integration unterscheidet zwischen temporären Verbindungsproblemen, kaputten Profilen, Lizenzproblemen und fehlenden Werten.

Situation	Verhalten	Maßnahme
Register dekodiert zu None	Sensor wird unknown	Typ/Skalierung im Profil prüfen
Modbus-Timeout	UpdateFailed, alle Register-Sensoren unavailable, Timeout-Zähler steigt	Netzwerk und Gateway prüfen
Verbindung verloren	TCP-Transport wird geschlossen, nächster Poll verbindet neu	Strom/Netzwerk des Geräts prüfen
Modbus-Exception	UpdateFailed, Exception-Code in der Statistik	Unit-ID, Adresse, Zugriff prüfen
Ungültiges Profil beim Setup	ConfigEntryError	JSON korrigieren und neu starten
Gerät beim Setup nicht erreichbar	ConfigEntryNotReady, HA versucht erneut	Host und Port prüfen
Lizenzsignatur ungültig	LicenseError; gespeicherte Lizenz verworfen; Trial/Free bleibt	Neue Lizenz anfordern
Lizenz an andere Instanz gebunden	LicenseError	Lizenz muss zur Instanz-UUID passen
Lizenz abgelaufen	14 Tage Grace, danach Basis-Sensoren	Lizenz verlängern
Schreiben ohne Pro	HomeAssistantError	Pro aktivieren
Schreiben bei deaktivierter Option	HomeAssistantError	Schreibzugriff in den Optionen aktivieren
Support-Token-Anfrage fehlgeschlagen	HomeAssistantError, keine Session	Lizenzserver-URL prüfen
Support-Provider nicht verfügbar	HomeAssistantError, keine Session	Provider-Konfiguration prüfen

Modbus-Exception-Codes

Code	Name
1	illegal function
2	illegal data address
3	illegal data value
4	server device failure
5	acknowledge
6	server device busy
8	memory parity error
10	gateway path unavailable
11	gateway target failed to respond

Diagnose

Der Verbindungs-Binary-Sensor zeigt Zähler:

• requests, successes, failures
• timeouts, exceptions, protocol_errors, reconnects
• last_error, last_exception_code, last_success, last_latency_ms
• die letzten zehn Fehlermeldungen

Der Diagnose-Download enthält den vollständigen Snapshot, einen Register-Dump und einen auf die Domain gefilterten Log-Auszug.