Web Flasher

Firmware direkt im Browser flashen — kein PlatformIO oder Kabel-Chaos nötig.

Dein Browser wird nicht unterstützt. Der Web Flasher benötigt Web Serial API und funktioniert nur in Google Chrome, Microsoft Edge oder Opera (Desktop). Firefox und Safari werden leider nicht unterstützt.

So funktioniert's

  1. Board per USB verbinden. Schließe den ESP32 (Coordinator oder Puck) per USB-Kabel an deinen Computer an.
  2. Browser: Chrome oder Edge verwenden. Der Web Flasher nutzt die Web Serial API — diese funktioniert nur in Chromium-basierten Browsern (Chrome, Edge, Opera).
  3. Unten den passenden "Firmware Flashen"-Button klicken. Wähle im Dialog den richtigen COM-Port deines ESP32 aus.
  4. Warten bis der Flash-Vorgang abgeschlossen ist. Das Board startet danach automatisch neu. Nicht das USB-Kabel während des Flashens entfernen!
Wichtig: Coordinator und Puck verwenden unterschiedliche ESP32-Chips. Flashe niemals eine Puck-Firmware auf den Coordinator oder umgekehrt — das Board startet sonst nicht!
Kein Chrome/Edge? — Firmware manuell mit esptool flashen

Wenn dein Browser kein Web Serial unterstützt (z.B. Safari, Firefox), kannst du die .bin-Datei mit dem offiziellen esptool von Espressif manuell flashen. Das funktioniert auf allen Betriebssystemen.

Voraussetzung

Python 3 muss installiert sein. Dann esptool installieren:

pip install esptool

Coordinator flashen (ESP32-S3)

esptool.py --chip esp32s3 --port PORT --baud 921600 write_flash 0x0 coordinator.bin

Puck flashen (ESP32-C3)

esptool.py --chip esp32c3 --port PORT --baud 921600 write_flash 0x0 puck.bin

PORT ersetzen

  • Windows: COM3, COM4, ... — im Geräte-Manager unter "Anschlüsse (COM & LPT)" nachschauen
  • macOS: /dev/cu.usbserial-* oder /dev/cu.usbmodem* — mit ls /dev/cu.* im Terminal auflisten
  • Linux: /dev/ttyUSB0 oder /dev/ttyACM0 — mit ls /dev/tty* auflisten. Falls keine Berechtigung: sudo usermod -aG dialout $USER und neu einloggen

Tipp: Falls der ESP32 nicht erkannt wird, den BOOT-Button am Board gedrückt halten während du das USB-Kabel einsteckst — das erzwingt den Download-Modus.

Du brauchst mehr Hilfe? Klicke hier und ChatGPT hilft dir Schritt für Schritt.

Coordinator (ESP32-S3)

Coordinator Firmware

Board: ESP32-S3-DevKitC-1-N16R8 · 16 MB Flash

Die Coordinator-Firmware steuert das gesamte PUCK RACER System: Spielverwaltung, WebUI, ESP-NOW Netzwerk und OTA-Updates der Pucks. Das Merged-Image enthält Bootloader, Partitionstabelle, Firmware und das LittleFS-Dateisystem mit der WebUI.

PuckRacer Release Candidate 1 — V2.99.9

Dein Browser unterstützt kein Web Serial. Web Serial ist in diesem Kontext nicht erlaubt.

Puck (ESP32-C3)

Puck Firmware

Board: ESP32-C3-DevKitM-1 · RISC-V Single Core · 4 MB Flash

Die Puck-Firmware steuert LEDs (WS2812B), Buttons, Buzzer, Batterie- und Temperatur-Schutz. Kommunikation mit dem Coordinator via ESP-NOW. Das Merged-Image enthält Bootloader, Partitionstabelle und Firmware.

PuckRacer Release Candidate 1 — FW 88

Dein Browser unterstützt kein Web Serial. Web Serial ist in diesem Kontext nicht erlaubt.
GitHub Repository & README