Pular para o conteúdo principal

Trabalhar com Tesserae

Este guia leva um dispositivo reTerminal E Series ou um reTerminal Sticky da caixa até um dashboard na parede com o Tesserae. Você grava o firmware uma vez a partir do navegador, conecta o dispositivo ao seu próprio servidor Tesserae e projeta suas páginas no editor web. As etapas são as mesmas em todos os dispositivos. Onde forem diferentes, escolha seu dispositivo nas abas.

Cores completas e escala de cinza

Tesserae aciona cada painel em toda a sua capacidade. O E1002 e o E1004 pintam em todas as seis cores Spectra™ 6, o E1003 pinta em 16 níveis de cinza e o Sticky em 4. O servidor renderiza cada quadro nos bytes exatos que o painel espera, então o dispositivo só precisa pintá-lo.

O que é o Tesserae?​

Tesserae é um servidor de dashboard auto-hospedado e de código aberto para displays de papel eletrônico. Você o executa em casa como um App do Home Assistant, um contêiner Docker ou uma instalação simples em macOS, Linux, Windows ou um Raspberry Pi. Você compõe dashboards a partir de widgets no navegador, e cada dispositivo busca seu quadro, o pinta e volta a dormir. Nada sai da sua rede a menos que você escolha.

O projeto começou com o reTerminal E Series e cresceu junto com ele. O E1001 foi um dos primeiros dispositivos que o Tesserae suportou, e a E Series continua entre o hardware mais utilizado no web flasher do projeto.

Por que usar o Tesserae?​

  • Auto-hospedado e privado: o servidor roda no seu próprio hardware, sem conta e sem assinatura. Uma opção hospedada, Tesserae Cloud, está disponível se você preferir não executar um servidor.
  • Feito para Home Assistant: Tesserae é instalado como um App do Home Assistant. Ele mostra suas entidades no painel e, em dispositivos com toque, pode chamar serviços de volta. Com a descoberta MQTT ativada, cada painel aparece no Home Assistant como um dispositivo.
  • Todas as cores que o painel tem: cor Spectra™ 6 no E1002 e E1004, escala de cinza de 16 níveis no E1003. As fotos são convertidas com dithering no servidor, para que pareçam corretas em cada painel.
  • Widgets e modelos: clima, calendários, transporte, tarefas, fotos, Home Assistant e mais, além de widgets da comunidade, temas e modelos completos de dashboard do catálogo.
  • Toque e botões: os botões frontais e as telas sensíveis ao toque podem girar páginas, pular para um dashboard, forçar uma atualização ou disparar um webhook. No Sticky e no E1003, regiões de toque em uma página atuam como controles.
  • Firmware com foco em bateria: o dispositivo permanece em deep sleep entre as atualizações. As atualizações de firmware são assinadas e entregues pelo ar pelo seu próprio servidor, então você só grava a partir do navegador uma vez.
  • Código aberto: o servidor e o firmware do dispositivo estão no GitHub.

Hardware compatível​

reTerminal E1001reTerminal E1002
7,5" Monocromático
800 × 480
7,3" Spectra™ 6 (Cor)
800 × 480
Cores completas no Tesserae
reTerminal E1003reTerminal E1004
10,3" Monocromático
Escala de cinza de 16 níveis, 1872 × 1404
Toque suportado
13,3" Spectra™ 6 (Cor)
1200 × 1600
Cores completas no Tesserae
reTerminal Sticky
Escala de cinza de 4 níveis, 480 × 800 em retrato
Toque suportado
nota

O mesmo firmware também roda na família XIAO ePaper, incluindo o kit EE02 13,3" Spectra™ 6, o kit EE03 10,3", o XIAO 7,5" ePaper Panel e o TRMNL 7,5" (OG) DIY Kit. Veja a lista de compatibilidade do Tesserae para todas as placas suportadas.

