Saltar al contenido principal

Trabajar con OpenEPaperLink / OpenDisplay

OpenDisplay y OpenEPaperLink (OEPL) son ecosistemas de código abierto para controlar pantallas ePaper mediante Bluetooth Low Energy (BLE). Un teléfono, ordenador u host de Home Assistant puede conectarse directamente a la pantalla, por lo que el flujo de trabajo básico no requiere un punto de acceso 802.15.4.

Esta guía cubre dos rutas de hardware de Seeed:

  • Ruta OpenDisplay Toolbox: recomendada para firmware OpenDisplay listo para usar en reTerminal E1001, reTerminal E1002, reTerminal E1003 y XIAO ePaper Display Board EN04.
  • Ruta OEPL_BLE: útil para un montaje modular DIY con la ePaper Breakout Board for Seeed Studio XIAO y una placa de la serie XIAO nRF52840.

La experiencia de usuario es similar en ambas rutas: instala el firmware, configura el dispositivo mediante BLE y luego sube una imagen. Las herramientas y los presets compatibles son diferentes, así que sigue la pestaña que coincida con tu hardware.

Hardware compatible​

OpenDisplay Toolbox incluye presets para reTerminal E1001, reTerminal E1002 y reTerminal E1003.

reTerminal E1001reTerminal E1002reTerminal E1003
Consigue uno ahora 🖱️
Consigue uno ahora 🖱️
Consigue uno ahora 🖱️
7,5" monocromo, 800 × 4807,3" Spectra 6 colores, 800 × 48010,3" monocromo, 1404 × 1872, táctil
Abrir en ToolboxAbrir en ToolboxAbrir en Toolbox

Usa esta ruta cuando quieras ejecutar firmware OpenDisplay directamente en un dispositivo reTerminal E Serie terminado.

precaución

Instalar firmware OpenDisplay reemplaza el firmware que se está ejecutando actualmente en el dispositivo. Ten preparada una ruta de restauración utilizando el Firmware Hub oficial de reTerminal E-Series o el paquete de firmware recomendado por el Wiki de tu producto.

¿Por qué usar OpenDisplay / OpenEPaperLink?​

  • Flujo de trabajo centrado en BLE: configura y sube imágenes sin un punto de acceso 802.15.4 dedicado.
  • Herramientas basadas en navegador: instala firmware, selecciona presets, configura dispositivos y sube imágenes desde un navegador compatible.
  • Presets para hardware de Seeed: OpenDisplay Toolbox incluye presets para reTerminal E1001, E1002, E1003 y EN04.
  • Compatibilidad con Home Assistant: los dispositivos OpenDisplay se pueden añadir mediante la integración oficial de OpenDisplay de Home Assistant.
  • Ecosistema de código abierto: el firmware, las herramientas y las integraciones se desarrollan en repositorios públicos.

Paso 1: Configuración del hardware​

Paso 1. Conecta el dispositivo reTerminal E Serie a tu ordenador con un cable de datos USB-C.

Paso 2. Enciende el dispositivo y mantenlo cerca del ordenador. El navegador usará USB para la instalación del firmware y BLE para la configuración.

Paso 3. Haz coincidir tu hardware con el preset correcto de OpenDisplay Toolbox:

DispositivoPreset de ToolboxPantalla
reTerminal E1001reterminal-e10017,5" monocromo, 800 × 480
reTerminal E1002reterminal-e10027,3" Spectra 6 colores, 800 × 480
reTerminal E1003reterminal-e100310,3" monocromo, 1404 × 1872

Paso 2: Instalar el firmware​

OpenDisplay proporciona presets directos de Toolbox para la reTerminal E Serie.

Paso 1. Abre el preset de Toolbox correspondiente en Chrome o Edge:

Paso 2. Confirma que el preset seleccionado coincide con tu dispositivo.

Paso 3. Haz clic en Install firmware (USB).

Paso 4. En el cuadro de diálogo de emparejamiento del navegador, selecciona el dispositivo serie USB que aparece cuando la reTerminal está conectada.

Paso 5. Espera hasta que el instalador termine y el dispositivo se reinicie.

Después de la instalación, continúa con la configuración BLE en el siguiente paso.

Paso 3: Configurar el dispositivo por BLE​

Paso 1. En la misma página de OpenDisplay Toolbox, haz clic en Configure over Bluetooth.

Paso 2. Selecciona tu dispositivo reTerminal en el cuadro de diálogo de emparejamiento BLE.

Paso 3. Espera a que la Toolbox escriba el preset seleccionado en el dispositivo.

Paso 4. Confirma que la pantalla se actualiza o muestra la imagen de inicio/prueba de OpenDisplay.

El dispositivo ya está listo para cargar imágenes mediante las herramientas OpenDisplay o Home Assistant.

Paso 4: Cargar imágenes​

Los dispositivos OpenDisplay pueden recibir imágenes a través de la herramienta de visualización del navegador.

Paso 1. Abre la herramienta de visualización OpenDisplay.

Paso 2. Haz clic en Connect y selecciona tu dispositivo reTerminal en el cuadro de diálogo de emparejamiento BLE.

Paso 3. Haz clic en Select Image y elige un archivo de imagen local.

Paso 4. Haz clic en Upload Image.

Cuando finalice la transferencia, la pantalla ePaper se actualizará y mostrará la imagen cargada.

tip

