reTerminal E1003 入门指南

介绍
reTerminal E1003 是一款 10.3 英寸、支持触控的开源黑白电子纸显示屏,具备 16 级灰度和 1404×1872 像素的高分辨率,在每天刷新一次的情况下,电池续航最长可达 6 个月。其由 ESP32-S3 驱动,原生支持我们的 SenseCraft HMI 零代码 UI 平台,可轻松创建仪表盘。无论是智能家居仪表盘可视化与控制、办公信息显示,还是教育项目,这款开箱即用的触控设备都能提供出色的显示效果和灵活的自定义能力,满足你的各种需求。
reTerminal E1003 的触控交互自 SenseCraft HMI 固件 v1.1.2 起开始支持。目前最新版本为 v1.1.4.3 —— 我们建议升级到该版本以获得最佳体验。 与触控相关的库支持计划在未来开源发布,以提供更大的面板自定义灵活性。更多更新将很快与大家分享。
针对 reTerminal E1003 的 ESPHome 支持正在开发中,将在未来版本中提供。
特性
- 3 秒全屏刷新,实现响应更快的电子纸仪表盘
- 借助 SenseCraft HMI 和触控支持,轻松构建交互式界面
- 16 级灰度与高分辨率电子纸显示,呈现清晰细腻的画面
- 最长 6 个月电池续航(基于每天刷新一次)
- 灵活的软硬件自定义能力
规格参数
| 项目 | 描述 |
|---|---|
| 产品名称 | reTerminal E1003 |
| 处理器 | ESP32-S3,带 8MB PSRAM |
| 存储 | 32 MB Flash;支持 microSD 卡 |
| 显示 | 10.3" 黑白 / 16 级灰度 |
| 分辨率 | 1404 x 1872 像素 |
| Micro SD 卡 | 支持最大 32 GB(FAT32)microSD 卡 |
| 无线连接 | 2.4GHz 802.11 b/g/n Wi-Fi,Bluetooth 5.0 |
| 传感器 | 温度、湿度传感器 |
| 麦克风 | 为语音交互应用预留 |
| 音频 | 蜂鸣器,用于声音提醒 |
| 电池 | 3000mAh |
| 电源输入 | USB-C 5V/1A |
| 工作温度 | 0-40°C |
| 尺寸 | 224mm x 187mm x 18.6mm |
应用场景
- 家庭自动化仪表盘: 通过 Home Assistant 显示温度、湿度、空气质量等智能家居实时数据。
- 低功耗黑白电子相框: 借助 SenseCraft HMI 或 App,你可以轻松远程上传相册中的一系列照片。配合大尺寸、高分辨率的黑白电子墨水屏,实现超低功耗的图像显示,让你不再担心电池续航。
- 智能办公显示屏: 在低功耗、常亮的电子纸屏幕上显示会议室占用情况、办公日程或指引信息。
- 零售与公共信息显示: 用于菜单、时刻表或占用指示的低功耗电子纸标牌,具备长续航能力。
硬件概览

- 屏幕刷新按键: 位于设备顶部,用于手动刷新屏幕。
- 翻页按键: 位于设备顶部,用于在页面之间导航。
- Wi-Fi 天线区域: 位于设备底部,用于 Wi-Fi 连接。
- MicroSD 卡 / TF 卡槽: 用于扩展存储(FAT32,最大 32GB)。
- 电源开关: 用于打开或关闭设备。
- 红色电源指示灯: 指示电池充电状态。
- 绿色状态指示灯: 指示当前运行或系统状态。
- USB-C 数据与充电接口: 用于给设备充电和进行数据传输。
- 扩展接口: 排针提供 VDD、GND、I2C 和 GPIO 连接,用于外接传感器、模块或外设。
- 支架安装螺丝孔: 位于设备背面的螺纹孔,用于固定支架。
- 3D 打印支架: 随机附带的支架配件,用于将设备竖直放置在平面上。
- 支架安装螺丝: 用于将支架固定到设备上的螺丝。
快速上手
reTerminal E1003 预装了支持 SenseCraft HMI 的固件,这是一个零代码平台,可让你轻松设计并部署个性化仪表盘。
前期准备
步骤 1. 打开 reTerminal E1003 包装盒,确认所有配件齐全:
- reTerminal E1003 电子纸显示屏
- USB Type-C 线缆
- 快速入门指南
- 螺丝刀
- 螺丝
- 3D 打印支架
步骤 2.(可选)安装 3D 打印支架,使设备可以竖直放置:
找到包装中附带的 3D 打印支架,将支架对准 reTerminal E1003 背面带有嵌入螺母的指定安装区域。使用螺丝刀将螺丝拧入 reTerminal E1003 背面的嵌入螺母中,将支架牢固固定在设备上。安装完成后,将 reTerminal E1003 放置在平坦的表面上,支架即可将其竖直支撑。
该支架提供固定的观看角度,无法调节。此固定角度旨在在大多数使用场景下提供最佳可视性。
步骤 3.(可选)如果计划将设备用作电子相框或需要额外存储空间,请插入 microSD 卡。
reTerminal E 系列电子纸显示屏仅支持最大 32GB 且为 FAT32 格式的 MicroSD 卡。
32GB SD 卡默认格式为 exFAT。将其格式化为 FAT32 后,即可成功挂载并用于存储图片。
步骤 4.(可选)如有需要,安装 USB 驱动:
根据你的操作系统,你可能需要安装 USB 驱动,以确保能够与 reTerminal E1003 正常通信:
- Windows
- MacOS
- Linux
- Windows 11 系统通常已默认包含该驱动
- 对于 Windows 10 及更早版本,你可能需要从 WCH 官方网站 下载并安装 CH341 驱动
如果你使用的是 Mac,并且之前没有手动安装过 CH34X 驱动,请按照以下步骤完成安装:
步骤 1. 下载并安装驱动
从 WCH 官方页面 下载驱动,并运行 CH34xVCPDriver.pkg。
如果 macOS 阻止安装,请前往 System Settings → Privacy & Security,向下滚动找到被阻止的 WCH 软件,然后点击 Allow。


