Skip to main content

使用 Tesserae

本指南将带你把一台 reTerminal E 系列设备或 reTerminal Sticky 从开箱一路用 Tesserae 挂到墙上的仪表盘。你只需在浏览器中刷写一次固件,把设备连接到你自己的 Tesserae 服务器,然后在网页编辑器中设计它的页面。每台设备的步骤都相同;如有差异,请在下方选项卡中选择你的设备。

全彩与灰度

Tesserae 会以每块面板的全部能力来驱动它们。E1002 和 E1004 能显示 Spectra™ 6 的全部六种颜色,E1003 能显示 16 级灰度,而 Sticky 能显示 4 级灰度。服务器会把每一帧渲染成面板所期望的精确字节,因此设备只需要负责刷新显示即可。

什么是 Tesserae?​

Tesserae 是一个面向电子纸显示屏的开源、自托管仪表盘服务器。你可以在家中将其作为 Home Assistant App、Docker 容器,或在 macOS、Linux、Windows 或 Raspberry Pi 上的普通安装来运行。你在浏览器中用小部件组合仪表盘,每台设备获取自己的画面、刷新显示,然后重新进入休眠。除非你主动选择,否则不会有任何数据离开你的网络。

该项目从 reTerminal E 系列起步,并与之共同成长。E1001 是 Tesserae 最早支持的设备之一,而 E 系列至今仍是该项目网页刷写器上刷写次数最多的硬件之一。

为什么要使用 Tesserae?​

  • 自托管且私密:服务器运行在你自己的硬件上,无需账号、无订阅。如果你不想自己运行服务器,也可以使用托管选项 Tesserae Cloud。
  • 为 Home Assistant 而生:Tesserae 作为 Home Assistant App 安装。它可以在面板上显示你的实体,在带触控的设备上还能回调服务。启用 MQTT 发现后,每块面板都会作为一个设备出现在 Home Assistant 中。
  • 用尽面板的每一种颜色:E1002 和 E1004 上的 Spectra™ 6 全彩,E1003 上的 16 级灰度。照片会在服务器端进行抖动处理,因此在每块面板上都能正确显示。
  • 小部件与模板:天气、日历、交通、任务、照片、Home Assistant 等等,再加上来自目录的社区小部件、主题和完整仪表盘模板。
  • 触控与按键:前面板按键和触摸屏可以切换页面、跳转到某个仪表盘、强制刷新或触发 webhook。在 Sticky 和 E1003 上,页面上的点击区域可以作为控制器使用。
  • 电池优先的固件:设备在两次刷新之间保持深度睡眠。固件更新由你自己的服务器签名并通过空中下发,因此你只需在浏览器中刷写一次。
  • 开源:服务器 和 设备固件 都托管在 GitHub 上。

兼容硬件​

reTerminal E1001reTerminal E1002
7.5" 黑白
800 × 480
7.3" Spectra™ 6(彩色)
800 × 480
在 Tesserae 中支持全彩
reTerminal E1003reTerminal E1004
10.3" 黑白
16 级灰度,1872 × 1404
支持触控
13.3" Spectra™ 6(彩色)
1200 × 1600
在 Tesserae 中支持全彩
reTerminal Sticky
4 级灰度,480 × 800 竖屏
支持触控
note

同一套固件也适用于 XIAO ePaper 系列,包括 EE02 13.3" Spectra™ 6 套件、EE03 10.3" 套件、XIAO 7.5" ePaper Panel 以及 TRMNL 7.5"(OG)DIY 套件。请查看 Tesserae 兼容性列表,了解所有受支持的开发板。

你需要准备什么​

  • 一台 reTerminal E 系列设备或 reTerminal Sticky
  • 一根支持数据传输的 USB-C 线(仅充电线只能为设备供电,电脑无法识别设备)
  • 桌面版 Chrome 或 Edge(刷写器使用 Web Serial,Firefox 和 Safari 不支持)
  • 一个 2.4 GHz Wi-Fi 网络
  • 一台用于运行 Tesserae 服务器的电脑、Raspberry Pi 或 Home Assistant 安装

步骤 1:安装 Tesserae 服务器​

选择适合你环境的安装方式。每种方式最终都会在浏览器中打开 Tesserae 的 Web 界面,端口为 8765。记下这个地址,例如 http://192.168.1.50:8765,因为设备在步骤 3 中需要用到它。

