English | 简体中文

ESP32-based e-ink display system with interactive UI

ESPaperPlay 是一个基于 ESP32 的电子墨水屏项目，提供联网天气显示、智能家居控制、系统设置等的交互界面。使用 SSD1681 芯片驱动的GDEY0154D67 1.54 英寸墨水屏，并基于 LVGL v9 构建 UI。

• 实时联网信息获取
• 天气信息显示 （温度、湿度等历史数据）
• 智能家居控制 （接入Home Assistant，尚未完成）
• 支持局部刷新，优化墨水屏显示性能
• 可扩展的 UI 界面，基于 LVGL v9

• ESP32-WROOM-32E
• GDEY0154D67 电子墨水屏（1.54 英寸）

git clone https://github.com/xiaobao/ESPaperPlay.git
cd ESPaperPlay

idf.py build
idf.py flash
idf.py monitor

• 上电后，使用手机连接 2.4G Wi-Fi；
• 打开 EspTouch 软件，选择 Esptouch 模式 进行配网。

• 墨水屏主界面会显示 时间信息 和 每日一言；
• 可通过触摸屏进行交互操作。

本项目使用 和风天气 API。需要在设备中设置 api_key 与 api_host：

1. 在设备菜单中点击对应设置条目；
2. ESP32 会启动一个 TCP 服务端；
3. 使用网络调试助手等工具：
   • 模式：TCP Client
   • IP 地址：ESP32 的 IP（可在设置中查看）
   • 端口：8080
4. 建立连接后，在发送框中输入 api_key 或其他配置项；
5. 在设备上点击 保存 即可（部分设置需重启后生效）。

注：其他设置项的配置方式与此类似。

本项目采用 MIT License，详见 LICENSE 文件。

项目仍在开发中，存在一些BUG和部分未完成的功能；欢迎您提交Issue以帮助改进本项目。