Benutzerhandbuch

Überblick

Das WebSerial Tool verbindet sich über die Web-Serial-Schnittstelle des Browsers mit einem seriellen Gerät (USB-Seriell-Adapter, Arduino, ESP32, Waage mit USB- oder RS-232-Adapter …). Alles läuft lokal im Browser – es werden keine Daten an einen Server übertragen.

Die wichtigsten Funktionen:

• Verbinden mit frei wählbaren Port-Einstellungen (Baudrate, Datenbits, Parität, Stoppbits, Flusssteuerung) und gespeicherten Profilen
• Terminal mit Zeitstempeln, Anzeige als Text und/oder HEX, Filter und farbiger Trennung von Empfang und Senden
• Befehle als Text oder HEX senden, mit wählbarem Zeilenende und Befehlsverlauf
• Automatische Wiederholung eines Befehls (Anzahl und Abstand einstellbar)
• Makros – häufig genutzte Befehle als Schaltflächen
• Live-Diagramm für Messwerte (z. B. Gewicht) mit Min/Max/Durchschnitt
• Export des Logs als HTML, CSV, Text oder JSON
• Steuerleitungen (DTR, RTS, Break) und Statusanzeige (CTS, DSR, DCD, RI)
• Automatisches Neuverbinden nach dem Aus- und Wiedereinstecken
• Demo-Modus zum Ausprobieren ohne Gerät

Voraussetzungen

• Die Seite muss über HTTPS aufgerufen werden (bei lx-labs.dev ist das der Fall).
• Für USB-Seriell-Adapter muss unter Windows ggf. der passende Treiber installiert sein (z. B. CH340/CH341, CP210x, FTDI, Prolific). Unter Linux, macOS und Android sind die gängigen Treiber meist schon vorhanden.
• Der Port darf nicht gleichzeitig von einem anderen Programm (z. B. Arduino IDE, PuTTY, Waagensoftware) geöffnet sein.

Schnellstart

1. Gerät anschließen – per USB an den PC bzw. per OTG-Adapter an das Android-Gerät.
2. Baudrate wählen – im Bereich Verbindung die Baudrate auswählen oder ein zuvor gespeichertes Profil antippen. Sie muss zur Einstellung des Geräts passen.
3. Verbinden – auf Verbinden klicken. Der Browser zeigt eine Liste der Ports; das Gerät auswählen und bestätigen.
4. Daten beobachten – die Statusanzeige oben wird grün, empfangene Zeilen erscheinen im Terminal in Grün.
5. Befehl senden – Befehl unten ins Eingabefeld tippen und Enter drücken bzw. Senden antippen. Gesendete Zeilen erscheinen in Gelb.
6. Trennen – der Verbinden-Knopf heißt jetzt Trennen. Vor dem Abziehen des Geräts sauber trennen.

Die Oberfläche

Kopfzeile

Oben stehen der Name, die Statusanzeige, das Handbuch und der Knopf Verbinden/Trennen. Die Statusanzeige zeigt am Desktop zusätzlich Gerät und Port-Einstellung, z. B. FTDI (0403:6001) · 9600 8N1.

Aufteilung am PC

Je nach Fensterbreite passt sich die Aufteilung an:

• Breite Bildschirme: drei Spalten – links Verbindung, Steuerleitungen, Statistik und Hilfe; in der Mitte das Terminal; rechts Live-Diagramm und Senden & Automatisierung.
• Mittlere Breite (Laptop): zwei Spalten. Das Live-Diagramm steht unter dem Terminal und ist zugeklappt – mit dem Pfeil rechts in seiner Kopfzeile lässt es sich aufklappen. Der aktuelle Wert wird auch im zugeklappten Zustand angezeigt.

Aufteilung auf dem Smartphone

Auf schmalen Bildschirmen gibt es unten eine Navigationsleiste mit vier Bereichen:

Der zuletzt geöffnete Bereich wird beim nächsten Aufruf wieder angezeigt. Der Verbinden-Knopf ist in der Kopfzeile immer erreichbar.

Verbinden & Port-Einstellungen

Die Port-Einstellungen im Bereich Verbindung müssen mit denen des Geräts übereinstimmen. Sie werden beim Öffnen des Ports übernommen und sind während einer Verbindung gesperrt – zum Ändern erst trennen.

Die übliche Kurzschreibweise 9600 8N1 bedeutet: 9600 Baud, 8 Datenbits, keine Parität (N), 1 Stoppbit.

Bekannte Geräte

Einmal freigegebene Geräte merkt sich der Browser. Sie erscheinen als Schaltflächen unter dem Verbinden-Knopf, mit Hersteller (sofern erkannt) und USB-Kennung. Mit × daneben wird die Freigabe für das Gerät wieder entzogen.

Automatisch neu verbinden

