Pular para o conteúdo principal

Trabalhar com TRMNL

Este guia é a única fonte de verdade para usar o TRMNL com qualquer produto Seeed ePaper compatível. Escolha seu hardware uma vez em cada etapa que precisar, e o restante do fluxo de trabalho será idêntico.

Suporte de hardware

O TRMNL oferece suporte oficial ao reTerminal E1001, reTerminal E1002, reTerminal E1003, TRMNL 7.5" (OG) DIY Kit e XIAO 7.5" ePaper Panel. No E1002 o conteúdo é atualmente renderizado em modo monocromático — a renderização em cores completas está planejada para uma versão futura. O painel de toque capacitivo do E1003 está disponível apenas com o firmware SenseCraft HMI; o firmware TRMNL usa os botões físicos do dispositivo.

O que é o TRMNL?​

TRMNL é uma plataforma inovadora projetada para ajudar as pessoas a se manterem focadas e calmas em nosso mundo digital cada vez mais distraído. Fundado em 2023, o TRMNL rapidamente se tornou uma solução líder para gerenciamento de dashboards em E Ink®, oferecendo uma abordagem única para exibir informações sem as notificações constantes e distrações das telas tradicionais.

Em sua essência, o TRMNL é construído sobre a filosofia de que a tecnologia deve melhorar nossas vidas sem exigir atenção constante. A plataforma oferece uma maneira elegante de visualizar informações importantes de relance por meio de displays E Ink®, criando uma experiência tecnológica mais consciente e menos intrusiva.

Por que usar o TRMNL?​

  • Criação simplificada de dashboards: A crescente biblioteca de aplicativos e integrações do TRMNL torna fácil criar telas de informação personalizadas sem programação complexa.
  • Baixo consumo de energia: O software eficiente do TRMNL combinado com os requisitos mínimos de energia do E Ink® cria uma solução extremamente eficiente em termos de energia.
  • Informação sem distrações: Obtenha as informações de que você precisa sem notificações e sem fadiga visual.
  • Atualizações regulares: O desenvolvimento ativo do TRMNL significa que novos recursos e integrações são adicionados semanalmente.
  • Amigável para desenvolvedores: A API aberta e as ferramentas para desenvolvedores do TRMNL permitem plugins e integrações personalizados.

Hardware compatível​

reTerminal E Series​

reTerminal E1001reTerminal E1002reTerminal E1003
7,5" Monocromático
Terminal integrado		7,3" Spectra 6 (Colorido)
Terminal integrado
Modo mono no TRMNL		10,3" Monocromático
Escala de cinza de 16 níveis
Terminal integrado
Adquira agora 🖱️
Adquira agora 🖱️
Adquira agora 🖱️

TRMNL DIY Kit & XIAO Panel​

TRMNL 7.5" (OG) DIY KitXIAO 7.5" ePaper Panel
7,5" Mono + case DIY
Driver XIAO ESP32-S3 Plus		Painel nu 7,5" Mono
XIAO ESP32-C3 diretamente
Adquira agora 🖱️
Adquira agora 🖱️

Etapa 1: Configuração da conta TRMNL e acesso BYOD​

Antes de conectar seu dispositivo ao TRMNL, você precisa de uma conta TRMNL e acesso BYOD (Bring Your Own Device) — o mesmo fluxo independentemente do hardware.

  1. Comprar acesso ao TRMNL

  2. Criar uma conta TRMNL

    • Visite o site do TRMNL
    • Clique em "Sign Up" para criar uma nova conta.
    • Siga o processo de registro.
nota

Suas credenciais TRMNL são informações sensíveis. Nunca as compartilhe publicamente nem as envie para sistemas de controle de versão.

Se você encontrar qualquer problema, entre em contato diretamente com a equipe TRMNL em [email protected].

Etapa 2: Configuração de hardware​

