环境运维

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);
}