Modbus Scanner tastet Unit-Adressen 1 bis 247 auf einem RS485-Bus ab
Auf dieser Seite

Ein Modbus-Scanner fragt auf einem Bus jede Slave-Adresse von 1 bis 247 ab und listet die Adressen, die antworten. Sie brauchen ihn, wenn Sie eine bestehende Anlage übernehmen und niemand weiß, welche Adressen belegt sind oder mit welcher Baudrate die Geräte kommunizieren. Mit den richtigen seriellen Parametern dauert der Scan wenige Minuten. Kennen Sie die Parameter nicht, gehen Sie zuerst Baudrate, Parität und Stoppbits durch; 9600 8N1 und 2400 8N1 decken die meisten Geräte ab.

Was macht ein Modbus-Scanner genau?

Ein Modbus-Scanner ist ein Werkzeug, das systematisch jede mögliche Slave-Adresse auf einem Bus anspricht und protokolliert, welche Adressen antworten. Der Scanner sendet an jede Unit-ID eine kleine Leseanfrage, meist Function Code 0x03 (Read Holding Registers) für ein Register auf Adresse 0x0000. Dann notiert er, ob innerhalb des Timeouts eine gültige Antwort zurückkommt.

Der gültige Adressbereich ist in der Modbus Application Protocol Specification V1.1b3 der Modbus Organization festgelegt. Ein einzelnes Gerät nutzt eine Adresse zwischen 1 und 247. Adresse 0 ist die Broadcast-Adresse (nur Schreiben, keine Antwort), und 248 bis 255 sind reserviert. Ein Scan durchläuft also diese 247 Adressen und setzt einen Haken, sobald ein Gerät reagiert.

Scanner prüft jede Unit-ID (1 bis 247)ID 1ID 12ID 30ID 1ID 247antwortet (belegte Adresse)still (kein Gerät)
Ein Modbus Scanner pollt jede Adresse von 1 bis 247 und markiert die wenigen Adressen, die innerhalb des Timeouts antworten. Der Rest bleibt still.

Wichtig: Ein Scanner findet nur Geräte, die mit denselben seriellen Parametern kommunizieren wie der Scanner selbst. Steht ein Gerät auf 19200 8E1, während Sie mit 9600 8N1 scannen, bleibt es unsichtbar. Zum Aufbau des Frames und der Slave-Adresse siehe die Modbus-RTU-Erklärung. Zum Protokoll insgesamt siehe Was ist Modbus?.

Was Sie vor dem Scan benötigen

Für einen RTU-Scan brauchen Sie einen USB-auf-RS485-Wandler, die Leitung zum Bus (A, B und möglichst GND) und ein Scan-Werkzeug auf dem Laptop. Für einen TCP-Scan genügt Netzwerkzugang zum Subnetz, in dem die Geräte oder das Gateway liegen.

Notieren Sie vorab, was Sie bereits wissen: die Anzahl der Geräte, die dort hängen sollten, und ob der Hersteller eine Default-Baudrate nennt. Der Energiezähler Eastron SDM630 startet zum Beispiel mit 2400 8N1 (Technisches Datenblatt Eastron SDM630), während viele SPS-gekoppelte Geräte auf 9600 oder 19200 stehen.

Schritt für Schritt: ein Modbus-RTU-Netzwerk scannen

Die Reihenfolge ist immer gleich: zuerst die Adresse bei bekannten seriellen Parametern finden, und erst wenn das nichts bringt, die seriellen Parameter selbst ermitteln.

  1. 1

    Scanner anschließen und Startparameter wählen

    Verbinden Sie den USB-auf-RS485-Wandler mit A und B des Busses. Beginnen Sie mit der häufigsten Einstellung: 9600 Baud, 8 Datenbits, keine Parität, 1 Stoppbit (8N1). Setzen Sie das Antwort-Timeout großzügig, etwa 300 Millisekunden, damit langsame Geräte mitkommen.

  2. 2

    Den gesamten Adressbereich 1 bis 247 scannen

    Lassen Sie das Werkzeug jede Adresse mit Function Code 0x03 oder 0x04 für ein Register pollen. In modpoll geschieht das in einer Schleife: modpoll -m rtu -a <id> -r 1 -c 1 -b 9600 -P none /dev/ttyUSB0. Adressen, die ein gültiges Frame zurücksenden, sind belegt. Notieren Sie sie.

  3. 3

    Finden Sie nichts, gehen Sie die seriellen Parameter durch

    Bleibt der gesamte Scan still, stimmen Baudrate oder Framing nicht. Gehen Sie die Kombination aus Baudrate und Framing durch, bis Sie eine gültige CRC erhalten. In der Praxis: erst 9600 8N1, dann 2400 8N1, dann 19200 8N1, danach die Even-Parität-Varianten (8E1).

