Makers

Para una MusicBox que montaste tú

Has montado tu MusicBox y estás instalando el software desde la página Software. Esto es lo que significan los mensajes que puedes encontrarte allí, y lo que cuenta la MusicBox al arrancar.

El navegador

El flasheo pasa por la API Web Serial: necesitas Chrome, Edge u Opera, en ordenador. Safari, Firefox y los navegadores móviles no la ofrecen.

La página pone la placa en modo flasheo por sí sola: no te pide que pulses ningún botón.

«No se pudo abrir la conexión serie»

El navegador no ha podido abrir el puerto elegido. Comprueba el cable, vuelve a conectar la placa y elige de nuevo su puerto en la ventana del navegador. Cerrar esa ventana sin elegir no muestra ningún error.

«El flasheo ha fallado»

La descarga, el paso al modo flasheo o la escritura se ha detenido. El detalle está en el monitor serie, en una línea que empieza por [flash] error. Vuelve a lanzar el flasheo.

Si el mensaje dice que no se ha podido restablecer el slot de arranque, el software se ha escrito bien pero la placa puede reiniciarse con la versión anterior: vuelve a lanzar el flasheo.

Borrar todo, o no

La opción «Borrar todo antes de flashear» sirve para una primera instalación. También borra lo que la placa tenía guardado, incluido el Wi-Fi. Sin ella, esos ajustes se conservan.

«Tu MusicBox sigue sin responder»

Después del flasheo, la página espera a que la MusicBox termine de arrancar para leer su código de acceso. Tarda unos treinta segundos, y la página espera hasta cuarenta.

Si nada responde, a menudo es que la placa aún no tiene software: flashéala en el paso 2. Si se desconectó durante la lectura del código, vuelve a conectarla en el paso 1.

Leer el registro de arranque

El monitor serie muestra el arranque paso a paso. Tres líneas importan: [1/3] para la tarjeta microSD, [2/3] para el audio, [3/3] para el lector NFC.

Si falla la tarjeta microSD o el audio, la luz parpadea despacio en rojo. Si solo falla el lector NFC, la MusicBox arranca sin él y ninguna luz lo indica: solo la línea [3/3] te lo dice.

El software necesita un ESP32-S3 N8R8, con 8 MB de PSRAM. En una placa sin PSRAM, el arranque se detiene en una línea FATAL que lo indica.

Antes de pedir ayuda

Toca «Copiar» en el monitor serie y adjunta las líneas a tu mensaje: casi siempre dicen dónde está el problema.

Guía revisada el 29 de octubre de 2026, con el software de la MusicBox de esa fecha.

¿Sigues atascado?

Escríbenos en Discord, respondemos.

Unirte al Discord
Newsletter

Una carta cada dos semanas

Cómo avanza el proyecto, sin adornos, un jueves por la mañana de cada dos. Lo que construyo, lo que sale, y los tropiezos del camino.