TRMNL 7.5英寸(OG) DIY 套件与 TRMNL 配合工作

什么是 TRMNL?
TRMNL 是一个创新平台,旨在帮助人们在日益分散注意力的数字世界中保持专注和冷静。TRMNL 成立于 2023 年,迅速成为 E Ink® 仪表板管理的领先解决方案,为显示信息提供了独特的方法,避免了传统屏幕的持续通知和干扰。
从核心来看,TRMNL 建立在这样的理念之上:技术应该增强我们的生活,而不需要持续的关注。该平台通过 E Ink® 显示屏提供了一种优雅的方式来一目了然地查看重要信息,创造了更加用心且较少侵扰的技术体验。
为什么使用 TRMNL?
集成 TRMNL 将带来几个引人注目的好处:
- 简化仪表板创建:TRMNL 不断增长的应用程序和集成库使得创建自定义信息显示变得容易,无需复杂的编程
- 低功耗:TRMNL 高效软件与我们 E Ink® 显示屏最小功耗要求的结合创造了极其节能的解决方案
- 无干扰信息:获取您需要的信息,而无需传统屏幕相关的持续通知和眼疲劳
- 定期更新:TRMNL 的积极开发意味着每周都会添加新功能和集成,不断扩展您显示屏的可能性
- 开发者友好:通过 TRMNL 的开放 API 和开发者工具,您可以为特定需求创建自定义插件和集成
通过将 TRMNL 强大的平台与我们高质量的 E Ink® 显示屏相结合,我们为用户提供了一个优雅的解决方案,用于创建个性化、低功耗的信息仪表板,既尊重他们的注意力,也尊重他们的时间。
TRMNL 入门
TRMNL 账户设置和 TRMNL 访问
在将您的套件连接到 TRMNL 之前,您需要:
-
购买 TRMNL 访问权限
- 在以下网址购买 TRMNL 网络应用程序 + 设备功能的访问权限:https://shop.usetrmnl.com/products/byod
- 这为您提供了使用 TRMNL 平台所需的凭据
- 前往 https://usetrmnl.com/claim-a-device 激活虚拟设备(购买后可能需要最多 10 分钟)
-
创建 TRMNL 账户
- 访问 TRMNL 网站
- 点击"注册"创建新账户
- 按照注册流程操作
您的 TRMNL 凭据是敏感信息。切勿公开分享或将其提交到版本控制系统。
一旦您拥有材料并购买了 TRMNL 访问权限,您就可以继续将设备连接到 TRMNL 平台。如果您遇到任何问题或有疑问,可以直接通过 [email protected] 联系 TRMNL 团队。
固件刷写
如果您获得了全新的套件,它将内置固件。因此您可以跳过此步骤。
要让您的 TRMNL 7.5英寸(OG) DIY 套件与 TRMNL 配合工作,您需要将适当的固件刷写到您的设备上。有三种推荐的方法:
方法 1:通过 TRMNL 网络刷写器刷写(最简单)
请使用 FW 1.5.12 或更新的固件以获得 Seeed 兼容性。
-
前往 TRMNL 网络刷写器
- 访问 https://usetrmnl.com/flash
- 此工具允许您直接从浏览器刷写设备。
- 按照屏幕上的说明完成刷写过程。

方法 2:从源代码构建和刷写(适用于高级用户/开发者)
- 克隆固件仓库
-
访问官方固件仓库并克隆它:
git clone https://github.com/usetrmnl/trmnl-firmware.git
有时我们更新代码需要向 TRMNL 提交 PR 并在显示之前进行审查,如果您想第一时间使用最新的固件版本,您也可以使用 Seeed 项目下的 TRMNL 仓库。
-
访问 Seeed 仓库并克隆它:
git clone https://github.com/Seeed-Projects/Seeed_TRMNL_Eink_Project.git
-
安装 PlatformIO
- 将 PlatformIO 安装为 VSCode 扩展或通过命令行安装。
-
打开项目
- 在 VSCode 中打开克隆的
firmware
文件夹。
- 在 VSCode 中打开克隆的
-
选择正确的环境
- 在
platformio.ini
中,选择TRMNL_7inch5_OG_DIY_Kit
环境。
- 在