O que você precisa​

  • Um dispositivo reTerminal E Series ou reTerminal Sticky
  • Um cabo USB-C que transmita dados (um cabo apenas de carga alimenta o dispositivo, mas o computador não consegue vê-lo)
  • Chrome ou Edge para desktop (o flasher usa Web Serial, que o Firefox e o Safari não suportam)
  • Uma rede Wi-Fi de 2,4 GHz
  • Um computador, Raspberry Pi ou instalação do Home Assistant para executar o servidor Tesserae

Etapa 1: Instalar o servidor Tesserae​

Escolha o caminho que se adapta à sua configuração. Cada um termina com a interface web do Tesserae aberta no seu navegador na porta 8765. Anote esse endereço, por exemplo http://192.168.1.50:8765, porque o dispositivo precisa dele na Etapa 3.

CaminhoMelhor para
Home Assistant AppVocê já executa Home Assistant OS ou Supervised
DockerUm Raspberry Pi, NAS ou máquina Linux que já executa contêineres
Proxmox VEUm servidor homelab executando Proxmox
macOS, Linux ou Raspberry PiUm computador que fica ligado, sem contêineres
WindowsUm PC com Windows que fica ligado
Tesserae CloudNenhum servidor próprio
Mantenha-o na sua rede doméstica

Tesserae é protegido por uma única senha e foi projetado para uma rede doméstica confiável. Não o exponha diretamente à internet. Para acesso remoto, use uma VPN como Tailscale ou WireGuard.

Home Assistant App​

  1. No Home Assistant, abra Settings → Apps → App store.
  2. Abra o menu no canto superior direito, escolha Repositories e adicione:
https://github.com/dmellok/homeassistant-tesserae-addon
  1. Encontre Tesserae na App store, clique em Install, depois em Start, e abra-o a partir da barra lateral. O Home Assistant faz seu login.

Seus dispositivos alcançam o Tesserae no próprio endereço do Home Assistant na porta 8765, por exemplo http://homeassistant.local:8765. Se você executar o App Mosquitto broker, o Tesserae o usa automaticamente, para que seus painéis possam aparecer no Home Assistant depois (veja a Etapa 5).

Docker​

Em um Raspberry Pi, NAS ou máquina Linux com Docker instalado:

mkdir ~/tesserae && cd ~/tesserae
curl -fsSLO https://raw.githubusercontent.com/dmellok/tesserae/main/docker-compose.yml
docker compose up -d

Antes de salvar quaisquer credenciais, defina uma chave secreta para que elas permaneçam legíveis se o contêiner for recriado algum dia. Gere uma:

python3 -c "import secrets; print(secrets.token_hex(32))"

Adicione-a a docker-compose.yml em environment::

TESSERAE_SECRET_KEY: "<the key>"

Execute docker compose up -d novamente, acesse o endereço da máquina na porta 8765 e escolha uma senha.

Proxmox VE​

Um comando no host Proxmox cria um contêiner Debian 13 sem privilégios, instala a versão mais recente do Tesserae e o inicia como um serviço:

COMMUNITY_SCRIPTS_URL=https://raw.githubusercontent.com/dmellok/tesserae/main/scripts/proxmox \
bash -c "$(curl -fsSL https://raw.githubusercontent.com/dmellok/tesserae/main/scripts/proxmox/ct/tesserae.sh)"
  1. Quando for perguntado sobre um canal de lançamento, pressione Enter ou aguarde dez segundos para escolher stable.
  2. Na caixa de diálogo do contêiner, escolha Default para usar os tamanhos do script, ou Advanced para definir você mesmo CPU, RAM, disco e rede. Mantenha os tamanhos de recursos padrão do script, incluindo o disco de 16 GB; o Tesserae também instala o Chromium para renderização. Se você usar Advanced, deixe espaço em disco suficiente para o aplicativo, dependências do navegador e futuras atualizações.
  3. Quando terminar, o script mostra o endereço do contêiner. Abra http://<container-ip>:8765 e escolha uma senha.

Para atualizar depois, execute update dentro do contêiner.

macOS, Linux ou Raspberry Pi​

Em um terminal:

curl -fsSL https://raw.githubusercontent.com/dmellok/tesserae/main/install.sh | bash

