Makers
Voor een MusicBox die je zelf hebt gebouwdJe hebt je MusicBox gebouwd en installeert de software vanaf de pagina Software. Dit betekenen de meldingen die je daar kunt tegenkomen, en dit vertelt de MusicBox bij het opstarten.
De browser
Het flashen gebruikt de Web Serial API: je hebt Chrome, Edge of Opera nodig, op een computer. Safari, Firefox en mobiele browsers bieden die niet aan.
De pagina zet het bordje zelf in flashmodus: je hoeft op geen enkele knop te drukken.
'Kon de seriële verbinding niet openen'
De browser kon de gekozen poort niet openen. Controleer de kabel, sluit het bordje opnieuw aan, en kies zijn poort opnieuw in het venster van de browser. Sluit je dat venster zonder te kiezen, dan verschijnt er geen fout.
'Het flashen is mislukt'
Het downloaden, het overschakelen naar flashmodus of het schrijven is gestopt. De details staan in de seriële monitor, op een regel die begint met [flash] error. Start het flashen opnieuw.
Zegt de melding dat het opstartslot niet gereset kon worden, dan is de software wel geschreven, maar kan het bordje op de vorige versie herstarten: start het flashen opnieuw.
Alles wissen, of niet
De optie 'Alles wissen vóór het flashen' is bedoeld voor een eerste installatie. Ze wist ook wat het bordje had opgeslagen, waaronder de Wi-Fi. Zonder die optie blijven die instellingen bewaard.
'Je MusicBox antwoordt nog steeds niet'
Na het flashen wacht de pagina tot de MusicBox klaar is met opstarten om zijn toegangscode te lezen. Dat duurt ongeveer dertig seconden, en de pagina wacht tot veertig.
Antwoordt er niets, dan staat er vaak nog geen software op het bordje: flash het in stap 2. Werd het bordje losgekoppeld tijdens het lezen van de code, verbind het dan opnieuw in stap 1.
Het opstartlogboek lezen
De seriële monitor toont het opstarten stap voor stap. Drie regels tellen: [1/3] voor de microSD-kaart, [2/3] voor het audiogedeelte, [3/3] voor de NFC-lezer.
Faalt de microSD-kaart of het audiogedeelte, dan knippert het licht langzaam rood. Faalt alleen de NFC-lezer, dan start de MusicBox zonder lezer en meldt geen enkel licht het: alleen de regel [3/3] zegt het je.
De software vraagt een ESP32-S3 N8R8, met 8 MB PSRAM. Op een bordje zonder PSRAM stopt het opstarten bij een regel FATAL die dat zegt.
Voordat je hulp vraagt
Tik op 'Kopiëren' in de seriële monitor en voeg de regels bij je bericht: ze zeggen bijna altijd waar het knelt.
Handleiding gecontroleerd op 29 oktober 2026, met de MusicBox-software van die dag.
Kom je er nog niet uit?
Schrijf ons op Discord, we antwoorden.