¿Qué es OpenGizmo? Gadgets ESP32 open source para flashear
OpenGizmo es un conjunto de gadgets ESP32 con licencia MIT de Mauro Brambilla: un ticker cripto con LED, un interruptor para NVR Reolink y una ESP32-CAM.
- Autor
Mauro Brambilla- Publicado
- Tiempo de lectura
- 8 min
- Categoría
- Guías

En resumen
OpenGizmo son tres proyectos ESP32 con licencia MIT: firmware que flasheas desde Chrome o Edge, un hotspot para configurar el Wi-Fi, una aplicación web en la placa y una carcasa imprimible.
OpenGizmo es una colección de gadgets ESP32 de código abierto creados por Mauro Brambilla. Cada uno es un pequeño dispositivo terminado: flasheas su firmware desde Chrome o Edge, configuras el Wi-Fi desde el teléfono mediante un portal cautivo, lo ajustas en una aplicación web que sirve la propia placa y lo cierras en una carcasa imprimible en 3D (por ahora la tienen dos de los tres). Hasta ahora son tres, todos con licencia MIT.
Este post es el mapa del sitio. Presenta los tres proyectos, muestra la arquitectura que comparten y enlaza las guías que profundizan en cada parte. Todo lo que cuento aquí sale de los repositorios de los proyectos y de los archivos de compilación que incluyen, y los datos que cambian llevan fecha: "a noviembre de 2026".

¿Cuáles son los proyectos de OpenGizmo?
OpenGizmo tiene tres proyectos: Gizmo Ticker, una pantalla de precios cripto en una matriz LED, Gizmo Reolink Switch, un botón que silencia un NVR Reolink, y Gizmo Camera, una cámara Wi-Fi de instantáneas con un servidor MCP. Cada repositorio incluye el firmware (microcontroller/), la aplicación web (webapp/) y la documentación.