Utiliza un tamaño de imagen que coincida con tu panel para obtener el mejor resultado:

  • reTerminal E1001: 800 × 480 px
  • reTerminal E1002: 800 × 480 px
  • reTerminal E1003: 1404 × 1872 px

Integración con Home Assistant​

Home Assistant tiene una integración oficial OpenDisplay para dispositivos con firmware OpenDisplay. Se comunica por BLE y proporciona la acción opendisplay.upload_image para enviar imágenes a la pantalla.

Requisitos previos​

  • Home Assistant 2026.4 o posterior.
  • Una configuración Bluetooth funcional que admita conexiones BLE activas.
  • Un dispositivo con firmware OpenDisplay encendido y dentro del alcance de Bluetooth.

Las siguientes rutas Bluetooth son adecuadas:

  • Home Assistant Green u otro host de Home Assistant con hardware Bluetooth compatible.
  • Proxy Bluetooth ESPHome que ejecute firmware ESPHome 2022.9.3 o posterior.
info

Los proxies Bluetooth de Shelly son útiles para sensores BLE pasivos, pero la carga de imágenes de OpenDisplay requiere conexiones BLE activas. Usa un adaptador Bluetooth de Home Assistant o un ESPHome Bluetooth Proxy para este flujo de trabajo.

Añadir el dispositivo​

Paso 1. En Home Assistant, ve a Settings > Devices & services.

Paso 2. Si el dispositivo se descubre automáticamente, haz clic en Add en la tarjeta de OpenDisplay.

Paso 3. Si no se descubre automáticamente, haz clic en Add Integration, busca OpenDisplay y sigue el flujo de configuración.

Paso 4. Asigna el nombre y el área del dispositivo.

Después de añadir el dispositivo, Home Assistant puede descubrir y conectarse al dispositivo OpenDisplay mediante Bluetooth.

Cargar una imagen desde Home Assistant​

Almacena tu imagen en la carpeta de medios local de Home Assistant y luego llama a opendisplay.upload_image.

action: opendisplay.upload_image
data:
  device_id: "your_device_id"
  image:
    media_content_id: "media-source://media_source/local/photo.png"
    media_content_type: "image/png"

Para actualizaciones programadas, usa la misma acción dentro de una automatización.

triggers:
  - trigger: time
    at: "08:00:00"
actions:
  - action: opendisplay.upload_image
    data:
      device_id: "your_device_id"
      image:
        media_content_id: "media-source://media_source/local/daily.png"
        media_content_type: "image/png"
tip

Usa automatizaciones de Home Assistant para generar o copiar un nuevo PNG antes de llamar a opendisplay.upload_image. La integración de OpenDisplay se encarga después de la transferencia BLE a la pantalla.

Opcional: cargas personalizadas de dibujo​

La comunidad de OpenDisplay también mantiene una integración HACS con un flujo de trabajo drawcustom para dibujar texto, iconos, formas, códigos QR, imágenes, gráficos y barras de progreso directamente desde cargas útiles de Home Assistant.

Utiliza esta ruta cuando necesites específicamente diseños basados en comandos de dibujo en lugar de cargar una imagen preparada.

OpenDisplay HACS Integration

En el editor visual de Home Assistant, crea una automatización, añade un disparador de tiempo, luego añade la acción de dibujo de OpenDisplay y selecciona el dispositivo de destino.

Uso de ESPHome Bluetooth Proxy​

Un ESPHome Bluetooth Proxy amplía la cobertura de Bluetooth y mejora la fiabilidad cuando la pantalla está lejos del host de Home Assistant.

Requisitos previos​

  • Un dispositivo ESP32, como XIAO ESP32S3.
  • ESPHome instalado en Home Assistant.
  • Un cable de datos USB para el primer flasheo.

Configuración paso a paso​

Paso 1. Conecta el dispositivo ESP32 al ordenador o al host de Home Assistant utilizado para el flasheo.

Paso 2. Crea un nuevo dispositivo ESPHome y utiliza una configuración de Bluetooth Proxy similar al siguiente ejemplo.

esphome:
  name: esps3-proxy
  friendly_name: ESP32S3 Bluetooth Proxy

esp32:
  board: esp32-s3-devkitc-1
  framework:
    type: esp-idf

logger:
  level: INFO

esp32_ble_tracker:
  scan_parameters:
    active: true

bluetooth_proxy:
  active: true

api:
  encryption:
    key: "YOUR_ENCRYPTION_KEY"

ota:
  - platform: esphome
    password: "YOUR_OTA_PASSWORD"

wifi:
  ssid: "YOUR_WIFI_SSID"
  password: "YOUR_WIFI_PASSWORD"

captive_portal:

Paso 3. Haz clic en Install en ESPHome y flashea el firmware en el dispositivo ESP32.

Paso 4. Después de que el ESP32 se conecte a la red Wi‑Fi, añade el Bluetooth Proxy descubierto en Home Assistant.

Paso 5. Mantén el proxy cerca del dispositivo OpenDisplay durante las cargas de imágenes.

Cuando el proxy está funcionando, Home Assistant muestra el Bluetooth Proxy como conectado y la pantalla de tinta electrónica puede descubrirse a través de él.

Extra: soporte impreso en 3D​

Para EN04 con el panel Spectra de 7,3", este modelo de la comunidad proporciona un inserto para el marco de fotos IKEA RODALM:

Recursos​

Soporte técnico y debate sobre el producto​

Gracias por elegir nuestros productos. Estamos aquí para ofrecerte diferentes tipos de 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.

Loading Comments...