Saltar al contenido principal

Trabajar con TRMNL

Esta guía es la única fuente de referencia para usar TRMNL con cualquier producto Seeed ePaper compatible. Elige tu hardware una vez en cada paso que lo requiera, y el resto del flujo de trabajo será idéntico.

Compatibilidad de hardware

TRMNL es compatible oficialmente con reTerminal E1001, reTerminal E1002, TRMNL 7.5" (OG) DIY Kit y XIAO 7.5" ePaper Panel. En el E1002 el contenido se muestra actualmente en modo monocromo — la representación a todo color está prevista para una versión futura.

¿Qué es TRMNL?​

TRMNL es una plataforma innovadora diseñada para ayudar a las personas a mantenerse concentradas y tranquilas en nuestro mundo digital cada vez más distractor. Fundada en 2023, TRMNL se ha convertido rápidamente en una solución líder para la gestión de paneles E Ink®, ofreciendo un enfoque único para mostrar información sin las notificaciones constantes y distracciones de las pantallas tradicionales.

En esencia, TRMNL se basa en la filosofía de que la tecnología debe mejorar nuestras vidas sin exigir atención constante. La plataforma proporciona una forma elegante de ver información importante de un vistazo a través de pantallas E Ink®, creando una experiencia tecnológica más consciente y menos intrusiva.

¿Por qué usar TRMNL?​

  • Creación de paneles simplificada: La creciente biblioteca de aplicaciones e integraciones de TRMNL facilita la creación de pantallas de información personalizadas sin programación compleja.
  • Bajo consumo de energía: El software eficiente de TRMNL combinado con los requisitos mínimos de energía de E Ink® crea una solución extremadamente eficiente energéticamente.
  • Información sin distracciones: Obtén la información que necesitas sin notificaciones ni fatiga visual.
  • Actualizaciones periódicas: El desarrollo activo de TRMNL significa que se añaden nuevas funciones e integraciones cada semana.
  • Amigable para desarrolladores: La API abierta y las herramientas para desarrolladores de TRMNL permiten complementos e integraciones personalizadas.

Hardware compatible​

reTerminal E1001reTerminal E1002TRMNL 7.5" (OG) DIY KitXIAO 7.5" ePaper Panel
7.5" monocromo
Terminal integrado		7.3" Spectra 6 (color)
Terminal integrado
Modo mono en TRMNL		7.5" mono + carcasa DIY
Controlador XIAO ESP32-S3 Plus		Panel desnudo 7.5" mono
XIAO ESP32-C3 directamente
Consigue uno ahora 🖱️
Consigue uno ahora 🖱️
Consigue uno ahora 🖱️
Consigue uno ahora 🖱️

Paso 1: Configuración de la cuenta TRMNL y acceso BYOD​

Antes de conectar tu dispositivo a TRMNL necesitas una cuenta TRMNL y acceso BYOD (Bring Your Own Device) — el mismo flujo independientemente del hardware.

  1. Comprar acceso a TRMNL

  2. Crear una cuenta TRMNL

    • Visita el sitio web de TRMNL
    • Haz clic en "Sign Up" para crear una nueva cuenta.
    • Sigue el proceso de registro.
nota

Tus credenciales de TRMNL son información sensible. Nunca las compartas públicamente ni las subas a sistemas de control de versiones.

Si encuentras algún problema, contacta directamente con el equipo de TRMNL en [email protected].

Paso 2: Configuración del hardware​

La reTerminal E Serie y el XIAO 7.5" Panel vienen preensamblados — solo necesitas encenderlos. El TRMNL DIY Kit requiere montaje.

La reTerminal E Serie está totalmente integrada. Solo conecta el cable USB-C y enciéndela. No se necesitan pasos de montaje.

Paso 3: Grabar el firmware de TRMNL​

Hay tres métodos de grabación disponibles. Método 1 (Web Flasher) es el más sencillo y funciona para todo el hardware compatible. Método 2 (SenseCraft HMI) es exclusivo para reTerminal E Serie. Método 3 (Compilar desde el código fuente) es para usuarios avanzados.

Los kits TRMNL DIY completamente nuevos ya se envían con el firmware TRMNL

Si compraste un kit TRMNL 7.5" (OG) DIY completamente nuevo, ya tiene el firmware TRMNL preinstalado: puedes omitir por completo el paso de flasheo e ir directamente al Paso 4.

Método 1: TRMNL Web Flasher (recomendado)​

El TRMNL Web Flasher funciona directamente en el navegador y es compatible con todos los dispositivos de esta página.

  1. Visita https://usetrmnl.com/flash.
  2. Conecta tu dispositivo mediante USB-C y sigue las instrucciones en pantalla.
  3. Elige el firmware que coincida con tu hardware:

Usa FW 1.6.7 o posterior para la compatibilidad con Seeed en reTerminal E Serie.

Método 2: Flashear mediante la plataforma SenseCraft HMI (solo reTerminal E Serie)​

info

