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 admite oficialmente reTerminal E1001, reTerminal E1002, reTerminal E1003, reTerminal E1004, TRMNL 7.5" (OG) DIY Kit y XIAO 7.5" ePaper Panel. Los E1002 y E1004 tienen paneles Spectra™ 6 a todo color, pero el firmware de TRMNL representa su contenido en modo monocromo. El panel táctil capacitivo del E1003 solo está disponible con el firmware SenseCraft HMI; el firmware de 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 de control con 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 de control: 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 E Serie​

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

TRMNL DIY Kit y panel XIAO​

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 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 panel XIAO 7.5" 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 (reTerminal E-Series Firmware Flasher) es exclusivo para reTerminal E Serie. Método 3 (Compilar desde el código fuente) es para usuarios avanzados.

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

Si compraste un kit TRMNL 7.5" (OG) DIY totalmente 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.
  • reTerminal E1004: selecciona reTerminal E1004 en la lista de firmware y usa FW 1.8.10 o posterior.

Método 2: Flashear mediante reTerminal E-Series Firmware Flasher (solo reTerminal E Serie)​

info

Este método es aplicable a reTerminal E1001 / E1002 / E1003 / E1004. (FW 1.8.10 y posteriores).

Prefiere el Método 1 para firmware TRMNL más reciente

El reTerminal E-Series Firmware Flasher proporciona un canal de firmware TRMNL alojado por Seeed para dispositivos reTerminal E Serie. Seeed no actualiza este canal con tanta frecuencia como el TRMNL Web Flasher oficial, y no todas las versiones de firmware TRMNL ascendentes se sincronizan aquí.

Usa primero el Método 1: TRMNL Web Flasher cuando quieras una versión de firmware TRMNL más reciente. Usa este método cuando necesites el flujo de flasheo de reTerminal E Serie alojado por Seeed.

Haz clic para desplegar los pasos de reTerminal E-Series Firmware Flasher

  1. Visita el reTerminal E-Series Firmware Hub. Para una entrada directa de TRMNL en E1004, también puedes abrir el enlace E1004 TRMNL 1.8.10 Hub.

  2. En Select platform, elige la tarjeta TRMNL de la sección de plataformas oficiales.

  3. Selecciona tu dispositivo:

    • reTerminal E1001
    • reTerminal E1002
    • reTerminal E1003
    • reTerminal E1004

  4. En la segunda página, revisa la versión de firmware TRMNL disponible para tu dispositivo seleccionado (para E1004, usa 1.8.10 o posterior).

  5. Conecta tu dispositivo al ordenador con un cable de datos USB.

  6. En Flash to device, selecciona Erase flash + flash para la primera instalación y luego haz clic en Connect & flash.

  7. Elige el puerto serie de tu dispositivo en la ventana del navegador e inicia el proceso de flasheo.

Primer flasheo

Para la primera instalación, selecciona Erase flash + flash para que el dispositivo arranque desde un estado de firmware limpio.

Solo reTerminal E1003

Asegúrate de que el interruptor de encendido esté en 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 activarlo y vuelve a intentarlo.

Comportamiento de pantalla de reTerminal E1002 / E1004

El reTerminal E1002 utiliza una pantalla de papel electrónico a todo color, pero el firmware TRMNL actualmente muestra el contenido del E1002 en modo monocromo. Durante la provisión de Wi-Fi, la pantalla AP del E1002 muestra un diseño compacto con el logotipo TRMNL en la esquina inferior derecha. Cuando veas esta pantalla, busca y conéctate al punto de acceso E1002 y luego continúa con el mismo flujo de configuración Wi-Fi que para los otros dispositivos.

El reTerminal E1004 también utiliza un panel Spectra™ 6 a todo color, pero el firmware TRMNL igualmente muestra su contenido en modo monocromo. Elige reTerminal E1004 en la herramienta de flasheo para que se use el panel correcto.

Cuando el flasheo haya finalizado, continúa con el Paso 4: Conectar el dispositivo a Wi-Fi.

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 las instantáneas de código fuente mantenidas por Seeed en el repositorio OSHW-reTerminal-Series-E-D en su lugar:

    git clone https://github.com/Seeed-Projects/OSHW-reTerminal-Series-E-D.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 muestra el contenido en monocromo en el E1002).
    • Para reTerminal E1003, selecciona el entorno TRMNL_X_E1003 en el repositorio oficial de firmware TRMNL.
    • Para reTerminal E1004, abre el proyecto dedicado de PlatformIO examples/official/TRMNL_E1004 y selecciona el entorno seeed_reTerminal_E1004 (ID de firmware TRMNL_reTerminal_E1004).

  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 solución de problemas de Wi‑Fi del dispositivo TRMNL.

Encender y entrar en modo de aprovisionamiento​

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

Conectarse al Wi‑Fi de 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 (de forma predeterminada 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 la contraseña de tu 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 de usetrmnl.com/flash y comprobar 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: Encontrar la dirección MAC de tu TRMNL.

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 de 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 de TRMNL:

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

El reTerminal E1004 utiliza los botones físicos frontales bajo el firmware de TRMNL. Usa esos botones para activar o refrescar el panel, y desliza el interruptor de encendido a OFF y luego a ON para reiniciar. Para la reconfiguración de Wi‑Fi, sigue el mismo flujo de pulsación larga / aprovisionamiento que se muestra en la pantalla del dispositivo después de un flasheo de fábrica o un restablecimiento de red.

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: organizar la playlist en grupos o añadir 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): configurar las opciones del plugin.
  • Delete (icono X): eliminar el elemento de tu playlist.
  • Preview (icono de ojo): previsualizar cómo se verá la pantalla.
  • Reorder (icono de barras): arrastrar 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 de 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 (FAQ)​

P1: ¿Cómo vuelvo a configurar la red?​

Mantén presionado 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 una advertencia 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 la advertencia 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 la advertencia incluso cuando el hardware está bien.

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

Si estás seguro de que la batería está bien pero la advertencia 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 sus ajustes de Battery.

Paso 3. Activa Hide Low Battery Screen. Esto evita que aparezca en el dispositivo la pantalla de advertencia 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 lista de reproducción.

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

P3: Web Flasher / PlatformIO no puede encontrar 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 presionado 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 / 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, E1003 y E1004), 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 distintas preferencias y necesidades.

Loading Comments...