STM32实战：5分钟搞定LVGL触摸屏（Touchpad）驱动对接（附电容/电阻屏示例）

STM32实战：5分钟搞定LVGL触摸屏驱动对接

在嵌入式GUI开发中，LVGL凭借其轻量级和高度可定制性成为许多STM32开发者的首选。但当你费尽周折搞定显示驱动后，往往会发现触摸屏的适配才是真正的"拦路虎"。本文将用最直接的方式，带你快速打通电容屏和电阻屏的驱动对接。

1. 触摸屏驱动对接核心逻辑

LVGL通过lv_indev_drv_t结构体管理输入设备，触摸屏的核心在于实现三个关键函数：

bool touchpad_is_pressed(void); // 检测触摸状态 void touchpad_get_xy(lv_coord_t *x, lv_coord_t *y); // 获取坐标 bool touchpad_read(lv_indev_drv_t *indev_drv, lv_indev_data_t *data); // 回调函数

典型工作流程：

1. LVGL周期调用touchpad_read
2. 在touchpad_read中：
   • 调用touchpad_is_pressed检测触摸状态
   • 若被触摸，调用touchpad_get_xy获取坐标
   • 填充lv_indev_data_t结构体

2. 电容屏驱动实现（以GT911为例）

GT911这类电容触摸芯片通常通过I2C通信，其特点是：

• 支持多点触控（但LVGL通常只用单点）
• 内置状态寄存器
• 坐标数据自动更新

关键实现代码：

// 检测触摸状态 static bool touchpad_is_pressed(void) { uint8_t status; HAL_I2C_Mem_Read(&hi2c1, GT911_ADDR, GT911_STATUS_REG, 1, &status, 1, 100); return (status & 0x80) ? true : false; // 最高位表示触摸状态 } // 获取坐标 static void touchpad_get_xy(lv_coord_t *x, lv_coord_t *y) { uint8_t data[4]; HAL_I2C_Mem_Read(&hi2c1, GT911_ADDR, GT911_X_REG, 1, data, 4, 100); *x = (data[1] << 8) | data[0]; // X坐标 *y = (data[3] << 8) | data[2]; // Y坐标 // 清除触摸状态（重要！） uint8_t clear = 0x00; HAL_I2C_Mem_Write(&hi2c1, GT911_ADDR, GT911_STATUS_REG, 1, &clear, 1, 100); }

注意：不同电容屏芯片的寄存器地址可能不同，需查阅具体数据手册

3. 电阻屏驱动实现（以XPT2046为例）

电阻屏通常通过SPI接口通信，其特点是：

• 需要主动发起坐标采样
• 需要处理触点抖动
• 可能需要校准

关键实现代码：

// SPI读取触摸数据 static uint16_t xpt2046_read(uint8_t cmd) { uint8_t data[2] = {0}; uint16_t val = 0; HAL_GPIO_WritePin(TOUCH_CS_GPIO_Port, TOUCH_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(&hspi1, &cmd, 1, 100); HAL_SPI_Receive(&hspi1, data, 2, 100); HAL_GPIO_WritePin(TOUCH_CS_GPIO_Port, TOUCH_CS_Pin, GPIO_PIN_SET); val = (data[0] << 8) | data[1]; return val >> 3; // 12位有效数据 } // 检测触摸状态 static bool touchpad_is_pressed(void) { return (HAL_GPIO_ReadPin(TOUCH_IRQ_GPIO_Port, TOUCH_IRQ_Pin) == GPIO_PIN_RESET); } // 获取坐标（带消抖） static void touchpad_get_xy(lv_coord_t *x, lv_coord_t *y) { uint16_t x_raw, y_raw; uint8_t samples = 3; uint32_t x_sum = 0, y_sum = 0; for(uint8_t i = 0; i < samples; i++) { x_raw = xpt2046_read(CMD_READ_X); y_raw = xpt2046_read(CMD_READ_Y); x_sum += x_raw; y_sum += y_raw; HAL_Delay(2); } *x = x_sum / samples; *y = y_sum / samples; }

4. 坐标转换与校准

触摸屏原始坐标通常需要转换到显示分辨率：

// 在touchpad_get_xy最后添加转换逻辑 void touchpad_get_xy(lv_coord_t *x, lv_coord_t *y) { // ...获取原始坐标raw_x, raw_y // 简单线性转换 *x = (raw_x - X_MIN) * LV_HOR_RES / (X_MAX - X_MIN); *y = (raw_y - Y_MIN) * LV_VER_RES / (Y_MAX - Y_MIN); // 更精确的做法是使用校准矩阵 // *x = A * raw_x + B * raw_y + C; // *y = D * raw_x + E * raw_y + F; }

四点校准法步骤：

1. 在屏幕四个角显示校准点
2. 记录每个点的触摸原始坐标
3. 解算转换矩阵参数
4. 保存参数到Flash

5. 性能优化技巧

中断 vs 轮询：

• 电容屏：建议使用中断模式，降低CPU占用
• 电阻屏：通常需要轮询检测，但可优化采样间隔

低功耗策略：

void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { if(GPIO_Pin == TOUCH_IRQ_Pin) { // 唤醒系统 __HAL_PWR_CLEAR_FLAG(PWR_FLAG_WU); } }

触摸事件过滤：

static bool touchpad_read(lv_indev_drv_t *indev_drv, lv_indev_data_t *data) { static uint8_t stable_count = 0; if(touchpad_is_pressed()) { if(++stable_count > 2) { // 连续3次检测到触摸才确认 touchpad_get_xy(&last_x, &last_y); >