Unbekannte serielle Parameter? Jede Kombination abtasten8N18E18O1115200384001920096002400Framing (Daten / Parität / Stopp)BaudrateTreffer: gültige CRC bei 9600 8N1
Kennen Sie die seriellen Parameter nicht, tasten Sie Baudrate gegen Framing ab, bis eine Kombination eine gültige CRC liefert. Erst dann ist ein Adress-Scan sinnvoll.

Die Modbus over Serial Line Specification V1.02 nennt 9600 und 19200 Baud mit Even-Parität als Standard, doch Hersteller weichen oft ab. Rechnen Sie daher mit sieben gängigen Baudraten (1200 bis 115200) und drei Framings (8N1, 8E1, 8O1). Die dabei genutzten Function Codes wie 0x03 und 0x04 sind in der Modbus-Funktionscodes-Referenz erklärt.

Die drei Fallstricke beim Scannen

Ein Scan, der nichts oder Unsinn liefert, geht fast immer auf eine dieser drei Ursachen zurück.

Fallstrick 1: zwei Geräte mit derselben Adresse. Stehen zwei Geräte auf Adresse 3, antworten beide gleichzeitig auf jede Anfrage an Adresse 3. Ihre Frames überlagern sich auf dem Bus, was CRC-Fehler und unlesbare Daten erzeugt. Ein zuverlässiger Scan ist dann nicht möglich.

MasterZähler Aaddr 3Zähler Baddr 3Zwei Geräte, dieselbe Adresse 3CRC-Fehler
Zwei Geräte auf derselben Adresse antworten im selben Moment. Ihre Frames kollidieren auf dem Bus und der Master liest nur einen CRC-Fehler. Lösung: die Geräte einzeln anschließen.

Die Lösung ist Punkt-zu-Punkt-Arbeit: Trennen Sie alle Geräte, schließen Sie eines an, lesen oder setzen Sie die Adresse, schließen Sie das nächste an. So erhält jedes Gerät eine eindeutige Adresse zwischen 1 und 247 und die Kollision verschwindet.

Fallstrick 2: die Broadcast-Adresse 0. Adresse 0 ist für Broadcast-Schreibaktionen an alle Geräte reserviert. Geräte antworten darauf grundsätzlich nicht, Sie finden damit also nie ein Gerät. Überspringen Sie Adresse 0 und beginnen Sie bei 1.

Fallstrick 3: der Bus ist physikalisch gestört. Ein fehlender Abschlusswiderstand, vertauschte A- und B-Leitungen oder eine zu lange Stichleitung lassen Geräte zufällig ausfallen. Ein Gerät, das im einen Scan antwortet und im nächsten nicht, deutet auf ein Verkabelungsproblem hin. Siehe die RS485-Verkabelungsanleitung für Terminierung und Polarität.

Modbus TCP auf Port 502 scannen

Bei Modbus TCP läuft das Scannen in zwei Schichten. Zuerst suchen Sie im Netzwerk, welche IP-Adressen auf TCP-Port 502 lauschen, dem Standard-Modbus-Port. Danach scannen Sie hinter jeder gefundenen IP die Unit-IDs, denn ein TCP-auf-RTU-Gateway kann mehrere RTU-Geräte hinter einer IP brücken.

Für die erste Schicht nutzen Sie nmap: nmap -p 502 --open 192.168.1.0/24 findet alle Hosts mit offenem Modbus-Port. Nmap hat auch ein eigenes Skript, nmap --script modbus-discover -p 502 <ip>. Es listet die Unit-IDs und fragt über Read Device Identification (Function Code 0x2B, MEI-Typ 0x0E) Hersteller und Produkt ab (Nmap-NSE-Dokumentation zu modbus-discover). Zu Port und Frame-Aufbau von TCP siehe die Modbus-TCP-Erklärung.

Welche Scanner-Werkzeuge gibt es?

Es gibt kein Werkzeug, das alles kann. Dies sind die Optionen, die Installateure am häufigsten einsetzen, von kostenloser CLI bis kostenpflichtiger GUI.

WerkzeugTypPlattformStark bei
modpollKostenlos, CLIWindows, Linux, macOSSkriptbarer Adress-Scan in einer Schleife
CAS Modbus ScannerKostenlos, GUIWindowsSchneller Adress- und Register-Scan
Modbus PollKostenpflichtig, GUIWindowsAdressbereich-Scan plus Live-Monitoring
QModMasterKostenlos, Open Source, GUIWindows, LinuxRTU und TCP in einem Werkzeug
OpenModScanKostenlos, Open Source, GUIWindowsSchlanker RTU- und TCP-Scanner
pymodbusKostenlos, Python-BibliothekAlleEigene Scan-Logik skripten
nmapKostenlos, CLIAlleModbus TCP auf Port 502 finden

