Pular para o conteúdo principal

Trabalhar com OpenEPaperLink / OpenDisplay

OpenDisplay e OpenEPaperLink (OEPL) são ecossistemas de código aberto para controlar displays ePaper via Bluetooth Low Energy (BLE). Um telefone, computador ou host Home Assistant pode se conectar diretamente ao display, portanto o fluxo básico não exige um ponto de acesso 802.15.4.

Este guia cobre dois caminhos de hardware da Seeed:

  • Caminho OpenDisplay Toolbox — recomendado para firmware OpenDisplay pronto para uso em reTerminal E1001, reTerminal E1002, reTerminal E1003 e XIAO ePaper Display Board EN04.
  • Caminho OEPL_BLE — útil para uma configuração modular DIY com a ePaper Breakout Board para Seeed Studio XIAO e uma placa da série XIAO nRF52840.

A experiência do usuário é semelhante em ambos os caminhos: instalar o firmware, configurar o dispositivo via BLE e depois enviar uma imagem. As ferramentas e os presets suportados são diferentes, então siga a aba que corresponde ao seu hardware.

Hardware compatível​

A OpenDisplay Toolbox inclui presets para reTerminal E1001, reTerminal E1002 e reTerminal E1003.

reTerminal E1001reTerminal E1002reTerminal E1003
Adquira agora 🖱️
Adquira agora 🖱️
Adquira agora 🖱️
7,5" monocromático, 800 × 4807,3" Spectra 6 cores, 800 × 48010,3" monocromático, 1404 × 1872, toque
Abrir na ToolboxAbrir na ToolboxAbrir na Toolbox

Use este caminho quando quiser executar o firmware OpenDisplay diretamente em um dispositivo reTerminal E Série finalizado.

cuidado

A instalação do firmware OpenDisplay substitui o firmware que está sendo executado atualmente no dispositivo. Mantenha um caminho de restauração pronto usando o reTerminal E-Series Firmware Hub oficial ou o pacote de firmware recomendado pelo Wiki do seu produto.

Por que usar OpenDisplay / OpenEPaperLink?​

  • Fluxo de trabalho centrado em BLE — configure e envie imagens sem um ponto de acesso 802.15.4 dedicado.
  • Ferramentas baseadas em navegador — instale firmware, selecione presets, configure dispositivos e envie imagens a partir de um navegador compatível.
  • Presets para hardware Seeed — a OpenDisplay Toolbox inclui presets para reTerminal E1001, E1002, E1003 e EN04.
  • Suporte ao Home Assistant — dispositivos OpenDisplay podem ser adicionados por meio da integração oficial OpenDisplay do Home Assistant.
  • Ecossistema de código aberto — firmware, ferramentas e integrações são desenvolvidos em repositórios públicos.

Etapa 1: Configuração de hardware​

Etapa 1. Conecte o dispositivo reTerminal E Série ao seu computador com um cabo de dados USB-C.

Etapa 2. Ligue o dispositivo e mantenha-o próximo ao computador. O navegador usará USB para instalação de firmware e BLE para configuração.

Etapa 3. Combine seu hardware com o preset correto da OpenDisplay Toolbox:

DispositivoPreset da ToolboxDisplay
reTerminal E1001reterminal-e10017,5" monocromático, 800 × 480
reTerminal E1002reterminal-e10027,3" Spectra 6 cores, 800 × 480
reTerminal E1003reterminal-e100310,3" monocromático, 1404 × 1872

Passo 2: Instalar o firmware​

O OpenDisplay fornece presets diretos do Toolbox para o reTerminal E Series.

Passo 1. Abra o preset do Toolbox correspondente no Chrome ou Edge:

Passo 2. Confirme que o preset selecionado corresponde ao seu dispositivo.

Passo 3. Clique em Install firmware (USB).

Passo 4. Na caixa de diálogo de pareamento do navegador, selecione o dispositivo serial USB que aparece quando o reTerminal é conectado.

Passo 5. Aguarde até que o instalador termine e o dispositivo reinicie.

Após a instalação, continue com a configuração BLE no próximo passo.

Passo 3: Configurar o dispositivo via BLE​

Passo 1. Na mesma página do OpenDisplay Toolbox, clique em Configure over Bluetooth.

Passo 2. Selecione o seu dispositivo reTerminal na caixa de diálogo de pareamento BLE.

Passo 3. Aguarde o Toolbox gravar o preset selecionado no dispositivo.

Passo 4. Confirme que o display é atualizado ou mostra a imagem de inicialização/teste do OpenDisplay.

O dispositivo agora está pronto para upload de imagens por meio das ferramentas OpenDisplay ou do Home Assistant.

Passo 4: Fazer upload de imagens​

Os dispositivos OpenDisplay podem receber imagens por meio da ferramenta de display no navegador.

