Skip to main content

搭配 TRMNL 使用

本指南是将 TRMNL 与任意兼容的 Seeed 电子纸产品配合使用的唯一权威参考。在每个需要选择硬件的步骤中选择一次你的硬件，其余工作流程完全相同。

硬件支持

TRMNL 官方支持 reTerminal E1001、reTerminal E1002、TRMNL 7.5" (OG) DIY Kit 和 XIAO 7.5" ePaper Panel。在 E1002 上，目前内容以单色模式渲染——完整彩色渲染计划在未来版本中提供。

什么是 TRMNL？​

TRMNL 是一个创新平台，旨在帮助人们在日益分心的数字世界中保持专注与平静。TRMNL 成立于 2023 年，很快就成为 E Ink® 仪表盘管理的领先解决方案，以独特方式展示信息，同时避免传统屏幕带来的持续通知和干扰。

TRMNL 的核心理念是：技术应当提升我们的生活，而不是不断索取我们的注意力。该平台通过 E Ink® 显示屏，以优雅的方式让你一眼查看重要信息，打造更专注、更少打扰的技术体验。

为什么要使用 TRMNL？​

  • 简化的仪表盘创建：TRMNL 不断增长的应用和集成库，让你无需复杂编程即可轻松创建自定义信息显示。
  • 低功耗：TRMNL 的高效软件结合 E Ink® 极低的功耗需求，构成一个极其节能的解决方案。
  • 无干扰的信息展示：在没有通知和眼睛疲劳的情况下获取所需信息。
  • 定期更新：TRMNL 正在积极开发中，每周都会加入新功能和新集成。
  • 对开发者友好：TRMNL 的开放 API 和开发者工具支持自定义插件和集成。

兼容硬件​

reTerminal E1001reTerminal E1002TRMNL 7.5" (OG) DIY KitXIAO 7.5" ePaper Panel
7.5" 单色
一体化终端		7.3" Spectra 6（彩色）
一体化终端
在 TRMNL 中为单色模式		7.5" 单色 + DIY 外壳
XIAO ESP32-S3 Plus 驱动		7.5" 单色裸屏
直接搭配 XIAO ESP32-C3
立即获取 🖱️
立即获取 🖱️
立即获取 🖱️
立即获取 🖱️

步骤 1：TRMNL 账号设置与 BYOD 访问​

在将你的设备连接到 TRMNL 之前，你需要一个 TRMNL 账号和 BYOD（自带设备）访问权限——无论使用哪种硬件，流程都相同。

  1. 购买 TRMNL 访问权限

  2. 创建 TRMNL 账号

    • 访问 TRMNL 官网
    • 点击 "Sign Up" 创建新账号。
    • 按提示完成注册流程。
note

你的 TRMNL 凭据是敏感信息。切勿公开分享，也不要将其提交到版本控制系统中。

如果遇到任何问题，请直接通过 [email protected] 联系 TRMNL 团队。

步骤 2：硬件准备​

reTerminal E 系列和 XIAO 7.5" 面板已预先组装——你只需为其供电即可。TRMNL DIY 套件则需要自行组装。

reTerminal E 系列是完全一体化的。只需连接 USB-C 线并开机，无需任何组装步骤。

步骤 3：烧录 TRMNL 固件​

提供三种烧录方式。**方法 1（网页烧录器）**最为简单，并适用于所有受支持硬件。**方法 2（SenseCraft HMI）**仅适用于 reTerminal E 系列。**方法 3（从源码构建）**适合高级用户。

全新 TRMNL DIY 套件已预装 TRMNL 固件

如果你购买的是全新的 TRMNL 7.5"（OG）DIY 套件，它已经预装了 TRMNL 固件——你可以完全跳过刷机步骤，直接前往步骤 4。

方法一：TRMNL Web Flasher（推荐）​

TRMNL Web Flasher 可直接在浏览器中运行，并支持本页面上的所有设备。

  1. 访问 https://usetrmnl.com/flash。
  2. 通过 USB-C 将设备连接到电脑，并按照屏幕上的指示操作。
  3. 选择与你的硬件匹配的固件：

在 reTerminal E 系列上，为了兼容 Seeed，请使用 FW 1.6.7 或更新版本。

方法二：通过 SenseCraft HMI 平台刷机（仅限 reTerminal E 系列）​

info