Acesse o endereço da máquina na porta 8765 e escolha uma senha. Em um Raspberry Pi, recomenda-se um sistema operacional de 64 bits e pelo menos 2 GB de RAM.

Windows​

No PowerShell:

iwr https://raw.githubusercontent.com/dmellok/tesserae/main/install.ps1 -UseBasicParsing | iex

Acesse o endereço do PC na porta 8765 e escolha uma senha. Se o dispositivo não conseguir alcançar o servidor depois, permita a porta 8765 no Firewall do Windows em redes privadas.

Tesserae Cloud​

Tesserae Cloud executa o servidor para você e funciona com os mesmos dispositivos. Entre com seu e-mail e, em seguida, crie um código de reivindicação em Settings → Panels → Add a panel. Na Etapa 3, escolha Cloud e insira o código de reivindicação em vez de um endereço de servidor.

Primeira execução​

Na primeira vez que você abrir o Tesserae (exceto como um App do Home Assistant, que faz login para você), escolha uma senha. Em seguida, um breve assistente de configuração será exibido:

  1. Help out: escolha se deseja enviar uma contagem anônima de instalações para o projeto Tesserae ou manter a instalação offline.
  2. Timezone: confirme o fuso horário detectado, para que os agendamentos sejam executados no seu horário local.
  3. Transport: deixe REST API selecionado. É a escolha certa para dispositivos alimentados por bateria como o reTerminal e o Sticky.
  4. Device: a página aguarda um painel se anunciar. Clique em Skip for now e aprove o dispositivo na Etapa 4, ou deixe esta página aberta enquanto você faz o flash: quando o dispositivo aparecer em Discovered, dê um nome a ele e clique em Register. Você não precisa de um código de pareamento.
  5. Dashboard: escolha I'll set this up later ou volte depois da Etapa 4 para criar um dashboard inicial vinculado ao seu dispositivo.

Etapa 2: Fazer flash do firmware Tesserae​

macOS: instale primeiro o driver CH340

O reTerminal E Series se conecta por meio de um chip USB-serial WCH CH340, e o macOS não possui um driver nativo para ele. Instale o driver CH34x da WCH e, em seguida, ative-o em System Settings → General → Login Items & Extensions → Driver Extensions. O Linux e as versões atuais do Windows geralmente instalam automaticamente um driver compatível. Se o Windows não detectar uma porta serial, instale o driver WCH CH341SER; o Windows 10 e anteriores podem exigi-lo. No Linux, se a porta não aparecer, execute sudo usermod -aG dialout $USER e saia e entre novamente.

  1. Conecte o dispositivo ao computador com o cabo de dados USB-C.
  2. Abra tesserae.ink/flash no Chrome ou Edge.
  3. Em Choose your panel, selecione o modelo do seu reTerminal e, em seguida, escolha a versão mais recente em Firmware build.
  4. Clique em Next: plug it in, depois em Connect & flash, e selecione a porta serial do dispositivo.
  5. Aguarde de 60 a 90 segundos. Deixe o cabo conectado até que o flasher confirme o sucesso.

Quando o processo de flash terminar, a etapa Connect it do flasher pode enviar os dados da sua rede Wi-Fi e o endereço do servidor para o dispositivo pelo mesmo cabo. Escolha My own Tesserae server, insira o endereço da Etapa 1 e avance para a Etapa 4.

nota

Fazer flash do Tesserae substitui o firmware atualmente no dispositivo. Você pode voltar a qualquer momento fazendo flash de outro firmware.

Etapa 3: Conectar ao Wi-Fi​