Passo 1. Abra a ferramenta de display OpenDisplay.

Passo 2. Clique em Connect e selecione o seu dispositivo reTerminal na caixa de diálogo de pareamento BLE.

Passo 3. Clique em Select Image e escolha um arquivo de imagem local.

Passo 4. Clique em Upload Image.

Quando a transferência terminar, o display ePaper será atualizado e mostrará a imagem enviada.

dica

Use um tamanho de imagem que corresponda ao seu painel para obter o melhor resultado:

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

Integração com Home Assistant​

O Home Assistant possui uma integração oficial OpenDisplay para dispositivos com firmware OpenDisplay. Ela se comunica via BLE e fornece a ação opendisplay.upload_image para enviar imagens ao display.

Pré-requisitos​

  • Home Assistant 2026.4 ou posterior.
  • Uma configuração Bluetooth funcional que suporte conexões BLE ativas.
  • Um dispositivo com firmware OpenDisplay ligado e dentro do alcance do Bluetooth.

Os seguintes caminhos Bluetooth são adequados:

  • Home Assistant Green ou outro host Home Assistant com hardware Bluetooth compatível.
  • ESPHome Bluetooth Proxy executando firmware ESPHome 2022.9.3 ou posterior.
info

Os proxies Bluetooth Shelly são úteis para sensores BLE passivos, mas o upload de imagens do OpenDisplay requer conexões BLE ativas. Use um adaptador Bluetooth do Home Assistant ou um ESPHome Bluetooth Proxy para este fluxo de trabalho.

Adicionar o dispositivo​

Passo 1. No Home Assistant, vá para Settings > Devices & services.

Passo 2. Se o dispositivo for descoberto automaticamente, clique em Add no cartão do OpenDisplay.

Passo 3. Se ele não for descoberto automaticamente, clique em Add Integration, pesquise por OpenDisplay e siga o fluxo de configuração.

Passo 4. Defina o nome e a área do dispositivo.

Depois que o dispositivo for adicionado, o Home Assistant poderá descobrir e conectar ao dispositivo OpenDisplay via Bluetooth.

Fazer upload de uma imagem a partir do Home Assistant​

Armazene sua imagem na pasta de mídia local do Home Assistant e, em seguida, chame 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 atualizações agendadas, use a mesma ação dentro de uma automação.

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"
dica

Use automações do Home Assistant para gerar ou copiar um novo PNG antes de chamar opendisplay.upload_image. A integração OpenDisplay então lida com a transferência BLE para o display.

Opcional: payloads de desenho personalizados​

A comunidade OpenDisplay também mantém uma integração HACS com um fluxo de trabalho drawcustom para desenhar texto, ícones, formas, códigos QR, imagens, gráficos e barras de progresso diretamente a partir de payloads do Home Assistant.

Use este caminho quando você precisar especificamente de layouts baseados em comandos de desenho em vez de fazer upload de uma imagem preparada.

Integração OpenDisplay HACS

No editor visual do Home Assistant, crie uma automação, adicione um gatilho de horário e, em seguida, adicione a ação de desenho do OpenDisplay e selecione o dispositivo de destino.

Usando ESPHome Bluetooth Proxy​

Um ESPHome Bluetooth Proxy estende a cobertura Bluetooth e melhora a confiabilidade quando o display está longe do host do Home Assistant.

Pré-requisitos​

  • Um dispositivo ESP32, como o XIAO ESP32S3.
  • ESPHome instalado no Home Assistant.
  • Um cabo de dados USB para o primeiro flash.

Configuração passo a passo​

Passo 1. Conecte o dispositivo ESP32 ao computador ou ao host do Home Assistant usado para o flash.

Passo 2. Crie um novo dispositivo ESPHome e use uma configuração de Bluetooth Proxy semelhante ao exemplo abaixo.

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:

Passo 3. Clique em Install no ESPHome e faça o flash do firmware no dispositivo ESP32.

Passo 4. Depois que o ESP32 se conectar ao Wi-Fi, adicione o Bluetooth Proxy descoberto no Home Assistant.

Passo 5. Mantenha o proxy próximo ao dispositivo OpenDisplay durante os uploads de imagem.

Quando o proxy estiver funcionando, o Home Assistant mostrará o Bluetooth Proxy como conectado e o display ePaper poderá ser descoberto por meio dele.

Bônus: suporte impresso em 3D​

Para o EN04 com o painel Spectra de 7,3", este modelo da comunidade fornece um inserto para a moldura de quadro IKEA RODALM:

Recursos​

Suporte técnico e discussão sobre o produto​

Obrigado por escolher nossos produtos! Estamos aqui para oferecer diferentes tipos de suporte para garantir que sua experiência com nossos produtos seja a mais tranquila possível. Oferecemos vários canais de comunicação para atender a diferentes preferências e necessidades.

Loading Comments...