此方法仅适用于 reTerminal E1001 / E1002。SenseCraft HMI 刷机工具可以在同一设备上在 SenseCraft HMI 固件和 TRMNL 固件之间切换。

  1. 访问 SenseCraft HMI 设备页面。

  2. 选择你的设备。

  3. 选择 TRMNL 固件（之后你可以在此处切换回 HMI 固件）。点击 Full Flash，然后点击 Flash。

  4. 将设备连接到电脑，并选择串口。

  5. 屏幕会刷新，并显示 TRMNL 标志和 MAC 地址。

方法三：从源码构建并刷写（进阶）​

  1. 克隆固件仓库

    • 访问官方固件仓库并克隆：

      git clone https://github.com/usetrmnl/trmnl-firmware.git
    tip

    有时我们提交到 TRMNL 上游的 PR 仍在审核中。如果你想获取最新的 Seeed 侧补丁，请改用 Seeed 镜像：

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

  2. 安装 PlatformIO，可以作为 VS Code 扩展或通过命令行安装。

  3. 打开项目：在 VS Code 中打开克隆得到的 firmware 文件夹。

  4. 为你的硬件选择正确的 PlatformIO 环境：

    在 platformio.ini 中：

    • 对于 reTerminal E1001，选择 seeed_reTerminal_E1001 环境。
    • 对于 reTerminal E1002，选择 seeed_reTerminal_E1002 环境（TRMNL 在 E1002 上以单色方式渲染内容）。

  5. 通过 USB-C 连接你的设备。

  6. 构建并上传：点击 PlatformIO 的 Upload 按钮，或运行：

    pio run --target upload

步骤 4：配置 Wi-Fi 并为设备进行配网​

所有受支持硬件的 Wi-Fi 配网流程完全相同。

💡 连接 Wi-Fi 有问题？ 请参阅 TRMNL 设备 Wi-Fi 故障排查指南。

开机并进入配网模式​

在刷入 TRMNL 固件并为设备上电后，如果尚未连接到 Wi-Fi，它会自动进入配网模式。

连接到 TRMNL Wi-Fi​

在手机或电脑上打开可用 Wi-Fi 网络列表。找到名为 TRMNL 的网络并连接（默认不需要密码）。

打开强制门户页面​

连接后，打开浏览器。设备应自动将你重定向到 TRMNL 配置页面；如果没有，请手动访问 http://4.3.2.1。

输入你的 Wi-Fi 凭据​

  • 选择你的 2.4 GHz Wi-Fi 网络（不支持 5 GHz 网络）。
  • 输入你的 Wi-Fi 密码并点击 Save / Connect。

⚠️ 重要： 请务必使用 2.4 GHz Wi-Fi 网络。这些设备上的 ESP32-C3 / ESP32-S3 芯片不支持 5 GHz 网络。

设备加入你的网络​

设备会断开与 TRMNL Wi-Fi 的连接并加入你的家庭网络。强制门户窗口会显示设备的 MAC 地址。请记录该 MAC 地址——你将在下一步用到它。

⚠️ 注意： MAC 地址只会在强制门户中显示 1–2 秒。如果你错过了它，你也可以：

  • 从 VS Code → PlatformIO 构建/上传日志中获取。
  • 使用 usetrmnl.com/flash 方法，并在刷机过程中查看浏览器开发者控制台。
  • 在你的路由器或 Mesh 网络应用的已连接设备列表中找到它。

请参阅官方指南：查找你的 TRMNL MAC 地址。

步骤 5：在 TRMNL 上注册设备​

当设备已连接到 Wi-Fi 且你已获取其 MAC 地址后，在 TRMNL Web 界面中注册它：

  1. 打开 TRMNL Web 界面：https://trmnl.app。

  2. 进入 Devices 页面。

  3. 添加新设备（右上角或页面中央的按钮）。

  4. 输入你在购买 BYOD 访问权限时收到的 Device ID（这 不是 MAC 地址——在你的购买确认邮件或 TRMNL 仪表盘中查找 Device ID）。点击 Add new device。

  5. 在设备设置页面绑定设备的 MAC 地址：

    你也可以在这里设置自定义名称并调整其他设置。

你的设备现已与 TRMNL 账户关联！你现在可以通过 TRMNL 界面直接发送播放列表、图片和其他内容。

💡 提示： 如果你有多个设备，请为每个设备使用其唯一的 Device ID 重复上述步骤。

