reTerminal E1003 入门指南

介绍
reTerminal E1003 是一款 10.3 英寸支持触控的开源黑白电子纸显示屏,具备 16 级灰度和 1404×1872 像素的高分辨率,电池续航最长可达 6 个月。其由 ESP32-S3 驱动,原生支持我们的 SenseCraft HMI 零代码 UI 平台,可轻松创建仪表盘。无论是智能家居仪表盘可视化与控制、办公信息显示,还是教育项目,这款开箱即用的触控设备都能提供出色的显示效果和灵活的自定义能力,满足你的各种需求。
reTerminal E1003 的触控交互从 SenseCraft HMI 固件 v1.1.2 开始支持。 与触控相关的库支持计划在未来开源发布,以提供更大的面板自定义灵活性。更多更新将很快与大家分享。
针对 reTerminal E1003 的 ESPHome 支持正在开发中,将在未来版本中提供。
特性
- 3 秒全屏刷新,实现更快速响应的电子纸仪表盘
- 借助 SenseCraft HMI 和触控支持轻松构建交互界面
- 16 级灰度与高分辨率电子纸显示,呈现清晰细腻的视觉效果
- 6 个月电池续航,实现真正无电缆部署
- 灵活的软硬件自定义能力
规格参数
| 项目 | 描述 |
|---|---|
| 产品名称 | reTerminal E1003 |
| 处理器 | ESP32-S3,带 8MB PSRAM |
| 存储 | 32MB Flash,支持 Micro SD 卡 |
| 显示 | 10.3" 黑白 / 16 级灰度 |
| 分辨率 | 1404 x 1872 像素 |
| Micro SD 卡 | 最大支持 32GB SD 卡,FAT32 格式 |
| 无线连接 | 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 |
硬件总览

- 电子纸显示屏: 10.3"、16 级灰度电子纸显示屏,支持电容触控。
- 按键: 位于设备顶部,用于手动操作屏幕。
- 麦克风: 为语音交互应用预留。
- MicroSD 卡 / TF 卡槽: 用于扩展存储(FAT32,最大 32GB)。
- 电源开关: 用于打开或关闭设备。
- 红色充电指示灯: 指示电池充电状态。
- 绿色状态指示灯: 指示当前运行或系统状态。
- USB-C 数据与充电接口: 用于设备充电和数据传输。
- 扩展接口: 排针提供 VDD、GND、UART、I2C 和 GPIO 连接,用于外接传感器、模块或外设。
- 蜂鸣器: 声音提醒的音频输出孔。
- 支架安装螺母: 嵌入在设备背面的螺母(螺丝孔),用于安装 3D 打印支架。
应用场景
- 3 秒全屏刷新,实现更快速响应的电子纸仪表盘
- 借助 SenseCraft HMI 和触控支持轻松构建交互界面
- 16 级灰度与高分辨率电子纸显示,呈现清晰细腻的视觉效果
- 6 个月电池续航,实现真正无电缆部署
- 灵活的软硬件自定义能力
入门
reTerminal E1003 预装了支持 SenseCraft HMI 的固件,这是一个零代码平台,可让你轻松设计并部署个性化仪表盘。
准备工作
步骤 1. 打开 reTerminal E1003 包装盒,确认所有配件齐全:
- reTerminal E1003 设备
- USB-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
开机
步骤 1. 将电源开关拨到 ON 位置以开启设备。电源开关位于机身背面。

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

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

步骤 2. 连接成功后,你的手机应会自动跳转到 Wi-Fi 配置页面。如果没有自动跳转,请打开浏览器并访问 192.168.4.1。

