Files

T

Kerim (portable/claudecode)andClaude Opus 5 70756f3762 Bon fuer die Kasse auf einem USB-Bondrucker ausgeben

Der Kunde soll mit einem Zettel zur Kasse gehen koennen, auf dem steht, was
er zahlen muss. Drei Wege fuehren jetzt zu einem Bon: der Knopf "Bon" auf der
Timer-Karte druckt den Zwischenstand und laesst den Timer weiterlaufen,
"Beenden" druckt den Endbeleg, und in der Historie laesst sich jeder Beleg
nachdrucken.

Der Drucker haengt per USB an einem Raspberry Pi und ist damit vom
Timer-Server aus nicht direkt erreichbar. Auf dem Pi laeuft deshalb eine
kleine Bruecke (deploy/bondrucker/, nur Python-Standardbibliothek), die
fertige ESC/POS-Daten per HTTP annimmt. Das Bon-Layout bleibt bewusst hier
im Repo, damit Aenderungen daran nicht auf dem Pi angefasst werden muessen.

Beim Beenden wird erst gespeichert und dann gedruckt. Eine leere Papierrolle
ist damit ein Papierproblem und kein Datenproblem - der Vorgang steht in der
Historie, die Oberflaeche sagt ausdruecklich, dass der Bon nicht gedruckt
wurde, und nennt den Grund.

Ohne PRINTER_HOST in der .env ist die Druckfunktion aus und die App verhaelt
sich unveraendert.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-09-04 20:37:12 +02:00

3.6 KiB

Raw Blame History

Bondrucker-Bruecke

Kleiner Dienst für den Raspberry Pi, an dem der Kassendrucker per USB hängt.

Warum es ihn gibt

Der Bondrucker ist ein USB-Gerät (/dev/usb/lp0) und damit nur für den Rechner sichtbar, an dem er steckt. Der Timer-Server läuft woanders. Diese Brücke nimmt fertige ESC/POS-Daten per HTTP entgegen und schiebt sie in das Gerät — mehr nicht. Der Bon selbst wird in der Timer-App gebaut (backend/receipt.js), damit Layout-Änderungen nicht auf dem Pi angefasst werden müssen.

Nur Python-Standardbibliothek, kein pip, kein CUPS, kein node.

Installation auf dem Pi

# Dateien auf den Pi kopieren
scp print-server.py bondrucker.service install.sh README.md pi@<PI-IP>:/tmp/bondrucker/

# Dort einrichten
ssh pi@<PI-IP>
cd /tmp/bondrucker && sudo bash install.sh

install.sh legt an:

Was	Wo
Dienstbenutzer `bondrucker` (Gruppe `lp`)	—
Programm	`/opt/bondrucker/print-server.py`
Token	`/etc/bondrucker/env` (`0640`, root:bondrucker)
udev-Regel	`/etc/udev/rules.d/99-bondrucker.rules`
Dienst	`bondrucker.service`, aktiviert und gestartet

Am Ende gibt das Skript den Wert für PRINTER_TOKEN aus. Der gehört in die .env des Timer-Servers.

Timer-Server konfigurieren

In backend/.env:

PRINTER_HOST=192.168.8.157
PRINTER_PORT=9100
PRINTER_TOKEN=<Ausgabe von install.sh>
PRINTER_WIDTH=42

Danach systemctl restart timer-app. Ist PRINTER_HOST leer, ist die Druckfunktion aus und die App verhält sich wie vorher — ohne Bon-Knöpfe.

Prüfen

# Zustand des Druckers
curl -s http://<PI-IP>:9100/status

# Aus der App heraus: Einstellungen -> "Probedruck"

Antwortet /status mit "ok": true, ist das Gerät da und beschreibbar.

Schnittstelle

Aufruf	Wirkung
`GET /status`	JSON mit Gerät, Beschreibbarkeit, letztem Fehler. HTTP 503, wenn kein Drucker da ist
`POST /print`	Rumpf = rohe ESC/POS-Bytes, Kopfzeile `X-Print-Token`. Antwortet `{"ok":true,"bytes":N}`

Fehler kommen als HTTP 4xx/5xx mit {"error": "..."} zurück — die Timer-App zeigt diesen Text unverändert an. „Papier leer" und „Deckel offen" landen als OSError beim Schreiben und damit als HTTP 502 in der Anzeige.

Betriebshinweise

Feste IP vergeben. Der Pi hängt per WLAN und DHCP im Netz. Wechselt die Adresse, druckt die App nicht mehr, bis PRINTER_HOST angepasst ist. Eine DHCP-Reservierung im Router ist der einfachste Weg.
USB-Kabel neu gesteckt? Aus lp0 kann lp1 werden. Der Dienst sucht deshalb selbst nach /dev/usb/lp* — es ist nichts zu tun.
Ein Auftrag nach dem anderen. Der Dienst serialisiert Druckaufträge, zwei gleichzeitige Bons können sich nicht ineinanderschieben.
Netzgrenze. Port 9100 sollte nur aus dem eigenen Netz erreichbar sein. Das Token schützt gegen versehentliche, nicht gegen entschlossene Zugriffe.

Fehlersuche

systemctl status bondrucker
journalctl -u bondrucker -f          # jeder Auftrag wird protokolliert

# Am Pi direkt drucken, ohne App und ohne Dienst:
printf 'Test\n\n\n\n\x1dVB\x00' | sudo tee /dev/usb/lp0 > /dev/null

Symptom	Ursache
`/status` sagt `deviceExists: false`	Drucker aus oder USB-Kabel ab
`/status` sagt `writable: false`	udev-Regel nicht gegriffen — `sudo udevadm trigger`, Dienst neu starten
HTTP 403	`PRINTER_TOKEN` in der `.env` weicht von `/etc/bondrucker/env` ab
App meldet „nimmt keine Verbindung an"	Dienst läuft nicht, oder falsche IP/Port
Umlaute als Kringel	Drucker beherrscht Codepage 16 (WPC1252) nicht — siehe `backend/escpos.js`

3.6 KiB Raw Blame History