Primeros pasos con OpenDisplay 7.3" Color Kit
Introducción
El OpenDisplay 7.3" Color Kit es una pantalla de papel electrónico lista para usar, co-desarrollada por Seeed Studio y OpenDisplay. Se envía totalmente ensamblada con un panel en color Spectra 6 de 7,3 pulgadas y 800×480, una XIAO ePaper Display Board EN04 de Seeed (XIAO nRF52840 Plus), una batería de 2000 mAh y una carcasa impresa en 3D, con el firmware ya instalado.
Úsalo mediante Bluetooth Low Energy desde tu navegador o Home Assistant. No se requiere Wi‑Fi. La radio permanece en un modo de escucha de bajo consumo, por lo que puedes enviar una nueva imagen siempre que la pantalla esté encendida y dentro del alcance (sin ventana de activación desde deep-sleep). Con aproximadamente una actualización cada dos horas, se estima alrededor de un año entre cargas.
Lo que necesitas
- El kit, encendido y dentro del alcance de Bluetooth
- Un teléfono o computadora con Bluetooth
- Chrome o Edge (escritorio/Android), o Bluefy en iPhone/iPad
De un vistazo
| Parámetro | Descripción |
|---|---|
| MCU | Seeed XIAO ePaper Display Board EN04 (XIAO nRF52840 Plus) |
| Pantalla | Papel electrónico en color Spectra 6 de 7,3 pulgadas |
| Colores | Negro, blanco, amarillo, rojo, azul, verde (tramado; no RGB completo) |
| Resolución | 800 × 480 |
| Batería | Batería recargable de ion-litio de 2000 mAh |
| Conectividad | Solo Bluetooth Low Energy (sin Wi‑Fi) |
| Carcasa | Incluye carcasa impresa en 3D |
Encendido
- Desempaqueta el kit y enciéndelo.
- Espera a la actualización de arranque: normalmente unos 15–20 segundos para Spectra 6. El parpadeo es normal.
- Cuando termine, la pantalla de arranque muestra el nombre de tu dispositivo (empieza por OD), KEY1: / KEY2: y un código QR.
El cifrado viene desactivado, por lo que las líneas de clave muestran not set. No necesitas una clave para el uso normal recién sacado de la caja.
Envía tu primera imagen
Escanea el código QR en la pantalla. Se abrirá una página personalizada en opendisplay.org con accesos directos para este dispositivo:
| Acceso directo | Qué hace |
|---|---|
| Enviar una imagen | Abre el BLE Tester para enviar una imagen de prueba desde tu navegador |
| Añadir a Home Assistant | Inicia la adición del dispositivo a Home Assistant |
| Advanced → Toolbox | Cambiar ajustes o reflashear el firmware (desarrolladores / recuperación) |
Compatibilidad del navegador
| Navegador | Compatibilidad |
|---|---|
| Chrome o Edge (escritorio, Android) | Compatible |
| iPhone / iPad | Usa Bluefy (App Store id1492822055) |
| Firefox | No compatible |
Desde la página de destino elige Send an image (o abre opendisplay.org). Haz clic en Connect, elige tu dispositivo en la lista del navegador (el nombre empieza por OD, por ejemplo ODCA6020), luego elige una foto o dibuja y toca Send to device.
Terminado cuando: la imagen aparece en la pantalla de papel electrónico.
Home Assistant (opcional)
Este kit usa solo BLE. Home Assistant necesita una ruta Bluetooth funcional:
- Bluetooth en el host de Home Assistant: adaptador integrado o dongle USB
- Proxy Bluetooth ESPHome: si la pantalla está lejos del host de HA (debe admitir conexiones activas / conectables)
Los proxies Shelly BLE no son compatibles: no pueden establecer la conexión activa que esta pantalla necesita. Usa un adaptador local o un proxy ESPHome.
Enciende la pantalla dentro del alcance de Bluetooth. Home Assistant debería descubrirla automáticamente: busca un nombre que empiece por OD en Settings → Devices & Services → Discovered, luego toca Add y Submit.
La página del dispositivo muestra la batería, los botones, el estado del firmware y el contenido de la pantalla. Más detalles: Home Assistant integration
Ir más allá
Activar el cifrado
El cifrado viene desactivado. En Toolbox → More options, establece Encryption en Locked, luego Configure over Bluetooth. Tras el reinicio, la clave aparece en KEY1: / KEY2: y en la página de destino del QR. Apaga y enciende de nuevo la pantalla para mostrar la clave otra vez si la pierdes.
Reflashear o recuperar
- Abre Toolbox — preset 7.3" Color Kit: Toolbox (7.3" Color Kit preset)
- Install firmware (USB): Chrome o Edge en un equipo de escritorio/portátil
- Configure over Bluetooth: vuelve a escribir los ajustes después de flashear
py-opendisplay
Para proyectos personalizados en Python, instala con pip install py-opendisplay: py-opendisplay
Duración de la batería
Con la batería incluida de 2000 mAh y aproximadamente una actualización cada dos horas, se estima alrededor de un año entre cargas en un uso típico. El tiempo real de funcionamiento depende de la frecuencia de actualización, el tamaño de la imagen y la temperatura.
Modela tu programación en Battery calculator (selecciona 7.3" Color Kit / nRF52840 / 2000 mAh).
Recursos
- [Web] Sitio web de OpenDisplay
- [Tool] Toolbox (7.3" Color Kit preset)
- [Tool] BLE Tester
- [Tool] Battery calculator
- [GitHub] OpenDisplay Firmware
- [GitHub] py-opendisplay
- [GitHub] Home Assistant Integration
- [Discord] OpenDisplay Discord
- [Wiki] Guía detallada de OpenDisplay
Solución de problemas
P1: Necesito de nuevo la pantalla de arranque o el código QR.
- Apaga y enciende la pantalla: Apaga, espera 10 segundos y vuelve a encender. La pantalla de arranque — con el nombre del dispositivo, las líneas KEY1:/KEY2: y el código QR — solo aparece después de una actualización completa al encender.
- Espera a que termine la actualización: Una actualización de arranque en color Spectra 6 tarda unos 15–20 segundos. El parpadeo y los patrones de color intermedios son normales. No apagues la pantalla durante la actualización.
- Escanea de nuevo el código QR o lee KEY1:/KEY2: directamente de la pantalla si necesitas la clave de cifrado.
- No es necesario reflashear ni reconfigurar: la pantalla de arranque siempre vuelve a aparecer después de un ciclo de encendido.
- Nota: La pantalla solo permite una conexión Bluetooth activa a la vez. Si otro dispositivo sigue conectado, desconéctalo primero.
P2: La pantalla no se enciende o no responde.
- Primero carga por USB: Una batería muy baja puede hacer que el dispositivo parezca muerto o bloqueado. Conecta el kit a una fuente de alimentación USB, cárgalo un rato y vuelve a intentarlo.
- Después de cargar: Apaga, espera 10 segundos, enciende y espera la pantalla de arranque.
- Confirma que el interruptor de encendido está activado: Desliza el interruptor firmemente a la posición ON.
- Comprueba el conector de la batería: Abre la carcasa y confirma que el conector JST de la batería está completamente insertado. El cable rojo debe mirar hacia la marca "+" y el cable negro hacia la marca "−". Un conector invertido puede dañar la placa.
- Asegúrate de que ningún otro dispositivo mantenga todavía una conexión BLE abierta: la pantalla solo admite una conexión activa a la vez.
P3: Home Assistant no descubre la pantalla.
- Comprueba la versión de la integración: Home Assistant 2026.4 y posteriores incluyen la integración OpenDisplay incorporada. Para versiones anteriores o el flujo de trabajo drawcustom, instala la integración personalizada de HACS (copia la carpeta
opendisplayencustom_components/), luego reinicia Home Assistant. - Desconecta primero otros clientes Bluetooth: Cierra BLE Tester, pestañas del navegador y Bluefy: la pantalla solo permite una conexión BLE activa a la vez. Si otro dispositivo está conectado, Home Assistant no podrá descubrir ni conectarse.
- Comprueba la ruta de Bluetooth: Usa un adaptador Bluetooth integrado o USB en el host de Home Assistant, o un proxy Bluetooth de ESPHome que admita conexiones activas / conectables. Los proxies Shelly BLE no son compatibles: no pueden establecer la conexión activa que esta pantalla necesita.
- ¿Sigue sin aparecer? Espera un minuto, acerca la pantalla y revisa en Settings → Devices & Services → Discovered si hay un nombre que empiece por "OD".
- Añadir manualmente: Si la pantalla no se detecta automáticamente, ve a Settings → Devices & Services, haz clic en Add Integration, busca "OpenDisplay" y sigue el flujo de configuración.
P4: Mi navegador no puede encontrar o conectarse a la pantalla.
- Usa un navegador compatible: Web Bluetooth funciona en Chrome y Edge (escritorio y Android). En iPhone o iPad, usa el navegador Bluefy (id de App Store 1492822055). Firefox y Safari (escritorio) no admiten Web Bluetooth.
- Activa el Bluetooth: Asegúrate de que Bluetooth esté activado en tu teléfono u ordenador. En Android, activa también Location: Chrome lo necesita para el escaneo BLE.
- Mantén el dispositivo cerca del kit.
- Desconecta primero todos los demás clientes: La pantalla solo permite una conexión BLE activa. Si Home Assistant u otro navegador ya está conectado, desconéctalo antes de intentarlo de nuevo.
- Elige el nombre de dispositivo que empiece por "OD" (por ejemplo, OD592B4A).
- Si no aparece: Pulsa un botón en la pantalla una vez, o apágala y enciéndela (apagado 10 segundos → encendido) y vuelve a intentarlo después de que termine la actualización de arranque.
- Si nada responde: Carga primero el kit por USB.
P5: La carga de la imagen falla o se agota el tiempo de espera.
- Confirma que la pantalla está encendida y dentro del alcance: El kit permanece listo para BLE sin ventana de activación de deep-sleep, pero debe estar encendido y dentro del alcance de Bluetooth.
- Desconecta todos los demás clientes: Solo una conexión BLE activa a la vez. Vuelve a conectar solo desde BLE Tester e inténtalo de nuevo.
- Si el cifrado está activado: Introduce la clave de la pantalla de arranque o de la página de destino del QR.
- Prueba con una imagen más pequeña, o espera a que termine la actualización completa antes de enviar la siguiente.
- El dispositivo dejó de responder a mitad de la sesión: Carga por USB y luego apágalo y enciéndelo (apagado 10 segundos → encendido).
P6: La clave de cifrado se rechaza o muestra "not set".
- Los kits de fábrica se envían con el cifrado desactivado: KEY1: y KEY2: muestran "not set" de fábrica: deja el campo de clave en blanco.
- ¿Activaste el cifrado pero perdiste la clave? Apaga y enciende la pantalla (apagado 10 segundos → encendido): la clave aparece en la pantalla de arranque tras el reinicio. También puedes escanear el código QR; la página de destino muestra la misma clave.
- Perdiste la clave y no puedes leer la pantalla: Abre Toolbox → establece Encryption en Unlocked → Configure over Bluetooth. Esto elimina el cifrado para que puedas configurarlo de nuevo. Si eso no funciona, vuelve a flashear el firmware y reconfigura.
P7: La pantalla parece bloqueada, muestra colores incorrectos o queda en blanco después de un envío.
- Espera a que termine la actualización: No apagues la pantalla en mitad de una actualización. Una actualización completa de Spectra 6 tarda unos 15–20 segundos.
- Ten en cuenta el renderizado de color: Las imágenes se tramitan a seis colores (no RGB completo): el texto y los gráficos simples se ven mejor; las fotos muestran un patrón granulado. Esto es un comportamiento esperado, no un fallo.
- Apaga durante 10 segundos → enciende para volver a la pantalla de arranque y luego confirma que BLE responde.
- Comprueba si hay otros dispositivos conectados: Si otro dispositivo está conectado al mismo tiempo, desconéctalo e inténtalo de nuevo con un solo cliente.
- ¿Aún no arranca ni se conecta? Carga primero por USB y luego vuelve a apagar y encender.
- Vuelve a flashear el firmware: Si la pantalla sigue bloqueada o en blanco después de todo lo anterior, vuelve a flashear por USB usando Toolbox (consulta "Reflash or recover" en la sección Going further).
Soporte técnico y debate sobre el producto
Cocreado por Seeed Studio y OpenDisplay.
Gracias por elegir nuestros productos. Estamos aquí para ofrecerte soporte y garantizar que tu experiencia con nuestros productos sea lo más fluida posible. Ofrecemos varios canales de comunicación para adaptarnos a diferentes preferencias y necesidades.