Saltar al contenido principal

Trabajar con Arduino

Prueba demos sin configurar un entorno de desarrollo

Si quieres previsualizar rápidamente los resultados del proyecto o probar el firmware demo básico antes de configurar un entorno de desarrollo, abre el reTerminal E-Series Firmware Hub. Puedes elegir un dispositivo reTerminal E Serie compatible y flashear firmware de demostración directamente desde un navegador.

Firmware Flasher 🖱️

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

Si solo necesitas el código base (un Hello World en un producto completamente 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 productoMCUNotas
reTerminal E1001 / E1002 / E1003 / E1004XIAO ESP32-S3 (integrado)Recetario disponible: consulta el enlace anterior
EE02 / EE03 / EE04 / EE05XIAO ESP32-S3 / ESP32-S3 PlusUsa la Configuration Tool con tu elección de pantalla
EN04 / EN05XIAO nRF52840 PlusElige el paquete de placa nRF52840; principalmente orientado a OpenDisplay (BLE) en su lugar
Panel ePaper XIAO de 7,5"XIAO ESP32-C3Consulta la guía dedicada del Panel XIAO de 7,5" + Arduino
Kit DIY TRMNL 7,5" (OG)XIAO ESP32-S3 PlusConsulta la guía dedicada del Kit DIY TRMNL + Arduino
Placa de expansión XIAO eInk v2 / Placa breakout ePaperCualquier XIAO que conectesUsa 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 / Kit DIY TRMNL: XIAO_ESP32S3_PLUS
  • EE02 / EE03 / EE04 / EE05 estándar / EN04 (ruta Arduino): XIAO_ESP32S3 (o XIAO_nRF52840 para placas basadas en nRF52840)
  • Panel ePaper XIAO de 7,5": 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 archivo de cabecera 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 nuevo archivo 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 definición extra, por ejemplo USE_XIAO_EPAPER_DISPLAY_BOARD_EE04).

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

#define BOARD_SCREEN_COMBO 520 // reTerminal E1001 (UC8179)

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 comunitaria popular 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 libros de recetas del producto incluyen ejemplos concretos de GxEPD2 cuando corresponde (por ejemplo, el libro de recetas de reTerminal E Serie muestra renderizado a todo color en la E1002).

Próximos pasos — Libros de recetas​

Esta página se detiene intencionalmente en el código base. Los ejemplos de código específicos de hardware y los recorridos de extremo a extremo se encuentran en el libro de recetas de cada producto:

Cuando se envían nuevos productos ePaper, el libro de recetas correspondiente se añade en la carpeta de cada producto; esta página principal se actualiza para enlazarlo.

Problemas comunes​

La pantalla no muestra nada o no se actualiza​

  • La mayoría de las veces 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 sketch de ejemplo que abriste coincida con tu pantalla (Básica vs Colorida).

No se puede subir el programa a la placa​

  • Prueba con otro cable USB-C (cable de datos, no solo de alimentación).
  • Para placas ESP32-S3: mantén presionado 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 resolución de problemas más profunda en un producto específico, consulta el libro de recetas para 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 diferentes preferencias y necesidades.

Loading Comments...