禁用固件提前发布与 OTA 更新

在 TRMNL 网页界面中添加设备后，进入该设备的设置页面，并关闭 Firmware Early Release 和 OTA Updates Enabled 这两个选项。

如果保持启用状态，你的设备可能会自动下载面向官方 TRMNL 硬件的固件更新，而这些固件与 Seeed 设备不兼容。安装不兼容的固件可能会导致设备故障或无响应。

请始终保持这两个选项为禁用状态，以确保设备稳定运行。

按钮使用说明​

在 TRMNL 固件下，reTerminal E 系列仅提供一个面向用户的按钮：

  • 绿色按钮 — 长按 5 秒：进入 Wi-Fi 重新配置模式。
  • Reset 按钮：单击以重启设备。

了解 TRMNL 播放列表​

TRMNL 播放列表精确控制你的电子墨水设备上显示的内容以及显示时间。

播放列表概览​

  • Playlist Title：你的 TRMNL 设备名称。
  • Display Time Range：播放列表处于激活状态的时间范围（例如 00:00–23:45）。
  • Update Interval：显示刷新的频率（例如每 5 分钟）。
  • Add a Group / Add a Plugin：将播放列表组织为多个分组，或添加新的内容插件。

播放列表条目​

每一行代表一个将在设备上显示的屏幕或小部件。示例：

  1. Weather — 显示你所在位置的当前天气信息。
  2. Days Left This Year — 显示本年度剩余天数的倒计时。
  3. Custom Text — 显示任意自定义消息（例如 "Hello World"）。

对于每个条目：

  • Settings（齿轮图标）：配置插件选项。
  • Delete（X 图标）：从播放列表中移除该条目。
  • Preview（眼睛图标）：预览屏幕显示效果。
  • Reorder（条形图标）：拖动以更改顺序。

智能播放列表​

在底部你可以选择是否自动跳过内容未发生变化的屏幕。详情请参阅 Smart Playlists 博客文章。

探索 TRMNL 插件​

插件是模块化的内容块，可以显示天气、日历事件、股票价格、RSS 源、励志语录、GitHub 活动等更多内容。

已连接插件​

在 Plugins 页面顶部，你可以看到所有已连接到 TRMNL 账户的插件。例如 Weather、Days Left This Year、Stock Price、RSS Feed、Reddit、Hacker News、Language Learning、Motivational Quote、Custom Text 等。

插件市场​

在已连接插件下方，你可以找到插件市场。插件按类别和标签（#productivity、#news、#ecommerce 等）进行组织。你可以浏览、搜索，并点击任意插件将其连接到你的账户。

开发者也可以创建并发布自己的插件 — 详情请参阅 plugin marketplace 文档。

更多高级功能请参阅 TRMNL 官方文档：https://docs.usetrmnl.com/go。

故障排查​

如何重新配置网络？​

长按 绿色按钮 5 秒。设备将返回到初始 TRMNL 界面并激活 AP。

Web Flasher / PlatformIO 无法找到设备或上传失败​

有时错误的程序会导致 XIAO 丢失端口或无法正常工作：

  • XIAO 已连接，但未找到端口号。
  • XIAO 已连接，端口出现，但上传失败。

将 XIAO 置于 BootLoader 模式以恢复：

  • 步骤 1：按住 XIAO ESP32-S3 / ESP32-C3 上的 BOOT 按钮且不要松开。
  • 步骤 2：在持续按住 BOOT 的同时，通过 USB-C 将设备连接到电脑。设备连接后再松开 BOOT。
  • 步骤 3：重新执行上传 / 烧录操作。大多数“未识别设备”或“上传失败”的问题都可以通过此方法解决。

特别鸣谢​

特别感谢整个 TRMNL 团队 在本次集成过程中给予的大力支持和宝贵帮助。我们尤其要感谢 Bogdan、Ryan Kulp、Fr3d、Schappi 以及所有其他团队成员在开发和文档编写过程中所付出的努力。

他们的专业知识使本次集成成为可能，并极大提升了 reTerminal E 系列、TRMNL DIY Kit 和 XIAO 7.5" 电子墨水面板社区的使用体验。

资源​

技术支持与产品讨论​

感谢你选择我们的产品！我们将为你提供多种支持，确保你在使用我们产品的过程中尽可能顺畅。我们提供多种沟通渠道，以满足不同的偏好和需求。

Loading Comments...