用ESP32和2.13寸墨水屏DIY一个能传书的阅读器（开源项目复现指南）
用ESP32和2.13寸墨水屏打造无线传书阅读器（全流程实战）
在创客圈里，电子墨水屏总是散发着独特的魅力——那种接近纸质书的显示效果，配上超低功耗的特性，让它成为DIY阅读器的理想选择。而ESP32这颗全能型芯片，凭借双核处理器、WiFi/蓝牙双模和丰富的外设接口，让硬件开发变得前所未有的简单。本文将带你用这两大核心元件，从零构建一个支持无线传书的便携阅读器。
1. 硬件准备与电路搭建
1.1 核心元件选型指南
- 主控板：ESP32-WROOM-32D（建议选择带CP2102串口芯片的版本，调试更方便）
- 显示屏：WeAct 2.13英寸三色墨水屏（型号GDEH0213B72，分辨率250×122）
- 存储模块：MicroSD卡适配器（SPI接口，支持FAT32格式）
- 输入设备：6×6mm轻触按键×3（或使用5向导航键简化布线）
- 电源方案：3.7V 1000mAh锂电池+TP4056充电模块（可选）
提示：购买墨水屏时注意区分黑白和黑白红版本，后者支持红色显示但刷新率较低。
1.2 电路连接详解
参照以下引脚定义进行连接：
| 元件 | ESP32引脚 | 备注 |
|---|---|---|
| 墨水屏SCK | GPIO18 | SPI时钟线 |
| 墨水屏MOSI | GPIO23 | 主设备输出从设备输入 |
| 墨水屏DC | GPIO14 | 数据/命令选择 |
| 墨水屏CS | GPIO4 | 片选信号 |
| 墨水屏RST | GPIO2 | 硬件复位 |
| 墨水屏BUSY | GPIO15 | 忙状态检测 |
| SD卡CS | GPIO5 | 需与屏幕CS不同 |
| 按键左 | GPIO25 | 下拉电阻10KΩ |
| 按键中 | GPIO33 | 需启用内部上拉 |
| 按键右 | GPIO32 | 防抖电容0.1μF |
// 引脚初始化示例（PlatformIO） #define EPAPER_BUSY 15 #define EPAPER_RST 2 #define SD_CS 5 void setup() { pinMode(EPAPER_BUSY, INPUT); pinMode(EPAPER_RST, OUTPUT); pinMode(SD_CS, OUTPUT); // ... }2. 开发环境配置与固件烧录
2.1 PlatformIO环境搭建
- 安装VS Code后搜索安装PlatformIO IDE扩展
- 新建项目时选择"Espressif 32"平台
- 添加必要库依赖：
lib_deps = olikraus/u8g2@^2.34.24 bodmer/EPD@^4.0.0
2.2 源码获取与编译
克隆开源项目并做适应性修改：
git clone https://github.com/example/esp32-reader.git cd esp32-reader # 修改platformio.ini中的板型配置 board = esp32dev upload_speed = 921600注意：首次编译前需执行
pio lib install安装依赖库，遇到内存不足错误时可尝试修改分区方案。
3. 无线传书功能实现
3.1 WiFi工作模式选择
项目支持两种网络模式：
- AP模式：ESP32自建热点，手机直连传输（默认SSID：ESP_Reader）
- STA模式：连接现有路由器（需提前硬编码WiFi凭证）
# 简易Python传书脚本示例 import socket def send_file(ip, filename): with open(filename, 'rb') as f: sock = socket.socket() sock.connect((ip, 8080)) sock.sendall(f.read()) print(f"{filename} 传输完成！")3.2 文件编码处理技巧
由于ESP32默认使用UTF-8编码，而中文电子书可能采用GBK编码，推荐预处理方案：
- 使用iconv命令转换编码：
iconv -f GBK -t UTF-8 input.txt > output.txt - 或在传输客户端中集成转码功能（Java示例）：
InputStreamReader reader = new InputStreamReader( new FileInputStream(file), "GB18030"); OutputStreamWriter writer = new OutputStreamWriter( socket.getOutputStream(), StandardCharsets.UTF_8);
4. 界面优化与功能扩展
4.1 字体更换实战
U8g2库支持多种字体格式，替换步骤：
- 使用 Font Converter 生成新字体
- 替换项目中的
u8g2_font_wqy16_t_gb2312定义 - 调整显示坐标避免文字溢出
4.2 低功耗优化方案
- 深度睡眠模式配置：
esp_sleep_enable_ext0_wakeup(GPIO_NUM_33, HIGH); esp_deep_sleep_start(); - 屏幕刷新策略：
- 翻页时全刷新
- 菜单切换局部刷新
- 闲置10分钟后清屏
5. 常见问题排查指南
5.1 显示异常处理
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 屏幕全白 | 未正确初始化 | 检查RST引脚时序 |
| 文字显示乱码 | 字体文件缺失 | 确认u8g2字体库包含中文字体 |
| 残影严重 | 刷新模式设置不当 | 增加全刷新频率 |
5.2 文件传输失败分析
- 确保客户端与设备在同一网络
- 检查SD卡是否格式化为FAT32
- 使用
telnet 192.168.x.x 8080测试端口连通性
这个项目最让我惊喜的是ESP32的WiFi性能——在STA模式下传输1MB的文本文件仅需3秒左右。不过要注意墨水屏的刷新限制，连续快速翻页可能导致"鬼影"现象，建议在代码中添加200ms的翻页间隔保护。