Pular para o conteúdo principal

Painel ePaper XIAO 7,5" Funciona com TRMNL


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 cheio de distrações. Fundado em 2023, o TRMNL rapidamente se tornou uma solução líder para gerenciamento de dashboards em E Ink®, oferecendo uma abordagem exclusiva 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 forma 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 integrar o TRMNL ao Painel ePaper XIAO 7,5"?

A integração do TRMNL com o nosso Painel ePaper XIAO 7,5" traz vários benefícios convincentes:

  • Criação simplificada de dashboards: A biblioteca em crescimento de apps e integrações do TRMNL torna fácil criar telas personalizadas de informação sem programação complexa
  • Baixo consumo de energia: A combinação do software eficiente do TRMNL com os requisitos mínimos de energia do nosso display 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 as notificações constantes e o cansaço visual associados às telas tradicionais
  • Atualizações regulares: O desenvolvimento ativo do TRMNL significa que novos recursos e integrações são adicionados semanalmente, expandindo continuamente as possibilidades para o seu display
  • Amigável para desenvolvedores: Com a API aberta do TRMNL e ferramentas para desenvolvedores, você pode criar plugins e integrações personalizados para suas necessidades específicas

Ao combinar a poderosa plataforma do TRMNL com o nosso display E Ink® de alta qualidade, oferecemos aos usuários uma solução elegante para criar dashboards de informação personalizados, de baixo consumo de energia, que respeitam tanto sua atenção quanto seu tempo.

Primeiros Passos com o TRMNL

Antes de começar a configurar o seu Painel ePaper XIAO 7,5" com o TRMNL, vamos reunir os materiais necessários e preparar suas credenciais do TRMNL.

Materiais Necessários

Para esta integração, você vai precisar de:

Painel ePaper XIAO 7,5"

Configuração de Conta TRMNL e Acesso ao TRMNL

Antes de conectar seu Painel ePaper ao TRMNL, você precisará:

  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 do TRMNL são informações sensíveis. Nunca as compartilhe publicamente nem as faça commit em sistemas de controle de versão.

Depois de ter seus materiais e ter comprado o acesso ao TRMNL, você pode prosseguir para conectar seu Painel ePaper à plataforma do TRMNL. Se encontrar algum problema ou tiver dúvidas, você pode entrar em contato diretamente com a equipe TRMNL em [email protected].

Gravação de Firmware

Para fazer o seu Painel ePaper XIAO 7,5" funcionar com o TRMNL, você precisa gravar o firmware apropriado no seu dispositivo. Há três métodos recomendados:

Método 1: Gravar via TRMNL Web Flasher (Mais fácil)

  1. Acesse o TRMNL Web Flasher
dica

Use o FW 1.5.12 ou firmware mais recente para compatibilidade com a Seeed.

  • Visite https://usetrmnl.com/flash
  • Esta ferramenta permite gravar o firmware no seu dispositivo diretamente do navegador.
  • Siga as instruções na tela para concluir o processo de gravação.

Método 2: Compilar e Gravar a partir do Código-Fonte (Para Usuários Avançados/Desenvolvedores)

  1. Clonar o Repositório de Firmware
dica

Há momentos em que atualizamos nosso código e precisamos enviar PR para o TRMNL e revisá-lo antes que seja exibido; se você quiser ser o primeiro a usar a versão mais recente do firmware, também pode usar o repositório TRMNL no projeto da Seeed.

  • Visite o repositório da Seeed e faça o clone:

    git clone https://github.com/Seeed-Projects/Seeed_TRMNL_Eink_Project.git
  1. Instalar o PlatformIO

    • Instale o PlatformIO como uma extensão do VSCode ou via linha de comando.
  2. Abrir o Projeto

    • Abra a pasta firmware clonada no VSCode.
  3. Selecionar o Ambiente Correto

    • Em platformio.ini, selecione o ambiente seeed_xiao_esp32c3.
  4. Conectar o Seu Dispositivo

    • Conecte o seu Painel ePaper XIAO 7,5".
  5. Compilar e Enviar

    • No PlatformIO, clique no botão "Upload" ou execute:

      pio run --target upload
    • O firmware será compilado e enviado para o seu dispositivo.

Configurar Wi‑Fi e Enviar Playlists para o TRMNL

Para usar o seu Painel ePaper XIAO 7,5" com o TRMNL e enviar playlists, primeiro você precisa conectar o dispositivo à sua rede Wi‑Fi. Esse processo é chamado de "modo de pareamento WiFi" e é feito por meio de um portal cativo simples. Siga as etapas abaixo:

💡 Com problemas no Wi‑Fi? Se você encontrar problemas ao conectar o dispositivo ao Wi‑Fi, consulte o Guia de Solução de Problemas de Wi‑Fi do Dispositivo TRMNL para soluções de problemas comuns de rede e compatibilidade de roteadores.

