77 lines
2.5 KiB
Markdown
77 lines
2.5 KiB
Markdown
# SerialManager
|
||
|
||
**Datei:** `SerialManager.cs`
|
||
|
||
## Verantwortung
|
||
|
||
- COM-Port-Erkennung per WMI (VID/PID)
|
||
- Verbindungsaufbau und automatischer Reconnect
|
||
- Hintergrund-Lese-Thread mit Paket-Assembler
|
||
- Sende-Methoden für alle Protokoll-Operationen
|
||
|
||
## COM-Port-Erkennung
|
||
|
||
```csharp
|
||
VidPid = "VID_239A&PID_0042" // muss mit platformio.ini übereinstimmen
|
||
|
||
SELECT Name, DeviceID FROM Win32_PnPEntity WHERE DeviceID LIKE '%VID_239A&PID_0042%'
|
||
// Name enthält z.B. "USB Serial Device (COM3)" → extrahiert "COM3"
|
||
```
|
||
|
||
Erkennt das Board auch bei wechselnder COM-Nummer. Funktioniert auch nach USB-Reinitialisierung (Kabel abziehen/stecken nach SWD-Flash).
|
||
|
||
## Verbindungsaufbau (TryConnect)
|
||
|
||
```
|
||
Monitor.TryEnter(_connectLock) – nur ein gleichzeitiger Versuch
|
||
FindPort() per WMI
|
||
SerialPort erstellen:
|
||
ReadTimeout = 500 ms
|
||
WriteTimeout = 500 ms
|
||
DtrEnable = true ← VOR Open() setzen! (SAMD21 CDC-Constraint)
|
||
port.Open()
|
||
Thread.Sleep(200) – CDC stabilisieren
|
||
ReadLoop-Thread starten
|
||
Connected-Event → UI-Thread
|
||
```
|
||
|
||
**Reconnect-Timer**: alle 3 s, Start nach 500 ms. 5 s Backoff (`_waitingAfterDisconnect`) nach Verbindungsverlust damit Board vollständig re-enumerieren kann.
|
||
|
||
## ReadLoop (Hintergrund-Thread)
|
||
|
||
```
|
||
while (port.IsOpen):
|
||
b = port.ReadByte() – blockiert 500 ms (ReadTimeout)
|
||
buf[bufFill++] = b
|
||
if bufFill < 8: continue
|
||
→ SerialPacket fertig → SynchronizationContext.Post → PacketReceived auf UI-Thread
|
||
bufFill = 0
|
||
|
||
Bei IOException:
|
||
if port.IsOpen: ignorieren ← .NET 7: IOException = normaler Timeout (kein Fehler!)
|
||
else: break → Disconnect
|
||
```
|
||
|
||
## Sende-Methoden
|
||
|
||
| Methode | Funktion |
|
||
|---|---|
|
||
| `Send(pkt)` | Rohe 8-Byte-Übertragung (fire-and-forget, ignoriert Sendefehler) |
|
||
| `SetLedOverride(keyId, r, g, b)` | CMD 0x01 |
|
||
| `ClearLedOverride(keyId)` | CMD 0x02 |
|
||
| `SetLedBase(keyId, r, g, b)` | CMD 0x03 |
|
||
| `RequestConfig()` | CMD 0x13 – Board antwortet mit Config-Dump |
|
||
| `RequestMacros()` | CMD 0x23 – Board antwortet mit Makro-Dump |
|
||
| `SendConfig(cfg)` | BEGIN(0x10) → 38×DATA(0x11) → COMMIT(0x12), 5 ms zwischen Chunks |
|
||
| `SendMacros(macros)` | BEGIN(0x20) → 43×DATA(0x21) → COMMIT(0x22), 5 ms zwischen Chunks |
|
||
|
||
`SendConfig` und `SendMacros` blockieren ~400 ms → werden in `Task.Run()` aus `ConfigForm.OnSave()` aufgerufen.
|
||
|
||
## Events
|
||
|
||
| Event | Gefeuert wenn |
|
||
|---|---|
|
||
| `Connected` | Verbindung erfolgreich hergestellt (auf UI-Thread) |
|
||
| `Disconnected` | Verbindung verloren (auf UI-Thread) |
|
||
| `PacketReceived` | Vollständiges 8-Byte-Paket empfangen (auf UI-Thread) |
|