Zum Inhalt

Aufbau & Topologien

Die Suite wächst mit: von einer Konsole am Schreibtisch bis zu einer Halle voller Stationen mit Stream und mehreren Bildschirmen. Die Bausteine bleiben dieselben. Es ändern sich nur die Zahl der Stationen und der Ort, an dem jeder Dienst läuft.

Topologie A: Minimal (Demo / Training)

Ein Windows-PC macht alles. Eine Station erfasst ein NES.

flowchart LR
    NES["<span style='color:#f8fafc'>🎮 NES</span>"]:::hw --> CAP["<span style='color:#f8fafc'>USB-Capture</span>"]:::hw --> ST["<span style='color:#111111'>nestris-station<br/>(Debian-Mini-PC)</span>"]:::core
    RD["<span style='color:#111111'>RFID-Leser</span>"]:::rfid --> ST
    subgraph PC["Windows-PC"]
        LTM["<span style='color:#111111'>NestrisLTM</span>"]:::ltm
        MQ["<span style='color:#ffffff'>Mosquitto</span>"]:::ext
        PG[("<span style='color:#ffffff'>PostgreSQL</span>")]:::ext
        OBS["<span style='color:#ffffff'>OBS</span>"]:::ext
    end
    ST -- MQTT + HTTP --> MQ & LTM
    MQ --> LTM <--> PG
    LTM -- Overlay --> OBS

    classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
    classDef core fill:#22d3ee,stroke:#0e7490,color:#111,stroke-width:2px
    classDef rfid fill:#f472b6,stroke:#be185d,color:#111,stroke-width:2px
    classDef ext fill:#64748b,stroke:#334155,color:#fff,stroke-width:2px
    classDef hw fill:#1f2937,stroke:#94a3b8,color:#f8fafc,stroke-dasharray:4 3

Noch keine Stations-Hardware?

Die Desktop-Werkzeuge in nestris-core (CLI, egui-/Qt-GUI, Browser-GUI) lassen dieselbe Erkennungs-Engine auf einer Capture-Karte, Webcam oder Videodatei laufen. Damit lässt sich die Erkennung ausprobieren, bevor eine Station gebaut wird.

Topologie B: Volle Turnierhalle

Ein eigener Host-PC, eine Station pro Konsole, ein Anmelde-Terminal, ein Stream-PC und Bildschirme in der Halle. Alles hängt an einem eigenen Switch oder VLAN.

flowchart TB
    subgraph LAN["Turnier-LAN (geschlossenes Netz)"]
        direction TB
        SW{{"<span style='color:#f8fafc'>Switch</span>"}}:::hw

        subgraph ST["Stationen × n"]
            direction LR
            S1["<span style='color:#111111'>Station 1</span>"]:::core
            S2["<span style='color:#111111'>Station 2</span>"]:::core
            S3["<span style='color:#111111'>Station 3</span>"]:::core
            S4["<span style='color:#111111'>Station …</span>"]:::core
        end

        subgraph HOST["Host-PC (Windows)"]
            LTM["<span style='color:#111111'>NestrisLTM :7990</span>"]:::ltm
            MQ["<span style='color:#ffffff'>Mosquitto :1883</span>"]:::ext
            PG[("<span style='color:#ffffff'>PostgreSQL :5432<br/>nur lokal</span>")]:::ext
        end

        TERM["<span style='color:#111111'>Anmelde-Terminal<br/>nestris-terminal + Leser</span>"]:::term
        STREAM["<span style='color:#ffffff'>Stream-PC<br/>OBS-Browserquellen</span>"]:::ext
        WALL["<span style='color:#ffffff'>Hallen-Bildschirme<br/>/view/highscore</span>"]:::ext
        ADMIN["<span style='color:#ffffff'>Admin-Laptop<br/>Browser</span>"]:::ext
        DECK["<span style='color:#ffffff'>Stream Deck</span>"]:::ext
    end

    S1 & S2 & S3 & S4 --- SW
    SW --- HOST
    SW --- TERM & STREAM & WALL & ADMIN
    DECK -.-> STREAM
    STREAM -- "Runden-API" --> LTM

    classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
    classDef core fill:#22d3ee,stroke:#0e7490,color:#111,stroke-width:2px
    classDef term fill:#a78bfa,stroke:#6d28d9,color:#111,stroke-width:2px
    classDef ext fill:#64748b,stroke:#334155,color:#fff,stroke-width:2px
    classDef hw fill:#1f2937,stroke:#94a3b8,color:#f8fafc,stroke-dasharray:4 3

