esp32 ——lcd篇

已于 2025-01-04 17:17:29 修改
阅读量970 收藏 7
点赞数 1
分类专栏： 单片机 文章标签： 学习
于 2025-01-04 15:53:13 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_51498063/article/details/144930640
版权

硬件

开发板上的液晶屏是2.0寸的IPS高清液晶屏，分辨率240*320，显示非常清晰。液晶屏驱动芯片ST7789，采用SPI通信方式与ESP32-C3连接。开发板上的触摸屏是电容触摸屏，用手指就可以触摸，支持双指触摸。触摸芯片型号是FT6336，使用I2C接口与ESP32-C3连接，I2C地址为0x38。

环境

esp-idf 5.3.1

lcd显示

spi总线初始化

#define PIN_NUM_MISO -1
#define PIN_NUM_MOSI 5
#define PIN_NUM_CLK 3

#define LCD_HOST  SPI2_HOST
#define EXAMPLE_LCD_H_RES 240

esp_err_t spi_bus_master_init(void)
{
    esp_err_t ret;
    spi_bus_config_t buscfg = {
        //spi总线使用的引脚
        .miso_io_num = PIN_NUM_MISO,
        .mosi_io_num = PIN_NUM_MOSI,
        .sclk_io_num = PIN_NUM_CLK,
        .quadwp_io_num = -1,
        .quadhd_io_num = -1,
        //在一次spi传输中最多传输80行像素
        .max_transfer_sz = EXAMPLE_LCD_H_RES * 80 * sizeof(uint16_t)
    };
    //使用dma的传输方式
    ret = spi_bus_initialize(LCD_HOST, &buscfg, SPI_DMA_CH_AUTO);
    return ret;
}

SPI总线分配LCD IO设备句柄

esp_err_t esp_spi_lcd_init_io(esp_lcd_panel_io_handle_t *io_handle)
{   
    esp_lcd_panel_io_spi_config_t io_config = {
        .dc_gpio_num = LCD_PIN_NUM_LCD_DC, // 数据/命令选择引脚
        .cs_gpio_num = LCD_PIN_NUM_LCD_CS, // 片选引脚
        .pclk_hz = LCD_LCD_PIXEL_CLOCK_HZ, // 像素时钟频率
        .lcd_cmd_bits = LCD_LCD_CMD_BITS, // 命令位数
        .lcd_param_bits = LCD_LCD_PARAM_BITS, // 参数位数
        .spi_mode = 0,//spi模式CPOL, CPHA
        .trans_queue_depth = 10, // 传输队列深度
    };
    // 将 LCD 连接到 SPI 总线
    return esp_lcd_new_panel_io_spi((esp_lcd_spi_bus_handle_t)LCD_HOST, &io_config, io_handle);
}

安装LCD控制器驱动

配置参数调用 esp_lcd_new_panel_st7789() 来创建 LCD 面板的句柄，这个句柄后续会用于控制显示屏的显示内容。io_handle是上一步骤中获得的从spi总线分配的lcd io句柄。

esp_err_t esp_spi_lcd_panel_init(esp_lcd_panel_handle_t *panel_handle,const esp_lcd_panel_io_handle_t io_handle)
{
    esp_lcd_panel_dev_config_t panel_config = {
        .reset_gpio_num = LCD_PIN_NUM_RST,     // 复位引脚，设为-1表示不使用硬件复位
        .rgb_ele_order = LCD_RGB_ELEMENT_ORDER_RGB,  // RGB颜色元素的顺序
        .bits_per_pixel = 16,    // 每像素16位色深，即RGB565格式
    };
    // 为 ST7789 创建 LCD 面板句柄，并指定 SPI IO 设备句柄
    return esp_lcd_new_panel_st7789(io_handle, &panel_config, panel_handle);
}

LCD面板初始化

    /* 复位LCD面板 */
    ESP_LOGI(TAG,"esp lcd reset");
    ESP_ERROR_CHECK(esp_lcd_panel_reset(panel_handle));

    /* 初始化LCD面板 */
    ESP_LOGI(TAG,"esp lcd init");
    ESP_ERROR_CHECK(esp_lcd_panel_init(panel_handle));

    /* 打开LCD显示 */
    ESP_LOGI(TAG,"esp lcd display on");
    ESP_ERROR_CHECK(esp_lcd_panel_disp_on_off(panel_handle, true));
    
    /* 反转LCD颜色 */
    ESP_LOGI(TAG,"esp lcd invert color");
    ESP_ERROR_CHECK(esp_lcd_panel_invert_color(panel_handle, true));

    /* 初始化LCD背光 */
    ESP_LOGI(TAG,"esp lcd backlight init");
    ESP_ERROR_CHECK(esp_lcd_backlight_init());

    /* 打开LCD背光 */
    ESP_LOGI(TAG,"esp lcd backlight on");
    esp_lcd_backlight_on();

