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):

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 que tenha a coluna Arduino marcada pode seguir este fluxo. 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; voltado principalmente para OpenDisplay (BLE)
XIAO 7.5" ePaper PanelXIAO ESP32-C3Veja o guia dedicado XIAO 7.5" Panel + 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á em 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)
  • XIAO 7.5" ePaper Panel: 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 um refresh parcial; os refreshes seguintes exibem o exemplo completo de Hello World.

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

Seeed_GFX é a biblioteca recomendada, mas se você já tem uma base de código usando GxEPD2, também pode controlar o Seeed ePaper com ela. GxEPD2 é uma biblioteca popular da comunidade que cobre uma ampla gama de displays e-paper.

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 produto 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 trechos 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 incorreto 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, em seguida, solte.
  • Confirme se Tools → Port aponta para o dispositivo serial correto após reconectar.

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

Suporte técnico e discussão sobre 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...