O reTerminal E Series e o XIAO 7.5" Panel vêm pré-montados — você só precisa ligá-los. O TRMNL DIY Kit requer montagem.

O reTerminal E Series é totalmente integrado. Basta conectar o cabo USB-C, deslizar a chave de energia para ON e ligá-lo. Nenhuma etapa de montagem é necessária.

Apenas reTerminal E1003

Se o dispositivo estiver em modo de espera e não responder, pressione o botão Refresh na parte superior da unidade para despertá-lo antes de conectar o USB ou entrar no modo de gravação.

Etapa 3: Gravar o firmware TRMNL​

Três métodos de gravação estão disponíveis. Método 1 (Web Flasher) é o mais fácil e funciona para todo o hardware compatível. Método 2 (reTerminal E-Series Firmware Flasher) é exclusivo para reTerminal E Series. Método 3 (Compilar a partir do código-fonte) é para usuários avançados.

Kits TRMNL DIY novos já são enviados com firmware TRMNL

Se você comprou um kit TRMNL 7.5" (OG) DIY novo, ele já vem com o firmware TRMNL pré-instalado — você pode pular totalmente a etapa de gravação e ir direto para a Etapa 4.

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

O TRMNL Web Flasher funciona diretamente no navegador e é compatível com todos os dispositivos desta página.

  1. Acesse https://usetrmnl.com/flash.
  2. Conecte seu dispositivo via USB-C e siga as instruções na tela.
  3. Escolha o firmware que corresponde ao seu hardware:
  • reTerminal E1001 / E1002: use FW 1.6.7 ou mais recente para compatibilidade com a Seeed.
  • reTerminal E1003: selecione reTerminal E1003 na lista de firmware e use FW 1.8.7 ou mais recente.

Método 2: Gravar via reTerminal E-Series Firmware Flasher (apenas reTerminal E Series)​

info

Este método é aplicável apenas ao reTerminal E1001 / E1002 / E1003. O reTerminal E-Series Firmware Flasher fornece pacotes de firmware TRMNL para esses três dispositivos reTerminal E Series.

Prefira o Método 1 para firmware TRMNL mais recente

O reTerminal E-Series Firmware Flasher fornece um canal de firmware TRMNL hospedado pela Seeed para dispositivos reTerminal E Series. A Seeed não atualiza esse canal com a mesma frequência que o TRMNL Web Flasher oficial, e nem todos os lançamentos de firmware TRMNL upstream são sincronizados aqui.

Use primeiro o Método 1: TRMNL Web Flasher quando quiser uma versão mais recente do firmware TRMNL. Use este método quando você precisar do fluxo de gravação do reTerminal E Series hospedado pela Seeed.

Clique para expandir as etapas do reTerminal E-Series Firmware Flasher

  1. Acesse o reTerminal E-Series Firmware Flasher.

  2. Em Select platform, escolha o cartão TRMNL na seção de plataformas oficiais.

  3. Selecione seu dispositivo:

    • reTerminal E1001
    • reTerminal E1002
    • reTerminal E1003

  4. Na segunda página, revise a versão de firmware TRMNL disponível para o dispositivo selecionado.

  5. Conecte seu dispositivo ao computador com um cabo de dados USB.

  6. Em Flash to device, selecione Erase flash + flash para a primeira instalação e clique em Connect & flash.

  7. Escolha a porta serial do seu dispositivo na janela do navegador e inicie o processo de gravação.

Primeira gravação

Para a primeira instalação, selecione Erase flash + flash para que o dispositivo inicie a partir de um estado de firmware limpo.

Apenas reTerminal E1003

Certifique-se de que o interruptor de energia esteja ON. Se o dispositivo estiver em modo de espera e a gravação não iniciar, pressione o botão Refresh na parte superior da unidade para acordá-lo e tente novamente.

Comportamento de exibição do reTerminal E1002