Wird das Kabel während einer Verbindung abgezogen, meldet das Tool Verbindung verloren. Ist unter Erweitert die Option Automatisch neu verbinden aktiv (Standard), wird die Verbindung nach dem Wiedereinstecken desselben Geräts selbstständig wiederhergestellt – mit denselben Einstellungen.

Profile

Profile speichern häufig benötigte Kombinationen aus Port-Einstellungen, z. B. je eines pro Gerät. Beim ersten Aufruf sind noch keine Profile vorhanden – sie werden bei Bedarf selbst angelegt.

• Laden: Profilnamen antippen. Die Einstellungen werden sofort übernommen (nur im getrennten Zustand möglich).
• Anlegen: Einstellungen wie gewünscht setzen, dann + Aktuelle Einstellungen antippen und einen Namen vergeben.
• Löschen: auf × neben dem Profil tippen und bestätigen.

Ein Profil speichert Baudrate, Datenbits, Parität, Stoppbits, Flusssteuerung, Zeichencodierung und Zeilenende. Den genauen Inhalt zeigt ein Tooltip, wenn man mit der Maus auf dem Profil verweilt.

Das Terminal

Im Terminal erscheint jede empfangene und gesendete Zeile mit Zeitstempel (Millisekunden) und Richtung:

14:02:11.250 ··  Verbunden: WCH CH34x (1A86:7523) · 9600 8N1
14:02:12.004 TX  S
14:02:12.061 RX  S S    250.34 g
14:02:12.250 RX  ST,GS,  250.36 g

Wie Zeilen gebildet werden

Eine Zeile endet bei CR, LF oder CR+LF. Sendet ein Gerät Daten ohne Zeilenende, wird der bisher empfangene Rest nach einer kurzen Pause (Standard 150 ms, siehe Zeilen-Timeout) trotzdem als Zeile angezeigt. Nicht druckbare Steuerzeichen werden als Symbole dargestellt, z. B. ␂ für STX oder ␛ für ESC.

Werkzeugleiste

Das Log behält standardmäßig die letzten 5000 Zeilen; ältere werden automatisch entfernt. Die Grenze ist unter Erweitert einstellbar.

Befehle senden

Gesendet werden kann an zwei Stellen, die immer denselben Inhalt haben:

• Schnell-Eingabe unter dem Terminal – mit Umschalter ASCII/HEX und Auswahl des Zeilenendes.
• Bereich Senden & Automatisierung – mit allen Optionen.

Senden mit Enter oder der Schaltfläche Senden.

Format: ASCII oder HEX

• ASCII / Text: Der eingegebene Text wird so gesendet, wie er dasteht, z. B. S oder *IDN?.
• HEX: Es werden Bytes als Hexadezimalzahlen eingegeben, z. B. 1B 40 0D. Leerzeichen, Kommas, Doppelpunkte, Bindestriche und 0x-Präfixe sind erlaubt: 0x1B,0x40 und 1B40 ergeben dasselbe. Die Anzahl der Ziffern muss gerade sein.

Zeilenende

Das Zeilenende wird automatisch an jeden Befehl angehängt – auch im HEX-Modus.

Escape-Sequenzen

Ist Escape-Sequenzen eingeschaltet, werden im ASCII-Modus folgende Zeichenfolgen umgewandelt – praktisch, um Steuerzeichen mitten im Text zu senden:

Beispiel: \x02DATA\x03 sendet 02 44 41 54 41 03 (plus gewähltes Zeilenende).

Befehlsverlauf

Die letzten 50 gesendeten Befehle werden gespeichert. Mit ↑ und ↓ im Eingabefeld blättert man durch den Verlauf; zusätzlich schlägt der Browser beim Tippen passende frühere Befehle vor.

Unter Erweitert lässt sich einstellen, dass das Eingabefeld nach dem Senden geleert wird.

Wiederholung

Die Wiederholung sendet den Befehl aus dem Eingabefeld automatisch mehrfach – z. B. um eine Waage regelmäßig abzufragen.

1. Befehl ins Eingabefeld schreiben (Format, Zeilenende und Escape-Einstellung wie beim normalen Senden).
2. Anzahl eintragen. 0 bedeutet endlos, bis man stoppt.
3. Abstand in Sekunden eintragen, z. B. 0,5 für zweimal pro Sekunde (kleinster Wert 0,05 s).
4. Wiederholung starten antippen.

Der Fortschrittsbalken und die Zeile darunter zeigen den Stand, z. B. Sendung 4 / 10 · alle 1 s. Mit Stoppen wird sofort abgebrochen.

Makros

Makros sind Schaltflächen für häufig benötigte Befehle. Ein Tipp darauf sendet den Befehl sofort. Jedes Makro hat sein eigenes Format, Zeilenende und seine eigene Escape-Einstellung – unabhängig von den aktuellen Sende-Einstellungen. Beim ersten Aufruf ist die Liste leer.

Live-Diagramm

