×12
Alle Fallstricke auf einen Blick
Die ersten zwölf stammen aus Welt 1 (Controller), die letzten acht aus Welt 2 bis 4 (Bild, Aufnahme, Training, KI).
| Problem | Ursache | Lösung |
|---|---|---|
| Kein Bluetooth-HID als Arduino-Sketch | Arduino-ESP32-Prebuilts ohne CONFIG_BT_HID_ENABLED | ESP-IDF über PlatformIO |
| Build bricht beim Linken ab | Python 3.15 und wechselnde SCons-Versionen | Eigene .venv-pio mit Python 3.13, pioarduino 55.03.312-1 |
| Datensalat ab 460 800 Baud | CH340 auf dem Adeept-Board am Mac | Bei 115 200 bleiben, kurze Nachrichten |
| Switch 2 ignoriert den ESP32, Mac koppelt problemlos | Bluedroid als HID-Gerät wird nicht angesprochen | BTstack-Firmware (JereDev) übernehmen |
| „Limited Discoverable“ macht den ESP32 unsichtbar | ESP32-Controller antwortet dann nur auf eingeschränkte Suche | General Discoverable behalten |
| Scheinbarer Erfolg, der keiner war | macOS hatte sich selbst mit dem „Pro Controller“ verbunden | Keine Bluetooth-Aktionen am Mac während Tests, Host-Adresse loggen |
| Tastatur-Skript reagiert nicht | Fehlende Eingabeüberwachungs-Rechte für pynput | GUI mit Fenster-Fokus (pygame-ce) |
| Bluetooth-Verbindung weg nach jedem Start | Port-Öffnen resettet den ESP32 | Auto-Reconnect in der Firmware |
| GUI friert nach USB-Abziehen ein | Toter Port blieb offen | Link schließen, automatisch neu verbinden |
| Nur 30 % der Pakete beantwortet | 200-Byte-Antworten sättigen die UART | Kompakte Antwort |
| Verbindung trennt alle 4 s | Report-Intervall 16 ms zu aggressiv | 24 ms |
| Controller macht „wilde Sachen“ im Test | Messung drückte echte Tasten | Unsichtbares Stick-Wackeln in der Totzone |
| Capture-Bild komplett schwarz | Ein zweites Programm hatte die Karte parallel offen (nur eines bekommt Bilder) | Nur ein Prozess an der Karte |
| Gerätenummer zeigt plötzlich auf die Webcam | macOS nummeriert Kameras nicht stabil, sobald mehrere USB-Kameras stecken | Namen über ffmpeg zuordnen, Webcam abziehen |
| Latenzmessung sieht keine Bildänderung, obwohl der Cursor springt | Helligkeitsänderung über das ganze Bild gemittelt, Cursor ändert nur einen kleinen Bereich | Anteil deutlich geänderter Pixel messen |
| Bild hakt alle 10 s, Fahrer fällt von der Strecke | Aufnahme schrieb 26 MB Rohbilder im Hauptthread, 0,5 s Stillstand, Watchdog ließ alle Tasten los | JPEG je Bild, Schreiben im Hintergrund, 30 Hz |
| Drift fehlt in den Trainingsdaten | Der Fahrer driftet mit ZR, aufgezeichnet wurde nur R | R/ZR und L/ZL zusammenfassen |
| Netz lenkt zu zaghaft | Regression zur Mitte: 69 % der Bilder sind „geradeaus“ | Lenkung als fünf Klassen, seltene Klassen gewichtet |
| KI klebt an der Bande und lenkt weiter hinein | Aufschaukeln: Bilder neben der Spur kamen in den Trainingsdaten nie vor | Shadow-Modus: Rettungen des Menschen nachtrainieren |
| Festfahr-Erkennung merkt das Schrammen an der Bande nicht | Kamera wackelt, Umgebung zieht vorbei: das Bild ändert sich trotzdem | Nur echten Stillstand abfangen; später Minimap-Marker als Fortschrittssignal |