ESP32super mini开发初探
使用ESP32-C3 Super Mini驱动1.54寸墨水屏实现“临时停车”显示
在智能停车、物联网设备和低功耗人机交互领域,电子墨水屏(E-Paper)因其超低功耗、高可视性与抗眩光特性,正成为理想的信息展示方案。本文将带你从零开始,基于 ESP32-C3 Super Mini 开发板,驱动一块 1.54英寸黑白墨水屏,实现静态文本“临时停车”的清晰显示,并集成 LVGL 图形库完成界面渲染与局部刷新优化。
一、项目概述
本项目旨在构建一个低功耗、高可视性的“临时停车”提示装置,适用于小区、商场、临时活动等场景。系统核心采用 ESP32-C3(集成 Wi-Fi 6 和蓝牙 5.0),通过 SPI 接口控制 1.54 英寸 GDEY0154D67-T03 墨水屏,使用 LVGL 8.3.4 实现中文文本渲染,并通过 触摸屏(FT6336) 实现交互反馈。
✅ 亮点:
无需额外 USB 转串口芯片,ESP32-C3 支持 USB CDC 串口通信
使用 LVGL 实现中文显示与局部刷新,降低功耗
支持触摸输入,可实现“点击切换”或“唤醒显示”功能
项目代码开源,适合二次开发
二、硬件准备与接线图
1. 核心硬件清单
|
模块 |
型号 |
数量 |
说明 |
|---|---|---|---|
|
主控板 |
ESP32-C3 Super Mini |
1 |
集成 USB 接口,无需 CP2102 |
|
墨水屏 |
GDEY0154D67-T03 |
1 |
1.54 英寸,黑白,SPI 接口 |
|
触摸屏 |
FT6336 |
1 |
I2C 接口,支持多点触控 |
|
电源 |
3.7V 锂电池 + TP4056 充电模块 |
1 |
支持续航与自动充电 |
|
连接线 |
杜邦线(公对母) |
若干 |
用于连接各模块 |
2. SPI 接线图(ESP32-C3 → 墨水屏)
| ESP32 Super Mini 引脚 | 墨水屏模块引脚 | 功能说明 | 备注 |
|---|---|---|---|
| 3.3V | VCC | 电源正极 | 必须接3.3V,部分开发板标注为3V3 |
| GND | GND | 电源地 | 共地 |
| GPIO 8 | CLK (SCK) | SPI时钟 | 对应ESP32-C3默认的SPI SCK引脚 |
| GPIO 7 | DIN (MOSI) | SPI数据 | 对应ESP32-C3默认的SPI MOSI引脚 |
| GPIO 5 | CS | 片选 | 低电平有效 |
| GPIO 4 | DC | 数据/命令 | 用于区分发送的是命令还是数据 |
| GPIO 3 | RST | 复位 | 低电平复位 |
| GPIO 2 | BUSY | 忙状态 | 屏幕忙碌时输出高电平,需读取状态 |
1. 开发工具链
-
IDE:VSCode + PlatformIO(推荐)
-
框架:ESP-IDF v5.0+
-
LVGL:v8.3.4(已集成在 ESP-IDF 示例中)
-
编译器:ESP32 Toolchain(通过 PlatformIO 自动管理)
2. PlatformIO 配置(platformio.ini)
[env:esp32-c3-devkitc-02]
platform = espressif32
board = esp32-c3-devkitc-02
framework = espidf
monitor_speed = 115200
build_flags = -DUSE_LVGL
✅ 关键配置:
build_flags = -DUSE_LVGL启用 LVGL 支持。
#include "driver/spi_master.h"
#include "esp_log.h"
#include "lvgl.h"
#define TAG "EPD"
// 墨水屏引脚定义 这里引脚需要重新定义
#define EPD_SCK_PIN 10
#define EPD_MOSI_PIN 11
#define EPD_CS_PIN 12
#define EPD_DC_PIN 13
#define EPD_RST_PIN 14
#define EPD_BUSY_PIN 15
// SPI 配置
static const spi_device_interface_config_t epd_spi_config = {
.mode = 0,
.clock_speed_hz = 20 * 1000 * 1000, // 20MHz(可调,避免失真)
.spics_io_num = EPD_CS_PIN,
.queue_size = 7,
.pre_cb = NULL,
.post_cb = NULL,
};
// 墨水屏控制函数
void epd_init(void) {
// 初始化 SPI
spi_bus_config_t bus_config = {
.mosi_io_num = EPD_MOSI_PIN,
.miso_io_num = -1,
.sclk_io_num = EPD_SCK_PIN,
.quadwp_io_num = -1,
.quadhd_io_num = -1,
.max_transfer_sz = 4096,
};
spi_bus_initialize(HSPI_HOST, &bus_config, SPI_DMA_CH_AUTO);
spi_device_handle_t spi_device;
spi_bus_add_device(HSPI_HOST, &epd_spi_config, &spi_device);
// 初始化引脚
gpio_set_direction(EPD_DC_PIN, GPIO_MODE_OUTPUT);
gpio_set_direction(EPD_RST_PIN, GPIO_MODE_OUTPUT);
gpio_set_direction(EPD_BUSY_PIN, GPIO_MODE_INPUT);
// 复位
gpio_set_level(EPD_RST_PIN, 0);
vTaskDelay(100 / portTICK_PERIOD_MS);
gpio_set_level(EPD_RST_PIN, 1);
vTaskDelay(100 / portTICK_PERIOD_MS);
// 等待忙信号释放
while (gpio_get_level(EPD_BUSY_PIN) == 1) {
vTaskDelay(10 / portTICK_PERIOD_MS);
}
// 发送初始化命令(简化版,实际需完整初始化序列)
epd_send_command(0x12); // Software reset
vTaskDelay(100 / portTICK_PERIOD_MS);
ESP_LOGI(TAG, "墨水屏初始化完成");
}
//2 LVGL 界面渲染(中文“临时停车”)
void lvgl_display_task(void *pvParameters) {
// 初始化 LVGL
lv_init();
lvgl_init();
// 创建屏幕
lv_obj_t *scr = lv_scr_act();
lv_obj_set_style_bg_color(scr, lv_color_black(), 0);
lv_obj_set_style_bg_opa(scr, LV_OPA_COVER, 0);
// 创建文本标签
lv_obj_t *label = lv_label_create(scr);
lv_label_set_text(label, "临时停车");
lv_obj_set_style_text_color(label, lv_color_white(), 0);
lv_obj_set_style_text_font(label, &lv_font_montserrat_48, 0);
lv_obj_align(label, LV_ALIGN_CENTER, 0, 0);
// 启用局部刷新
lv_disp_t *disp = lv_disp_get_default();
disp->driver->flush_cb = epd_flush; // 自定义刷新函数
disp->driver->antialiasing = 1;
while (1) {
lv_timer_handler();
vTaskDelay(pdMS_TO_TICKS(5));
}
}
// 3. 局部刷新优化(关键!)
void epd_flush(lv_disp_drv_t *disp, const lv_area_t *area, lv_color_t *color_p) {
// 计算像素数据
uint32_t w = (area->x2 - area->x1 + 1);
uint32_t h = (area->y2 - area->y1 + 1);
uint32_t size = w * h;
// 将 LVGL 颜色转换为 1bit 数据
uint8_t *buffer = malloc(size);
for (int i = 0; i < size; i++) {
buffer[i] = (color_p[i].ch.red > 128) ? 0xFF : 0x00;
}
// 发送 SPI 数据
epd_send_data(buffer, size);
// 释放内存
free(buffer);
lv_disp_flush_ready(disp);
}