- 连接您的设备
- 插入您的 TRMNL 7.5英寸(OG) DIY套件。
-
构建和上传
- 在 PlatformIO 中,点击"Upload"按钮,或运行:
pio run --target upload
- 固件将被编译并上传到您的设备。
- 在 PlatformIO 中,点击"Upload"按钮,或运行:
配置Wi-Fi并向TRMNL发送播放列表
要将您的TRMNL 7.5英寸(OG) DIY套件与TRMNL一起使用并发送播放列表,您首先需要将设备连接到您的Wi-Fi网络。这个过程称为"WiFi配对模式",通过一个简单的强制门户完成。请按照以下步骤操作:
💡 Wi-Fi故障排除? 如果您在将设备连接到Wi-Fi时遇到问题,请参考TRMNL设备Wi-Fi故障排除指南以获得常见网络和路由器兼容性问题的解决方案。
开机并进入配置模式
- 刷入TRMNL固件并为设备通电后,如果尚未连接到Wi-Fi,它将自动进入配置模式。

连接到TRMNL Wi-Fi
- 在您的手机或电脑上,打开可用Wi-Fi网络列表。
- 查找名为TRMNL的网络并连接到它。(默认情况下不需要密码。)

打开强制门户
- 连接后,打开网络浏览器(如Chrome或Edge)。
- 设备应该自动将您重定向到TRMNL配置页面。如果没有,请在浏览器中手动访问http://4.3.2.1。
输入您的Wi-Fi凭据
- 在配置页面上,您将看到可用Wi-Fi网络的列表。
- 选择您的2.4GHz Wi-Fi网络(TRMNL不支持5GHz网络)。
- 输入您的Wi-Fi密码。
- 点击保存或连接。
⚠️ 重要: 确保使用2.4GHz Wi-Fi网络。ESP32-C3芯片不支持5GHz网络。

设备连接到您的网络
- 设备将尝试连接到您的Wi-Fi。
- 成功后,它将断开与TRMNL Wi-Fi的连接并加入您的家庭网络。
- 窗口将显示设备的MAC地址。请记录MAC地址,因为您在后续步骤中需要它。

⚠️ 注意: MAC地址在强制门户中只显示1-2秒。如果您错过了,您也可以:
- 从VS Code > PlatformIO构建/上传日志中检索它。
- 使用usetrmnl.com/flash方法,并在刷写过程中检查Chrome/Edge/Firefox开发者控制台中的MAC地址。
- 在您的路由器或Mesh网络应用的已连接设备列表中找到它。
有关更多详细信息和截图,请参阅官方指南:查找您的TRMNL MAC地址
访问TRMNL Web界面
在您的TRMNL 7.5英寸(OG) DIY套件连接到Wi-Fi并记录其MAC地址(设备ID)后,您可以将其添加到您的TRMNL账户:
-
打开TRMNL Web界面
- 在您的电脑或移动设备上,打开浏览器并访问TRMNL web界面。
-
转到设备页面
- 在TRMNL界面中,导航到设备部分。
-
添加新设备
- 点击添加新设备按钮,通常位于右上角或设备页面的中央。
-
输入设备ID
- 在弹出窗口中,输入您购买TRMNL访问权限时收到的设备ID(这不是MAC地址)。使用购买确认邮件或TRMNL仪表板中的设备ID。
- 点击添加新设备完成该过程。
-
注册XIAO 7.5"设备MAC地址
为了在XIAO电子纸面板和TRMNL之间建立连接,我们需要在TRMNL设置页面中绑定正确的设备MAC地址。
-
您可以在PlatformIO上传过程中检索MAC地址(检查上传日志),或从配置门户中获取(它将在Wi-Fi设置后显示)。
-
提前添加您的MAC地址有助于确保顺畅的入门过程和设备管理。
-
然后您可以为您的电子纸面板设置自定义名称,并根据需要调整其他设置。
-
您的TRMNL 7.5英寸(OG) DIY套件现在已链接到您的TRMNL账户!您现在可以直接从TRMNL界面向您的显示器发送播放列表、图像或其他内容。
💡 提示: 如果您有多个电子纸面板,请使用它们各自的唯一设备ID为每个设备重复上述步骤。
在TRMNL web界面中添加您的设备后,请转到设备的设置页面并关闭****固件早期发布和启用OTA更新。
如果这些选项保持启用状态,您的设备在连接到互联网时可能会自动从 TRMNL 下载并安装固件更新。这些更新是为官方 TRMNL 硬件设计的,与 TRMNL 7.5inch(OG) DIY 套件不兼容。安装不兼容的固件可能会导致您的设备出现故障或无响应。
请始终保持这两个选项处于禁用状态,以确保您的 XIAO ePaper Panel 稳定运行。
了解 TRMNL 播放列表功能

