Kapitel 3 — Bridge-App (Hardware-Verbindungsbrücke)

Die Kasse läuft im Browser, und der Browser kann nicht direkt mit Kartenterminal, Drucker, Waage und Kundendisplay kommunizieren. Die Bridge-App ist diese Brücke: Sie läuft neben der Kasse und verbindet diese Geräte mit der Kasse.

Es gibt sie in drei Ausführungen, die alle dasselbe tun (die iOS-Version ist experimentell):

• Android-App auf einem Tablet
• Desktop-App auf einem Computer (Windows/Mac/Linux)
• iOS-App (experimentell)

⚠️ Sprache: Die Oberfläche der Android-App ist praktisch Englisch. Nur einige alte Zeichenketten wurden ins Deutsche übersetzt; das gesamte Dashboard, das der Bediener sieht (Status, Power Guard, Keep Bridge Awake, Logs usw.), ist Englisch.

💡 In der Regel richten Sie Bridge einmal ein, danach läuft es im Hintergrund. Die Adresse von Bridge geben Sie in der Kasse unter Kasse → Einstellungen → Bridge ein (Kassenhandbuch, Kapitel 9). Die Android-App läuft als dauerhafter Vordergrunddienst: Sie bleibt aktiv, auch wenn Sie die App aus der Übersicht schließen, startet nach einem Update automatisch neu, und eine Überwachung startet den Server bei Bedarf alle 30 Sekunden erneut.

3.1. Android-App — Statusseite

Eine Vollbildseite (Kiosk) mit einer Zusammenfassungszeile oben und mehreren Statuskarten. Beim Start sehen Sie die Meldung „Die Brücke wird vorbereitet; Kartenterminal und Kundendisplay werden verbunden".

• Gesamtzusammenfassung oben auf der Seite, etwa: „Brücke bereit für Zahlung", „Kartenterminal bereit, wartet auf Browser", „Browser verbunden / Kartenterminal offline", „Verbindung zum Kartenterminal wird wiederhergestellt" oder „Transaktion läuft".
• Statuskarten (jeweils ein farbiger Punkt und ein Statuswort):
• WebSocket — der lokale Port, mit dem sich die Kasse verbindet.
• Browser (Browser) — ob die Kasse verbunden ist.
• Kartenterminal (POS Terminal) — Zustände: getrennt / Verbindung wird hergestellt / Verbindung wird wiederhergestellt / verbunden / beschäftigt (Busy) während einer Transaktion.
• Kundendisplay — Status des zweiten Bildschirms.
• Power Guard — Schutz von Akku/Prozessor/WLAN, um Ausfälle im Leerlauf zu verhindern.

Karte „Bridge-Adresse"

• Zeigt die Adresse an (lokal 127.0.0.1:PORT oder eine Netzwerkadresse mit der IP des Geräts), die in der Kasse eingetragen werden muss.
• Die Schaltfläche für den Verbindungsmodus ist dreistufig und wechselt bei jedem Tippen: Lokal → Netzwerk → Automatisch (Auto). Im Automatikmodus wird das Netzwerk verwendet, sofern eine lokale Netzwerkadresse verfügbar ist, andernfalls lokal.
• Halten der Schaltfläche für den Verbindungsmodus: erstellt oder löscht den Pairing-Token — einen sechsstelligen Code, der an die Adresse angehängt wird (?token=XXXXXX), damit sich nur die berechtigte Kasse verbinden kann. Dieser Token wirkt nur im Netzwerkmodus (im lokalen Modus wird er ignoriert) und wird in der Adresse als „Paired/Open" angezeigt.

Weitere Karten und Zugriff auf die Logs

• Power Guard → „Bridge wach halten" (Keep Bridge Awake): öffnet die Akku-Einstellungen von Android, damit Bridge im Leerlauf nicht getrennt wird.
• Logs: werden mit der Schaltfläche Enable/Disable Logs ein-/ausgeschaltet, und View Logs öffnet die Log-Seite; beim Ausschalten werden die gespeicherten Logs gelöscht. Ein zweiter Weg, die Logs zu öffnen, ist ein langes Drücken (long-press) auf die Leiste am oberen Bildschirmrand.
• Log-Seite: nur lesbar — Text in dicktengleicher Schrift, der sich jede Sekunde aktualisiert und nach unten scrollt; es gibt keine Schaltfläche zum Teilen/Exportieren (zum Senden an den Support müssen Sie ihn manuell kopieren).
• Kundendisplay-Seite: zeigt dem Kunden auf dem zweiten Bildschirm die Positionen und die Bestellsumme mit einer Web-Vorlage. Unter Android heftet sie sich automatisch an jeden angeschlossenen zweiten Bildschirm (ohne manuelle Auswahl; beim Abziehen des Kabels wird sie entfernt).