lcd触摸

下载FT5x06控制器组件。

idf.py add-dependency "espressif/esp_lcd_touch_ft5x06^1.0.4"

由于使用的是idf5.3.1，有些api不适用，需要对FT5x06控制器组件代码进行修改。        

        managed_components中的代码，需要先把managed_components中的组件放到自己的components中才可以修改，否则你改了之后，一编译，就会恢复原来的样子，就白改了。所以我们先在spi_lcd_touch文件夹中新建一个文件，命名为components。

        然后把managed_components文件夹中的espressif__esp_lcd_touch_ft5x06文件夹剪切到components文件夹中。注意，是剪切，不是复制。

修改组件

FTx06创建i2c设备句柄

这里使用i2c_master的方式进行i2c通信。

//添加部分
const i2c_device_config_t i2c_dev_ft5x06_config = {
    .dev_addr_length = I2C_ADDR_BIT_LEN_7,
    .device_address = 0x38,
    .scl_speed_hz = 10000,
};
static i2c_master_dev_handle_t i2c_ft5x06_dev; 
//添加部分

//传入参数多了i2c_master_bus_handle_t 
esp_err_t esp_lcd_touch_new_i2c_ft5x06(const esp_lcd_panel_io_handle_t io, const esp_lcd_touch_config_t *config, esp_lcd_touch_handle_t *out_touch,i2c_master_bus_handle_t bus_handle)
{
    esp_err_t ret = ESP_OK;

    assert(config != NULL);
    assert(out_touch != NULL);

    //添加部分
    ESP_LOGI(TAG,"add ft5x06 to  i2c bus");
    i2c_master_bus_add_device(bus_handle, &i2c_dev_ft5x06_config, &i2c_ft5x06_dev);
    //添加部分

修改触摸读写函数


/**
 * @brief 通过I2C写入数据到FT5x06触摸芯片
 * @param tp 触摸屏句柄
 * @param reg 寄存器地址
 * @param data 要写入的数据
 * @return esp_err_t 错误码
 */
static esp_err_t touch_ft5x06_i2c_write(esp_lcd_touch_handle_t tp, uint8_t reg, uint8_t data)
{
    assert(tp != NULL);

    // *INDENT-OFF*
    /* 写入数据 */
    uint8_t write_buf[2] = {reg, data};
    return i2c_master_transmit(i2c_ft5x06_dev, write_buf, sizeof(write_buf), -1);
    // *INDENT-ON*
}

/**
 * @brief 通过I2C从FT5x06触摸芯片读取数据
 * @param tp 触摸屏句柄
 * @param reg 寄存器地址
 * @param data 数据缓冲区指针
 * @param len 要读取的数据长度
 * @return esp_err_t 错误码
 */
static esp_err_t touch_ft5x06_i2c_read(esp_lcd_touch_handle_t tp, uint8_t reg, uint8_t *data, uint8_t len)
{
    assert(tp != NULL);
    assert(data != NULL);
    return i2c_master_transmit_receive(i2c_ft5x06_dev,&reg,1,data,len,-1);

}

使用示例

在官方esp_lcd_touch_ft5x06组件中有使用的示例。

i2c_master初始化

#define SCL_IO_PIN GPIO_NUM_1
#define SDA_IO_PIN GPIO_NUM_0
#define PORT_NUMBER -1  //-1 meansauto detect port number

/**
 * @brief 初始化I2C主机总线
 * @param bus_handle I2C总线句柄指针
 * @return esp_err_t 错误码
 */
esp_err_t i2c_master_init(i2c_master_bus_handle_t* bus_handle){ 
    /* I2C总线配置 */
    i2c_master_bus_config_t i2c_bus_config = {
        .clk_source = I2C_CLK_SRC_DEFAULT,      // 使用默认时钟源
        .i2c_port = PORT_NUMBER,                // I2C端口号
        .scl_io_num = SCL_IO_PIN,              // SCL引脚
        .sda_io_num = SDA_IO_PIN,              // SDA引脚
        .glitch_ignore_cnt = 7,                 // 忽略毛刺计数
        .flags.enable_internal_pullup = true,   // 使能内部上拉
    };
    
    /* 创建新的I2C主机总线 */
    ESP_ERROR_CHECK(i2c_new_master_bus(&i2c_bus_config, bus_handle));
    return ESP_OK;
}

触摸配置

    /* 配置触摸屏参数 */
    esp_lcd_touch_config_t tp_cfg = {
        .x_max = 320,                    /* X轴最大分辨率 */
        .y_max = 240,                    /* Y轴最大分辨率 */
        .rst_gpio_num = -1,              /* 复位引脚,不使用 */
        .int_gpio_num = -1,              /* 中断引脚,不使用 */
        .levels = {
            .reset = 0,                  /* 复位电平 */
            .interrupt = 0,              /* 中断电平 */
        },
        .flags = {
            .swap_xy = 0,                /* 是否交换XY轴 */
            .mirror_x = 0,               /* 是否镜像X轴 */
            .mirror_y = 0,               /* 是否镜像Y轴 */
        },
    };

    /* 创建触摸屏句柄并初始化FT5x06触摸芯片 */
    esp_lcd_touch_handle_t tp;
    //esp_lcd_panel_io_handle_t io_handle;
    esp_lcd_touch_new_i2c_ft5x06(io_handle, &tp_cfg, &tp,i2c_master_handle);

lvgl移植

选择组件

idf.py add-dependency "espressif/esp_lvgl_port^1.4.0"

参考官方示例：

/* 显示屏宽度 */
#define DISP_WIDTH 240
/* 显示屏高度 */
#define DISP_HEIGHT 320
/* LVGL显示设备句柄 */
static lv_disp_t * disp_handle;

/**
 * @brief 初始化LVGL端口
 * @param io_handle LCD面板IO句柄
 * @param panel_handle LCD面板句柄
 * @param _disp_handle LVGL显示设备句柄指针
 * @return esp_err_t 错误码
 */
esp_err_t u_esp_lvgl_port_init(esp_lcd_panel_io_handle_t io_handle,esp_lcd_panel_handle_t panel_handle,lv_disp_t **_disp_handle)
{
    /* 使用默认配置初始化LVGL */
    const lvgl_port_cfg_t lvgl_cfg = ESP_LVGL_PORT_INIT_CONFIG();
    esp_err_t err = lvgl_port_init(&lvgl_cfg);
    if (err != ESP_OK) {
        return err;
    }

    /* 配置LVGL显示设备参数 */
    const lvgl_port_display_cfg_t disp_cfg = {
        .io_handle = io_handle,              /* LCD面板IO句柄 */
        .panel_handle = panel_handle,        /* LCD面板句柄 */
        .buffer_size = 320*sizeof(uint16_t)*14*2, /* 显示缓冲区大小 */
        .double_buffer = true,               /* 使用双缓冲 */
        .hres = DISP_WIDTH,                 /* 水平分辨率 */
        .vres = DISP_HEIGHT,                /* 垂直分辨率 */
        .monochrome = false,                /* 非单色显示 */
        //.color_format = LV_COLOR_FORMAT_RGB565, /* RGB565颜色格式 */
        .rotation = {
            .swap_xy = false,               /* 不交换XY轴 */
            .mirror_x = false,              /* 不镜像X轴 */
            .mirror_y = false,              /* 不镜像Y轴 */
        },
        .flags = {
            .buff_dma = true,              /* 使用DMA传输显示缓冲 */
            //.swap_bytes = false,         /* 不交换字节序 */
        }
    };
    /* 添加显示设备并获取句柄 */
    disp_handle = lvgl_port_add_disp(&disp_cfg);
    *_disp_handle = disp_handle;
    return ESP_OK;
}

main函数中执行：

    lv_disp_t *disp_handle;
    ESP_ERROR_CHECK(u_esp_lvgl_port_init(io_handle,panel_handle,&disp_handle));

lvgl触摸输入配置

    /* 配置LVGL触摸设备参数 */
    const lvgl_port_touch_cfg_t touch_cfg = {
        .disp = disp_handle,  /* LVGL显示设备句柄 */
        .handle = tp,         /* 触摸屏句柄 */
    };
    /* 添加触摸设备并获取句柄 */
    lv_indev_t* touch_handle = lvgl_port_add_touch(&touch_cfg);

参考文章

Docs

espressif/esp_lvgl_port • v1.4.0• ESP Component Registry

LCD - ESP32 - — ESP-IDF 编程指南 release-v5.3 文档

ESP32-C3入门教程 基础篇⑥——SPI通信点亮LCD显示屏
08-27 4392
ESP32-C3入门教程 基础篇⑥——SPI通信点亮LCD显示屏
ESP32-C3入门教程——导读
热门推荐
09-13 5万+
一、环境篇 ESP32-C3入门教程 环境篇①——简单介绍与软硬件准备 ESP32-C3入门教程 环境篇②——Windows开发环境准备 ESP32-C3入门教程 环境篇③——VS Code IDE快速入门 二、基础篇 ESP32-C3入门教程 基础篇①——GPIO口控制 ESP32-C3入门教程 基础篇②——PWM控制 ESP32-C3入门教程 基础篇③——ADC输入 ESP32-C3入门教程 基础篇④——串口通信 ESP32-C3入门教程 基础篇⑤——SPI通信 ESP32-C3入门教程 基础篇⑥——I
ESP32的4线SPI之LCD驱动
04-02
有关ESP32的4线SPI之LCD驱动，实现功能包括登录WIFI，LCD显示，LCD背光PWM控制。背光强度可调，LCD显示英文，中文字库太大，不支持，但支持自定义中文字符，不宜太多，ESP32的容量......你懂得
4.在esp32上使用tftLCD屏幕（st7789驱动）
weixin_51803729的博客
03-16 1万+
在前言里面我想告诉你一些在对一款新的处理器的学习中，我们会遇到的那些错误，并且我相信这绝对不会是我一个人会出现的问题，出现这种问题首先原因是处理器的教程不够全面，没有像stm32一样一套保姆级别的教程能够一点一点引导着大家去学习，第二个原因就是esp32更新版本很快，导致一些教程会因为大版本的更新而不能使用。这里我就想站在初学者的角度来进行一番探索，也希望大家看完我出错的的过程后能够有所启发。
ESP32C3 嘉立创实战派 st7789的触摸驱动LVGL移植新版本求助
最新发布
SABERLU的博客
04-11 198
现在的问题是，我需要使用9.2.2LVGL驱动来重新驱动该屏幕的触摸驱动，9.2.2后没有hal文件夹，也就没有包含这个头函数#include "src/core/lv_indev.h"，导致下面这个代码无法移植，问了AI也不知道具体应该如何调整。如题，之前是使用该开发板进行桌面天气时钟的部署，使用的LVGL版本是8.3.11，和触摸相关的代码如下。有没大佬知道应该如何调整的，求助。
ESP32 ESP-IDF TFT-LCD(ST7735 128x160) LVGL基本配置和使用
perseverance51博客
02-17 1403
ESP32 ESP-IDF TFT-LCD(ST7735 128x160) LVGL基本配置和使用
ESP32 IDF开发——RGB LCD显示屏（ST7701S）
ShenZhen_zixian的博客
07-29 8448
ESP32 IDF开发——RGB LCD显示屏（ST7701S）
ESP32S3 使用LVGL驱动LCD屏（ST7789主控）
smallerxuan的博客
12-23 8683
在ESP32S3主控芯片上使用LVGL组件驱动ST7789主控的LCD屏。
关于esp32一些lcd函数的说明
m0_65259648的博客
04-16 433
在调用vspi发送颜色数组时，相关的十六进制对照表如下。而在esp32实现屏幕显示图片的过程中有两中方式去实现自己想要展示的图片。一种以输出字符为格式（如上所示）一种是以实时处理为基准的函数（如下所示）其中一种是打开图片路径对图片进行三色渲染，留取有颜色的部分。一种是以bmp图片转C语言十六进制数组格式的形式去处理图片。在esp32中调用相关的函数案例为以下两种。调用以下函数即可实现颜色输出。
ESP32的4线SPI的LCD驱动
12-08
ESP32的4线SPI之LCD驱动，实现功能包括登录WIFI，LCD显示，LCD背光PWM控制。背光强度可调，LCD显示英文，中文字库太大，不支持，但支持自定义中文字符
[ESP32]：LCD显示摄像头画面
LINKKEEE的博客
03-15 1401
[ESP32]：LCD显示摄像头画面
ESP32 ESP-IDF TFT-LCD(ST7735 128x160)自定义组件驱动显示
perseverance51博客
02-18 1295
ESP32 ESP-IDF TFT-LCD(ST7735 128x160)自定义组件驱动显示
esp32单片机通过spi驱动LCD显示 （嵌入式开发 程序 ）
07-06
esp32单片机通过spi驱动LCD显示 （嵌入式开发 程序 ）
esp32-1.0.6.zip
08-30
ESP32是一款高性能、低功耗的32位微控制器，专为IoT（物联网）应用设计。它集成了Wi-Fi、蓝牙（包括经典蓝牙和BLE低功耗蓝牙）以及各种传感器，使得开发者能够轻松创建无线连接的智能设备。本离线下载包“esp32-...
快速入门ESP32——使用GUI-Guider生成工具
mucherry的博客
02-23 2573
在上一期我们移植了LVGL，本期就教大家怎么移植GUI-Guide生成的代码。GUI Guider 是恩智浦为 LVGL 开发了一个上位机GUI 设计工具，可以通过拖放控件的方式设计 LVGL GUI 页面，加速 GUI 的设计，提供c语言代码，可以很方便的嵌入到自己的项目中来。不知道的怎么下载GUI-Guide 看这里快速入门GUI-guider不知道的怎么移植LVGL看这里快速入门ESP32——移植LVGLESP32S3+1.69LCD（无触摸），
ESP-LCD多媒体智能控制方案，ESP32芯片模组技术方案应用
m0_59195407的博客
05-06 946
ESP32-S2-HMI-DevKit-1为GUI应用场景设计，可实现智能家居交互面板、闹钟、音箱等人机交互界面的智能控制。配备一块4.3寸TFT LCD电容触摸显示屏，具有丰富的板载传感器和拓展接口，方便用户轻松定制开发。 ESP32-S2-HMI-DevKit-1搭载ESP32-S2-WROVER模组，使用I2C接口进行通信。开发板的板载资源丰富，支持多种传感器，以及音频播放、麦克风等功能。 此外它还提供了多个扩展接口，包括 5 V 与 3.3 V 电源接口、程序下载、UART、I2C、SPI、U.
ESP32点亮LCD屏
qq_34884166的博客
05-09 1525
esp32点亮lcd屏
ESP32 入门笔记08：1.54寸（240*240）彩色TFT 显示高清IPS LCD 屏幕 SPI接口
Naiva的博客
04-04 7739
ESP32 入门笔记01：乐鑫ESP32-DevKitC开发板信息、开发环境搭建以及学资料准备。
ESP32（MicroPython） TFT LCD多功能显示（RTC+DHT22）
weixin_74155302的博客
07-02 892
本程序内容与之前的类似，传感器换成DHT22，测量温湿度更符合日常使用的需要。逻辑上的一项改动是测量的温度和湿度值统一保留一位小数。
esp32tftlcd\
01-17
### ESP32与TFT LCD使用教程 #### 初始化设置 为了使ESP32能够成功连接并控制TFT屏幕，初始化过程至关重要。当采用Arduino IDE作为开发平台时，需安装特定库文件来简化这一流程。对于1.8寸TFT屏幕而言，`TFT_eSPI`库是一个理想的选择[^1]。 ```cpp #include <TFT_eSPI.h> // Hardware-specific library TFT_eSPI tft = TFT_eSPI(); // Invoke custom library, pins defined in User_Setup.h ``` 这段代码展示了如何引入必要的硬件专用库以及创建一个名为`tft`的对象实例，该对象负责处理后续所有的显示操作。 #### 显示基本图形和文本 一旦完成了上述准备工作之后，就可以利用预定义函数轻松地向屏幕上绘制各种形状或是输出字符串了： ```cpp void setup() { tft.init(); tft.fillScreen(TFT_BLACK); tft.setTextColor(TFT_WHITE, TFT_BLACK); tft.setTextSize(2); tft.setCursor(0, 0); tft.println("Hello World!"); } void loop() {} ``` 此部分程序实现了屏幕清空、颜色设定、字体大小调整等功能，并最终打印了一条消息到指定位置上。 #### 高级应用案例——生成二维码 除了基础功能外，在某些应用场景下可能还需要更复杂的数据可视化能力。例如，可以借助第三方插件实现动态生成QR Code图像并在TFT设备上呈现出来。这里给出一段简化的示例代码片段用于说明这个概念[^2]: ```cpp // 假设已存在一个有效的WiFi网络连接 String ssid = "yourSSID"; String password = "yourPassword"; QRCODE_t qrcode; qrcode_init(&qrcode, QRECLEVEL_L, 4); char qrData[100]; sprintf(qrData,"WIFI:S:%s;P:%s;;",ssid.c_str(),password.c_str()); tft.setRotation(1); draw_qrcode(tft.getViewport().x, tft.getViewport().y, &qrcode, (uint8_t*)qrData,strlen(qrData)); ``` 请注意实际编码过程中还需考虑更多细节问题，比如内存管理等。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值