Pular para o conteúdo principal

Trabalhar com Arduino

Esta página é o manual de referência para controlar qualquer produto Seeed ePaper compatível a partir da IDE Arduino. Ela cobre as partes que são idênticas em todo o hardware:

  1. Configurar a IDE Arduino e o suporte à placa ESP32.
  2. Instalar a biblioteca Seeed_GFX — nosso fork mantido de TFT_eSPI com suporte de primeira classe para Seeed ePaper.
  3. Gerar um driver.h para a combinação da sua placa + tela usando a Seeed GFX Configuration Tool.
  4. (Opcionalmente) usar a biblioteca de terceiros GxEPD2 como driver alternativo.

Para o passo a passo completo de “abrir a caixa, gravar um hello world, acender sensores e botões”, vá direto ao cookbook do seu hardware específico — essas páginas reutilizam esta referência para o boilerplate e depois adicionam exemplos específicos do produto (periféricos, trechos de código, solução de problemas):

  • reTerminal E Series — ePaper Display cookbook — cobre reTerminal E1001 / E1002 / E1003 / E1004 com exemplos Hello World usando tanto Seeed_GFX quanto GxEPD2.
  • reTerminal E Series — Onboard Peripherals cookbook — exemplos completos de periféricos para os mesmos modelos: LED, buzzer, três botões de usuário, sensor SHT4x, monitor de bateria, cartão microSD e renderização de imagem BMP a partir do SD.
  • Mais cookbooks (Painel XIAO 7,5", placas driver EE0x, …) serão adicionados conforme os produtos correspondentes forem incluídos na plataforma.

Se você só precisa do boilerplate (um Hello World em um produto novo ainda não coberto por um cookbook), esta página por si só é suficiente.

Hardware compatível​

Todo produto Seeed ePaper na página principal do hub que tenha a coluna Arduino marcada pode seguir este fluxo de trabalho. Em resumo:

Linha de produtoMCUObservações
reTerminal E1001 / E1002 / E1003 / E1004XIAO ESP32-S3 (integrado)Cookbook disponível — veja o link acima
EE02 / EE03 / EE04 / EE05XIAO ESP32-S3 / ESP32-S3 PlusUse a Configuration Tool com a sua escolha de tela
EN04 / EN05XIAO nRF52840 PlusEscolha o pacote de placa nRF52840; em vez disso, é voltado principalmente para OpenDisplay (BLE)
Painel ePaper XIAO 7,5"XIAO ESP32-C3Veja o guia dedicado Painel XIAO 7,5" + Arduino
TRMNL 7,5" (OG) DIY KitXIAO ESP32-S3 PlusVeja o guia dedicado TRMNL DIY Kit + Arduino
XIAO eInk Expansion Board v2 / ePaper Breakout BoardQualquer XIAO que você conectarUse a Configuration Tool com a sua combinação de XIAO + tela

Etapa 1: Configurar a IDE Arduino​

Para controlar qualquer produto Seeed ePaper rodando em um ESP32 / ESP32-S3 / ESP32-C3 a partir do Arduino, você precisa da IDE Arduino mais o suporte à placa ESP32.

dica

Se esta é a sua primeira vez usando Arduino, veja primeiro Getting Started with Arduino.

Etapa 1. Baixe e instale a IDE Arduino.

Download Arduino IDE

Etapa 2. Adicione o suporte à placa ESP32. Na IDE Arduino vá para File → Preferences e adicione ao campo Additional Boards Manager URLs:

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

Etapa 3. Instale o pacote de placas ESP32: Tools → Board → Boards Manager, procure por esp32, instale o pacote da Espressif Systems.

Etapa 4. Escolha a placa correta para o seu hardware:

  • reTerminal E Series / EE04 com EE04 plus / TRMNL DIY Kit: XIAO_ESP32S3_PLUS
  • EE02 / EE03 / EE04 / EE05 padrão / EN04 (caminho Arduino): XIAO_ESP32S3 (ou XIAO_nRF52840 para placas baseadas em nRF52840)
  • Painel ePaper XIAO 7,5": XIAO_ESP32C3

Se você não tiver certeza de qual escolher, o cookbook do seu produto informará.

Etapa 5. Conecte seu hardware via USB-C e selecione a porta correta em Tools → Port.

Etapa 6. Para placas ESP32-S3 (a maioria das reTerminal E Series e placas EE0x) ative a PSRAM:

Tools → PSRAM → OPI PSRAM

Etapa 2: Instalar a biblioteca Seeed_GFX​

Seeed_GFX é um fork de TFT_eSPI com suporte de primeira classe para displays Seeed. É a biblioteca recomendada para toda a nossa linha de ePaper.

Etapa 1. Baixe a biblioteca Seeed_GFX do GitHub:

Download the Library

Etapa 2. Sketch → Include Library → Add .ZIP Library e selecione o ZIP baixado.

nota

Se você instalou TFT_eSPI anteriormente, remova-o temporariamente ou renomeie-o na pasta de bibliotecas do Arduino para evitar conflitos.

Etapa 3: Gerar driver.h para o seu hardware​

Todo sketch de exemplo em Seeed_GFX procura por um driver.h local na pasta do sketch. Esse header informa à biblioteca qual placa, controlador de tela e mapa de pinos usar. A Configuration Tool o gera para você.

Etapa 1. Escolha um sketch de exemplo:

  • Telas monocromáticas: File → Examples → Seeed_GFX → ePaper → Basic → HelloWorld
  • Telas coloridas: File → Examples → Seeed_GFX → ePaper → Colorful → HelloWorld

Etapa 2. Na mesma pasta do sketch, crie um novo arquivo chamado driver.h (use a seta de nova aba na IDE Arduino).

Etapa 3. Abra a Seeed GFX Configuration Tool e escolha o seu hardware. Cada dispositivo pré-configurado produz o valor BOARD_SCREEN_COMBO correto (e quaisquer defines extras, por exemplo USE_XIAO_EPAPER_DISPLAY_BOARD_EE04).

Etapa 4. Copie o conteúdo gerado e cole no seu driver.h. Valores comuns:

#define BOARD_SCREEN_COMBO 520 // reTerminal E1001 (UC8179)

Para qualquer outra combinação, sempre confie na saída da Configuration Tool — escolha sua placa XIAO (ou None se for um kit integrado reTerminal/EN04) mais a tela que você conectou.

Etapa 5. Envie o sketch para o seu hardware. Na primeira energização pode aparecer uma atualização parcial; as atualizações subsequentes exibem o exemplo Hello World completo.

Etapa 4 (opcional): Usar GxEPD2 em vez disso​

Seeed_GFX é a biblioteca recomendada, mas se você já tem uma base de código baseada em GxEPD2, também pode controlar o Seeed ePaper com ela. GxEPD2 é uma biblioteca popular da comunidade que cobre uma ampla gama de displays de papel eletrônico.

Para instalá-la manualmente a partir do GitHub com o suporte mais recente a dispositivos:

Download the Library

Sketch → Include Library → Add .ZIP Library e selecione o ZIP baixado. Os cookbooks de produtos incluem exemplos concretos de GxEPD2 quando aplicável (por exemplo, o cookbook reTerminal E Series mostra renderização em cores completas no E1002).

Para onde ir em seguida — Cookbooks​

Esta página intencionalmente para no boilerplate. Os exemplos de código específicos de hardware e os passo a passos completos estão no cookbook de cada produto:

Quando novos produtos de ePaper são enviados, o cookbook correspondente é adicionado na pasta de cada produto; esta página principal é atualizada para apontar para ele.

Problemas comuns​

A tela não mostra nada ou não atualiza​

  • Na maioria das vezes o cabo FPC do ePaper está solto ou de cabeça para baixo. Recoloque-o com os contatos metálicos voltados para cima.
  • Verifique se OPI PSRAM está habilitado em Tools → PSRAM para placas ESP32-S3.
  • Confirme se BOARD_SCREEN_COMBO em driver.h corresponde ao seu hardware. O valor errado produz silenciosamente uma tela em branco.
  • Verifique se o sketch de exemplo que você abriu corresponde à sua tela (Básico vs Colorido).

Não é possível fazer upload para a placa​

  • Tente um cabo USB-C diferente (cabo de dados, não apenas de alimentação).
  • Para placas ESP32-S3: mantenha pressionado o botão BOOT antes de conectar o cabo USB para entrar no modo de download e depois solte.
  • Confirme se Tools → Port aponta para o dispositivo serial correto após reconectar.

Para uma solução de problemas mais aprofundada em um produto específico, consulte o cookbook para esse hardware.

Suporte técnico e discussão de produtos​

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...