| Proyecto | Placa | Componentes | Qué hace | Dificultad |
|---|---|---|---|---|
| Gizmo Ticker | Seeed Studio XIAO ESP32-S3 | Matriz MAX7219 4 en 1 FC16, de 4 a 32 módulos | Desplaza precios cripto en vivo desde la API de CoinGecko | Intermedio, unos 60 min, soldadura |
| Gizmo Reolink Switch | Seeed Studio XIAO ESP32-S3 | Botón, buzzer, LCD I2C 16x2 | Silencia y restaura las alertas y la grabación de un NVR Reolink | Intermedio, unos 60 min, soldadura |
| Gizmo Camera | AI Thinker ESP32-CAM (OV2640) | Placa USB ESP32-CAM-MB | Instantáneas JPEG por HTTP y un servidor MCP para agentes de IA | Principiante, unos 15 min, sin soldadura |
La columna de dificultad es la que aparece en la página de cada proyecto.
Gizmo Ticker
Gizmo Ticker es una pantalla de escritorio que desplaza el precio de una moneda y sus datos de mercado en una matriz LED MAX7219. El firmware maneja de 4 a 32 módulos de 8 x 8, y en la aplicación web ajustas el número de módulos, la moneda, qué datos rotan, el formato de los números, el brillo y la velocidad de desplazamiento. Los precios vienen de CoinGecko, así que añades tu propia clave de API en la aplicación web. La construcción está en cómo construir un ticker cripto con ESP32 y MAX7219, y las conexiones, la lógica de 3,3 V y los módulos en espejo en la guía de cableado del MAX7219 FC16. Código: gizmo-ticker en GitHub.
Gizmo Reolink Switch
Gizmo Reolink Switch es un interruptor para salir sin que salten las alertas. Una pulsación corta elige cuánto dura el modo silencio, mantener pulsado el botón inicia la cuenta atrás, y el firmware llama a la API HTTP del NVR Reolink para desactivar las notificaciones y la grabación en los canales activos; luego las vuelve a activar en los canales que había silenciado cuando termina el temporizador o lo cancelas. Un buzzer da la respuesta sonora y el LCD muestra el estado. Los pines están en el repositorio: el botón en D0 (GPIO1), el buzzer en D1 (GPIO2) y el LCD por I2C con SDA en D4 (GPIO5) y SCL en D5 (GPIO6). El paso a paso está en cómo controlar un NVR Reolink con un ESP32. Código: gizmo-reolink-switch en GitHub.
Gizmo Camera
Gizmo Camera convierte una AI Thinker ESP32-CAM en una cámara a la que personas y scripts pueden pedir una foto. Cada petición GET /api/capture devuelve un JPEG, de 160 x 120 hasta 1600 x 1200, con la resolución, la calidad y el flash como opciones. Un servidor MCP en /mcp expone una herramienta take_snapshot, de modo que un agente de IA como Claude Code puede mirar a través de la cámara. MCP es el Model Context Protocol, un estándar abierto que permite a las herramientas de IA llamar a herramientas externas. La cámara va sobre su placa ESP32-CAM-MB, por eso no necesita soldadura: mira la guía de programación de la ESP32-CAM-MB y cómo Claude Code toma fotos con un servidor MCP en un ESP32. Código: gizmo-camera en GitHub.
¿Cómo funciona un proyecto de OpenGizmo?
Todos los proyectos de OpenGizmo están hechos igual: firmware PlatformIO para el ESP32 con el framework Arduino, una aplicación web Nuxt 4 comprimida dentro del firmware y servida por la placa, y una biblioteca compartida, gizmo-common, que se encarga del Wi-Fi, el hotspot de configuración y la API del dispositivo. Los repositorios fijan espressif32 @ 8.0.0 y una etiqueta de versión de gizmo-common en platformio.ini.
¿Qué hace gizmo-common?
gizmo-common es la biblioteca que comparten los tres firmwares. Se conecta al Wi-Fi, abre el hotspot de configuración, sirve el portal cautivo, responde a los endpoints del dispositivo (/api/device, /api/restart, /api/forget-wifi), sirve la aplicación web incorporada y gestiona el restablecimiento de fábrica. También rechaza las peticiones que llegan con otro nombre de host, lo que protege la placa del DNS rebinding. A noviembre de 2026, Gizmo Ticker y Gizmo Reolink Switch usan la v2.5.1 y Gizmo Camera la v2.4.0.
¿Cómo se configura el Wi-Fi sin código?
Un portal cautivo es una página que el teléfono abre solo cuando se une a una red Wi-Fi que pide iniciar sesión. OpenGizmo lo usa al revés. Sin una red guardada (o cuando la guardada falla), la placa crea un hotspot abierto con el nombre del proyecto (Gizmo-Ticker, Gizmo-Reolink o Gizmo-Camera) y redirige el teléfono a una página de configuración. Las credenciales nuevas se prueban primero y solo se guardan cuando la conexión funciona, así que un error al teclear no te deja fuera. Si la página no aparece, la guía de solución de problemas del portal cautivo repasa las causas, y la comparativa de métodos de aprovisionamiento Wi-Fi pone el hotspot frente a las alternativas.
¿Cómo accedes a la placa después?
Cuando se une a tu red, la placa responde a un nombre mDNS: gizmo-ticker.local, gizmo-reolink-switch.local o gizmo-camera.local. mDNS es una forma de resolver un nombre .local sin servidor DNS, y no todos los routers ni todas las versiones de Android lo soportan, así que la dirección IP siempre funciona. El post sobre problemas con mDNS explica cómo puede fallar.
¿Dónde se guardan los ajustes?
La red Wi-Fi y los ajustes del proyecto viven en la memoria flash del ESP32, en espacios de nombres NVS separados, nunca en la imagen del firmware. Por eso flashear una versión nueva conserva tu Wi-Fi, y por eso el firmware puede publicarse como un único archivo ya compilado para todos. En los proyectos con la XIAO ESP32-S3, mantener pulsado el botón BOOT durante 10 segundos con la placa en marcha hace que olvide el Wi-Fi y los ajustes (en el Reolink Switch, también el acceso guardado al NVR, y se niega a hacerlo mientras haya cámaras silenciadas); el botón no se alcanza dentro de la carcasa cerrada del Ticker, así que allí usa la aplicación web. La ESP32-CAM no tiene ese restablecimiento, porque el GPIO0 es también el reloj de la cámara y un pin de strapping, así que el Wi-Fi se olvida desde la aplicación web.
¿Cómo funciona el flasheador del navegador?
Cada página de proyecto tiene una tarjeta de firmware que flashea la última versión por USB con la Web Serial API. Está construido sobre esptool-js de Espressif, y el manifiesto que lee enumera las partes y sus direcciones de flash en el formato que usa ESP Web Tools. La guía de ESP Web Tools explica el formato y cómo añadir un flasheador de navegador a tu propio proyecto, y Failed to connect: no serial data received cubre los problemas habituales de USB. Los tres firmwares usan la tabla de particiones huge_app.csv, un único slot de aplicación de 3 MB, así que no hay actualizaciones inalámbricas; la explicación de la tabla de particiones muestra a qué se renuncia, y la comparativa de métodos OTA las alternativas.
¿Cómo se publica una versión?
Cada repositorio tiene un workflow manual de GitHub Actions que solo corre en main. Lee la versión semántica del archivo VERSION, rechaza una versión que ya tiene etiqueta o que no coincide con el package.json de la aplicación web, compila la aplicación web, ejecuta sus pruebas y las pruebas nativas del firmware, compila el firmware y empaqueta las partes para flashear. Después crea una release de GitHub y sube los archivos a Cloudflare R2, con el manifiesto al final, de modo que el sitio solo ofrece una versión que se ha subido completa. Puedes leerlo en el workflow de Gizmo Camera.
¿Y las carcasas?
Gizmo Ticker y Gizmo Camera tienen una carcasa impresa en 3D, que se ve en sus páginas de proyecto. El Reolink Switch por ahora solo tiene pruebas de ajuste. Las carcasas se diseñan en FreeCAD con scripts de Python, y mis notas de diseño fijan un estilo común: cuerpo blanco, tapa trasera naranja y el mismo tornillo M3 x 8, atornillado directamente en la impresión. Se imprimen en PLA en una Bambu Lab A1 con capas de 0,2 mm, 4 paredes y sin soportes. Las reglas y las pruebas de ajuste están en la guía de diseño de carcasas impresas en 3D. Las páginas del Ticker y de la Camera muestran un plano de cada diseño.
¿Para quién es OpenGizmo?
OpenGizmo es para makers que quieren un gadget que funcione y el código que hay detrás. Si solo quieres el dispositivo, el camino sin código es un cable USB y Chrome. Si quieres aprender, el firmware, la aplicación web y los archivos de compilación son lo bastante pequeños para leerlos en una tarde, y las guías explican las decisiones.