O reTerminal E1002 usa uma tela ePaper colorida, mas o firmware TRMNL atualmente renderiza o conteúdo em modo monocromático. Durante o provisionamento de Wi-Fi, a tela AP do E1002 mostra um layout compacto com o logotipo TRMNL no canto inferior direito. Quando você vir essa tela, procure e conecte-se ao hotspot E1002 e continue com o mesmo fluxo de configuração de Wi-Fi dos outros dispositivos.

Após a conclusão da gravação, continue para a Etapa 4: Conectar o dispositivo ao Wi-Fi.

Método 3: Compilar e gravar a partir do código-fonte (avançado)​

  1. Clone o repositório de firmware

    dica

    Às vezes, nossos PRs para o TRMNL upstream ainda estão em revisão. Se você quiser os patches mais recentes do lado da Seeed, use o espelho da Seeed:

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

  2. Instale o PlatformIO como uma extensão do VS Code ou via linha de comando.

  3. Abra o projeto: abra a pasta firmware clonada no VS Code.

  4. Selecione o ambiente PlatformIO correto para o seu hardware:

    Em platformio.ini:

    • Para reTerminal E1001, selecione o ambiente seeed_reTerminal_E1001.
    • Para reTerminal E1002, selecione o ambiente seeed_reTerminal_E1002 (o TRMNL renderiza o conteúdo em monocromático no E1002).
    • Para reTerminal E1003, selecione o ambiente TRMNL_X_E1003 no repositório oficial de firmware TRMNL.

  5. Conecte seu dispositivo via USB-C.

  6. Compile e envie: clique no botão Upload do PlatformIO ou execute:

    pio run --target upload

Etapa 4: Configurar Wi-Fi e provisionar o dispositivo​

O fluxo de provisionamento de Wi-Fi é idêntico para todo o hardware compatível.

💡 Problemas para conectar ao Wi-Fi? Veja o Guia de solução de problemas de Wi-Fi do dispositivo TRMNL.

Ligue e entre no modo de provisionamento​

Após gravar o firmware TRMNL e ligar o dispositivo, ele entrará automaticamente no modo de provisionamento se ainda não estiver conectado ao Wi-Fi.

Conectar ao Wi-Fi TRMNL​

No seu celular ou computador, abra a lista de redes Wi-Fi disponíveis. Procure uma rede chamada TRMNL e conecte-se a ela (nenhuma senha é exigida por padrão).

Abrir o portal cativo​

Depois de conectado, abra um navegador. O dispositivo deve redirecionar automaticamente para a página de configuração TRMNL; se isso não acontecer, acesse manualmente http://4.3.2.1.

Inserir suas credenciais de Wi-Fi​

  • Selecione sua rede Wi-Fi de 2,4 GHz (redes de 5 GHz não são compatíveis).
  • Insira a senha do Wi-Fi e clique em Save / Connect.

⚠️ Importante: certifique-se de usar uma rede Wi-Fi de 2,4 GHz. Os chips ESP32-C3 / ESP32-S3 nesses dispositivos não suportam redes de 5 GHz.

O dispositivo entra na sua rede​

O dispositivo irá se desconectar do Wi-Fi TRMNL e entrar na sua rede doméstica. A janela do portal cativo mostrará o endereço MAC do dispositivo. Anote o endereço MAC — você vai precisar dele na próxima etapa.

⚠️ Observação: o endereço MAC só fica visível no portal cativo por 1–2 segundos. Se você perder esse momento, também pode:

  • Recuperá-lo a partir dos logs de compilação/envio do VS Code → PlatformIO.
  • Usar o método usetrmnl.com/flash e verificar o console de desenvolvedor do navegador durante o processo de gravação.
  • Encontrá-lo na lista de dispositivos conectados do seu roteador ou aplicativo de rede mesh.

Consulte o guia oficial: Finding your TRMNL MAC address.

Etapa 5: Registrar o dispositivo no TRMNL​