步骤 2. 启用驱动扩展(关键) 从 Launchpad 打开 CH34xVCPDriver 应用,点击 Install,然后前往 System Settings → General → Login Items & Extensions → Driver Extensions。将 CH34xVCPDriver Extensions 切换为 ON(蓝色)。


步骤 3. 连接并验证 确保设备 电源开关已打开,并使用 数据 USB-C 线缆(非仅充电线)。打开 Terminal 并运行:
ls /dev/tty.wch*
# Expected output: /dev/tty.wchusbserialxxx

如果你在输出中看到设备路径,说明驱动已正确安装,你的 reTerminal 已经可以使用了!
Ubuntu 22.04 及更高版本默认已包含所需驱动。 对于更早的发行版,如果设备未被识别,你可能需要手动加载驱动。
开机
步骤 1. 将电源开关拨到 ON 位置为设备上电。电源开关位于机身背面。

步骤 2. 首次启动时,设备会显示产品信息和网络设置说明。

步骤 3. 绿色状态指示灯会亮起约 3 秒然后熄灭,这表示设备已上电并正在初始化。如果在 30 秒内没有进行任何操作,设备会自动进入睡眠模式以节省电量。
因此,我们需要在这段时间内完成后续的网络配置步骤。当设备进入睡眠后,你将无法找到设备的热点。如果出现这种情况,可以按下机身顶部的 Refresh 按钮唤醒设备。
网络设置
- Network Setup via PC
- Network Setup via SenseCraft APP
步骤 1. 使用手机或电脑连接设备的 Wi-Fi 接入点。AP 名称会显示在屏幕上(无需密码)。网络凭据格式为 reTerminal E1003-{MAC Address}。

步骤 2. 连接成功后,你的手机应会自动跳转到 Wi-Fi 配置页面。如果没有自动跳转,你可以使用手机扫描 reTerminal E1003 屏幕上显示的二维码,或手动打开浏览器并访问 192.168.4.1。
如果你输入了错误的密码,只需重新输入并再次提交即可。

步骤 3. 选择你的本地 Wi-Fi 网络并输入密码,然后点击 “Connect”。
reTerminal E 系列电子墨水屏仅支持 2.4 GHz Wi-Fi 网络,不支持 5 GHz 或其他频段。
步骤 4. 连接成功后,设备会发出提示音并显示配对码界面。

连接到 SenseCraft 平台
步骤 1. 在浏览器中访问 SenseCraft HMI,创建账号或登录。
步骤 2. 在左侧边栏点击 Device 进入设备页面,然后点击左上角的 + New Device 按钮。

步骤 3. 为你的设备命名,并输入设备屏幕上显示的配对码,然后点击 Create。

步骤 4. 配对成功后,设备会显示一条消息,提示你创建第一个仪表盘。

此方法通过 SenseCraft 手机应用使用蓝牙为设备配置网络,并将其添加到你的 SenseCraft 账号中。
首先,下载 SenseCraft App。你可以在 Google Play 商店或 Apple App Store 中搜索 “SenseCraft” 获取。或者,你也可以从本网站下载。
步骤 1. 打开 SenseCraft App,登录你的账号,并进入 User 选项卡。点击 Device Bluetooth Configuration 开始配置流程。