Após o flash, o dispositivo mostra uma tela de Setup mode com um código QR, o nome da rede de configuração e sua senha.

  1. No seu telefone ou computador, conecte-se à rede Wi-Fi Tesserae-Setup (senha tesserae), seja escaneando o código QR ou escolhendo-a na lista.
  2. A página de configuração será aberta automaticamente. Se isso não acontecer, acesse http://192.168.4.1.
  3. Insira o nome e a senha da sua rede Wi-Fi de 2,4 GHz ou escolha sua rede na lista que o dispositivo escaneou.
  4. Escolha como o dispositivo alcança o Tesserae:
    • Local (padrão): insira o endereço do seu servidor Tesserae, por exemplo http://192.168.1.50:8765. Deixe Pairing code em branco e você aprovará o dispositivo na Etapa 4.
    • Cloud: insira o código de reivindicação de oito dígitos de Settings → Panels → Add a panel no Tesserae Cloud.
    • Relay: para um dispositivo em uma rede diferente da do seu servidor. Insira o código de pareamento de Settings → Cloud relay → Add a remote panel no seu servidor.
  5. Toque em Save & restart. O dispositivo entra na sua rede Wi-Fi e se anuncia ao servidor.
dica

A rede de configuração permanece ativa por 15 minutos após a saída do último visitante. Se ela tiver expirado, reinicie o dispositivo ou pressione um botão frontal nas placas que tiverem um, para trazer a tela de configuração de volta.

Etapa 4: Registrar o dispositivo no Tesserae​

Novos dispositivos aguardam sua aprovação, para que o dispositivo de mais ninguém possa se conectar ao seu servidor. Até que você o aprove, o dispositivo mostra Almost done e pede que você o aprove no Tesserae em Settings → Devices.

  1. Na interface web do Tesserae, um selo New device aparece na barra lateral. Abra Settings → Devices, onde um banner informa "1 device has been heard but is not registered".
  2. Clique em Register no banner. O Tesserae mostra o modelo do dispositivo, o tamanho do painel e a versão do firmware, com o modelo já selecionado.
  3. Dê a ele um nome de exibição, como "Cozinha" ou "Corredor", e clique em Register.
  4. O dispositivo coleta seu token de acesso na próxima verificação e é movido para a lista Devices. Seu cartão mostra o que ele está exibindo, bateria, versão do firmware e a próxima atualização agendada.

Etapa 5: Crie um Dashboard e envie-o​

  1. Abra Dashboards → New dashboard e dê um nome, ou instale um modelo pronto em Settings → Widgets → Browse catalog.
  2. O editor guia você pelas etapas: escolha seu dispositivo como exibição, selecione um layout e escolha um widget para cada célula.
  3. Altere a visualização de Live para As the panel shows it para ver exatamente o quadro que seu dispositivo irá desenhar, com suas cores ou tons de cinza.
  4. Clique no botão Push to, que traz o nome do seu dispositivo. O dispositivo desenha o novo quadro no próximo despertar.
Primeiro dashboard mais rápido

De volta à etapa Dashboard do assistente de configuração, Create a starter dashboard cria um relógio dimensionado para o seu dispositivo e vinculado a ele. Clique em Push to panel para confirmar que tudo está conectado e depois abra-o no editor para deixá-lo do seu jeito.

Algumas dicas para cada painel:

  • E1001 e Sticky: tipos em negrito e com alto contraste têm a melhor leitura.
  • E1002 e E1004: dê a cada elemento seu próprio bloco de cor. Uma atualização completa Spectra™ 6 leva cerca de 30 segundos no E1002 e cerca de 40 no E1004. Isso é normal para o painel.
  • E1003: fotos e gradientes são renderizados em 16 níveis de cinza, e a tela alta é adequada para listas e agendas.

Para mudar o que um dispositivo mostra ao longo do dia, abra Lineups e escolha Set up a display. Você pode escolher as páginas, com que frequência elas são atualizadas e quando o dispositivo permanece em silêncio durante a noite. Para dispositivos alimentados por bateria, o Smart sync renderiza cada quadro pouco antes de o dispositivo acordar, para que ele sempre desenhe conteúdo novo sem desperdiçar bateria.

