Handbuch eines unbekannten Modbus-Geräts einlesen

Erkennt Diagnostics ein Modbus-Gerät nicht sicher, lesen Sie die Register aus dem Handbuch ein. Wie das Erkennen funktioniert, steht unter Modbus-Gerät erkennen, Werte lesen und schreiben. Ein Gerätetyp ist in Diagnostics das, was im Portal Template heißt. Das Handbuch bleibt auf Ihrem Computer.

Was Sie brauchen

• ModbusCloud Diagnostics auf einem Computer mit Windows oder macOS. Die Installation steht unter ModbusCloud Diagnostics installieren.
• Das Handbuch mit der Registertabelle des Modbus-Geräts.
• Für die Prüfung das Modbus-Gerät, angeschlossen und in Diagnostics hinzugefügt. Wie das geht, steht unter Modbus-Gerät mit Diagnostics anschließen und finden.
• Für die Übertragung ins Portal die Rolle Eigentümer, Administrator oder Techniker.

Handbuch öffnen

Nach diesen Schritten stehen die Register aus dem Handbuch als Liste im Fenster Handbuch einlesen. Beim Hinzufügen erscheint die Schaltfläche Ich habe das Handbuch, wenn das Erkennen keinen sicher passenden Gerätetyp fand. Klicken Sie darauf, fügt die App das Modbus-Gerät zunächst ohne Gerätetyp hinzu. Auf dem Tab Live steht die Schaltfläche, solange das Modbus-Gerät keinen Gerätetyp hat und das Erkennen nichts fand oder nur einen Typ mit Möglich.

1. Fenster öffnen

   Klicken Sie beim Modbus-Gerät auf Ich habe das Handbuch. Ohne Modbus-Gerät klicken Sie in Bibliothek rechts neben der Überschrift auf das Dokumentsymbol (Handbuch einlesen).

2. Dateiauswahl öffnen

   Klicken Sie auf Datei wählen. Oder ziehen Sie die Datei in das Feld Handbuch hierher ziehen.

3. Handbuch wählen

   Wählen Sie das Handbuch. Die App zeigt die gefundenen Register je Tabelle, bei einer PDF mit der Seitenzahl.

Die App liest eine PDF mit Text, eine Excel-Datei (.xlsx), CSV, TSV und eine Textdatei. Eine gescannte Seite hat keinen Text. Die App überspringt sie und nennt die Seitenzahl. Eine .xls-Datei öffnet sie nicht, speichern Sie diese in Excel als .xlsx oder CSV.

Findet die App keine Tabelle, meldet sie In diesem Handbuch wurde keine Registerliste gefunden. Fügen Sie die Tabelle dann als Text ein.

1. Tabelle kopieren

   Kopieren Sie nur die Registertabelle aus der PDF oder aus Excel.

2. Textfeld öffnen

   Klicken Sie auf Registerliste einfügen.

3. Tabelle einfügen

   Fügen Sie die Tabelle in das Textfeld ein.

4. Text lesen lassen

   Klicken Sie auf Lesen. Die App zeigt die gefundenen Register.

Register auswählen

Nach diesen Schritten hat der Gerätetyp eine Marke, einen Namen und die Register, die Sie auslesen wollen. Über der Liste stehen Baudrate, Parität und Slave-Adresse, die das Handbuch nennt. Was das Handbuch nicht nennt, setzt die App auf 9600 Baud, 8N1 und Adresse 1.

Adressen wie 30001 oder 40001 rechnet die App in die Adresse ab 0 um. Die Liste zeigt dann beide, etwa 30001 → 0.

1. Marke eingeben

   Geben Sie bei Marke den Hersteller ein. Hat die App die Marke schon gefunden, prüfen Sie sie.

2. Namen eingeben

   Geben Sie bei Name den Namen des Gerätetyps ein. Bei einer Datei steht der Dateiname schon dort.

3. Register aktivieren

   Aktivieren Sie die Register, die Sie auslesen wollen. Messwerte mit einer gängigen Einheit wie V, A, W, kWh, Hz und °C sind schon aktiviert.

Von jeder Tabelle stehen die aktivierten Register im Bild. Die anderen erscheinen nach einem Klick auf die Zeile mit der Anzahl der weiteren Register. Ein Register suchen Sie im Feld Register suchen… nach Name oder Adresse.

