--- type: types/concept.md concept_type: protocol tags: [industrial, automation, communication, serial] created: 2026-07-25 modified: 2026-08-29 related: - see-also: E3DC - see-also: ha-core - see-also: Home Assistant sources: [] provenance: general summary: Industrielles Kommunikationsprotokoll von 1979 zur Anbindung speicherprogrammierbarer Steuerungen und Geräte über serielle oder TCP-Netze. --- # Modbus **Typ:** Protokoll (Kommunikationsprotokoll) ## Definition Modbus ist ein serielles Kommunikationsprotokoll, das 1979 von Modicon (jetzt Schneider Electric) veröffentlicht wurde und für die Verwendung mit seinen programmierbaren Steuerungsgeräten (PLCs) bestimmt ist. Es ist seitdem zu einem De-facto-Standard-Kommunikationsprotokoll in industriellen Umgebungen geworden und ist jetzt die am häufigsten verfügbare Mittel zum Verbinden industrieller elektronischer Geräte. ## Kernpunkte - **Offener Standard** - Öffentlich verfügbar, keine Lizenzgebühren - **Serielles Protokoll** - Ursprünglich für serielle (RS-232/RS-485) Kommunikation konzipiert - **Client-Server-Modell** - Ein Master, mehrere Slaves (Geräte) - **Einfaches Frame-Format** - Leicht auf eingebetteten Geräten zu implementieren - **Weit verbreitet** - Wird in vielen Branchen und Gerätetypen verwendet ## Varianten ### Modbus RTU - **Transport:** Seriell (RS-232, RS-485) - **Kodierung:** Binär (RTU = Remote Terminal Unit) - **Prüfsumme:** CRC - **Anwendungsfall:** Industrielle Umgebungen, lange Entfernungen - **Geschwindigkeit:** Bis zu 115200 Baud - **Entfernung:** Bis zu 1200 Meter (RS-485) ### Modbus ASCII - **Transport:** Seriell (RS-232, RS-485) - **Kodierung:** ASCII-Zeichen - **Prüfsumme:** LRC (Longitudinal Redundancy Check) - **Anwendungsfall:** Menschenlesbar, langsamer aber robuster in lauten Umgebungen - **Geschwindigkeit:** Langsamer als RTU aufgrund der ASCII-Kodierung ### Modbus TCP - **Transport:** Ethernet TCP/IP - **Kodierung:** Wie Modbus RTU (binär) - **Port:** 502 (Standard) - **Anwendungsfall:** Moderne Netzwerke, Integration mit IT-Systemen - **Adressierung:** Verwendet IP-Adressen statt Slave-IDs - **Vorteil:** Keine serielle-zu-Ethernet-Konverter erforderlich ### Modbus over TCP/IP (Modbus/TCP) Wie Modbus TCP - die häufigste TCP-Variante. ## Adressierung ### Geräte-Adressierung - **Slave ID:** 1-247 (0 ist Broadcast, 248-255 sind reserviert) - **TCP:** IP-Adresse ersetzt Slave ID, aber Slave ID ist noch im Protokoll-Frame ### Daten-Adressierung Modbus organisiert Daten in vier primäre Tabellen: | Tabelle | Code | Beschreibung | |-------|------|-------------| | Discrete Inputs | 0x | Schreibgeschützt, 1-Bit (digitale Eingänge) | | Coils | 01 | Lesen-Schreiben, 1-Bit (digitale Ausgänge) | | Input Registers | 04 | Schreibgeschützt, 16-Bit (analoge Eingänge) | | Holding Registers | 03 | Lesen-Schreiben, 16-Bit (analoge Ausgänge, Konfiguration) | **Hinweis:** Adressen werden oft mit einem Präfix referenziert: - `0:` oder `I:` für Input (Discrete Inputs, Input Registers) - `1:` oder `Q:` für Output (Coils, Holding Registers) - `4:` für Holding Registers (häufige Konvention) ## Datentypen Modbus überträgt 16-Bit-Werte. Größere Werte werden als mehrere Register übertragen: | Datentyp | Register | Byte-Reihenfolge | |-----------|-----------|------------| | INT16 | 1 | Big-Endian | | UINT16 | 1 | Big-Endian | | INT32 | 2 | Konfigurierbar | | UINT32 | 2 | Konfigurierbar | | FLOAT32 | 2 | IEEE 754, konfigurierbar | | FLOAT64 | 4 | IEEE 754, konfigurierbar | **Byte-Reihenfolge (Endianness):** - Big-Endian: Höchstwertiges Byte zuerst - Little-Endian: Niedrigstwertiges Byte zuerst - Wort-Reihenfolge: Hochwort zuerst oder Niedrigwort zuerst Häufige Kombinationen: 1211 (Big-Endian-Wort, Big-Endian-Byte), 2143, 4321 usw. ## Funktionscodes Häufige Modbus-Funktionscodes: | Code | Name | Beschreibung | |------|------|-------------| | 01 | Read Coils | Mehrere Coil-Status lesen | | 02 | Read Discrete Inputs | Mehrere diskrete Eingänge lesen | | 03 | Read Holding Registers | Mehrere Holding Registers lesen | | 04 | Read Input Registers | Mehrere Input Registers lesen | | 05 | Write Single Coil | Ein einzelnes Coil schreiben | | 06 | Write Single Register | Ein einzelnes Holding Register schreiben | | 07 | Read Exception Status | Gerätekennstatus lesen | | 08 | Diagnostics | Diagnose-Funktionen | | 15 | Write Multiple Coils | Mehrere Coil-Status schreiben | | 16 | Write Multiple Registers | Mehrere Holding Registers schreiben | | 17 | Report Slave ID | Slave ID und zusätzliche Informationen melden | ## Verwendung in Ihren Projekten Basierend auf der Repository-Struktur wird Modbus wahrscheinlich verwendet von: - [[E3DC]]-Systeme stellen Modbus-TCP-Schnittstellen bereit - [[ha-core]] kann Modbus verwenden, um mit E3DC-Wechselrichtern zu kommunizieren - [[Home Assistant]]-Integrationen verwenden häufig Modbus zur Gerätekommunikation ### Beispiel: Lesen von E3DC-Daten über Modbus TCP ```python # Python example using pymodbus from pymodbus.client import ModbusTcpClient client = ModbusTcpClient('192.168.1.100', port=502) client.connect() # Read battery SOC (Holding Register 40000, assuming INT16) response = client.read_holding_registers(0, 1, slave=1) soc = response.registers[0] print(f"Battery SOC: {soc}%") client.close() ``` ```go // Go example using a Modbus library package main import ( "fmt" "github.com/goburrow/modbus" ) func main() { handler := modbus.NewTCPClientHandler("192.168.1.100:502") handler.SlaveId = 1 handler.Timeout = 5000 * time.Millisecond client := modbus.NewClient(handler) if err := client.Connect(); err != nil { panic(err) } defer client.Close() // Read holding register 0 results, err := client.ReadHoldingRegisters(0, 1) if err != nil { panic(err) } fmt.Printf("Value: %d\n", results[0]) } ``` ## Häufige Probleme 1. **Endianness-Fehler** - Daten erscheinen mit falschen Werten 2. **Register-Adressierung um Eins daneben** - Verschiedene Hersteller verwenden unterschiedliche Adressierung 3. **Baud-Raten-Fehler** - Für serielle Verbindungen 4. **Parität/Stop-Bits** - Serielle Konfigurationsprobleme 5. **Slave-ID-Konflikte** - Mehrere Geräte mit gleicher ID auf demselben Bus 6. **Timeout-Probleme** - Gerät reagiert nicht innerhalb des Timeout-Zeitraums 7. **Byte-Reihenfolge-Verwirrung** - Unterschiedliche Interpretationen von Register-Paaren ## Best Practices 1. **Die Modbus-Map immer dokumentieren** - Welche Register enthalten welche Daten 2. **Zuerst mit Modbus-Tools testen** - Modbus Poll, QModMaster oder ähnliches verwenden 3. **Timeouts elegant verarbeiten** - Geräte können vorübergehend nicht verfügbar sein 4. **Werte zwischenspeichern** - Nicht zu häufig abfragen 5. **Daten validieren** - Auf angemessene Bereiche prüfen 6. **Ordnungsgemäße Fehlerbehandlung verwenden** - Nicht davon ausgehen, dass Lesevorgänge erfolgreich sind 7. **Endianness dokumentieren** - Byte- und Wort-Reihenfolge angeben ## Tools - **Modbus Poll** - Windows GUI-Tool zum Testen - **QModMaster** - Cross-Plattform-Modbus-Master - **modbus-palette** - Node-RED-Knoten für Modbus - **pymodbus** - Python-Bibliothek - **goburrow/modbus** - Go-Bibliothek - **libmodbus** - C-Bibliothek - **Wireshark** - Mit Modbus-Dissektor für Analyse ## Wann Modbus zu verwenden - Verbindung zu industriellen Geräten (PLCs, Wechselrichter, Sensoren) - Wenn Ethernet oder Seriell verfügbar ist - Für einfache, zuverlässige Kommunikation - Wenn das Gerät Modbus nativ unterstützt ## Wann Modbus NICHT zu verwenden - Wenn höherwertige Protokolle verfügbar sind (MQTT, HTTP REST) - Für komplexe Datenstrukturen - Wenn Sicherheit ein Problem ist (Modbus hat keine eingebaute Sicherheit) - Für Hochgeschwindigkeits-Datenübertragung mit hohem Volumen ## Sicherheitsaspekte **Modbus hat keine eingebaute Sicherheit:** - Keine Authentifizierung - Keine Verschlüsselung - Keine Integritätsprüfung **Abhilfemaßnahmen:** - Auf isolierten Netzwerken verwenden (nicht dem Internet ausgesetzt) - VPNs oder Firewalls zum Einschränken des Zugriffs verwenden - Modbus Security (TLS) in Betracht ziehen, falls verfügbar - Netzwerksegmentierung verwenden ## Leistung - **Latenz:** Normalerweise 10-100ms pro Anfrage - **Durchsatz:** 10-100 Anfragen/Sekunde (hängt vom Netzwerk und den Geräten ab) - **Nachrichtengröße:** Durch Protokoll begrenzt (normalerweise < 260 Bytes) ## Verwandte Concepts - [[MQTT]] - Alternatives Protokoll für IoT/Industrie - [[OPC UA]] - Modernes Industrieprotokoll mit Sicherheit - Industrial-Automation-Konzept ## Historie - [1979] - Ursprünglich von Modicon veröffentlicht - [2004] - Modbus IDA (Modbus Industrial Automation) gegründet - [2006] - Modbus/TCP-Spezifikation veröffentlicht - [2007] - Modbus-Organisation gegründet - [2026-07-25] - Concept-Seite erstellt ## Siehe auch - [Modbus Organization](https://modbus.org/) - [Modbus Specifications](https://modbus.org/specifications/) ## Beziehungen - **see-also:** [[E3DC]] - **see-also:** [[ha-core]] - **see-also:** [[Home Assistant]]