Depois que o dispositivo estiver conectado ao Wi-Fi e você tiver o endereço MAC, registre-o na interface web do TRMNL:

  1. Abra a interface web do TRMNL em https://trmnl.app.

  2. Vá para a página Devices.

  3. Adicione um novo dispositivo (botão no canto superior direito ou no centro da página).

  4. Insira o Device ID que você recebeu ao comprar o acesso BYOD (isso não é o endereço MAC — encontre o Device ID no e-mail de confirmação da compra ou no painel do TRMNL). Clique em Add new device.

  5. Associe o endereço MAC do dispositivo na página de configurações do dispositivo:

    Você também pode definir um nome personalizado e ajustar outras configurações aqui.

Seu dispositivo agora está vinculado à sua conta TRMNL! Agora você pode enviar playlists, imagens e outros conteúdos diretamente pela interface do TRMNL.

💡 Dica: se você tiver vários dispositivos, repita as etapas acima para cada um usando seus Device IDs exclusivos.

Desative Firmware Early Release & OTA Updates

Depois de adicionar o dispositivo na interface web do TRMNL, vá para a página de configurações do dispositivo e desative tanto Firmware Early Release quanto OTA Updates Enabled.

Se permanecerem ativadas, seu dispositivo poderá baixar automaticamente atualizações de firmware destinadas ao hardware oficial TRMNL que não são compatíveis com os dispositivos da Seeed. Instalar firmware incompatível pode fazer com que o dispositivo apresente mau funcionamento ou deixe de responder.

Mantenha sempre ambas as opções desativadas para garantir uma operação estável.

Uso dos botões​

Os reTerminal E1001 e E1002 expõem um único botão voltado ao usuário sob o firmware TRMNL:

  • Botão verde — pressionar por 5 s: entra no modo de reconfiguração de Wi-Fi.
  • Botão Reset: clique único para reiniciar o dispositivo.

Entendendo a Playlist do TRMNL​

A Playlist do TRMNL controla exatamente o que é exibido no seu dispositivo ePaper e quando.

Visão geral da playlist​

  • Playlist Title: o nome do seu dispositivo TRMNL.
  • Display Time Range: quando a playlist está ativa (por exemplo, 00:00–23:45).
  • Update Interval: com que frequência a tela é atualizada (por exemplo, a cada 5 minutos).
  • Add a Group / Add a Plugin: organize a playlist em grupos ou adicione novos plugins de conteúdo.

Itens da playlist​

Cada linha é uma tela ou widget que será exibido no seu dispositivo. Exemplos:

  1. Weather — informações meteorológicas atuais para a sua localização.
  2. Days Left This Year — contagem regressiva dos dias restantes no ano atual.
  3. Custom Text — exibe qualquer mensagem personalizada (por exemplo, "Hello World").

Para cada item:

  • Settings (ícone de engrenagem): configura as opções do plugin.
  • Delete (ícone X): remove o item da sua playlist.
  • Preview (ícone de olho): pré-visualiza como a tela ficará.
  • Reorder (ícone de barras): arraste para alterar a ordem.

Smart Playlist​

Na parte inferior você pode escolher se deseja pular automaticamente telas cujo conteúdo não mudou. Consulte o post do blog sobre Smart Playlists para mais detalhes.

Explorando os plugins do TRMNL​

Plugins são blocos de conteúdo modulares que podem mostrar clima, eventos de calendário, preços de ações, feeds RSS, frases motivacionais, atividade no GitHub e muito mais.

Plugins conectados​

Na parte superior da página Plugins você vê todos os plugins já conectados à sua conta TRMNL. Exemplos incluem Weather, Days Left This Year, Stock Price, RSS Feed, Reddit, Hacker News, Language Learning, Motivational Quote, Custom Text, …

Marketplace de plugins​