Este método solo es aplicable a reTerminal E1001 / E1002. El flasher de SenseCraft HMI sabe cómo cambiar entre el firmware SenseCraft HMI y el firmware TRMNL en el mismo dispositivo.

  1. Visita la página de dispositivos SenseCraft HMI.

  2. Selecciona tu dispositivo.

  3. Elige el firmware TRMNL (más tarde podrás volver al firmware HMI aquí). Haz clic en Full Flash y luego en Flash.

  4. Conecta tu dispositivo al ordenador y selecciona el puerto serie.

  5. La pantalla se actualizará y mostrará el logotipo de TRMNL y la dirección MAC.

Método 3: Compilar y flashear desde el código fuente (avanzado)​

  1. Clona el repositorio de firmware

    tip

    A veces nuestros PR al upstream de TRMNL siguen en revisión. Si quieres los últimos parches del lado de Seeed, usa en su lugar el mirror de Seeed:

    git clone https://github.com/Seeed-Projects/Seeed_TRMNL_Eink_Project.git

  2. Instala PlatformIO como extensión de VS Code o mediante la línea de comandos.

  3. Abre el proyecto: abre la carpeta firmware clonada en VS Code.

  4. Selecciona el entorno correcto de PlatformIO para tu hardware:

    En platformio.ini:

    • Para reTerminal E1001, selecciona el entorno seeed_reTerminal_E1001.
    • Para reTerminal E1002, selecciona el entorno seeed_reTerminal_E1002 (TRMNL representa el contenido en monocromo en la E1002).

  5. Conecta tu dispositivo mediante USB-C.

  6. Compila y sube: haz clic en el botón Upload de PlatformIO o ejecuta:

    pio run --target upload

Paso 4: Configurar Wi-Fi y aprovisionar el dispositivo​

El flujo de trabajo de aprovisionamiento Wi-Fi es idéntico para todo el hardware compatible.

💡 ¿Problemas para conectar el Wi-Fi? Consulta la guía de solución de problemas de Wi-Fi del dispositivo TRMNL.

Enciende y entra en modo de aprovisionamiento​

Después de flashear el firmware TRMNL y encender tu dispositivo, entrará automáticamente en modo de aprovisionamiento si aún no está conectado a Wi-Fi.

Conéctate al Wi-Fi TRMNL​

En tu teléfono u ordenador, abre la lista de redes Wi-Fi disponibles. Busca una red llamada TRMNL y conéctate a ella (por defecto no se requiere contraseña).

Abre el portal cautivo​

Una vez conectado, abre un navegador web. El dispositivo debería redirigirte automáticamente a la página de configuración de TRMNL; si no lo hace, visita manualmente http://4.3.2.1.

Introduce tus credenciales Wi-Fi​

  • Selecciona tu red Wi-Fi de 2,4 GHz (las redes de 5 GHz no son compatibles).
  • Introduce tu contraseña Wi-Fi y haz clic en Save / Connect.

⚠️ Importante: asegúrate de usar una red Wi-Fi de 2,4 GHz. Los chips ESP32-C3 / ESP32-S3 de estos dispositivos no son compatibles con redes de 5 GHz.

El dispositivo se une a tu red​

El dispositivo se desconectará del Wi-Fi TRMNL y se unirá a tu red doméstica. La ventana del portal cautivo mostrará la dirección MAC del dispositivo. Anota la dirección MAC: la necesitarás en el siguiente paso.

⚠️ Nota: la dirección MAC solo es visible en el portal cautivo durante 1–2 segundos. Si te la pierdes también puedes:

  • Recuperarla desde los registros de compilación/subida de VS Code → PlatformIO.
  • Usar el método usetrmnl.com/flash y revisar la consola de desarrollador del navegador durante el flasheo.
  • Encontrarla en la lista de dispositivos conectados de tu router o de la app de tu red mallada.

Consulta la guía oficial: Finding your TRMNL MAC address.

Paso 5: Registrar el dispositivo en TRMNL​

Después de que tu dispositivo esté conectado a Wi-Fi y tengas su dirección MAC, regístralo en la interfaz web de TRMNL:

  1. Abre la interfaz web de TRMNL en https://trmnl.app.

  2. Ve a la página Devices.

  3. Añade un nuevo dispositivo (botón en la parte superior derecha o en el centro de la página).

  4. Introduce el Device ID que recibiste cuando compraste el acceso BYOD (este no es la dirección MAC: busca el Device ID en el correo de confirmación de compra o en el panel de TRMNL). Haz clic en Add new device.

  5. Vincula la dirección MAC del dispositivo en la página de configuración del dispositivo:

    Aquí también puedes establecer un nombre personalizado y ajustar otros parámetros.

¡Tu dispositivo ahora está vinculado a tu cuenta TRMNL! Ahora puedes enviar listas de reproducción, imágenes y otros contenidos directamente desde la interfaz TRMNL.

💡 Consejo: si tienes varios dispositivos, repite los pasos anteriores para cada uno usando sus Device ID únicos.

Desactivar Firmware Early Release y actualizaciones OTA