路径最适合的场景
Home Assistant App你已经在运行 Home Assistant OS 或 Supervised
Docker已经在运行容器的 Raspberry Pi、NAS 或 Linux 机器
Proxmox VE运行 Proxmox 的家庭实验室服务器
macOS, Linux or Raspberry Pi一台常年开机、但不使用容器的电脑
Windows一台常年开机的 Windows 电脑
Tesserae Cloud你没有自己的服务器
将它留在你的家庭网络中

Tesserae 仅由一个密码保护,设计用于受信任的家庭网络。不要将其直接暴露在互联网中。若需远程访问,请使用 Tailscale 或 WireGuard 等 VPN。

Home Assistant App​

  1. 在 Home Assistant 中打开 Settings → Apps → App store。
  2. 打开右上角菜单,选择 Repositories,并添加:
https://github.com/dmellok/homeassistant-tesserae-addon
  1. 在 App store 中找到 Tesserae,点击 Install,然后点击 Start,再从侧边栏打开它。Home Assistant 会为你完成登录。

你的设备将通过 Home Assistant 自身的地址加上 8765 端口访问 Tesserae,例如 http://homeassistant.local:8765。如果你运行了 Mosquitto broker App,Tesserae 会自动使用它,这样你的面板稍后就能出现在 Home Assistant 中(见步骤 5)。

Docker​

在已安装 Docker 的 Raspberry Pi、NAS 或 Linux 机器上:

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

在保存任何凭据之前,先设置一个密钥,这样即使容器被重建,它们仍然是可读的。生成一个密钥:

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

将它添加到 docker-compose.yml 的 environment: 下:

TESSERAE_SECRET_KEY: "<the key>"

再次运行 docker compose up -d,在浏览器中访问该机器 8765 端口的地址,并设置一个密码。

Proxmox VE​

在 Proxmox 主机上运行一条命令即可创建一个非特权的 Debian 13 容器,安装最新的 Tesserae 版本并将其作为服务启动:

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. 当被询问发行通道时,按 Enter 或等待十秒以选择 stable。
  2. 在容器对话框中,选择 Default 使用脚本的大小,或选择 Advanced 自行设置 CPU、RAM、磁盘和网络。保持脚本的默认资源大小,包括其 16 GB 磁盘;Tesserae 还会安装用于渲染的 Chromium。如果使用 Advanced,请为应用、浏览器依赖和未来更新预留足够的磁盘空间。
  3. 完成后,脚本会打印容器的地址。打开 http://<container-ip>:8765 并选择一个密码。

以后要更新时,在容器内运行 update。

macOS、Linux 或 Raspberry Pi​

在终端中:

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

在浏览器中访问该机器在 8765 端口上的地址并选择一个密码。在 Raspberry Pi 上,建议使用 64 位操作系统并至少配备 2 GB RAM。

Windows​

在 PowerShell 中:

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

在浏览器中访问这台 PC 在 8765 端口上的地址并选择一个密码。如果之后设备无法连接到服务器,请在 Windows 防火墙的专用网络中放行 8765 端口。

Tesserae Cloud​

Tesserae Cloud 为你托管服务器,并可与相同的设备配合使用。使用你的邮箱登录,然后在 Settings → Panels → Add a panel 下创建一个 claim code。在步骤 3 中选择 Cloud,并输入该 claim code,而不是服务器地址。

首次运行​

第一次打开 Tesserae 时(作为 Home Assistant App 运行除外,它会自动为你登录),需要先选择一个密码。随后会出现一个简短的设置向导:

  1. Help out:选择是否向 Tesserae 项目发送匿名安装计数,或保持安装离线。
  2. Timezone:确认检测到的时区,以便计划任务在你的本地时间运行。
  3. Transport:保持选择 REST API。对于 reTerminal 和 Sticky 这类电池设备,这是正确的选择。
  4. Device:此页面会等待面板自我宣布。你可以点击 Skip for now 并在步骤 4 中批准该设备,或者在刷写时保持此页面打开:当设备出现在 Discovered 下时,为其命名并点击 Register。你不需要配对码。
  5. Dashboard:选择 I'll set this up later,或者在完成步骤 4 后返回此处,为你的设备创建一个绑定的入门仪表板。

步骤 2:刷写 Tesserae 固件​

macOS:请先安装 CH340 驱动

