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 (Scopeterminal) 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.