Ligar e Entrar no Modo de Provisionamento

  • Depois de gravar o firmware TRMNL e ligar o dispositivo, ele entrará automaticamente em modo de provisionamento se ainda não estiver conectado ao Wi‑Fi.

Conectar ao Wi‑Fi TRMNL

  • No seu telefone ou computador, abra a lista de redes Wi‑Fi disponíveis.
  • Procure por 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 web (como Chrome ou Edge).
  • O dispositivo deve redirecioná-lo automaticamente para a página de configuração do TRMNL. Se isso não acontecer, acesse manualmente http://4.3.2.1 no seu navegador.

Inserir Suas Credenciais de Wi‑Fi

  • Na página de configuração, você verá uma lista de redes Wi‑Fi disponíveis.
  • Selecione sua rede Wi‑Fi de 2,4 GHz (o TRMNL não oferece suporte a redes de 5 GHz).
  • Digite a senha do seu Wi‑Fi.
  • Clique em Save ou Connect.

⚠️ Importante: Certifique-se de usar uma rede Wi‑Fi de 2,4 GHz. Redes de 5 GHz não são suportadas pelo chip ESP32‑C3.

Dispositivo Conecta à Sua Rede

  • O dispositivo tentará se conectar ao seu Wi‑Fi.
  • Depois que a conexão for bem-sucedida, ele se desconectará do Wi‑Fi TRMNL e entrará na sua rede doméstica.
  • A janela exibirá o endereço MAC do dispositivo. Anote o endereço MAC, pois você vai precisar dele em uma etapa posterior.

⚠️ Nota: 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 Chrome/Edge/Firefox para o endereço MAC durante a gravação.
  • Encontrá-lo na lista de dispositivos conectados do seu roteador ou app da rede Mesh.

Para mais detalhes e capturas de tela, consulte o guia oficial: Finding your TRMNL MAC address

Acessar a Interface Web do TRMNL

Depois que o seu XIAO Painel de ePaper de 7,5" estiver conectado ao seu Wi-Fi e você tiver registrado o endereço MAC (ID do Dispositivo), você poderá adicioná-lo à sua conta TRMNL:

  1. Abra a Interface Web do TRMNL

  2. Vá para a Página de Dispositivos

    • Na interface do TRMNL, navegue até a seção Devices.
  3. Adicionar um Novo Dispositivo

    • Clique no botão Add new device, que geralmente é encontrado no canto superior direito ou no centro da página Devices.
  4. Inserir o ID do Dispositivo

    • Na janela pop-up, insira o ID do Dispositivo que você recebeu ao adquirir o acesso ao TRMNL (este não é o endereço MAC). Use o ID do Dispositivo do e-mail de confirmação de compra ou do painel do TRMNL.
    • Clique em Add new device para concluir o processo.
  5. Registrar o Endereço MAC do Dispositivo XIAO 7,5"

    Para construir uma conexão entre o painel de ePaper XIAO e o TRMNL, precisamos vincular o endereço MAC correto do dispositivo na página de configurações do TRMNL.

    • Você pode recuperar o endereço MAC durante o processo de upload no PlatformIO (verifique os logs de upload) ou no portal de provisionamento (ele será exibido após a configuração do Wi‑Fi).

    • Adicionar o seu endereço MAC antecipadamente ajuda a garantir um processo de integração e gerenciamento do dispositivo mais tranquilo.

    • Em seguida, você pode definir um nome personalizado para o seu Painel de ePaper e ajustar outras configurações conforme necessário.

Seu XIAO Painel de ePaper de 7,5" agora está vinculado à sua conta TRMNL! Agora você pode enviar playlists, imagens ou outros conteúdos para o seu display diretamente a partir da interface do TRMNL.

💡 Dica: Se você tiver vários Painéis de ePaper, repita as etapas acima para cada dispositivo usando seus IDs de Dispositivo exclusivos.

cuidado

Após adicionar o seu dispositivo na interface web do TRMNL, acesse a página de configurações do dispositivo e desative tanto Firmware Early Release quanto OTA Updates Enabled.

Se essas opções permanecerem ativadas, seu dispositivo poderá baixar e instalar automaticamente atualizações de firmware do TRMNL quando estiver conectado à internet. Essas atualizações são destinadas ao hardware oficial TRMNL e não são compatíveis com o XIAO Painel de ePaper de 7,5". A instalação de 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 o funcionamento estável do seu Painel de ePaper XIAO.

Entendendo o Recurso de Playlist do TRMNL

O recurso de Playlist do TRMNL permite controlar exatamente o que é exibido no seu Painel de ePaper e quando. Aqui está uma visão geral das principais seções e controles, conforme mostrado na captura de tela acima:

Visão Geral da Playlist

  • Título da Playlist: Na parte superior, você vê o nome do seu dispositivo TRMNL (por exemplo, "MengDu's TRMNL").
  • Intervalo de Tempo de Exibição: Você pode definir o intervalo de tempo em que a playlist ficará ativa (por exemplo, de 00:00 a 23:45).
  • Intervalo de Atualização: Escolha com que frequência o display será atualizado (por exemplo, a cada 5 minutos).
  • Add a Group / Add a Plugin: Use esses botões para organizar sua playlist em grupos ou adicionar novos plugins de conteúdo (como clima, calendário ou texto personalizado).