步骤 3. 选择你的本地 Wi-Fi 网络并输入密码,然后点击 "Connect"。
reTerminal E 系列电子纸显示屏仅支持 2.4GHz WiFi 网络,不支持 5GHz 或其他频段。
步骤 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.4G 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 并等待更新完成。仅当你希望将设备恢复到出厂状态时才启用 Full Flash(所有数据、设置和设计都会被清除)。
-
更新固件可确保最佳性能并获取最新功能。reTerminal E1003 的触控交互需要固件 v1.1.2 或更高版本。
-
当设备处于关机或睡眠状态时,无法正确烧录固件。如果你选择了设备的正确端口,但始终看不到固件烧录进度,你可能需要按下机身顶部的 Refresh 按钮唤醒设备,然后重试。
-
执行标准 Flash 可保留你的配置:Wi-Fi、已部署的设计和图片都会被保留。执行 Full Flash 重新开始:所有数据、设置和设计都会被清除(恢复出厂状态)。
在你的 reTerminal E1003 上显示内容
设备配对完成后,你就可以开始使用它来显示你想要的任何内容。我们推荐使用 SenseCraft HMI —— 一个零代码云平台,只需几次点击即可为你的 reTerminal E1003 设计并部署内容。
SenseCraft HMI 拥有专门的 Wiki,提供完整的教程和功能文档。有关深入指南(账号设置、固件烧录、高级编辑器使用、部署等),请参考:
由于本文是产品 入门指南,我们不会在此重复相同内容——下面仅展示如何在你的 reTerminal E1003 上快速显示一些内容。
Home — 从社区模板开始
最快在屏幕上显示内容的方法是从现成模板开始。在 SenseCraft HMI 的 Home 页面,你会发现一个庞大且持续增长的模板集合,由社区贡献——仪表盘、时钟、天气面板、语录墙、日历、相框等。浏览图库,选择你喜欢的设计,一键部署到你的 reTerminal E1003 上。

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

设计保存后,点击 Deploy to Device,选择与你配对的 reTerminal E1003,内容就会通过无线方式传输到设备上。电子墨水屏会更新以显示你的设计。使用固件 v1.1.2 或更高版本 时,你还可以直接点击电子墨水屏,与支持触控的页面进行交互。
关于其他内容——编辑器的详细操作、技巧和发行说明——请参考 SenseCraft HMI Wiki。
操作设备
刷新按钮

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

如果你需要连接到不同的 Wi-Fi 网络:
步骤 1. 同时按住两个导航按钮(左和右)2 秒钟。
步骤 2. 设备将进入 Wi-Fi 配置模式,你可以再次按照 网络设置 的步骤连接到新的网络。
LED 指示灯
-
红色 LED:
- 关闭:已完全充电或未在充电
- 常亮:正在充电
-
绿色 LED:
- 启动时亮 30 秒:设备正在开机
电池运行
当使用电池供电时:
-
设备将在两次刷新之间自动进入低功耗模式
-
电池寿命取决于刷新频率(在默认设置下,满电通常可使用 3 个月)
-
当电池电量低于 20% 时,设备会在右上角显示低电量图标
如果你想自己编写一些代码来读取电池电压,在 analogRead() 函数前添加 10ms 延时会更加精确。
扩展引脚
reTerminal E1003 配备了一个 8 针扩展排针(J2),可用于连接外部传感器、模块或其他硬件,以扩展设备的功能。该扩展排针引出了多个 ESP32-S3 GPIO 引脚和通信接口,使其成为 DIY 项目中非常灵活的连接点。
扩展排针引脚定义
8 针扩展排针(J2)的引脚定义如下:
| 引脚(从上到下) | 标记 | ESP32-S3 引脚 | 功能 | 描述 |
|---|---|---|---|---|
| 1 | HEADER_3V3 | - | 电源 | 为外部设备提供 3.3V 电源 |
| 2 | GND | - | 地 | 公共地参考 |
| 3 | ESP_IO46 | GPIO46 | GPIO/ADC | 具有模拟输入能力的通用 I/O |
| 4 | ESP_IO2/ADC1_CH4 | GPIO2 | GPIO/ADC | 具有模拟输入能力的通用 I/O(ADC1 通道 4) |
| 5 | ESP_IO17/TX1 | GPIO17 | GPIO/UART TX | GPIO 或 UART 发送(TX)信号 |
| 6 | ESP_IO18/RX1 | GPIO18 | GPIO/UART RX | GPIO 或 UART 接收(RX)信号 |
| 7 | ESP_IO20/I2C0_SCL | GPIO20 | GPIO/I2C SCL | GPIO 或 I2C 时钟信号 |
| 8 | 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 断线图标会消失
- 如果无法重新连接,请按照上面的网络重置步骤操作
Q5:在 macOS 上找不到串口(COM)
如果你的 Mac 无法通过 USB 识别 reTerminal,请按照以下简要指南安装 CH340/CH340K 驱动:
步骤 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 可以正常使用了!
资源
技术支持与产品讨论
感谢你选择我们的产品!我们将为你提供多种支持,以确保你在使用我们产品的过程中尽可能顺利。我们提供多种沟通渠道,以满足不同的偏好和需求。