Zum Inhalt

SimpleSerial

Beta-Funktion

Die Darstellung einfacher serieller Geräte ist derzeit in frühem Release-Status und noch in Entwicklung. Die Funktionalität kann sich im Laufe der Zeit ändern und die Stabilität kann nicht garantiert werden.

SimpleSerial kann verwendet werden, um Daten von benutzerdefinierten seriellen Geräten mit einer nur-Text- oder Trennzeichen-separierten String-Ausgabe zu visualisieren und aufzuzeichnen. Es stellt eine Verbindung über einen Serienport zur Software her. Diese Funktion erfordert eine Online-Aktivierungslizenz.

Verbindung und Einrichtung

  1. Schließen Sie die externe serielle Quelle an und schalten Sie sie ein.
  2. Öffnen Sie das Geräteverwaltungs-Panel.
  3. Verwenden Sie Mehr und wählen Sie SimpleSerialDevice.
  4. Wählen Sie den korrekten COM-Port.
  5. Konfigurieren Sie Baudrate und andere serielle Einstellungen.
  6. Wählen Sie das Daten-Trennzeichen und Dezimal-Trennzeichen.
  7. Aktivieren Sie das optionale Kopfzeilenanalyse, wenn die erste Zeile Kanalnamen enthält.
  8. Starten Sie das Streaming und verifizieren Sie die Live-Werte.

Unterstützte Parser-Optionen:

  • Daten-Trennzeichen: Komma (,), Semikolon (;), Tab (\t), Pipe (|), Leerzeichen ( ), Doppelpunkt (:)
  • Dezimal-Trennzeichen: Punkt (.), Komma (,)

Typische serielle Standards:

  • BaudRate: 115200
  • Parity: None
  • DataBits: 8
  • StopBits: One

Kopfzeile und Payload-Format

Wenn eine Kopfzeile gesendet wird, kann EasyGraph Kanalnamen automatisch zuweisen.

Kopfzeilenanalyse-Modell:

  • Die Kopfzeile verwendet das gleiche Zeilenformat wie eine normale Datenzeile.
  • Sie verwendet das ausgewählte Trennzeichen und Zeilenumbruch-Modell.
  • Statt numerischer Werte enthält sie Text-Elemente.
  • Diese Elemente werden zu den Kanalnamen.
  • Die Anzahl der Kopfzeilen-Elemente muss der Anzahl der Werte in späteren Datenzeilen entsprechen.

Beispiel A (Komma-Daten-Trennzeichen, Punkt-Dezimal-Trennzeichen):

...
12.42,5.00,1013.2\r\n
12.40,5.02,1013.1\r\n
...

Beispiel B (Semikolon-Daten-Trennzeichen, Komma-Dezimal-Trennzeichen):

...
12,42;5,00;1013,2\n
12,40;5,02;1013,1\n
...

Beispiel C mit Kopfzeile:

...
12.42;5.00;1013.8\n
Flow_A;Flow_B;Pressure\n
12.42;5.00;1013.2\n
12.40;5.02;1013.1\n
...

Tipp: Kopfzeilen-Implementierung

Um sicherzustellen, dass die Kopfzeile aktualisiert wird, auch wenn der Datenstrom des Zielgeräts bereits gestartet ist, sollten Sie die Kopfzeile regelmäßig senden, z. B. alle 5 Sekunden.

Timeout-Verhalten

Der SimpleSerial-Gerätetreiber verwendet ein festcodiertes Timeout von 1 Sekunde. Es beginnt nach dem ersten gültigen empfangenen Paket und wird durch jedes neue gültige Paket zurückgesetzt. Falls keine gültigen eingehenden Daten innerhalb dieses Zeitfensters empfangen werden, beendet EasyGraph die Geräteverbindung.

Automatische Wiederverbindung ist nicht vorhanden. Wie bei anderen EasyGraph-Geräten wird das Gerät als grauer Offline-Eintrag im Geräteverwaltungs-Panel angezeigt. Durch Klicken auf den Eintrag wird es aus der Liste entfernt. Um eine Wiederverbindung herzustellen, starten Sie den ursprünglichen Verbindungs-Arbeitsablauf erneut.

Fehlersuche

Symptom Wahrscheinliche Ursache Empfohlene Maßnahme
Keine Werte angezeigt Falscher COM-Port COM-Port im Windows-Geräte-Manager erneut überprüfen
Keine Werte angezeigt Falsche serielle Einstellungen Baudrate, Parität, Stoppbits überprüfen
Werte sind verzerrt Baud- oder Parität-Nichtübereinstimmung Sender- und EasyGraph-Serieneinstellungen abgleichen
Zufällige Verbindungsabbrüche Kabel-, Rausch- oder Stromversorgungsproblem Abschirmung verbessern, Kabel kürzen, Stromversorgung stabilisieren
Port kann nicht geöffnet werden Port wird von einer anderen Anwendung blockiert Andere Terminal- oder Logger-Anwendungen schließen
Falsche Kanalnamen Kopfzeile nicht aktiviert oder fehlerhaft Kopfzeile/Daten-Element-Anzahl + Format verifizieren
Dezimal-Parse-Fehler Dezimal-Trennzeichen-Nichtübereinstimmung Zwischen Punkt- und Komma-Dezimal-Trennzeichen wechseln

Grenzen und Best Practices

  • Halten Sie die Kanalanzahl für die Ziel-Abtastrate und PC-Kapazität realistisch.
  • Verwenden Sie ein konsistentes Trennzeichen-Schema in allen Zeilen.
  • Mischen Sie Dezimal-Trennzeichen nicht im gleichen Stream.
  • Bevorzugen Sie explizite Kopfzeilen für wiederholbare Projekte.
  • Geben Sie ein aussagekräftiges Kopfzeilen-Element pro Kanal an.