ESP32电子纸库与示例
ESP32_ePaper_example
ESP32
2/5
已发布
项目简介
为ESP32的全功能ePaper库，含演示应用。
ESP32_ePaper_example 是一个专为 ESP32 微控制器设计的电子纸（ePaper）显示驱动库，核心目标是让开发者能够高效、灵活地驱动基于 GDEH029A1 / SSD1608 控制器的 4 线 SPI 电子纸屏幕。该项目解决了在 ESP32 上使用电子纸时常见的驱动复杂、刷新慢、图形绘制功能匮乏等问题，尤其适合需要低功耗、静态显示且对图形和文字渲染有较高要求的物联网终端设备，如电子价签、智能家居面板、便携式信息看板等。
标签
项目特点
**双模式支持**：支持 4 位灰度模式和 1 位黑白模式，可在运行时动态选择。
**高速 SPI 通信**：基于 spi-master 驱动，采用 DMA 和直接 SPI 组合传输，SPI 速度可达 20 MHz。
**丰富的图形绘制**：提供超过 15 种图形绘制函数，包括像素、线、矩形、圆、椭圆、三角形、多边形、弧等。
**灵活的字体系统**：支持固定宽度和比例字体，内置 8 种字体，可从文件加载无限字体，并包含 7 段矢量字体。
**JPEG 图像显示**：支持从文件或内存缓冲区解码和显示 JPEG 图像，可缩放并转换为 4 位灰度。
**高级字符串输出**：支持任意角度旋转、透明背景、自动换行、居中/右对齐等特殊定位功能。
**完整的演示应用**：包含详细注释的演示程序，展示所有库功能，便于学习和使用。
**SPIFFS 文件系统**：预置 SPIFFS 镜像，包含字体和图片文件，简化部署流程。
技术规格
| 支持控制器 | GDEH029A1 / SSD1608（4线SPI模式） |
|---|---|
| 显示模式 | 4-bit 灰度 / 1-bit 黑白（运行时切换） |
| SPI 最高速度 | 20 MHz |
| 默认引脚 | MOSI:23, SCK:18, CS:5, DC:26, RST:27, BUSY:32 |
| 供电方式 | 3.3V 或 GPIO 引脚供电 |
| 图像格式 | JPEG（基线，YCbCr，采样因子4:4:4/4:2:2/4:2:0） |
| 字体支持 | 内置8种 + 文件字体 + 7段矢量字体 |
| 开发环境 | ESP-IDF（FreeRTOS，建议Tick Rate 1000） |
| 文件系统 | SPIFFS |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| ESP32 开发板（如 SparkFun ESP32 Thing） | 1 | — | 推荐 |
| 2.9英寸 ePaper 模块（Waveshare 或兼容） | 1 | — | 基于 GDEH029A1/SSD1608 |
| 杜邦线（母对母） | 若干 | — | 用于连接 ESP32 和 ePaper 模块 |
| USB 数据线 | 1 | — | 为 ESP32 供电和烧录 |
能力画像
⚪ 记忆与知识检索: 2/5
🔵 逻辑推演: 3/5
⚪ 表达与交流: 1/5
⚪ 感知与观察: 2/5
⚪ 数理与计算: 3/5
⚪ 动手与操作: 3/5
⚪ 狂热与坚持: 2/5
⚪ 创造与创新: 3/5
项目图库
所需技能
🔧 **动手能力**：需要连接杜邦线或焊接排针，将 ePaper 模块与 ESP32 开发板正确连接。
💻 **编程能力**：需要熟悉 ESP-IDF 开发环境、C 语言编程、Git 基本操作，以及 SPIFFS 文件系统概念。
⚡ **电子电路**：了解 SPI 通信协议、GPIO 引脚配置，以及 ePaper 模块的基本电气特性（3.3V 供电）。
适用场景
**低功耗信息显示**：制作电子价签、温湿度计、日历、待办事项列表等，利用 ePaper 的零功耗保持特性。
**电子阅读器原型**：开发简易的电子书阅读器，支持文本和图片显示。
**物联网数据看板**：通过 WiFi 获取 NTP 时间或传感器数据，在 ePaper 上实时更新显示。
**教育与学习**：学习 ESP32 的 SPI 驱动、图形库设计、文件系统操作和嵌入式开发流程。