Playground · Experiment · 2019

Open-Pay

Ein kleines Bezahlsystem mit RFID-Karten auf einem Raspberry Pi. Kinder einer Jugendfreizeit bekamen eine Karte mit einem Guthaben in „Talern“ und konnten damit am Kiosk bezahlen. Kein Bargeld, kein Wechselgeld, keine Zettelwirtschaft.

Python 3TkinterRaspberry Pi3,5″-TouchdisplayRFID (Mifare, seriell)MariaDBpandas / CSVOktober 2019
Läuft nicht im Browser. Open-Pay ist eine Desktop-Anwendung für einen Raspberry Pi mit Touchdisplay und USB-RFID-Leser. Diese Seite zeigt, was das Projekt war und wie es funktioniert hat. Die Oberfläche unten ist nachgebaut.

So sah es aus

Das Jufö Bankensystem
Kind A hat 5 Taler übertragen bekommen
Kind B hat -2 Taler übertragen bekommen
Kind C hat -1.5 Taler übertragen bekommen
Kind A hat -3 Taler übertragen bekommen
Kind D hat 10 Taler übertragen bekommen
Kind B hat -0.5 Taler übertragen bekommen
2,50
123456789,0X Weiter

Nachbau mit Beispieldaten: Hauptbildschirm mit Buchungsverlauf und der Ziffernblock zum Ein- und Auszahlen

Wie es funktioniert hat

  1. Einrichten: Die Teilnehmerliste wurde als CSV-Datei (Spalten name, nachname) per USB-Stick eingelesen. Jede Person startete mit einem festen Guthaben.
  2. Karte zuordnen: Eine neue RFID-Karte auflegen, Person aus der Liste wählen, fertig.
  3. Bezahlen: Karte auflegen, „Einzahlen“ oder „Auszahlen“ tippen, Betrag eingeben. Jede Buchung landet im Verlauf auf dem Startbildschirm.
  4. Einstellungen: USB-Stick einstecken öffnet ein PIN-Feld. Danach lassen sich die Datenbank sichern, Nutzer importieren, die Netzwerk-Verlinkung starten oder Updates einspielen.
  5. Mehrere Kassen: Mehrere Pis mit SD-Karten-Klonen und festen IPs im Netz 10.0.0.x fanden sich per Ping und nutzten eine gemeinsame MariaDB.

Bausteine

gui.py

Tkinter-Oberfläche im Vollbild-„Kiosk“-Modus: Verlauf, Kartenverwaltung, Ziffernblock, Einstellungen.

rfid.py

Spricht seriell mit einem Mifare-Leser an /dev/ttyUSB0 und gibt die Karten-ID zurück.

db.py

MariaDB-Anbindung mit den Tabellen users (Guthaben) und history (Buchungen).

detodev.py

Findet andere Kassen im lokalen Netz per Ping über einen IP-Bereich.

.env

Konfiguration: Startguthaben, Einstellungs-PIN, IP-Adressen, DHCP-Profile.

nodm + openbox

Startet direkt in die App, ohne Desktop. Ein schneller Start war das Ziel.

Code-Ausschnitte

# rfid.py – Karte abfragen, bis eine gültige ID kommt
ser = serial.Serial('/dev/ttyUSB0', 9600, timeout=1)
while True:
    ser.write(prot['enquiry_card'].encode())
    resp = ser.read(4)
    if resp == prot['enquiry_cards_return'].encode():
        ser.read(3)
        ser.write(prot['anticollision'].encode())
        resp = ser.read(7)
        if binascii.b2a_hex(resp)[:4].decode() == "0603":
            ser.write(prot['active_buzzer'].encode())   # Piep!
            return binascii.b2a_hex(resp).decode()
# db.py – zwei Tabellen reichen
CREATE TABLE IF NOT EXISTS users(
  ID INTEGER PRIMARY KEY AUTO_INCREMENT,
  tagid VARCHAR(65), name VARCHAR(30), nachname VARCHAR(30),
  kontostand FLOAT, changes VARCHAR(45));
CREATE TABLE IF NOT EXISTS history(
  ID INTEGER PRIMARY KEY AUTO_INCREMENT, entry VARCHAR(120));
# ~/.xsession – Kioskmodus: App läuft in einer Endlosschleife
exec openbox-session &
while true; do
  python3 ~/open-pay/gui.py
done

Dateien

open-pay/
├── gui.py            # Oberfläche (≈ 500 Zeilen)
├── rfid.py           # RFID-Leser
├── db.py             # MariaDB
├── detodev.py        # andere Kassen im Netz finden
├── dotenvpars.py     # .env-Werte zur Laufzeit ändern
├── empty.csv         # Vorlage für den Nutzerimport
├── cardcheck/        # Hilfsskripte zum Prüfen von Karten
├── .env              # Konfiguration (PIN hier entfernt)
└── README.md

Rückblick

Ein Wochenendprojekt, das im Einsatz funktioniert hat. Heute würde man einiges anders machen: SQL-Abfragen mit Parametern statt String-Formatierung (im Code steht schon der Kommentar „potential sql injection“), keinen Root-Datenbanknutzer ohne Passwort und keine PIN in einer eingecheckten Datei.