步骤 2. 在 “Please select the device type” 界面中,选择 reTerminal E1003。

步骤 3. 按照屏幕提示将设备置于蓝牙广播模式。确保手机的蓝牙已开启。点击 Scan,应用会搜索附近的设备。从列表中选择你的设备进行连接。

步骤 4. 通过蓝牙连接成功后,应用会提示你进行 Wi-Fi 设置。从下拉列表中选择本地 2.4GHz Wi-Fi 网络,输入密码,然后点击 Next。
设备只能通过 2.4 GHz Wi-Fi 网络进行配置。

步骤 5. 应用会将 Wi-Fi 凭据发送到设备,并将其添加到你的 SenseCraft 账号中。完成后会显示 “Device added successfully” 提示。现在你可以点击 Start exploring! 继续操作。

步骤 6. 你的 reTerminal 现在会出现在应用主界面 Device 选项卡的设备列表中,并已成功连接到你的 SenseCraft 账号。

步骤 7. 你可以点击列表中的设备进入其 Device Detail 页面。在这里,你可以管理设备并上传照片。对于更复杂的仪表盘和画布设计,系统会提示你使用 SenseCraft 的网页版。

固件更新
设备成功添加到你的 SenseCraft 账号后,平台会自动检查固件版本。如果有更新的固件可用,你会收到更新提示。
你也可以随时手动检查固件版本:
步骤 1. 在 Device 页面找到你的 reTerminal E1003 查看其详情,并记下 当前固件版本。

步骤 2. 在左侧边栏点击 Tools,打开 Firmware Flasher 选项卡,以查看该设备可用的 最新固件版本。

步骤 3. 如果当前版本低于最新版本,请按照 Firmware Flasher 页面上的 3 步流程进行更新:
-
选择你的设备 — 使用 USB-C 线将 reTerminal E1003 连接到电脑,确保电源开关处于 ON 状态,然后点击 Select 并在列表中选择你的设备。
-
选择固件 — 在下拉菜单中选择最新的固件版本。
-
烧录(Flash) — 点击 Flash 并等待更新完成。仅当你希望将设备恢复到出厂状态时才启用 Full Flash(所有数据、设置和设计都会被清除)。
-
更新固件可以确保最佳性能并获取最新功能。reTerminal E1003 的触控交互需要固件版本 v1.1.2 或更高。当前最新版本为 v1.1.4.3 —— 我们建议更新到该版本以获得最佳体验。
-
当设备处于关机或睡眠状态时,无法正确烧录固件。如果你选择了正确的设备端口却始终看不到固件烧录进度,可能需要按下机身顶部的 Refresh 按钮唤醒设备,然后重试。
-
执行标准 Flash 可保留你的配置:Wi-Fi、已部署的设计和图片都会被保留。执行 Full Flash 以全新开始:所有数据、设置和设计都会被清除(恢复出厂状态)。
在你的 reTerminal E1003 上显示内容
设备配对完成后,你就可以开始使用它来显示你想要的内容。我们推荐使用 SenseCraft HMI —— 一个零代码云平台,只需几次点击即可为你的 reTerminal E1003 设计并部署内容。
SenseCraft HMI 拥有专门的 Wiki,提供完整的教程和功能文档。有关更深入的指南(账号设置、固件烧录、高级编辑器使用、部署等),请参考:
由于本文是一篇产品入门指南,我们不会在这里重复相同的内容——下面只展示如何在你的 reTerminal E1003 上快速显示一些内容。
首页 — 从社区模板开始
在屏幕上快速显示内容的最快方式是从一个现成的模板开始。在 SenseCraft HMI 的 Home 页面,你可以找到由社区贡献的大量且持续增长的模板集合——仪表盘、时钟、天气面板、语录墙、日历、相框等。浏览图库,选择你喜欢的任意设计,一键部署到你的 reTerminal E1003 上。

工作区 — 管理和设计你的自定义内容
Workspace 页面用于管理当前绑定设备上显示的所有页面和内容。在这里你可以:
- 从零开始创建和排列你自己的设计页面
- 上传图片并将其组织成幻灯片
- 在一个拖放式编辑器中组合文本、小部件、形状、数据、RSS 源、网页内容等
- 将最终设计通过无线方式部署到你的 reTerminal E1003