Conecte seus dados​

  • Home Assistant: adicione um token de acesso de longa duração e a URL do seu Home Assistant em Settings → Widgets → Home Assistant Core. Para que cada painel apareça como um dispositivo no Home Assistant, ative Home Assistant discovery em Settings → Server. O App já usa o broker Mosquitto do Home Assistant se você tiver um em execução.
  • Calendários: adicione URLs iCal em Settings → Widgets → Calendar Feeds.
  • Mais widgets: widgets, temas e modelos da comunidade estão em Settings → Widgets → Browse catalog.

Botões e Toque​

Os três botões frontais funcionam imediatamente:

BotãoAção padrão
EsquerdaDashboard anterior
DireitaPróximo dashboard
RefreshRenderizar e desenhar o dashboard atual novamente

Altere o mapeamento para cada dispositivo em Controls → Button map no cartão do dispositivo. Um botão também pode ir direto para um dashboard específico ou disparar um webhook. Mantenha Refresh pressionado por cerca de 3 segundos e solte para mudar para a configuração Bluetooth pelo app companheiro Tesserae. Mantenha-o pressionado por 20 segundos para restaurar as configurações de fábrica, o que apaga as configurações salvas de Wi-Fi e servidor e retorna o dispositivo à tela de configuração.

O E1003 também suporta toque. Veja a seção Touch na aba Sticky; funciona da mesma forma em ambos os dispositivos.

Atualizações de Firmware​

As atualizações de firmware chegam pelo ar. Settings → Firmware na interface web do Tesserae mostra a versão instalada e a disponível para cada dispositivo. Clique em Queue update, ou ative Auto, e o dispositivo baixa, verifica e instala a atualização assinada no próximo despertar. Você só precisa fazer o flash pelo navegador novamente para uma instalação do zero ou para recuperação.

O Tesserae verifica se há novo firmware quando os recursos online estão ativados (Settings → System → Online features). Em uma instalação offline, baixe o arquivo descriptor-<kind>.json da versão de firmware e importe-o em Manual import.

FAQ​

P1: O flasher não encontra meu dispositivo​

  • Use um cabo USB-C que transmita dados e uma porta USB que suporte dados. Portas do painel frontal em alguns desktops não suportam.
  • Use Chrome ou Edge. Firefox e Safari não suportam Web Serial.
  • No macOS com um reTerminal E Série, instale e ative o driver CH340 (veja a Etapa 2).
  • Feche qualquer outro programa que possa estar usando a porta serial.

P2: O dispositivo não aparece em Discovered​

  • Verifique se o dispositivo saiu do modo de configuração. Se ele ainda mostrar a tela de configuração, insira os dados de Wi-Fi novamente.
  • Certifique-se de que sua rede Wi-Fi é de 2,4 GHz.
  • Verifique se o endereço do servidor funciona a partir de outro dispositivo na mesma rede, por exemplo abrindo http://<your-server>:8765 em um navegador.

P3: O dispositivo mostra "Can't reach the server" ou "Wi-Fi unavailable"​

O dispositivo mostra o problema no painel e tenta novamente por conta própria. Se o Wi-Fi cair, ele tenta novamente a cada minuto por cerca de 12 minutos e então abre o portal de configuração uma vez por 15 minutos. Depois disso, continua tentando a rede salva em segundo plano e se reconecta quando a rede voltar. Para abrir o portal de configuração novamente, reinicie o dispositivo ou pressione um botão frontal.

P4: O quadro é baixado, mas o painel não desenha​

A bateria pode estar muito fraca para uma atualização do painel. Conecte a alimentação USB, deixe carregar por uma hora e tente novamente.

Agradecimentos Especiais​

Agradecimentos especiais à equipe da Seeed Studio pelo suporte durante todo o desenvolvimento do reTerminal E Série e do Sticky, em particular a Mason Cao e Lily Li.

Agradecimentos também aos contribuidores do Tesserae que ajudaram a tornar o projeto possível, em particular skynet01, charmmmz, theiereman, vaibhav8a, partridgeworks, bablokb, varanu5 e Frankynov, e à comunidade em geral pelos widgets, testes de firmware e relatos de hardware que sustentam esta integração.

Recursos​

Suporte Técnico & Discussão de 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...