TRMNL 播放列表功能允许您精确控制在 ePaper Panel 上显示的内容以及显示时间。以下是主要部分和控件的详细说明,如上面的截图所示:
播放列表概览
- 播放列表标题:在顶部,您可以看到 TRMNL 设备的名称(例如,"MengDu's TRMNL")。
- 显示时间范围:您可以设置播放列表活跃的时间范围(例如,从 00:00 到 23:45)。
- 更新间隔:选择显示更新的频率(例如,每 5 分钟)。
- 添加组 / 添加插件:使用这些按钮将播放列表组织成组或添加新的内容插件(如天气、日历或自定义文本)。
播放列表项目
播放列表中的每一行代表将在您的 ePaper Panel 上显示的屏幕或小部件(仅供参考):
- 天气
- 显示您选择位置的当前天气信息。
- 绿色的"Displayed now"标签表示此屏幕当前正在您的设备上显示。
- 今年剩余天数
- 显示当前年份剩余天数的倒计时(例如,"2025")。
- 标签(例如,"9 days ago")显示此屏幕上次更新或显示的时间。
- 自定义文本
- 让您显示任何自定义消息(例如,"Hello World")。
- 也显示上次更新的时间。
对于每个项目,您有几个控制选项:
- 设置(齿轮图标):配置插件的选项。
- 删除(X 图标):从播放列表中移除项目。
- 预览(眼睛图标):预览屏幕的外观。
- 重新排序(条形图标):拖动以更改屏幕显示的顺序。
智能播放列表
- 智能播放列表选项:在底部,您可以选择是否自动跳过内容未更改的屏幕(例如,"Never skip screens")。
📖 想了解更多?阅读智能播放列表博客文章获取高级技巧和详细信息。
这个灵活的播放列表系统让您完全自定义 ePaper Panel 显示的内容、更新频率和显示顺序。您可以混合搭配不同的插件来创建符合您需求的个性化仪表板。
探索 TRMNL 插件
TRMNL 的插件系统是让您的 ePaper Panel 真正强大和可定制的关键。插件是模块化的应用程序或小部件,您可以将其添加到设备中以显示各种信息和内容。

什么是插件?
插件是独立的内容块,可以显示天气、日历事件、股票价格、RSS 订阅、励志名言、GitHub 活动等内容。您可以混合搭配插件来创建符合您需求的仪表板。
已连接的插件
在插件页面的顶部,您将看到已连接到 TRMNL 账户的所有插件。这些插件已准备好添加到播放列表中并在 ePaper Panel 上显示。示例包括:
- 天气:显示当前天气状况。
- 今年剩余天数:年底倒计时。
- 股票价格:跟踪您喜爱的股票。
- RSS 订阅:显示新闻或博客更新。
- Reddit、Hacker News:显示热门帖子。
- 语言学习、励志名言、自定义文本:使用学习工具或自定义消息个性化您的显示。
插件市场
在已连接的插件下方,您将找到插件市场。在这里您可以浏览、搜索和发现要添加到设备的新插件。插件按类别和标签(如 #productivity、#news、#ecommerce 等)组织,便于找到您需要的内容。
- 浏览和搜索:使用搜索栏或标签快速找到您感兴趣的插件。
- 添加插件:点击任何插件将其连接到您的账户并开始在播放列表中使用。
开发者甚至可以创建和发布自己的插件供他人使用,使生态系统不断扩展新的可能性(了解更多关于插件创建的信息)。
如果您对使用 TRMNL 有任何疑问或想探索更多高级功能,欢迎阅读官方 TRMNL 文档获取更多信息:https://docs.usetrmnl.com/go
特别感谢
特别感谢整个 TRMNL 团队 对本项目的大力支持和宝贵帮助。特别地,我们要感谢 Bogdan、Ryan Kulp、Fr3d 以及所有其他团队成员在整个开发和文档编写过程中的奉献和协助。
您的专业知识和承诺使这一集成成为可能,并极大地改善了 TRMNL 7.5英寸(OG) DIY 套件社区的用户体验。
资源
- [GITHUB]: TRMNL 固件仓库
- [固件] TRMNL 电子纸库 (GitHub)
- [硬件] 驱动板原理图
- [可打印] 三角形底座
- [可打印] L形底座
- [Thingiverse] 三角形底座
- [Thingiverse] L形底座
技术支持与产品讨论
感谢您选择我们的产品!我们在这里为您提供不同的支持,以确保您使用我们产品的体验尽可能顺畅。我们提供多种沟通渠道,以满足不同的偏好和需求。