当前位置：首页 > news >正文

ESP32+LVGL8.1实战：用陀螺仪模拟编码器输入（附完整代码）

news 2026/7/17 18:49:25

ESP32+LVGL8.1实战：用陀螺仪模拟编码器输入（附完整代码）

在嵌入式界面开发中，输入控制方式往往决定了用户体验的流畅度。传统编码器虽然可靠，但体积和成本限制了其在小型设备中的应用。本文将展示如何利用ESP32内置的加速度传感器，通过姿态识别实现低成本、高自由度的输入方案，完整代码可直接用于实际项目开发。

1. 硬件方案设计

1.1 传感器选型与原理

ESP32开发板通常集成MPU6050或LIS3DH等加速度传感器，这些器件通过I2C接口提供三轴加速度数据。当设备倾斜时，各轴加速度分量会发生变化，通过计算俯仰角(pitch)和横滚角(roll)可以识别设备姿态：

// 加速度转欧拉角计算公式 void LIS3DH_get_angleXY(short x, short y, short z, float *pitch, float *roll) { *pitch = atan2(x, sqrt(y*y + z*z)) * 180/M_PI; *roll = atan2(y, sqrt(x*x + z*z)) * 180/M_PI; }

1.2 硬件连接示意图

模块	ESP32引脚	备注
加速度传感器	SDA	GPIO21 (默认I2C)
SCL	GPIO22 (默认I2C)
INT	可配置中断引脚(可选)

提示：部分ESP32开发板已内置传感器，无需额外接线

2. 软件架构实现

2.1 LVGL输入设备驱动注册

LVGL通过lv_indev_drv_t结构体注册输入设备，陀螺仪模拟编码器需配置为LV_INDEV_TYPE_ENCODER类型：

void encoder_lv_port_indev_init(void) { static lv_indev_drv_t indev_drv; lv_indev_drv_init(&indev_drv); indev_drv.type = LV_INDEV_TYPE_ENCODER; indev_drv.read_cb = encoder_read; lv_indev_drv_register(&indev_drv); }

2.2 姿态到输入的转换逻辑

通过设定阈值将角度变化转换为编码器事件：

static void encoder_handler(void) { short aacx, aacy, aacz; float pitch, roll; Get_Accelerometer(&aacx, &aacy, &aacz); LIS3DH_get_angleXY(aacx, aacy, aacz, &pitch, &roll); if (pitch > 66) { encoder_state = LV_INDEV_STATE_PR; // 按压状态 } else { encoder_state = LV_INDEV_STATE_REL; // 释放状态 } if(roll > 66 && pre_flag) { encoder_diff++; // 顺时针旋转 pre_flag = 0; } else if(roll < -66 && pre_flag) { encoder_diff--; // 逆时针旋转 pre_flag = 0; } else { pre_flag = 1; // 防抖标志 } }

3. 关键参数调优

3.1 防抖处理方案

传感器数据存在噪声，需要组合硬件和软件滤波：

硬件层面：
- 配置传感器的低通滤波器
- 适当降低采样频率
软件层面：
- 移动平均滤波
- 状态变化延时确认

// 示例：简易软件防抖 vTaskDelay(10 / portTICK_PERIOD_MS);

3.2 灵敏度调节参数

参数	推荐值	调节建议
按压阈值	±66°	根据握持姿势微调
旋转阈值	±30°	影响操作流畅度
采样周期	50ms	平衡响应速度和功耗

4. 实际应用案例

4.1 菜单导航实现

创建对象组并关联输入设备：

lv_group_t * group = lv_group_create(); lv_obj_t * btn1 = lv_btn_create(lv_scr_act()); lv_obj_t * btn2 = lv_btn_create(lv_scr_act()); lv_group_add_obj(group, btn1); lv_group_add_obj(group, btn2); lv_indev_set_group(indev, group);

4.2 旋钮模拟控件

通过编码器差值控制进度条：

static void slider_event_cb(lv_event_t * e) { lv_obj_t * slider = lv_event_get_target(e); static int16_t val = 0; if(lv_event_get_key(e) == LV_KEY_RIGHT) { val = LV_MIN(val + 5, 100); } else if(lv_event_get_key(e) == LV_KEY_LEFT) { val = LV_MAX(val - 5, 0); } lv_slider_set_value(slider, val, LV_ANIM_ON); }