Itens da Playlist

Cada linha da playlist representa uma tela ou widget que será exibido no seu Painel de ePaper (apenas para referência):

  1. Weather
    • Mostra as informações meteorológicas atuais para o local selecionado.
    • O rótulo verde "Displayed now" indica que esta tela está sendo exibida no seu dispositivo no momento.
  2. Days Left This Year
    • Exibe uma contagem regressiva dos dias restantes no ano atual (por exemplo, "2025").
    • O rótulo (por exemplo, "9 days ago") mostra quando esta tela foi atualizada ou exibida pela última vez.
  3. Custom Text
    • Permite exibir qualquer mensagem personalizada (por exemplo, "Hello World").
    • Também mostra quando foi atualizada pela última vez.

Para cada item, você tem vários controles:

  • Configurações (ícone de engrenagem): Configura as opções do plugin.
  • Excluir (ícone de 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 em que as telas são exibidas.

Smart Playlist

  • Opção de Smart Playlist: Na parte inferior, você pode escolher se deseja pular automaticamente telas cujo conteúdo não foi alterado (por exemplo, "Never skip screens").

📖 Quer aprender mais? Leia o post do blog sobre Smart Playlists para dicas avançadas e mais detalhes.

Esse sistema de playlist flexível permite que você personalize totalmente o que o seu Painel de ePaper exibe, com que frequência ele é atualizado e em que ordem. Você pode combinar diferentes plugins para criar um painel personalizado que atenda às suas necessidades.

Explorando os Plugins do TRMNL

O sistema de plugins do TRMNL é o que torna o seu Painel de ePaper realmente poderoso e personalizável. Plugins são aplicativos ou widgets modulares que você pode adicionar ao seu dispositivo para exibir uma grande variedade de informações e conteúdos.

O que são Plugins?

Plugins são blocos de conteúdo individuais que podem mostrar coisas como clima, eventos de calendário, preços de ações, feeds RSS, frases motivacionais, atividade no GitHub e muito mais. Você pode combinar plugins para criar um painel que atenda às suas necessidades.

Plugins Conectados

Na parte superior da página de Plugins, você verá todos os plugins que já conectou à sua conta TRMNL. Eles estão prontos para serem adicionados à sua playlist e exibidos no seu Painel de ePaper. Exemplos incluem:

  • Weather: Mostra as condições meteorológicas atuais.
  • Days Left This Year: Contagem regressiva até o final do ano.
  • Stock Price: Acompanhe suas ações favoritas.
  • RSS Feed: Exibe atualizações de notícias ou blogs.
  • Reddit, Hacker News: Mostra posts em destaque.
  • Language Learning, Motivational Quote, Custom Text: Personalize o display com ferramentas de aprendizado ou mensagens personalizadas.

Marketplace de Plugins

Abaixo dos seus plugins conectados, você encontrará o marketplace de plugins. Aqui você pode navegar, pesquisar e descobrir novos plugins para adicionar ao seu dispositivo. Os plugins são organizados por categorias e tags (como #productivity, #news, #ecommerce, etc.), facilitando encontrar o que você precisa.

  • Navegar e Pesquisar: Use a barra de pesquisa ou as tags para encontrar rapidamente plugins do seu interesse.
  • Adicionar Plugins: Clique em qualquer plugin para conectá-lo à sua conta e começar a usá-lo na sua playlist.

Desenvolvedores podem até criar e publicar seus próprios plugins para que outros utilizem, fazendo com que o ecossistema se expanda continuamente com novas possibilidades (saiba mais sobre a criação de plugins).


Se você tiver qualquer dúvida sobre o uso do TRMNL ou quiser explorar recursos mais avançados, sinta-se à vontade para ler a documentação oficial do TRMNL para mais informações: https://docs.usetrmnl.com/go

Agradecimentos Especiais

Agradecimentos especiais a toda a equipe TRMNL pelo forte apoio e ajuda inestimável com este projeto. Em particular, gostaríamos de agradecer a Bogdan, Ryan Kulp, Fr3d, Schappi e a todos os outros membros da equipe por sua dedicação e assistência ao longo de todo o processo de desenvolvimento e documentação.

Sua experiência e comprometimento tornaram essa integração possível e melhoraram muito a experiência do usuário para a comunidade do XIAO Painel de ePaper de 7,5".

Solução de Problemas

Como reconfigurar a rede?

Pressione o botão Reset no XIAO, solte-o e, em seguida, mantenha pressionado o botão Boot por cinco segundos. O dispositivo retornará à interface inicial do TRMNL e ativará o AP.

Recursos

Suporte Técnico & Discussão sobre o Produto

Obrigado por escolher nossos produtos! Estamos aqui para fornecer 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...