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

TRMNL oferece suporte oficial ao reTerminal E1001, reTerminal E1002, 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 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 telas 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 personalizadas.

Hardware compatível​

reTerminal E1001reTerminal E1002TRMNL 7.5" (OG) DIY KitXIAO 7.5" ePaper Panel
7.5" monocromático
Terminal integrado		7.3" Spectra 6 (colorido)
Terminal integrado
Modo mono no TRMNL		7.5" mono + case DIY
Driver XIAO ESP32-S3 Plus		Painel nu 7.5" mono
XIAO ESP32-C3 diretamente
Adquira agora 🖱️
Adquira agora 🖱️
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 e ligá-lo. Nenhuma etapa de montagem é necessária.

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 (SenseCraft HMI) é exclusivo para o reTerminal E Series. Método 3 (Build from Source) é para usuários avançados.

Kits TRMNL DIY novos já são enviados com o 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 completamente 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:

Use FW 1.6.7 ou mais recente para compatibilidade com a Seeed na reTerminal E Series.

Método 2: Gravar via SenseCraft HMI Platform (apenas reTerminal E Series)​

info

Este método é aplicável apenas à reTerminal E1001 / E1002. O gravador SenseCraft HMI sabe como alternar entre o firmware SenseCraft HMI e o firmware TRMNL no mesmo dispositivo.

  1. Acesse a página de dispositivo SenseCraft HMI.

  2. Selecione seu dispositivo.

  3. Escolha o firmware TRMNL (você pode voltar para o firmware HMI aqui depois). Clique em Full Flash e depois em Flash.

  4. Conecte seu dispositivo ao computador e selecione a porta serial.

  5. A tela será atualizada e exibirá o logotipo TRMNL e o endereço MAC.

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

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

Conecte-se 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).

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

Insira as credenciais do seu Wi-Fi​

  • Selecione sua rede Wi-Fi de 2,4 GHz (redes de 5 GHz não são compatíveis).
  • Digite a senha do seu 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 são compatíveis com redes de 5 GHz.

O dispositivo entra na sua rede​

O dispositivo 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 fica visível no portal cativo por apenas 1–2 segundos. Se você perder esse momento, também pode:

  • Recuperá-lo nos 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 a gravação.
  • Encontrá-lo na lista de dispositivos conectados do seu roteador ou aplicativo de rede mesh.

Veja o guia oficial: Encontrando o endereço MAC do seu TRMNL.

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

  1. Abra a interface web 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 (este não é o endereço MAC — encontre o Device ID no e-mail de confirmação da compra ou no painel TRMNL). Clique em Add new device.

  5. Vincule 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 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 seu 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 TRMNL oficial que não são compatíveis com os dispositivos Seeed. Instalar firmware incompatível pode fazer com que seu 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​

A reTerminal E Série expõe um único botão voltado ao usuário sob o firmware TRMNL:

  • Botão verde — pressione 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​

  • Título da Playlist: o nome do seu dispositivo TRMNL.
  • Intervalo de tempo de exibição: quando a playlist está ativa (por exemplo, 00:00–23:45).
  • Intervalo de atualização: 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 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:

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

Playlist inteligente​

Na parte inferior você pode escolher se deseja pular automaticamente telas cujo conteúdo não foi alterado. Veja 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 de 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.

Solução de problemas​

Como reconfigurar a rede?​

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

Web Flasher / PlatformIO não encontra o dispositivo ou o upload 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 upload falha.

Coloque o XIAO em modo BootLoader para recuperar:

  • Passo 1: pressione e segure 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 upload / flash. A maioria dos problemas de "dispositivo não reconhecido" ou "falha no upload" é resolvida assim.

Agradecimentos especiais​

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

A experiência e o conhecimento deles tornaram esta integração possível e melhoraram muito a experiência para as comunidades reTerminal E Série, TRMNL DIY Kit e XIAO 7.5" ePaper Panel.

Recursos​

Suporte técnico e discussão sobre o produto​

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