reTerminal E 系列通过 WCH CH340 USB-串口芯片连接,而 macOS 没有内置该芯片的驱动。请安装 WCH 的 CH34x 驱动,然后在 System Settings → General → Login Items & Extensions → Driver Extensions 中启用它。Linux 和当前的 Windows 版本通常会自动安装兼容驱动。如果 Windows 未检测到串口,请安装 WCH CH341SER 驱动;Windows 10 及更早版本可能需要它。在 Linux 上,如果串口没有出现,请运行 sudo usermod -aG dialout $USER,然后注销并重新登录。

  1. 使用 USB-C 数据线将设备连接到电脑。
  2. 在 Chrome 或 Edge 中打开 tesserae.ink/flash。
  3. 在 Choose your panel 下选择你的 reTerminal 型号,然后在 Firmware build 下选择最新版本。
  4. 点击 Next: plug it in,然后点击 Connect & flash,并选择设备的串口。
  5. 等待 60 到 90 秒。在刷写器确认成功之前,请保持数据线连接。

刷写完成后,刷写器的 Connect it 步骤可以通过同一根数据线将你的 Wi-Fi 信息和服务器地址发送到设备。选择 My own Tesserae server,输入步骤 1 中的地址,然后跳到步骤 4。

note

刷写 Tesserae 会替换当前设备上的固件。你可以随时通过刷写其他固件恢复。

步骤 3:连接到 Wi-Fi​

刷写完成后,设备会显示 Setup mode 屏幕,其中包含一个二维码、配网网络名称及其密码。

  1. 在手机或电脑上加入 Wi-Fi 网络 Tesserae-Setup(密码为 tesserae),可以扫描二维码或在列表中选择。
  2. 配置页面会自动打开。如果没有,请访问 http://192.168.4.1。
  3. 输入你的 2.4 GHz Wi-Fi 名称和密码,或从设备扫描到的列表中选择你的网络。
  4. 选择设备连接 Tesserae 的方式:
    • Local(默认):输入你的 Tesserae 服务器地址,例如 http://192.168.1.50:8765。将 Pairing code 留空,你会在步骤 4 中批准该设备。
    • Cloud:输入来自 Tesserae Cloud 中 Settings → Panels → Add a panel 的八位 claim code。
    • Relay:用于设备与服务器不在同一网络的情况。输入服务器上 Settings → Cloud relay → Add a remote panel 中的配对码。
  5. 点击 Save & restart。设备会加入你的 Wi-Fi 并向服务器自我宣布。
tip

在最后一个访问者离开后,配网网络会保持开启 15 分钟。如果已超时,请重启设备,或在带有前置按键的板卡上按下前置按键,以重新显示配网屏幕。

步骤 4:在 Tesserae 中注册设备​

新设备会等待你的批准,这样其他人的设备就无法附加到你的服务器上。在你批准之前,设备会显示 Almost done,并提示你在 Tesserae 的 Settings → Devices 中批准它。

  1. 在 Tesserae Web 界面中,侧边栏会出现 New device 标记。打开 Settings → Devices,你会看到一条横幅提示“1 device has been heard but is not registered”。
  2. 点击横幅上的 Register。Tesserae 会显示设备的型号、面板尺寸和固件版本,并已为你选中型号。
  3. 为其设置一个显示名称,例如“Kitchen”或“Hallway”,然后点击 Register。
  4. 设备在下一次签到时会获取其访问令牌,并移动到 Devices 列表中。其卡片会显示当前显示内容、电池、电池电量、固件版本以及下一次计划更新的时间。

步骤 5:构建仪表盘并推送​

  1. 打开 Dashboards → New dashboard 并为其命名,或者在 Settings → Widgets → Browse catalog 中安装现成的模板。
  2. 编辑器会引导你完成各个步骤:选择你的设备作为显示屏,选择布局,并为每个单元格选择一个小部件。
  3. 将预览从 Live 切换到 As the panel shows it,以查看设备将要绘制的精确画面,包括其颜色或灰度。
  4. 点击带有你设备名称的 Push to 按钮。设备会在下一次唤醒时绘制新的画面。
最快的第一个仪表盘

回到设置向导的 Dashboard 步骤,Create a starter dashboard 会创建一个适配你设备尺寸并绑定到该设备的时钟。点击 Push to panel 以确认一切已连接,然后在编辑器中打开它并进行个性化修改。

每种面板的一些提示:

  • E1001 和 Sticky:粗体、高对比度的字体效果最佳。
  • E1002 和 E1004:为每个元素分配自己的色块。一次完整的 Spectra™ 6 刷新在 E1002 上大约需要 30 秒,在 E1004 上大约需要 40 秒。这对该面板来说是正常的。
  • E1003:照片和渐变会以 16 级灰度渲染,且较高的画布适合列表和日程。