Das Diagramm liest aus jeder empfangenen Zeile automatisch einen Zahlenwert und zeichnet dessen Verlauf. Darüber stehen der aktuelle Wert in großer Schrift sowie Min, Max, Durchschnitt (Ø) und Anzahl der Messwerte (n).

• Wert ablesen: Mit der Maus über das Diagramm fahren bzw. auf dem Smartphone antippen – Wert und Uhrzeit des nächstliegenden Messpunkts werden angezeigt.
• Fenster: Wie viele der letzten Messpunkte gezeigt werden (100, 300, 1000 oder 3000). Einstellbar unter Auswertung: Ausdruck & Fenster unter dem Diagramm.

Rechts in der Kopfzeile des Diagramms liegen drei Symbole:

Auf Laptops mittlerer Bildschirmbreite ist das Diagramm unter dem Terminal zugeklappt; der Pfeil ganz rechts klappt es auf.

Welche Zahl wird gelesen? – der Ausdruck

Welche Zahl aus der Zeile genommen wird, bestimmt der Ausdruck (ein regulärer Ausdruck) im aufklappbaren Bereich Auswertung: Ausdruck & Fenster. Die Voreinstellung nimmt die erste Zahl der Zeile, mit Vorzeichen und Dezimalstellen – Komma oder Punkt:

([-+]?\d+(?:[.,]\d+)?)

Für typische Waagenausgaben wie ST,GS, 250.36 g passt das ohne Änderung. Enthält die Zeile vor dem Messwert weitere Zahlen, kann der Ausdruck angepasst werden. Es zählt die erste Klammergruppe:

Ist der Ausdruck ungültig, wird das Feld rot umrandet und es werden keine Werte aufgezeichnet. Zeilen ohne passende Zahl werden einfach übersprungen.

Log exportieren

Über das Download-Symbol in der Terminal-Werkzeugleiste wird das Log als Datei gespeichert:

Dateinamen enthalten Datum und Uhrzeit, z. B. wst-log-20260924-140211.csv.

Für die reinen Messwerte gibt es den separaten CSV-Export im Diagramm (Spalten Zeit; Wert).

Steuerleitungen

Für Geräte, die auf die Handshake-Leitungen der seriellen Schnittstelle reagieren. Die Bedienelemente sind nur bei einer echten Verbindung aktiv.

Beim Verbinden werden DTR und RTS eingeschaltet. Die Eingänge werden zweimal pro Sekunde abgefragt; ein grünes Lämpchen bedeutet aktiv.

Statistik

Im Bereich Statistik stehen laufend:

• Empfangen / Gesendet – Datenmenge in Byte, KB oder MB
• Zeilen – Anzahl empfangener Zeilen
• Datenrate – aktuell empfangene Bytes pro Sekunde
• Verbindungsdauer – Zeit seit dem Verbinden

Zurücksetzen stellt alle Zähler auf null (bei aktiver Verbindung beginnt auch die Dauer neu).

Erweiterte Einstellungen

Im Bereich Verbindung unter Erweitert:

Demo-Modus

Der Demo-Modus simuliert eine Waage und eignet sich zum Kennenlernen des Tools, zum Testen von Makros und Diagramm-Ausdrücken oder für Browser ohne Web Serial.

• Starten über Demo-Modus (ohne Gerät) im Bereich Verbindung – oder direkt über die Adresse mit angehängtem #demo, z. B. https://lx-labs.dev/tools/webserial/#demo.
• Die simulierte Waage sendet viermal pro Sekunde einen schwankenden Gewichtswert: ST,GS, 263.69 g
• Sie antwortet auf S (Einzelwert), *IDN? (Kennung) und AT (OK). Alles andere wird mit ECHO: … zurückgegeben.
• Beenden mit Trennen.

Steuerleitungen sind im Demo-Modus nicht verfügbar.

Fehlerbehebung

Datenschutz & Speicherung

Das Tool läuft vollständig im Browser. Die Kommunikation mit dem Gerät findet ausschließlich lokal statt; es werden keine Mess- oder Logdaten an einen Server gesendet. Exportierte Dateien landen im Download-Ordner des eigenen Geräts.

Im lokalen Speicher des Browsers werden abgelegt:

• Einstellungen (Port, Anzeige, Senden, Diagramm)
• Profile und Makros
• die letzten 50 gesendeten Befehle
• der zuletzt geöffnete Bereich (Smartphone)

Das Log selbst wird nicht gespeichert – beim Neuladen der Seite ist es leer. Wichtige Aufzeichnungen daher vorher exportieren.

Welche Geräte die Seite nutzen darf, merkt sich der Browser. Die Freigabe lässt sich über das × neben einem bekannten Gerät oder in den Website-Einstellungen des Browsers entziehen.

Allgemeine Hinweise zum Datenschutz auf lx-labs.dev stehen in der Datenschutzerklärung.

Kurzreferenz

Häufige Einstellungen