3.2. Desktop-App — „LonioBridge — Host"

Ein kleines Steuerungsfenster zum Ausführen von Bridge auf einem Computer:

• Einrichtungsformular:
• WebSocket-Port (Standard 8088)
• Bindungsadresse (Bind): nur dieser Computer oder das gesamte Netzwerk (Standard 0.0.0.0).
• Kundendisplay: manuelle Auswahl des Monitors, der als Kundendisplay dienen soll (oder keiner).
• Start/Stopp zum Ausführen der Brücke; die Einstellungen werden in der Datei ~/.loniobridge/host.properties zwischen den Ausführungen gespeichert.
• Autostart (Autostart): über den Parameter --autostart (das Installationsprogramm unter Windows richtet ihn mit Aktivierungs-/Deaktivierungsskripten so ein, dass er beim Systemstart hochfährt).
• Fensterloser Modus (Console): mit --console lässt er sich ohne grafische Oberfläche ausführen.
• Statusbereich: Serverzustand (gestoppt / wird gestartet / lauscht am Port / ungültiger Port / Fehler), Anzahl der verbundenen Kassen, Status des Kartenterminals und die Anzeige beschäftigt/im Leerlauf (während einer Transaktion).
• Aktivitätsprotokoll: ein zeitgestempeltes Ereignisprotokoll; die Option Verbose protokolliert die Rohframes des Kartenterminals (nur zur Fehlersuche).

⚠️ Im Desktop-Fenster gibt es keine Auswahl für Drucker oder Waage; nur Port, Bindungsadresse und Kundendisplay. Drucker und Waage werden von der Kasse aus konfiguriert, und Bridge richtet sie gemäß der Meldung der Kasse ein.

3.3. Welche Geräte verbunden werden

• Kartenterminal: Es gibt zwei Treiber, die im Terminalprofil ausgewählt werden:
• ZVT (Standard) — über Netzwerk/TCP, mit automatischem Wiederverbinden (Backoff) und den Zuständen Verbindung wird hergestellt/wiederhergestellt/verbunden.
• GP Tom (SoftPOS) — der Treiber von Global Payments, der auf demselben Android-Tablet mit der GP-Kartenterminal-App kommuniziert (Verkauf/Storno/Rückerstattung; der Tagesabschluss (Settlement) über diesen App2App-Weg wird noch nicht unterstützt).
• Kundendisplay: eine Web-Vorlage (Positionen und Bestellsumme), die die Kasse dorthin sendet; unter Android heftet es sich automatisch an, auf dem Desktop durch manuelle Auswahl des Monitors.
• Drucker:
• ⚠️ Unter Android wird der Druck derzeit nur angenommen, die tatsächliche Ausführung des Drucks ist aber nicht umgesetzt; der echte Druck funktioniert auf dem Desktop.
• Auf dem Desktop gibt es drei Wege: seriell, Systemdrucker (Windows) und Netzwerk/TCP (Standard, Port 9100); inklusive Papierschnitt und Öffnen der Geldlade.
• Waage: nur auf dem Desktop — seriell oder USB-HID, mit Erkennung der Einheit (kg/g/lb/oz) und stabilem/instabilem Modus. Android hat keine Waage.

3.4. Konfiguration, die die einrichtende Person kennen muss

• Port (Standard 8088) und Bindungsadresse (lokal gegenüber Netzwerk).
• Der Unterschied zwischen 127.0.0.1 (lokal) und der Netzwerk-IP: Wenn die Kasse auf demselben Gerät läuft, genügt lokal; läuft sie auf einem anderen Gerät, sind der Netzwerkmodus + die IP erforderlich, und beide müssen sich im selben Netzwerk befinden.
• Pairing-Token (?token=…) nur im Netzwerkmodus.
• Akku-Einstellungen von Android (Keep Bridge Awake), um Ausfälle zu verhindern.

3.5. Schnelle Fehlersuche