RetroLink folgt einem strikten Systemvertrag. Das sind Architekturregeln, keine Stilfragen. ### Phasenreihenfolge (ändert sich nie) - `Simulation -> Snapshot -> Rendering -> Present` - Nur der Host simuliert den autoritativen Zustand. - Clients simulieren, glätten, prognostizieren oder erfinden niemals Zustand. - Rendering arbeitet ausschließlich auf Snapshots und muss idempotent sein. ### Regeln für deterministisches Rendering - Jede sichtbare Pixeländerung muss aus genau einem Simulationstakt stammen. - `render()` und Draw-Helper dürfen keine `millis()`, `micros()`, Timer oder Zufallsquellen verwenden. - Rendering darf keinen Gameplay-Zustand mutieren. - Keine rollenabhängigen Verzweigungen in der Renderlogik. ### Display- und Buffer-Regeln - Immer ausschließlich in den Back Buffer rendern. - Den Back Buffer immer über die SPI-DMA-Queue von RetroGoDisplay ausgeben. - Nach dem Present: Back nach Front kopieren, dann swappen. - Der Front Buffer dient nur der Synchronisation, nie als Renderziel. - Tearing, Flicker, Ghosting oder Frame-Desync sind kritische Defekte. ### Interrupt- und Netzwerksicherheit - Keine Display-API-Aufrufe aus ISR- oder ESP-NOW-Callbacks. - Im ISR-Pfad dürfen nur Paketdaten gespeichert und Flags gesetzt werden. - Display-Arbeit wird in den Main Loop bzw. Task-Kontext verschoben. - SPI-Transaktionsdaten müssen in stabilem Speicher liegen, nie auf dem Stack. ### Speicher- und Asset-Regeln - DMA-Buffer müssen in internem DMA-fähigem RAM liegen, nicht in PSRAM. - Große temporäre Decode-Buffer dürfen PSRAM verwenden. - Kern-Gameplay-Grafiken bestehen aus Tiles und Sprites, nicht aus Full-Frame-RGB565-Assets. - PNG-Assets in SPIFFS sind für UI- und Ladepfade erlaubt, dekodiert außerhalb von `render()`. ### Warum das funktioniert Dieser Vertrag hält die Multiplayer-Ausgabe über mehrere Geräte hinweg deterministisch und bewahrt gleichzeitig die Display-Stabilität auf begrenzter Hardware. Die Architektur wurde durch reale Fehlerfälle geprägt: White Screens, Bus-Korruption, DMA-Bugs durch Stack-Lebensdauer und Desynchronisation. Deshalb ist sie bewusst streng formuliert.