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 es idéntico.

Compatibilidad de hardware

TRMNL admite oficialmente reTerminal E1001, reTerminal E1002, reTerminal E1003, TRMNL 7.5" (OG) DIY Kit y XIAO 7.5" ePaper Panel. En el E1002 el contenido se representa actualmente en modo monocromo; la representación a todo color está prevista para una versión futura. El panel táctil capacitivo del E1003 solo está disponible con el firmware SenseCraft HMI; el firmware TRMNL utiliza los botones físicos del dispositivo.

¿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 simplificada de paneles: 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 plugins e integraciones personalizadas.

Hardware compatible​

reTerminal E Serie​

reTerminal E1001reTerminal E1002reTerminal E1003
7.5" monocromo
Terminal integrado		7.3" Spectra 6 (color)
Terminal integrado
Modo mono en TRMNL		10.3" monocromo
Escala de grises de 16 niveles
Terminal integrado
Consigue uno ahora 🖱️
Consigue uno ahora 🖱️
Consigue uno ahora 🖱️

TRMNL DIY Kit y XIAO Panel​

TRMNL 7.5" (OG) DIY KitXIAO 7.5" ePaper Panel
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 🖱️

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 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 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. Simplemente conecta el cable USB-C, desliza el interruptor de encendido a ON y enciéndela. No se necesitan pasos de montaje.

Solo reTerminal E1003

Si el dispositivo está en reposo y no responde, pulsa el botón Refresh en la parte superior de la unidad para despertarlo antes de conectar el USB o entrar en modo de flasheo.

Paso 3: Flashear el firmware de TRMNL​

Hay disponibles tres métodos de flasheo. 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 y pasar 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:
  • reTerminal E1001 / E1002: usa FW 1.6.7 o posterior para compatibilidad con Seeed.
  • reTerminal E1003: selecciona reTerminal E1003 en la lista de firmware y usa FW 1.8.7 o posterior.

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

info

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

Prefiere el Método 1: solo firmware antiguo probado por Seeed

El flasher SenseCraft HMI distribuye una compilación TRMNL fija y antigua que Seeed ha verificado en el hardware reTerminal. Seeed no sincroniza continuamente cada nuevo lanzamiento de TRMNL en este canal.

Usa primero el Método 1: TRMNL Web Flasher; es la forma más sencilla de obtener el firmware más reciente compatible con Seeed. Recurre a este método SenseCraft HMI solo si el Web Flasher falla o no puedes completar un flasheo a través del navegador.

Después de que tu dispositivo esté registrado en TRMNL, abre la configuración del dispositivo en la interfaz web de TRMNL y desactiva tanto Firmware Early Release como OTA Updates Enabled para que el dispositivo no se actualice automáticamente a un firmware que pueda no coincidir con tu hardware Seeed. Consulta el Paso 5 para más detalles.

Haz clic para desplegar los pasos de flasheo con SenseCraft HMI

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

  2. Selecciona tu dispositivo.

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

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

    Solo reTerminal E1003

    Asegúrate de que el interruptor de encendido esté ON. Si el dispositivo está en reposo y el flasheo no comienza, pulsa el botón Refresh en la parte superior de la unidad para despertarlo y vuelve a intentarlo.

  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 aún están 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 una 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).
    • Para reTerminal E1003, selecciona el entorno TRMNL_X_E1003 en el repositorio oficial de firmware TRMNL.

  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 de Wi-Fi es idéntico para todo el hardware compatible.

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

Encender e ingresar al 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.

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

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

Introducir tus credenciales de Wi-Fi​

  • Selecciona tu red Wi-Fi de 2,4 GHz (las redes de 5 GHz no son compatibles).
  • Introduce tu contraseña de 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 de 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/carga 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 (esto no es la dirección MAC — encuentra 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 de TRMNL.

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

Desactivar Firmware Early Release y OTA Updates

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​

Los reTerminal E1001 y E1002 exponen un único botón orientado al usuario bajo el firmware TRMNL:

  • Botón verde — pulsación larga 5 s: entrar en modo de reconfiguración de Wi-Fi.
  • Botón Reset: clic único 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​

  • Playlist Title: el nombre de tu dispositivo TRMNL.
  • Display Time Range: cuándo está activa la playlist (p. ej. 00:00–23:45).
  • Update Interval: 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 en el año actual.
  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 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.

Preguntas frecuentes​

P1: ¿Cómo reconfiguro 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.

P2: ¿Qué debo hacer si la pantalla siempre muestra un aviso de batería baja?​

Dos situaciones diferentes pueden activar esta pantalla:

  1. El voltaje de la batería es realmente bajo. Este es el caso más común — el dispositivo realmente necesita cargarse. Conéctalo o sustituye/carga la batería y el aviso debería desaparecer una vez que el voltaje se recupere.

  2. Un problema del lado del servidor de TRMNL. El nivel de batería se evalúa en los servidores de TRMNL, no solo en el dispositivo. Un error del servidor o una actualización reciente de la plataforma puede informar temporalmente mal el estado de la batería y seguir mostrando el aviso incluso cuando el hardware está bien.

Si la batería está realmente baja, carga primero el dispositivo — no ocultes el aviso hasta que hayas confirmado que el paquete está en buen estado.

Si estás seguro de que la batería está bien pero el aviso no desaparece, no necesitas modificar el firmware. TRMNL te permite suprimir el aviso en pantalla desde el panel web:

Paso 1. Abre la interfaz web de TRMNL y ve a Devices.

Paso 2. Selecciona el dispositivo afectado y abre su configuración de Battery.

Paso 3. Activa Hide Low Battery Screen. Esto evita que aparezca en el dispositivo la pantalla de aviso de batería baja mientras se recupera la detección de batería del lado del servidor de TRMNL, o cuando necesitas que la pantalla permanezca en tu playlist.

Paso 4. (Opcional) Deja activada Low Battery Email Notification si aún quieres alertas por correo electrónico sin interrumpir la pantalla.

P3: Web Flasher / PlatformIO no puede encontrar el dispositivo o la carga falla​

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

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

Pon el XIAO en modo BootLoader para recuperarlo:

  • Paso 1: mantén presionado el botón BOOT en el XIAO ESP32-S3 / ESP32-C3 sin soltarlo.
  • Paso 2: mientras sigues presionando 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 con esto.

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 todo 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 (E1001, E1002 y E1003), TRMNL DIY Kit y XIAO Panel ePaper de 7,5".

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