¿Eres nuevo en el hardware? Empieza por qué es un microcontrolador, luego qué es el ESP32 y ESP32 vs ESP8266. ¿Estás eligiendo una placa para tu propio proyecto? Lee qué ESP32 comprar y la comparativa de Arduino IDE y PlatformIO.
¿Cómo empiezas?
Elige según lo que tengas y cuánta soldadura quieras hacer:
- Si quieres un resultado rápido: construye Gizmo Camera. Sin soldadura, unos 15 minutos.
- Si tienes un NVR Reolink: construye Gizmo Reolink Switch, con botón, buzzer y LCD.
- Si quieres una pantalla de escritorio: construye Gizmo Ticker y su carcasa impresa.
- Después abre la página del proyecto en Chrome o Edge, conecta la placa con un cable de datos y pulsa el botón de flasheo.
¿Dónde termina OpenGizmo?
OpenGizmo son tres dispositivos pequeños con una sola función, no una referencia general de ESP32 ni un framework como ESPHome; el post ESPHome vs firmware personalizado explica cuándo conviene cada uno. El firmware no tiene actualizaciones inalámbricas, así que una versión nueva implica volver a conectar la placa. El flasheador del navegador necesita un navegador de escritorio basado en Chromium. El firmware apunta solo a las placas indicadas arriba, así que revisa los pines antes de adaptar un proyecto a otra placa. Para el siguiente paso, abre el proyecto que coincida con lo que tienes, o lee la guía principal de la ESP32-CAM si quieres una cámara funcionando hoy.
Preguntas frecuentes
Encuentra respuestas rápidas a las preguntas más comunes sobre este tema.
Sí. El firmware, la aplicación web y las herramientas de Gizmo Ticker, Gizmo Reolink Switch y Gizmo Camera están publicados en GitHub con licencia MIT, igual que la biblioteca compartida gizmo-common. Puedes leer, modificar y reutilizar el código, también en tus propios proyectos ESP32, siempre que conserves el aviso de licencia.
Autor
Mauro Brambilla¿Listo para montar tu propio gizmo?
Elige un proyecto open source con ESP32 y sigue su guía paso a paso, desde la lista de componentes y el cableado hasta el firmware y el primer arranque.