Typische Größenordnung. Ein live-Stream mit vollem Spielfeld braucht etwa 18 KB/s pro Station. Selbst ein Dutzend Stationen nutzt nur einen Bruchteil eines 100-Mbit/s-Netzes. Die Hauptlast des Hosts sind die Datenbank und das Ausliefern der Overlays.

Topologie C: Verteilte Dienste

Jeder Dienst lässt sich verschieben. PostgreSQL und Mosquitto können auf anderen Rechnern laufen, und NestrisLTM kann headless auf einem Linux-Server laufen:

flowchart LR
    ST["<span style='color:#111111'>Stationen</span>"]:::core --> MQ["<span style='color:#ffffff'>Mosquitto<br/>(Server A)</span>"]:::ext
    MQ --> LTM["<span style='color:#111111'>NestrisLTM --headless<br/>(Server B)</span>"]:::ltm
    LTM <--> PG[("<span style='color:#ffffff'>PostgreSQL<br/>(Server C)</span>")]:::ext
    TERM["<span style='color:#111111'>Terminal</span>"]:::term --> LTM

    classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
    classDef core fill:#22d3ee,stroke:#0e7490,color:#111,stroke-width:2px
    classDef term fill:#a78bfa,stroke:#6d28d9,color:#111,stroke-width:2px
    classDef ext fill:#64748b,stroke:#334155,color:#fff,stroke-width:2px

Im NestrisLTM-Installer PostgreSQL und Mosquitto abwählen, um vorhandene Server zu nutzen. Dann die Abschnitte [database] und [mqtt] der Konfiguration auf diese Server zeigen lassen.

Hardware- & Softwareanforderungen

Punkt Anforderung
Betriebssystem Windows 10/11 x64 (der Headless-Kern läuft auch unter Linux)
Datenbank PostgreSQL 14+ (der Installer kann PostgreSQL 18 installieren)
Broker Mosquitto 2.x (der Installer kann 2.1.2 installieren)
Netzwerk Feste IP im Turnier-LAN; TCP 7990 und 1883 für das lokale Subnetz offen
Tipp Kabelverbindung; Bildschirme und OBS verbinden sich mit diesem PC
Punkt Anforderung
Rechner Kleiner x86-64- oder ARM64-PC mit Debian 12 oder 13
Capture USB-Capture-Stick (v4l2) oder Netzwerk-Stream (RTSP/SRT über go2rtc)
Leser Retroverse-RFID-Leser an USB
Konsole NES / Famicom mit Classic Tetris; modifizierte ROMs mit Hex-Score werden unterstützt
Punkt Anforderung
Rechner Windows-10/11-x64-Touch-PC, 1920×1080 empfohlen (1280×800 geht auch)
Leser Retroverse-RFID-Leser (USB-Seriell-Treiber CP210x oder CH340)
Netzwerk Erreicht den Host auf TCP 7990
Punkt Anforderung
Board ESP32 DevKit (ESP32-WROOM-32)
RFID RC522-Modul (SPI)
Display SSD1306-OLED 128×32 oder 128×64 (I²C), optional
Karten MIFARE Classic 1K / 4K

Checkliste Netzwerk & Sicherheit

  • Das Turnier in einem eigenen Netz betreiben. Die Ports 7990 und 1883 nie ins Internet weiterleiten.
  • Der Installer beschränkt seine Firewall-Regeln auf das lokale Subnetz.
  • Mosquitto lässt standardmäßig anonyme Clients zu. In einem geteilten Netz MQTT-Benutzer anlegen und in der NestrisLTM-Konfiguration und auf jeder Station eintragen.
  • Eigene API-Tokens für die Stationen (Scope stations) und das Terminal (Scope terminal) anlegen.
  • Die Datenbank vor und nach jedem Eventtag sichern. Der Update-Manager legt zusätzlich vor jedem Update ein Backup an.

Die vollständige Portübersicht steht unter Netzwerk & Ports.