Auslesen und Protokollieren von MODBUS-RTU-Geräten in CSV-Dateien

Eine vollständige Anleitung zum Auslesen von Daten aus MODBUS-RTU-Seriengeräten und zum Exportieren geparster Werte direkt in eine CSV-Datei mit eigener Werte-Spalten-Zuordnung und Protokolldateirotation

1. Protokollkonfiguration: MODBUS RTU

Kommunikationstyp: Aktive Abfrage (Master/Slave über RS485/COM)

Da MODBUS Daten binär überträgt, muss der Parser bestimmte Holding-Register (z. B. 40001) oder Input-Register extrahieren. Wenn Ihr Sensor 32-Bit-Gleitkommazahlen verwendet, konfigurieren Sie den Parser so, dass er zwei benachbarte 16-Bit-Register liest und das korrekte Byte-Swapping (Endianness) anwendet, um den Float-Wert zu rekonstruieren.

Wenden Sie diese Basiskonfiguration für die serielle Verbindung an:

{
  "port": "COM3",
  "baud_rate": 9600,
  "data_bits": 8,
  "stop_bits": 1,
  "parity": "none",
  "protocol": "modbus_rtu_serial",
  "poll_interval_ms": 1000
}

2. Datenbankeinrichtung: CSV-Datei

Verwenden Sie das integrierte Exportmodul 'Lokale Datenbank'. Es sind keine externen Treiber erforderlich.

Verwenden Sie das folgende SQL-Skript, um Ihre Zieltabelle zu erstellen. Protokollieren Sie nicht jahrelang kontinuierlich in eine einzelne CSV-Datei. Verwenden Sie die Einstellung 'Protokolldatei-Rotation' der Software, um täglich automatisch eine neue Datei zu starten (z. B. `Log_YYYYMMDD.csv`). Dies verhindert, dass Dateien zu groß werden, um in Excel geöffnet zu werden.

No SQL required. You can define a custom header row in the plugin settings to match the exported variables.

3. Protokollspezifische Problembehandlung

• Timeout- oder CRC-Fehler: Im Gegensatz zu TCP ist serielles MODBUS RTU auf strikte Zeitvorgaben angewiesen. Überprüfen Sie, ob Ihre RS485-A/B-Leitungen nicht vertauscht sind und dass die Baudrate und die Geräte-ID in der Software exakt mit dem Slave-Gerät übereinstimmen.
• Das Gerät gibt den Fehlercode „Illegal address“ zurück: Versuchen Sie, in Ihrer MODBUS-Anforderung Funktion #3 anstelle von Funktion #4 zu verwenden. Überprüfen Sie andernfalls, ob Sie die korrekte Registeradresse verwenden. Versuchen Sie, einen absoluten Offset anzugeben (keine logische Adresse wie 40001).
• Ich habe mehrere Werte, die ich in einer Datenzeile exportieren möchte. Der Logger schreibt jedoch einen Wert pro Zeile: Sie müssen die Option „Alle Daten auf einmal exportieren“ in den MODBUS-Plugin-Einstellungen aktivieren.

4. Datenbankspezifische Problembehandlung

• Excel öffnet die Datei, aber alle Daten sind in einer Spalte zusammengequetscht: Dies ist ein Problem der regionalen Einstellungen. In Nordamerika ist das Listentrennzeichen ein Komma (,), in Europa jedoch häufig ein Semikolon (;). Stellen Sie sicher, dass das im Data Logger eingestellte Trennzeichen mit den regionalen Einstellungen des PCs übereinstimmt, der die Datei öffnet.
• Wie kann ich meine serial.print-Ausgabe in eine CSV-Datei schreiben lassen?: Dies ist der einfachste Fall. Der Logger muss in Ihrem Fall nichts verarbeiten. Aktivieren Sie einfach die Protokollierung in eine Datei vor der Analyse und ändern Sie die Protokolldateiendung in 'csv'.
• Kann ich CSV-Daten auf eine Netzwerkfreigabe schreiben, um sie von meinem Computer aus zu verwenden?: Ja, Sie können den Zielpfad als '\\server_name\folder\filename.csv' angeben. Wenn Ihre eingehenden Daten schnell sind, ist es besser, häufig eine neue Protokolldatei zu erstellen, beispielsweise stündlich.