Después de añadir tu dispositivo en la interfaz web de TRMNL, ve a la página de configuración del dispositivo y desactiva tanto Firmware Early Release como OTA Updates Enabled.

Si se dejan activadas, tu dispositivo puede descargar automáticamente actualizaciones de firmware destinadas al hardware oficial de TRMNL que no son compatibles con los dispositivos de Seeed. Instalar firmware incompatible puede hacer que tu dispositivo funcione mal o deje de responder.

Mantén siempre ambas opciones desactivadas para garantizar un funcionamiento estable.

Uso de los botones​

La reTerminal E Serie expone un único botón orientado al usuario bajo el firmware TRMNL:

  • Botón verde — pulsación larga 5 s: entra en modo de reconfiguración de Wi‑Fi.
  • Botón de reinicio: un solo clic para reiniciar el dispositivo.

Comprender la Playlist de TRMNL​

La Playlist de TRMNL controla exactamente qué se muestra en tu dispositivo de ePaper y cuándo.

Visión general de la Playlist​

  • Título de la Playlist: el nombre de tu dispositivo TRMNL.
  • Intervalo de tiempo de visualización: cuándo está activa la playlist (p. ej. 00:00–23:45).
  • Intervalo de actualización: con qué frecuencia se actualiza la pantalla (p. ej. cada 5 minutos).
  • Add a Group / Add a Plugin: organiza la playlist en grupos o añade nuevos plugins de contenido.

Elementos de la Playlist​

Cada fila es una pantalla o widget que se mostrará en tu dispositivo. Ejemplos:

  1. Weather — información meteorológica actual de tu ubicación.
  2. Days Left This Year — cuenta atrás de los días restantes del año en curso.
  3. Custom Text — muestra cualquier mensaje personalizado (p. ej. "Hello World").

Para cada elemento:

  • Settings (icono de engranaje): configura las opciones del plugin.
  • Delete (icono X): elimina el elemento de tu playlist.
  • Preview (icono de ojo): previsualiza cómo se verá la pantalla.
  • Reorder (icono de barras): arrastra para cambiar el orden.

Smart Playlist​

En la parte inferior puedes elegir si quieres omitir automáticamente las pantallas cuyo contenido no haya cambiado. Consulta la entrada del blog sobre Smart Playlists para más detalles.

Explorando los plugins de TRMNL​

Los plugins son bloques de contenido modulares que pueden mostrar el tiempo, eventos de calendario, precios de acciones, fuentes RSS, frases motivacionales, actividad de GitHub y mucho más.

Plugins conectados​

En la parte superior de la página de Plugins ves todos los plugins ya conectados a tu cuenta TRMNL. Algunos ejemplos son Weather, Days Left This Year, Stock Price, RSS Feed, Reddit, Hacker News, Language Learning, Motivational Quote, Custom Text, …

Marketplace de plugins​

Debajo de tus plugins conectados encontrarás el marketplace. Los plugins están organizados por categorías y etiquetas (#productivity, #news, #ecommerce, …). Navega, busca y haz clic en cualquier plugin para conectarlo a tu cuenta.

Los desarrolladores también pueden crear y publicar sus propios plugins — consulta la documentación del marketplace de plugins para más detalles.

Para funciones más avanzadas, consulta la documentación oficial de TRMNL: https://docs.usetrmnl.com/go.

Solución de problemas​

¿Cómo reconfigurar la red?​

Mantén pulsado el Botón verde durante 5 segundos. El dispositivo volverá a la interfaz inicial de TRMNL y activará el AP.

Web Flasher / PlatformIO no encuentra el dispositivo o la carga falla​

A veces, el programa incorrecto puede hacer que la XIAO pierda su puerto o no funcione correctamente:

  • La XIAO está conectada pero no se encuentra ningún número de puerto.
  • La XIAO está conectada, el puerto aparece, pero la carga falla.

Pon la XIAO en modo BootLoader para recuperarla:

  • Paso 1: mantén pulsado el botón BOOT en la XIAO ESP32-S3 / ESP32-C3 sin soltarlo.
  • Paso 2: mientras sigues manteniendo BOOT, conecta el dispositivo al ordenador mediante USB-C. Suelta BOOT después de que el dispositivo esté conectado.
  • Paso 3: vuelve a ejecutar la carga / el flasheo. La mayoría de los problemas de "dispositivo no reconocido" o "carga fallida" se resuelven así.

Agradecimientos especiales​

Agradecimientos especiales a todo el equipo de TRMNL por su sólido apoyo y ayuda inestimable a lo largo de esta integración. En particular queremos agradecer a Bogdan, Ryan Kulp, Fr3d, Schappi y a todos los demás miembros del equipo por su dedicación durante el desarrollo y la documentación.

Su experiencia hizo posible esta integración y mejoró enormemente la experiencia para las comunidades de reTerminal E Serie, TRMNL DIY Kit y XIAO 7.5" ePaper Panel.

Recursos​

Soporte técnico y debate sobre el producto​

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