Trabajar con Arduino

Esta página es el manual de referencia para controlar cualquier producto Seeed ePaper compatible desde el IDE de Arduino. Cubre las partes que son idénticas en todo el hardware:

1. Configurar el IDE de Arduino y el soporte de placas ESP32.
2. Instalar la biblioteca Seeed_GFX, nuestro fork mantenido de TFT_eSPI con soporte de primera clase para Seeed ePaper.
3. Generar un driver.h para tu combinación de placa + pantalla usando la Seeed GFX Configuration Tool.
4. (Opcionalmente) usar la biblioteca de terceros GxEPD2 como controlador alternativo.

Para la guía completa de “abrir la caja, grabar un hello world, encender sensores y botones”, ve al recetario de tu hardware específico; esas páginas reutilizan esta referencia para el código base y luego añaden ejemplos específicos del producto (periféricos, ejemplos de código, resolución de problemas):

• Recetario Arduino de reTerminal E Serie: cubre reTerminal E1001 / E1002 / E1003 / E1004 con ejemplos completos de periféricos (LEDs, zumbador, botones, SHT4x, BMS, microSD, renderizado de imágenes BMP).
• Más recetarios (XIAO Panel de 7,5", placas controladoras EE0x, …) llegarán a medida que los productos correspondientes se añadan a la plataforma.

Si solo necesitas el código base (un Hello World en un producto nuevo que aún no está cubierto por un recetario), esta página por sí sola es suficiente.

Hardware compatible

Cada producto Seeed ePaper en la página principal que tenga marcada la columna Arduino puede seguir este flujo de trabajo. En resumen:

Línea de producto	MCU	Notas
reTerminal E1001 / E1002 / E1003 / E1004	XIAO ESP32-S3 (integrado)	Recetario disponible: ver enlace arriba
EE02 / EE03 / EE04 / EE05	XIAO ESP32-S3 / ESP32-S3 Plus	Usa la Configuration Tool con tu elección de pantalla
EN04 / EN05	XIAO nRF52840 Plus	Elige el paquete de placa nRF52840; principalmente orientado a OpenDisplay (BLE) en su lugar
XIAO 7.5" ePaper Panel	XIAO ESP32-C3	Consulta la guía dedicada XIAO 7.5" Panel + Arduino
TRMNL 7.5" (OG) DIY Kit	XIAO ESP32-S3 Plus	Consulta la guía dedicada TRMNL DIY Kit + Arduino
XIAO eInk Expansion Board v2 / ePaper Breakout Board	Cualquier XIAO que conectes	Usa la Configuration Tool con tu elección de XIAO + pantalla

Paso 1: Configurar el IDE de Arduino

Para controlar cualquier producto Seeed ePaper que funcione en un ESP32 / ESP32-S3 / ESP32-C3 desde Arduino, necesitas el IDE de Arduino más el soporte de placas ESP32.

tip

Si es la primera vez que usas Arduino, consulta primero Getting Started with Arduino.

Paso 1. Descarga e instala el IDE de Arduino.

Download Arduino IDE

Paso 2. Añade el soporte de placas ESP32. En el IDE de Arduino ve a File → Preferences y añade en el campo Additional Boards Manager URLs:

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

Paso 3. Instala el paquete de placas ESP32: Tools → Board → Boards Manager, busca esp32 e instala el paquete de Espressif Systems.

Paso 4. Elige la placa correcta para tu hardware:

• reTerminal E Serie / EE04 con EE04 plus / TRMNL DIY Kit: XIAO_ESP32S3_PLUS
• EE02 / EE03 / EE04 / EE05 estándar / EN04 (ruta Arduino): XIAO_ESP32S3 (o XIAO_nRF52840 para placas basadas en nRF52840)
• XIAO 7.5" ePaper Panel: XIAO_ESP32C3

Si no estás seguro de cuál elegir, el recetario de tu producto te lo indicará.

Paso 5. Conecta tu hardware mediante USB-C y selecciona el puerto correcto en Tools → Port.

Paso 6. Para placas ESP32-S3 (la mayoría de reTerminal E Serie y placas EE0x) habilita la PSRAM:

Tools → PSRAM → OPI PSRAM

Paso 2: Instalar la biblioteca Seeed_GFX

Seeed_GFX es un fork de TFT_eSPI con soporte de primera clase para pantallas Seeed. Es la biblioteca recomendada para toda nuestra línea ePaper.

Paso 1. Descarga la biblioteca Seeed_GFX desde GitHub:

Download the Library

Paso 2. Sketch → Include Library → Add .ZIP Library y selecciona el ZIP descargado.

nota

Si instalaste previamente TFT_eSPI, elimínala temporalmente o cámbiale el nombre en la carpeta de bibliotecas de Arduino para evitar conflictos.

Paso 3: Generar driver.h para tu hardware

Cada sketch de ejemplo en Seeed_GFX busca un driver.h local en la carpeta del sketch. Ese encabezado le indica a la biblioteca qué placa, controlador de pantalla y asignación de pines usar. La Configuration Tool lo genera por ti.

Paso 1. Elige un sketch de ejemplo:

• Pantallas monocromas: File → Examples → Seeed_GFX → ePaper → Basic → HelloWorld
• Pantallas en color: File → Examples → Seeed_GFX → ePaper → Colorful → HelloWorld

Paso 2. En la misma carpeta del sketch, crea un archivo nuevo llamado driver.h (usa la flecha de nueva pestaña en el IDE de Arduino).

Paso 3. Abre la Seeed GFX Configuration Tool y elige tu hardware. Cada dispositivo preconfigurado produce el valor correcto de BOARD_SCREEN_COMBO (y cualquier define adicional, por ejemplo USE_XIAO_EPAPER_DISPLAY_BOARD_EE04).

Paso 4. Copia el contenido generado y pégalo en tu driver.h. Valores habituales:

reTerminal E1001

#define BOARD_SCREEN_COMBO 520 // reTerminal E1001 (UC8179)

reTerminal E1002

#define BOARD_SCREEN_COMBO 521 // reTerminal E1002 (UC8179C)

reTerminal E1003

#define BOARD_SCREEN_COMBO 522 // reTerminal E1003 (ED103TC2)

reTerminal E1004

#define BOARD_SCREEN_COMBO 523 // reTerminal E1004 (T133A01)

EE04 + 5.83" mono

#define BOARD_SCREEN_COMBO 503 // 5.83 inch monochrome ePaper Screen (UC8179)
#define USE_XIAO_EPAPER_DISPLAY_BOARD_EE04

Para cualquier otra combinación, confía siempre en la salida de la Configuration Tool: elige tu placa XIAO (o None si es un kit integrado reTerminal/EN04) más la pantalla que tengas conectada.

Paso 5. Sube el sketch a tu hardware. En el primer encendido puede aparecer una actualización parcial; las actualizaciones posteriores mostrarán el ejemplo completo de Hello World.

Paso 4 (opcional): Usar GxEPD2 en su lugar

Seeed_GFX es la biblioteca recomendada, pero si ya tienes una base de código basada en GxEPD2, también puedes controlar Seeed ePaper con ella. GxEPD2 es una biblioteca popular de la comunidad que cubre una amplia gama de pantallas de tinta electrónica.

Para instalarla manualmente desde GitHub y obtener el soporte más reciente de dispositivos:

Download the Library

Sketch → Include Library → Add .ZIP Library y selecciona el ZIP descargado. Los recetarios de producto incluyen ejemplos concretos de GxEPD2 cuando corresponde (por ejemplo, el recetario reTerminal E Serie muestra renderizado a todo color en la E1002).

Próximos pasos: Recetarios

Esta página se detiene intencionadamente en el código base. Los ejemplos de código específicos de hardware y las guías completas de principio a fin se encuentran en el recetario de cada producto:

• Recetario Arduino de reTerminal E Serie: Hello World en E1001/E1002/E1003/E1004, más el conjunto completo de periféricos: control de LED, zumbador (pitidos PWM pasivos + reproducción de melodías), entrada de 3 botones, temperatura/humedad SHT4x, gestión de batería, tarjeta microSD, renderizado de imágenes BMP desde SD.
• XIAO 7.5" ePaper Panel + Arduino: guía paso a paso con XIAO ESP32-C3 usando Seeed_GFX.
• TRMNL 7.5" DIY Kit + Arduino: uso del hardware del kit en sketches personalizados de Arduino (en lugar de la plataforma en la nube TRMNL).

Cuando se envíen nuevos productos ePaper, se añadirá el recetario correspondiente en la carpeta de cada producto; esta página principal se actualizará para enlazarlo.

Problemas comunes

La pantalla no muestra nada o no se actualiza

• Lo más frecuente es que el cable FPC del ePaper esté suelto o al revés. Vuelve a colocarlo con los contactos metálicos hacia arriba.
• Comprueba que OPI PSRAM esté habilitado en Tools → PSRAM para placas ESP32-S3.
• Confirma que BOARD_SCREEN_COMBO en driver.h coincida con tu hardware. Un valor incorrecto produce silenciosamente una pantalla en blanco.
• Verifica que el ejemplo que abriste coincida con tu pantalla (Básica vs Colorida).

No se puede cargar el programa en la placa

• Prueba con otro cable USB-C (de datos, no solo de alimentación).
• Para placas ESP32-S3: mantén pulsado el botón BOOT antes de conectar el cable USB para entrar en modo de descarga y luego suéltalo.
• Confirma que Tools → Port apunte al dispositivo serie correcto después de volver a conectar.

Para una solución de problemas más profunda en un producto específico, consulta el cookbook de ese hardware.

Soporte técnico y debate sobre productos

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 distintas preferencias y necesidades.