要在一天中更改设备显示的内容,打开 Lineups 并选择 Set up a display。你可以选择页面、刷新频率以及设备在夜间保持静默的时间。对于电池供电设备,Smart sync 会在设备唤醒前刚刚渲染每一帧,因此既能始终显示最新内容,又不会浪费电量。

连接你的数据​

  • Home Assistant:在 Settings → Widgets → Home Assistant Core 中添加一个长期有效的访问令牌以及你的 Home Assistant URL。若希望每个面板在 Home Assistant 中显示为一个设备,请在 Settings → Server 中打开 Home Assistant discovery。如果你运行了 Mosquitto 代理,App 已经会使用 Home Assistant 的 Mosquitto 代理。
  • Calendars:在 Settings → Widgets → Calendar Feeds 中添加 iCal URL。
  • More widgets:社区小部件、主题和模板位于 Settings → Widgets → Browse catalog 中。

按钮和触控​

三个前置按钮开箱即用:

按钮默认操作
Left上一个仪表盘
Right下一个仪表盘
Refresh重新渲染并绘制当前仪表盘

在设备卡片上的 Controls → Button map 下更改每个设备的映射。按钮也可以直接跳转到特定仪表盘或触发 webhook。按住 Refresh 大约 3 秒 后松开,可通过 Tesserae 配套应用切换到蓝牙设置。持续按住 20 秒 可恢复出厂设置,这会清除已保存的 Wi-Fi 和服务器设置,并将设备恢复到设置界面。

E1003 还支持触控。请参阅 Sticky 选项卡中的 Touch 部分;两种设备的工作方式相同。

固件更新​

固件更新通过空中下发。Tesserae Web UI 中的 Settings → Firmware 会显示每个设备已安装和可用的版本。点击 Queue update,或打开 Auto,设备会在下一次唤醒时下载、验证并安装签名更新。你只需在全新安装或恢复时再次通过浏览器烧录。

当在线功能开启时(Settings → System → Online features),Tesserae 会检查新固件。在离线安装中,从固件发布页下载 descriptor-<kind>.json 文件,并在 Manual import 下导入。

常见问题​

Q1:烧录工具找不到我的设备​

  • 使用支持数据传输的 USB-C 线缆,以及支持数据传输的 USB 接口。一些台式机机箱的前置接口不支持数据。
  • 使用 Chrome 或 Edge。Firefox 和 Safari 不支持 Web Serial。
  • 在 macOS 上使用 reTerminal E 系列时,请安装并启用 CH340 驱动程序(参见步骤 2)。
  • 关闭任何可能正在使用串口的其他程序。

Q2:设备没有出现在 Discovered 下​

  • 检查设备是否已退出设置模式。如果仍显示设置界面,请重新输入 Wi-Fi 信息。
  • 确保你的 Wi-Fi 网络为 2.4 GHz。
  • 检查服务器地址是否能在同一网络的其他设备上正常访问,例如在浏览器中打开 http://<your-server>:8765。

Q3:设备显示 “Can't reach the server” 或 “Wi-Fi unavailable”​

设备会在面板上显示问题并自行重试。如果 Wi-Fi 断开,它会每分钟重试一次,持续约 12 分钟,然后打开一次设置门户,持续 15 分钟。之后它会在后台持续重试已保存的网络,并在网络恢复时重新加入。要再次打开设置门户,请重启设备或按下前置按钮。

Q4:画面已下载但面板没有刷新​

电池电量可能过低,无法刷新面板。请连接 USB 供电,充电一小时后再试。

特别鸣谢​

特别感谢 Seeed Studio 团队在 reTerminal E 系列和 Sticky 早期开发过程中的全程支持,尤其感谢 Mason Cao 和 Lily Li。

同时也感谢为该项目做出贡献的 Tesserae 贡献者们,特别是 skynet01、charmmmz、theiereman、vaibhav8a、partridgeworks、bablokb、varanu5 和 Frankynov,以及更广泛的社区在小部件、固件测试和硬件反馈方面所做的工作,使本次集成成为可能。

资源​

技术支持与产品讨论​

感谢你选择我们的产品!我们将为你提供多种支持,以确保你在使用我们产品时拥有尽可能顺畅的体验。我们提供多种沟通渠道,以满足不同的偏好和需求。

Loading Comments...