Maker
Für eine selbst gebaute MusicBoxDu hast deine MusicBox gebaut und installierst die Software über die Seite Software. Hier steht, was die Meldungen bedeuten, denen du dort begegnen kannst, und was die MusicBox beim Start erzählt.
Der Browser
Das Flashen läuft über die Web Serial API: du brauchst Chrome, Edge oder Opera auf dem Computer. Safari, Firefox und mobile Browser bieten sie nicht an.
Die Seite versetzt die Platine von selbst in den Flash-Modus: sie bittet dich nicht, irgendeine Taste zu drücken.
„Die serielle Verbindung konnte nicht geöffnet werden“
Der Browser konnte den gewählten Port nicht öffnen. Prüf das Kabel, steck die Platine neu ein und wähle ihren Port im Browser-Fenster erneut. Schließt du dieses Fenster, ohne etwas zu wählen, erscheint kein Fehler.
„Das Flashen ist fehlgeschlagen“
Der Download, der Wechsel in den Flash-Modus oder das Schreiben ist abgebrochen. Die Einzelheiten stehen im seriellen Monitor, in einer Zeile, die mit [flash] error beginnt. Starte das Flashen neu.
Sagt die Meldung, dass der Boot-Slot nicht zurückgesetzt werden konnte, ist die Software zwar geschrieben, aber die Platine startet möglicherweise mit der vorherigen Version: starte das Flashen neu.
Alles löschen, oder nicht
Die Option „Vor dem Flashen alles löschen“ ist für eine Erstinstallation gedacht. Sie löscht auch, was die Platine gespeichert hatte, darunter das Wi-Fi. Ohne sie bleiben diese Einstellungen erhalten.
„Deine MusicBox antwortet immer noch nicht“
Nach dem Flashen wartet die Seite, bis die MusicBox fertig gestartet ist, um ihren Zugangscode zu lesen. Das dauert etwa dreißig Sekunden, und die Seite wartet bis zu vierzig.
Antwortet nichts, ist oft noch keine Software auf der Platine: flashe sie in Schritt 2. Wurde sie beim Lesen des Codes getrennt, verbinde sie in Schritt 1 erneut.
Das Startprotokoll lesen
Der serielle Monitor zeigt den Start Schritt für Schritt. Drei Zeilen zählen: [1/3] für die microSD-Karte, [2/3] für das Audio, [3/3] für den NFC-Leser.
Schlägt die microSD-Karte oder das Audio fehl, blinkt das Licht langsam rot. Schlägt nur der NFC-Leser fehl, startet die MusicBox ohne ihn, und kein Licht zeigt es an: nur die Zeile [3/3] sagt es dir.
Die Software braucht einen ESP32-S3 N8R8 mit 8 MB PSRAM. Auf einer Platine ohne PSRAM bricht der Start mit einer Zeile FATAL ab, die das sagt.
Bevor du um Hilfe bittest
Tippe im seriellen Monitor auf „Kopieren“ und häng die Zeilen an deine Nachricht an: sie sagen fast immer, wo es hakt.
Anleitung geprüft am 29. Oktober 2026, mit der MusicBox-Software von diesem Tag.
Kommst du nicht weiter?
Schreib uns auf Discord, wir antworten.