Harden protocol transfers and config validation

doc/00_architecture.md

@@ -18,8 +18,9 @@
 | `SerialManager` | Verbindungsverwaltung, WMI-Erkennung, Lese-Thread, Sende-Methoden |
 | `ConfigForm` | Hauptfenster (Grid + Encoder-Panel + Footer); öffnet ActionDialog |
 | `ActionDialog` | Modaler Dialog zum Bearbeiten einer Aktion + LED-Einstellungen |
-| `DeviceConfig` | C#-Spiegel von `SDeviceConfig`; Serialisierung/Deserialisierung (223 B) |
-| `MacroTable` | C#-Spiegel von `SMacroTable`; Serialisierung/Deserialisierung (256 B) |
+| `DeviceConfig` | C#-Spiegel von `SDeviceConfig`; Validierung und Serialisierung (740 B) |
+| `MacroTable` | C#-Spiegel von `SMacroTable`; Validierung und Serialisierung (512 B) |
+| `ChunkTransferBuffer` | prüft Dump-Chunkzahl, Indizes und Vollständigkeit |
 | `ConfigJson` | JSON-Import/Export für `DeviceConfig` |
 | `Protocol` | Konstanten für alle Command/Event-IDs (spiegelt `usb_serial.h`) |
 
@@ -29,9 +30,9 @@
 Board → SerialManager (ReadLoop, BG-Thread)
     → SynchronizationContext.Post (→ UI-Thread)
         → TrayApp.OnPacket()
-            ├── Config-Dump: _rxConfigBuf aufbauen → DeviceConfig.FromBytes()
-            ├── Makro-Dump:  _rxMacroBuf aufbauen  → MacroTable.FromBytes()
-            └── HOST_COMMAND-Events: (TODO: Aktion ausführen)
+            ├── Config-Dump vollständig sammeln → DeviceConfig.FromBytes()
+            ├── danach Makro-Dump vollständig sammeln → MacroTable.FromBytes()
+            └── HOST_COMMAND-Events mit 16-Bit-Command-ID empfangen
 
 Benutzer → ConfigForm → ActionDialog
     → DeviceConfig / MacroTable (in-memory ändern)
@@ -55,7 +56,8 @@ Alle Board-Events werden per `SynchronizationContext.Post` auf den UI-Thread gep
 ```
 Start → Timer feuert → TryConnect() → WMI-Suche (VID 0x239A / PID 0x0042)
   → SerialPort öffnen (DtrEnable=true VOR Open()!)
-  → 200 ms warten → ReadLoop starten → Connected-Event → RequestConfig() + RequestMacros()
+  → 200 ms warten → ReadLoop starten → Connected-Event
+  → RequestConfig() → vollständig validieren → RequestMacros()
 
 Disconnect → ReadLoop bricht ab → Disconnected-Event → 5 s Backoff → Timer läuft weiter
 ```
@@ -64,6 +66,12 @@ Disconnect → ReadLoop bricht ab → Disconnected-Event → 5 s Backoff → Tim
 
 - **DtrEnable=true muss VOR `Open()` gesetzt werden**: SAMD21 prüft DTR für `usb_serial_send()`. Der Default-Wert false würde alle Board→PC-Antworten still verwerfen.
 - **IOException ≠ Disconnect**: .NET 7 wirft `IOException` statt `TimeoutException` bei `ReadByte()`-Timeout. Nur als echten Fehler behandeln wenn `_port.IsOpen == false`.
-- **Packed-kompatible Serialisierung**: `DeviceConfig.ToBytes()` muss exakt 223 B in derselben Reihenfolge wie `SDeviceConfig` (packed C++) erzeugen. Jede Änderung am Firmware-Layout muss hier gespiegelt werden.
-- **Config-Version**: `DeviceConfig.Version == 2`. `FromBytes()` prüft Magic + Version + CRC; schlägt einer fehl → Methode gibt `false` zurück, Config bleibt unverändert.
-- **Debug-Log**: `versapad_rx.txt` in `%TEMP%` – vor Release-Nutzung entfernen (TODO).
+- **Packed-kompatible Serialisierung**: `DeviceConfig.ToBytes()` erzeugt exakt
+  740 B in derselben Reihenfolge wie `SDeviceConfig`; `MacroTable` exakt 512 B.
+- **Config-Version**: `DeviceConfig.Version == 3`. `FromBytes()` prüft Magic,
+  Version, CRC, Profilindex, Actions, LED-Enums und kritische Perioden, bevor
+  Objektzustand geändert wird.
+- **Transfer-Synchronisation**: Config- und Makro-Uploads laufen unter einem
+  gemeinsamen Transfer-Lock; einzelne Pakete unter einem Write-Lock.
+- **Host-Commands**: Pakete sind vollständig definiert, die Ausführung einer
+  Command-ID als Desktop-Aktion ist bewusst noch nicht implementiert.