设计保存后,点击 Deploy to Device,选择与你配对的 reTerminal E1003,内容就会通过无线方式传输到设备上。电子纸显示屏将更新以显示你的设计。触摸交互需要固件 v1.1.2 或更高版本——当前最新版本为 v1.1.4.3,我们建议更新到该版本以获得最佳体验。
关于其他所有内容——详细的编辑器操作、技巧和发行说明——请参考 SenseCraft HMI Wiki。
手动设备控制
刷新按钮

设备顶部的刷新按钮具有以下几个功能:
-
单击:手动刷新显示并从 SenseCraft 平台检查新内容。蜂鸣器会响一声以确认操作。当设备进入睡眠且仪表盘无法立即刷新时,此按钮也常用于唤醒设备。
-
长按(未来功能):将激活语音输入模式。
导航按钮
如果你的仪表盘包含多个页面,左右按钮可用于在多个页面之间导航:
-
左键:导航到上一页
-
右键:导航到下一页
网络重置

如果你需要连接到不同的 Wi-Fi 网络:
步骤 1. 同时按住两个导航按钮(左和右)2 秒。
步骤 2. 设备将进入 Wi-Fi 配置模式,你可以再次按照 Network Setup 的步骤连接到新网络。
LED 指示灯
-
所有 LED 熄灭:
- 未连接 USB 线缆
-
红色 LED:
- 当连接 USB 线缆且正在充电时常亮
-
绿色 LED:
- 每次上电时点亮约 3 秒,然后熄灭
- 当连接 USB 线缆且电池已充满时常亮
电池工作
当使用电池供电时:
-
设备将在两次刷新之间自动进入低功耗模式
-
电池寿命取决于刷新频率(在满电且每天刷新一次的情况下,典型续航为 6 个月)
-
当电池电量低于 20% 时,设备会在右上角显示低电量图标
如果你想自己编写一些代码来读取电池电压,在 analogRead() 函数前增加 10ms 延时会更加精确。

扩展引脚
reTerminal E1003 配备了一个 6 针扩展排针(J2),可用于连接外部传感器、模块或其他硬件,以扩展设备功能。该扩展排针引出了多个 ESP32-S3 GPIO 引脚和通信接口,使其成为 DIY 项目中一个多功能的连接点。
扩展排针引脚定义
6 针扩展排针(J2)的引脚定义如下:
| 引脚(从上到下) | 标记 | ESP32-S3 引脚 | 功能 | 描述 |
|---|---|---|---|---|
| 1 | HEADER_3V3 | - | 电源 | 为外部设备提供 3.3V 电源 |
| 2 | GND | - | 地 | 公共接地参考 |
| 3 | ESP_IO47 | GPIO47 | GPIO/ADC | 通用 I/O,具备模拟输入能力 |
| 4 | ESP_IO6/ADC1_CH | GPIO6 | GPIO/ADC | 通用 I/O,具备模拟输入能力 |
| 5 | ESP_IO20/I2C0_SCL | GPIO20 | GPIO/I2C SCL | GPIO 或 I2C 时钟信号 |
| 6 | ESP_IO19/I2C0_SDA | GPIO19 | GPIO/I2C SDA | GPIO 或 I2C 数据信号 |
故障排查
Q1:设备无法开机
- 确保电源开关处于 ON 位置
- 连接 USB-C 线缆为设备充电
- 检查红色 LED 是否常亮(表示正在充电)
- 如果使用电池供电,确保电池连接正确且已充电
Q2:无法连接到 Wi-Fi
- 确认你输入了正确的 Wi-Fi 密码
- 确保你的 Wi-Fi 网络工作正常
- 检查你的 Wi-Fi 路由器是否支持 2.4GHz 网络(不支持 5GHz)
- 尝试将设备放置在更靠近 Wi-Fi 路由器的位置
Q3:显示未更新
- 按下刷新按钮手动触发一次更新
- 确认设备已连接到 Wi-Fi(角落中没有断网图标)
- 检查你的 SenseCraft 账户,确保仪表盘已正确部署
- 如果问题仍然存在,尝试重启设备
- 如果重启后设备仍无响应,请在 SenseCraft HMI 平台上重新烧录相应固件,并检查是否恢复正常刷新
Q4:网络连接丢失
- 设备会自动尝试重新连接到已知网络
- 重新连接后,Wi-Fi 断开图标将消失
- 如果无法重新连接,请按照上文的网络重置步骤操作
资源
技术支持与产品讨论
感谢你选择我们的产品!我们将为你提供多种支持,以确保你在使用我们产品时的体验尽可能顺畅。我们提供多种沟通渠道,以满足不同的偏好和需求。