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 todos os hardwares:

  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á para o 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, exemplos de código, solução de problemas):

  • reTerminal E Series Arduino cookbook — cobre reTerminal E1001 / E1002 / E1003 / E1004 com exemplos completos de periféricos (LEDs, buzzer, botões, SHT4x, BMS, microSD, renderização de imagem BMP).
  • Mais cookbooks (Painel XIAO 7,5", placas driver EE0x, …) serão adicionados à medida que 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 tela de sua escolha
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
Kit DIY TRMNL 7,5" (OG)XIAO ESP32-S3 PlusVeja o guia dedicado Kit DIY TRMNL + Arduino
Placa de Expansão XIAO eInk v2 / Placa Breakout ePaperQualquer XIAO que você conectarUse a Configuration Tool com sua escolha 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 / Kit DIY TRMNL: 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 dos 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 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 seu hardware. Cada dispositivo pré-configurado produz o valor correto de BOARD_SCREEN_COMBO (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 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 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 e-paper.

Para instalá-la manualmente a partir do GitHub para obter 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 tutoriais ponta a ponta ficam no cookbook de cada produto:

  • reTerminal E Series Arduino cookbook — Hello World no E1001/E1002/E1003/E1004, além do conjunto completo de periféricos: controle de LED, buzzer (bipes PWM passivos + reprodução de melodia), entrada de 3 botões, temperatura/umidade SHT4x, gerenciamento de bateria, cartão microSD, renderização de imagem BMP a partir do SD.
  • Painel ePaper XIAO 7,5" + Arduino — passo a passo com XIAO ESP32-C3 usando Seeed_GFX.
  • Kit DIY TRMNL 7,5" + Arduino — usando o hardware do kit em sketches Arduino personalizados (em vez da plataforma em nuvem TRMNL).

Quando novos produtos ePaper forem lançados, o cookbook correspondente será adicionado na pasta de cada produto; esta página principal será 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 invertido. 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 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...