Für einen einmaligen Einsatz vor Ort ist eine kostenlose GUI wie der CAS Modbus Scanner am schnellsten. Wollen Sie das Scannen automatisieren oder in ein Skript gießen, sind modpoll und pymodbus praktischer.

Fehlerbehebung beim Scannen

SymptomWahrscheinliche UrsacheLösung
Gesamter Scan bleibt stillFalsche Baudrate oder Framing9600 8N1, 2400 8N1, 19200 8N1, dann 8E1-Varianten durchgehen
CRC-Fehler auf einer AdresseZwei Geräte auf derselben AdresseGeräte einzeln anschließen, eindeutige Adresse setzen
Gerät fällt zufällig ausVerkabelung, fehlender AbschlusswiderstandA/B-Polarität prüfen, 120 Ohm Terminierung setzen
Kein Gerät auf TCPPort 502 blockiert oder falsches SubnetzFirewall und korrekten IP-Bereich mit nmap prüfen
Exception 0x02 zurückAdresse existiert, Register nichtGerät gefunden. Ein gültiges Register lesen, etwa 0x0000

Eine Exception Response (zum Beispiel Function Code 0x83) ist während eines Scans eine gute Nachricht. Auf dieser Adresse sitzt ein Gerät, nur das angefragte Register existiert nicht.

Kontinuierlich aus der Cloud überwachen

Ein einmaliger Scan liefert eine Momentaufnahme. In der Praxis verändert sich eine Anlage: Ein Monteur setzt einen Zähler dazu, ein Gerät fällt durch ein defektes Netzteil aus, oder jemand ändert eine Adresse. Manuelles Nachscannen skaliert nicht über Dutzende Standorte.

Das ModbusCloud Gateway pollt die eingerichteten Adressen fortlaufend, und Sie sehen die Werte jedes Geräts zwischen den Serviceeinsätzen im Dashboard. Mit automatischen Modbus-Benachrichtigungen erhalten Sie eine Meldung, wenn ein Wert eine Schwelle überschreitet, ein Störcode erscheint oder das Gateway selbst offline geht.

Häufig gestellte Fragen

Welchen Bereich haben Modbus-Slave-Adressen?

Ein einzelnes Modbus-Gerät nutzt eine Slave-Adresse zwischen 1 und 247. Adresse 0 ist die Broadcast-Adresse für Schreibaktionen an alle Geräte gleichzeitig und liefert keine Antwort. Die Adressen 248 bis 255 sind reserviert. Ein Scanner durchläuft daher den Bereich 1 bis 247.

Wie scanne ich ein Modbus-RTU-Netzwerk ohne die Baudrate zu kennen?

Gehen Sie die Kombination aus Baudrate und Framing durch, bis Sie eine gültige CRC erhalten. Beginnen Sie mit 9600 8N1, dann 2400 8N1 und 19200 8N1, danach die Even-Parität-Varianten (8E1). Erst wenn die seriellen Parameter stimmen, ist ein Adress-Scan sinnvoll, denn ein Gerät auf anderen Parametern bleibt unsichtbar.

Dürfen zwei Modbus-Geräte dieselbe Adresse haben?

Nein, nicht am selben Bus. Zwei Geräte auf derselben Adresse antworten gleichzeitig auf jede Anfrage, ihre Frames kollidieren und der Master liest nur CRC-Fehler. Schließen Sie die Geräte einzeln an, geben Sie jedem eine eindeutige Adresse zwischen 1 und 247 und schließen Sie sie danach wieder zusammen an.

Welches Modbus-Scanner-Programm ist kostenlos?

modpoll (CLI), CAS Modbus Scanner (Windows-GUI), QModMaster und OpenModScan sind kostenlos. pymodbus ist eine kostenlose Python-Bibliothek für eigene Scans. Für Modbus TCP auf Port 502 nutzen Sie nmap mit dem modbus-discover-Skript. Modbus Poll von Witte Software ist die bekannteste kostenpflichtige Option.

Wie finde ich die Modbus-Adresse eines Geräts?

Schließen Sie das Gerät als einziges an den Bus an und scannen Sie den Adressbereich 1 bis 247 mit einem Scan-Werkzeug. Da nur ein Gerät hängt, ist die antwortende Adresse sofort die gesuchte. Diese Punkt-zu-Punkt-Methode verhindert zugleich Kollisionen mit anderen Geräten.