Abaixo dos seus plugins conectados você encontrará o marketplace. Os plugins são organizados por categorias e tags (#productivity, #news, #ecommerce, …). Navegue, pesquise e clique em qualquer plugin para conectá-lo à sua conta.

Desenvolvedores também podem criar e publicar seus próprios plugins — consulte a documentação do marketplace de plugins para mais detalhes.

Para recursos mais avançados, consulte a documentação oficial do TRMNL: https://docs.usetrmnl.com/go.

FAQ​

P1: Como reconfiguro a rede?​

Pressione e segure o Botão verde por 5 segundos. O dispositivo retornará à interface inicial do TRMNL e ativará o AP.

P2: O que devo fazer se a tela sempre mostrar um aviso de bateria fraca?​

Duas situações diferentes podem acionar essa tela:

  1. A tensão da bateria está realmente baixa. Este é o caso mais comum — o dispositivo realmente precisa ser carregado. Conecte-o ou substitua/carregue a bateria e o aviso deve desaparecer assim que a tensão se recuperar.

  2. Um problema no lado do servidor TRMNL. O nível de bateria é avaliado nos servidores do TRMNL, não apenas no dispositivo. Um bug no servidor ou uma atualização recente da plataforma pode, temporariamente, relatar incorretamente o status da bateria e continuar exibindo o aviso mesmo quando o hardware está em boas condições.

Se a bateria estiver realmente fraca, carregue o dispositivo primeiro — não oculte o aviso até confirmar que o pack está saudável.

Se você tiver certeza de que a bateria está boa, mas o aviso não desaparece, você não precisa modificar o firmware. O TRMNL permite suprimir o aviso na tela a partir do painel web:

Etapa 1. Abra a interface web do TRMNL e vá para Devices.

Etapa 2. Selecione o dispositivo afetado e abra as configurações de Battery.

Etapa 3. Ative Hide Low Battery Screen. Isso impede que a tela de aviso de bateria fraca apareça no dispositivo enquanto a detecção de bateria do lado do servidor TRMNL se recupera, ou quando você precisa que a tela permaneça na sua playlist.

Passo 4. (Opcional) Deixe a Notificação de Bateria Fraca por E-mail ativada se você ainda quiser alertas por e-mail sem interromper a tela.

P3: O Web Flasher / PlatformIO não encontra o dispositivo ou o envio falha​

Às vezes, o programa incorreto pode fazer com que o XIAO perca sua porta ou não funcione corretamente:

  • O XIAO está conectado, mas nenhum número de porta é encontrado.
  • O XIAO está conectado, a porta aparece, mas o envio falha.

Coloque o XIAO em modo BootLoader para recuperar:

  • Passo 1: mantenha pressionado o botão BOOT no XIAO ESP32-S3 / ESP32-C3 sem soltá-lo.
  • Passo 2: enquanto ainda estiver segurando BOOT, conecte o dispositivo ao computador via USB-C. Solte BOOT depois que o dispositivo estiver conectado.
  • Passo 3: execute novamente o envio / gravação. A maioria dos problemas de "dispositivo não reconhecido" ou "falha no envio" é resolvida assim.

Agradecimentos Especiais​

Agradecimentos especiais a toda a equipe TRMNL pelo forte apoio e ajuda inestimável em toda esta integração. Em particular, queremos agradecer ao Bogdan, Ryan Kulp, Fr3d, Schappi e a todos os outros membros da equipe por sua dedicação durante todo o desenvolvimento e documentação.

A experiência deles tornou esta integração possível e melhorou muito a experiência para as comunidades do reTerminal E Série (E1001, E1002 e E1003), TRMNL DIY Kit e XIAO Painel ePaper de 7,5".

Recursos​

Suporte Técnico & Discussão de Produtos​

Obrigado por escolher nossos produtos! Estamos aqui para oferecer diferentes tipos de suporte para garantir que sua experiência com nossos produtos seja a mais tranquila possível. Oferecemos vários canais de comunicação para atender a diferentes preferências e necessidades.

Loading Comments...