Liste am Modbus-Gerät prüfen

Nach der Prüfung wissen Sie, welche Register am Modbus-Gerät stimmen. Weicht das Handbuch bei Adresse, Funktionscode, Wortreihenfolge oder Skalierung ab, passt die App die Liste an. Die App liest nur und schreibt nichts in das Modbus-Gerät. Die Prüfung ist nicht Pflicht.

Hängt das Gateway am selben RS485-Bus wie Ihr USB-RS485-Adapter, lösen Sie währenddessen seine A- und B-Ader. Zwei Master an einem Bus liefern verstümmelte Antworten.

1. Modbus-Gerät wählen

   Haben Sie das Fenster aus Bibliothek geöffnet, wählen Sie das Modbus-Gerät bei Gerät wählen…. Aus einem Modbus-Gerät heraus steht die Auswahl schon fest.

2. Prüfung starten

   Klicken Sie auf Am Gerät prüfen. Die App liest die Register zweimal, mit 3 Sekunden Abstand.

3. Werte vergleichen

   Vergleichen Sie die Werte in der Liste mit dem Display des Modbus-Geräts. Jedes geprüfte Register zeigt seinen Wert mit einem Häkchen.

4. Lesart wählen

   Fragt die App Welche Werte stimmen?, klicken Sie bei den Werten, die zum Display oder zu Ihrer eigenen Messung passen, auf Diese stimmt. Wissen Sie es nicht, klicken Sie auf Weiß ich nicht. Die Liste bleibt dann so, wie sie das Handbuch lieferte.

Die Tabelle zeigt, was die Meldungen unter der Schaltfläche bedeuten.

Gerätetyp speichern

Klicken Sie auf Als Gerätetyp speichern. Die Schaltfläche funktioniert, sobald mindestens ein Register aktiviert ist und keine Prüfung läuft. Haben Sie das Fenster aus einem Modbus-Gerät geöffnet, verwendet die App den Gerätetyp dort sofort. Der Tab Live zeigt dann die Werte mit Name und Einheit.

Der Gerätetyp steht danach in Bibliothek mit dem Label Eigene. Er enthält nur die aktivierten Register und die Verbindungsdaten oberhalb der Liste. Das Erkennen vergleicht ein Modbus-Gerät künftig auch mit diesem Gerätetyp. Waren alle aktivierten Register geprüft, steht dort Auf Hardware verifiziert, sonst Nicht verifiziert.

Den Text des Handbuchs bewahrt die App beim Gerätetyp auf. Darin suchen Sie später mit Im Handbuch suchen beim Gerätetyp in Bibliothek, zum Beispiel nach der Baudrate.

Gerätetyp ins Portal übertragen

Diagnostics macht aus dem Gerätetyp eine JSON-Datei, die das Portal als Template einliest. ModbusCloud erstellt ein fehlendes Template auch kostenlos. Wie Sie das anfragen, steht unter Modbus-Gerät steht nicht in der Bibliothek.

1. Bibliothek öffnen

   Klicken Sie in der Seitenleiste von Diagnostics auf Bibliothek.

2. Gerätetyp öffnen

   Klicken Sie in der Liste auf Ihren Gerätetyp. Mit der Auswahl Eigene stehen nur Ihre eigenen Gerätetypen in der Liste.

3. Export öffnen

   Klicken Sie auf Exportieren als.

4. Format wählen

   Wählen Sie ModbusCloud-Gateway-JSON.

5. Datei speichern

   Speichern Sie die Datei. Diagnostics meldet, wo sie liegt.

6. Im Portal einlesen

   Lesen Sie die Datei im Portal mit Import auf der Seite eines Templates ein, wie unter Eigenes Template erstellen.

Prüfen Sie nach Import und vor Speichern das Protokoll des Templates. Nennt das Handbuch nicht eindeutig RTU oder TCP, steht dort keine gültige Auswahl. Wählen Sie dann Modbus RTU oder Modbus TCP.

Prüfen Sie auch die Spalte Datentyp. Das Gateway liest nur int16, uint16, int32, uint32 und float32. Entfernen Sie ein Register mit einem anderen Datentyp, etwa Text oder eine 64-Bit-Zahl, mit dem Papierkorb (Loeschen).