The Open Music Box ha sido open source desde el primer día. Pero entre "el código está en GitHub" y "puedes construir el tuyo" había un hueco: tenías que instalar una toolchain, lidiar con esptool, escribir los archivos binarios correctos en las direcciones correctas. No precisamente accesible.
El enfoque es sencillo, y es todo el espíritu del proyecto: tú construyes la caja, la carcasa y la electrónica en torno a un módulo ESP32-S3. Yo aporto las dos piezas de software, el firmware que hace funcionar la caja y la aplicación móvil para gobernarla. Todo está reunido en la página de construcción, y la parte de la que estoy genuinamente orgulloso es que el firmware se flashea directamente desde tu navegador, sin nada que instalar.
Tres formas de construir
No todo el mundo parte del mismo punto. Algunos quieren soldar, otros simplemente quieren una placa lista para usar, otros quieren esperar a un producto terminado. Por eso la página de construcción ofrece tres caminos, todos en torno al mismo módulo ESP32-S3 y el mismo firmware open source:
- A mano, sobre una protoboard y luego una PCB personalizada: la ruta maker completa, con el esquema de cableado para cada componente (lector NFC, audio I2S, anillo de LED, encoder, botones).
- Con la PCB de HermitX, una placa diseñada por otro maker que reúne el lector NFC y lo esencial en un solo circuito. Un atajo práctico que te ahorra el cableado.
- Con la PCB oficial de The Open Music Box, todavía en fase de finalización. Certificaciones previstas, diseñada para usarse de forma autónoma, como kit DIY o integrada en un producto completo.
Una nota honesta: la PCB de HermitX es un producto prototipo orientado a la creación de prototipos y a los makers. No lleva ninguna certificación regulatoria y se suministra tal cual. Eso queda indicado claramente en la página, prefiero ser transparente al respecto.
Flashear desde el navegador
Aquí está la parte que lo cambia todo. Conecta tu ESP32-S3 por USB, abre la página de flasheo en Chrome o Edge, elige tu versión, haz clic. El firmware se instala. Eso es todo.
Sin Python, sin toolchain, sin línea de comandos. Por debajo es ESP Web Tools comunicándose con la placa mediante Web Serial, directamente desde la pestaña del navegador. Puedes elegir el canal (estable o beta) y la versión exacta entre las builds publicadas. El manifiesto de flasheo se genera al vuelo, en el navegador.
El detalle que más sudores me costó es, irónicamente, el más invisible. Los binarios se publican en GitHub, pero los archivos de las GitHub Release no devuelven cabeceras CORS, así que el navegador no puede descargarlos directamente. Por eso monté un pequeño proxy CORS en fw.theopenmusicbox.com que sirve los archivos .bin con las cabeceras correctas y una caché. Nada que llegues a ver nunca, pero sin él el flasheo con un solo clic simplemente no funcionaría.
Cableado y el bastidor
La página de construcción también detalla el pinout real de cada componente, sacado directamente del código del firmware en lugar de adivinarlo: el bus SPI del lector NFC, el bus SPI de la tarjeta SD, el audio I2S, el anillo de LED, el encoder y los botones. Suficiente para reproducir la construcción de forma limpia.
Para el bastidor, estoy trabajando en una v4 más compacta. Los componentes objetivo todavía se están seleccionando, y los archivos de impresión saldrán cuando estén realmente listos para seguir. Mientras tanto, el bastidor v3 sigue documentado.
Te toca a ti
El proyecto pasó de ser algo con lo que trasteaba para mis hijos a un sistema que cualquiera puede retomar. El código está ahí, flashear lleva un solo clic, y la aplicación móvil lo gobierna todo.
El punto de partida es la página de construcción: los tres caminos de montaje, el pinout de los componentes y el flasheador, todo en un mismo lugar.
Si te animas y construyes la tuya, cuéntame. Y si te atascas en algún punto, las preguntas son bienvenidas, hablémoslo.