Technik
Hier steht, was jeder Controller auf dem Brett macht und wer mit wem über welchen Bus redet. Für alle, denen der Steckbrief in der Backstage zu kurz ist.
Ab dem Proxy gibt es nur Kabel, kein Funk. Jedes Board bekommt die Rolle, die zu seiner Leistung passt: Der Schwächste bekommt den dümmsten Job.
Wer mit wem
Die Leitungen
Browser ↔ Proxy
HTTPS für die Seiten, ein WebSocket für das Spiel. Darüber kommen Klopfer, Taps und Tomaten an, und zehnmal pro Sekunde geht der Spielstand zurück. Der Proxy schickt alle 30 s einen Ping, damit die Leitung nicht einschläft.
Der Proxy steht zwischen Internet und Brett: Er bremst zu eifrige Klopfer und hält nichts fest, was einen Neustart überleben müsste.
Proxy ↔ P4
Ethernet, eine einzige stehende TCP-Verbindung. Binär und gemultiplext: ein Kanal pro Klo, einer für die Lobby, einer für die Dateien der Seite. Der P4 sieht nie einen Spieler-Socket.
- Der P4 schickt jede Sekunde einen Status und zehnmal pro Sekunde den ganzen Spielstand.
- Der Proxy baut die Verbindung auf und weist sich mit einem gemeinsamen Schlüssel aus.
- Der P4 hängt allein im Netz, nur der Proxy darf mit ihm reden.
P4 → vier Picos
Der P4 ist Master, die Picos sind Slaves: Pumpstation Nord, Pumpstation Süd, Kassenhäuschen und Vorverkauf. Modus 3, 1 MHz.
- Gemeinsam sind SCK, MOSI und MISO. Jeder Pico hat sein eigenes Chip Select.
- Jede Transaktion tauscht zwei Blöcke von 256 Bytes mit Prüfsumme. Ein Block wird wiederholt, bis die Gegenseite ihn bestätigt.
- Ein Slave kann nicht von sich aus reden. Deshalb hat jeder Pico eine eigene Daten-da-Leitung zum P4.
- Ohne Anlass fragt der P4 jeden Pico alle 10 ms. Schweigt einer 300 ms lang, ist das ein Teilausfall.
- In den Leitungen sitzen 330 Ω gegen Überschwinger auf den Drähten.
P4 ↔ Festivalleitung (Ring)
P4 → Glied 1 → 2 → 3 → 4 → 5 → P4. Jeder Link hat zwei Drähte, Vollduplex mit 1 Mbaud. Ein Glied hat zwei Ports, einen zu jedem Nachbarn.
- Chain Replication: Der P4 ist der einzige Schreiber, das letzte erreichbare Glied bestätigt.
- Die Kette läuft in bis zu zwei Segmenten vom P4 aus, Glied 1 aufwärts und Glied 5 abwärts. Fällt ein Glied aus, ordnet der P4 sie neu.
- Fehlen zwei Glieder, ist der Ring zerfallen, und es gibt Unwetter.
- Die Sendeleitungen des P4 laufen über 1 kΩ.
Pumpstation ↔ Klo
Punkt zu Punkt, jedes Klo hat seine eigene Leitung. 1 Mbaud, Frames mit COBS und CRC16. COBS verwirft auch den Boot-Müll des ESP8266.
- Pro Pumpstation fünf Klos: zwei an den echten UARTs des Pico, drei an UARTs aus der PIO.
- Dazu ein dritter Draht pro Klo: Debug-Zeilen vom Pin D4 des Klos in einen weiteren Eingang aus der PIO.
- Zum Klo: Klopfer, Taps, Tomaten und das Lastmodell der Runde. Zurück: Heartbeat, alle 50 ms ein Status mit freiem Speicher, nach jedem Start ein Hallo.
- Über dieselbe Leitung kommt neue Firmware. Das Klo schreibt sie selbst in seinen Flash.
- In jedem Draht sitzt direkt am Pico 1 kΩ.
Vorverkauf ↔ Türsteher
115200 Baud, Anfrage und Antwort. Der Vorverkauf fragt nach einem Namen, der Türsteher sagt: frei, ungültig, verboten, belegt oder voll. Alle 2 s meldet der Vorverkauf, welche Namen noch aktiv sind.
P4 ↔ Stadtarchiv
Der P4 ist Master, das Archiv Slave auf Adresse 0x42, 100 kHz. Am selben Bus hängt der Audio-Codec des P4-Boards. Für einen weiteren UART fehlten am P4 die Pins.
- Der P4 schickt jedes Ereignis mit laufender Nummer, Uhrzeit und Spieltag.
- Alle 100 ms liest er das Antwortfach: was bestätigt ist, was angenommen ist, wie es den Karten geht.
- Erst was auf einer Karte steht, gilt als bestätigt. Bis dahin hält der P4 bis zu 1024 Ereignisse fest.
- Auf dem Brett sind es 38 cm Draht, mit Pull-ups von 4,7 kΩ am P4.
Stadtarchiv → zwei microSD-Karten
Ein eigener SPI-Bus am Due, getrennt von dem des P4. Original und Durchschlag teilen sich Takt und Daten, jede Karte hat ihr eigenes Chip Select. 12 MHz.
Ordnungsamt hört mit, Amtsblatt an den P4
Das Ordnungsamt hängt mit drei UART-Eingängen an drei Ring-Leitungen, jeweils über 1 kΩ. Es hört nur zu und sendet dort nie.
Senden darf es nur auf einer einzigen Leitung, dem Amtsblatt zum P4. 1 Mbaud, weil derselbe UART auch auf dem Ring mithört. Darüber meldet es jeden Einbruch der Spannung und jede Sekunde die Messwerte.
Ordnungsamt → Anzeigetafel
Ein OLED mit 128 × 64 Pixeln am eigenen I2C des Ordnungsamts. Es zeigt Frames pro Sekunde auf dem Ring, Prüfsummenfehler als Verstöße, die Spannungen und manchmal Unfug.
P4 ↔ Sanitäter
- Puls: Der P4 schaltet alle 100 ms eine Leitung um.
- Reset: Bleibt der Puls 5 s aus, zieht der Sanitäter den Reset-Pin des P4 für 100 ms auf LOW. Er zieht nur nach unten, als echter Open-Drain.
- Zähler: Jede Sekunde meldet er über einen UART mit 115200 Baud, wie oft er schon ran musste.
③ Eine Notiz am Rand
Mit Bleistift neben dem Reset-Pin: Das dritte Wort heißt PAUSE.
P4 → Lichterkette
Eine Datenleitung zu 23 LEDs vom Typ WS2812B, eine unter jedem Board. Eine zweite Leitung schaltet die Schiene der LEDs ab, zur Nachtruhe von 22 bis 8 Uhr. Programmiert, noch nicht verdrahtet.
Die Controller
P4
Single Point of Failure · Waveshare ESP32-P4-ETH · Rust auf ESP-IDF
Aufgaben
- Die ganze Spiellogik. Er entscheidet, wer wo sitzt, wie lange und wer fliegt.
- Die einzige Uhr für alle Leases.
- Einziger Schreiber im Ring.
- Einziger Anschluss nach draußen.
- Misst die Hauptschiene, liest seinen Temperatursensor und den Urlaubsschalter, steuert die Lichterkette.
- Startet sich nach 2 s Hänger selbst neu. Hilft das nicht, kommt der Sanitäter.
Busse
Ethernet zum Proxy, SPI zu vier Picos, zwei UARTs im Ring, I2C zum Archiv, ein UART-Eingang für das Amtsblatt, Puls, Reset und Zähler vom Sanitäter, eine Datenleitung für die Lichterkette.
Sanitäter
STM8S103F3 · C mit SDCC
Aufgaben
- Fühlt den Puls des P4 und startet ihn neu, wenn er hängt.
- Gibt dem P4 nach jedem Neustart 30 s Schonfrist.
- Zählt seine Einsätze im EEPROM, reihum auf 32 Plätze verteilt.
Anderer Chip, eigener Takt, eigener Watchdog: Was den P4 lahmlegt, trifft ihn nicht.
Festivalleitung
5 × ESP32 DevKit (WROOM-32) · Rust auf ESP-IDF
Aufgaben
- Schreiben alles mit, was der P4 entscheidet: Leases, Punkte, Sauereien, die Klowand.
- Die Klowand liegt im Flash jedes Glieds. Nach einem Neustart liest der P4 sie von dort zurück.
- Alle fünf haben dieselbe Firmware und lesen ihre Nummer beim Start von drei Brücken.
Busse
Zwei UARTs, einer zu jedem Nachbarn. Der dritte bleibt am USB für Debug.
Pumpstation Nord und Süd
2 × Raspberry Pi Pico 2 (RP2350) · Rust mit embassy-rp
Aufgaben
- Reicht alles zwischen fünf Klos und dem P4 durch.
- Sammelt die Debug-Zeilen der Klos.
- Meldet ein Klo als gekippt, wenn 200 ms kein Status kommt oder es unerwartet Hallo sagt.
- Drosselt nichts. Die einzige Bremse ist der Proxy.
Busse
SPI-Slave zum P4 mit Daten-da. Zehn UARTs zu den Klos, je fünf Sender und Empfänger plus fünf Debug-Eingänge. Dafür braucht er 11 seiner 12 PIO-State-Machines.
Klo
10 × Wemos D1 mini (ESP8266) · Arduino mit PlatformIO · WLAN aus
Aufgaben
- Hält fest, wer drinsitzt.
- Arbeitet jeden Klopfer und jede Tomate wirklich ab. Das kostet Rechenzeit und Speicher.
- Staut sich zu viel, kommt der Heartbeat zu spät, und der Besetzer fliegt raus. Wird der Speicher knapp, startet das Klo selbst neu.
Busse
UART an TX und RX zur Pumpstation, ein zweiter UART nur zum Senden an D4 für Debug.
Kassenhäuschen
Raspberry Pi Pico 2 (RP2350) · Rust mit embassy-rp
Aufgaben
- Hat das Frontend im Flash, gzip-gepackt mit Inhaltsverzeichnis und Prüfsumme pro Datei. Auch diese Seite.
- Der Proxy holt es stückweise über den P4.
Busse
SPI-Slave zum P4 mit Daten-da, sonst nichts.
Vorverkauf
Raspberry Pi Pico 2 (RP2350) · Rust mit embassy-rp
Aufgaben
- Führt die Liste der Angemeldeten und die Schlange.
- Gibt dem P4 die Spieler einer Runde und stellt sie danach wieder hinten an.
- Lässt jeden neuen Namen vom Türsteher prüfen.
Busse
SPI-Slave zum P4 mit Daten-da, UART zum Türsteher.
Türsteher
ESP-01 (ESP8266) · Arduino mit PlatformIO
Aufgaben
- Prüft jeden Namen gegen die Sperrliste. Verglichen wird normalisiert, „Oma“ ist „0MA“.
- Passt auf, dass keiner zweimal gleichzeitig da ist. 64 Plätze, was 10 s lang nicht gemeldet wird, wird frei.
Busse
Ein UART, sonst nichts. Der Schwächste bekommt den dümmsten Job.
Ordnungsamt
Arduino Due (SAM3X8E) · Arduino mit PlatformIO
Aufgaben
- Messamt: misst jede Millisekunde die Schienen. Ein Einbruch ist alles unter 90 %. Kippt ein Klo dabei, war es nicht ehrlich, sondern „umgefallen“.
- Blitzer: ein Logikanalysator mit 8 Kanälen bis 4 MHz für PulseView.
- Bußgeldstelle: die Anzeigetafel.
Busse
Drei UART-Eingänge am Ring, ein UART-Ausgang zum P4, I2C zur Tafel, Analogeingänge an den Schienen, nativer USB zum Rechner.
Stadtarchiv
Arduino Due (SAM3X8E) · Arduino mit PlatformIO und SdFat
Aufgaben
- Merkt sich alles, was über einen Abend hinausgeht, auf zwei Karten: Original und Durchschlag.
- Eine Logdatei pro Spieltag in JSON Lines mit Prüfsumme, vorbelegt mit 16 MB, damit die Dateitabelle sich selten ändert.
- Fällt eine Karte aus, arbeitet es mit der anderen weiter.
- Schwärzt nach 30 Tagen die Namen.
Busse
I2C-Slave am P4, SPI-Master zu den Karten, nativer USB für sein Log.
Geplant ist noch eine Ausbaustufe mit zwei weiteren Pumpstationen und zehn ESP-01 als Pissoir. Sie hängen genauso am SPI des P4, und jedes Klo bekommt statt des Debug-Drahts eine Leitung für Reset und eine für den Bootloader.