NUCLEO-H5E5ZJ 移植 LVGL(ST7735 LCD + 五向摇杆)
0. 效果 LCD 显示 LVGL 菜单界面:标题 Joystick Menu + 4 个菜单按钮(LED1 GREEN / LED2 RED / LED3 BLUE / About)+ 底部状态行。LCD 扩展板上的五向摇杆导航:上下/左右移动焦点(黄色高亮框),按下确认——前 3 项直接翻转板载 LD1/LD2/LD3,状态行同步显示 LDx ON/OFF。已在实物上验证通过。 1. 系统架构五向摇杆(电阻分压) ST7735 LCD9 T, }7 p- `3 ~│ ▲ ▼ 模拟电压 │ SPI4 @10MHz ADC1_INP9 (PB0, Arduino A3) │ │ │ ▼ │8 u' `/ ^3 C9 S/ ? l5 E' j Zephyr adc-keys 输入驱动 │ ┌─────────────────────┐ (50ms 轮询 + 最近阈值匹配 + 消抖) │ │ lcd_bare 裸 SPI 驱动 │ │ INPUT_KEY_* 事件 ├──▶│ display_bare shim │ ▼ │ │ (Zephyr display API) │ zephyr,lvgl-keypad-input │ └─────────────────────┘ (input-codes → lvgl-codes 映射) │ ▲" {, t7 ]. m* V; I& z4 G# c8 q9 n │ LV_KEY_* │ display_write(RGB565) ▼ │ │! {1 F$ P* r$ `: p/ v) S$ \, R LVGL keypad indev → lv_group 焦点组 ──────┴─── LVGL 渲染(lv_timer_handler) LVGL 显示与输入在 Zephyr 中全部通过设备树声明对接,应用代码零胶水。 2. 硬件连接(LCD 扩展板插 Arduino 排针)功能Arduino 位H5E5ZJ 引脚外设) ^1 x( o- j* D& \! u w; m9 uSPI_SCKD13PE12SPI4_SCK SPI_MISOD12PE13SPI4_MISO SPI_MOSID11PE14SPI4_MOSI LCD CSD10PE11GPIO(软件控制) LCD DCD8PA9GPIO9 z7 T7 [* _- Y3 b6 }0 \ 五向摇杆A3PB0ADC1_INP9 引脚依据为 MB2129 原理图第 5 页连接器部分:
电阻分压式:3.3 V 经上拉,拨向某方向把对应电阻短到 GND,输出不同分压。ADC(12 位,3.3 V 基准)实测各方向电压: 方向ADC raw(约)电压(约)press-thresholds-mv5 Z$ D$ P, a5 T' ^* d, m右8871 mV71 上738595 mV595 z7 o) \ X) Y5 m+ ~: q9 `( F- N 确认(按下)13101055 mV1055 左20481650 mV1650( r; i J, \7 F/ O8 D 下33762720 mV27200 @' w3 c1 x8 |3 W9 @ 松开(开路)40953298 mVkeyup = 33003. 逐步实现第 1 步:应用骨架apps/lvgl_demo/ ├── CMakeLists.txt; D& N" c4 p( D8 y% K# N0 Z ├── prj.conf* ]0 r! `. }, i4 c ├── boards/nucleo_h5e5zj.overlay ├── dts/bindings/display/8 M( x3 n( `& q* {1 q0 h7 Z │ ├── uniknect,lcd-bare.yaml # display shim 绑定 │ └── uniknect,lcd-io.yaml # LCD DC/CS GPIO 绑定 └── src/' n) L7 x8 y3 u" D ├── main.c # LVGL 菜单 UI + 摇杆焦点组. G) A6 z; g1 q. X: T+ w- i' f ├── lcd_bare.c / lcd_bare.h # ST7735 裸 SPI 驱动(板级无关)6 o$ l8 n3 _1 z) T& N+ a ├── display_bare.c # Zephyr display API shim(LVGL 的显示后端) E c5 T9 J3 v4 i* P% f └── font_petme128_8x8.h第 2 步:overlay —— 摇杆接入 Zephyr 输入子系统 Zephyr 自带 adc-keys 输入驱动(drivers/input/input_adc_keys.c),专为电阻分压式按键设计:按 sample-period-ms 轮询 ADC,找电压最接近的阈值判定按键,内置两周期消抖,无需自写驱动: #include <zephyr/dt-bindings/input/input-event-codes.h>8 z1 o) [0 C/ ]+ p#include <zephyr/dt-bindings/lvgl/lvgl.h> / { joystick: joystick { compatible = "adc-keys";6 S [/ [8 k6 ~6 |6 N; r: m io-channels = <&adc1 9>;7 `! a# m* x7 e( H8 i3 M8 j sample-period-ms = <50>; keyup-threshold-mv = <3300>; /* 松开=开路电压 */ key_right { press-thresholds-mv = <71>; zephyr,code = <INPUT_KEY_RIGHT>; };8 P# @$ j0 G4 K1 C6 q+ }' M key_up { press-thresholds-mv = <595>; zephyr,code = <INPUT_KEY_UP>; }; key_center { press-thresholds-mv = <1055>; zephyr,code = <INPUT_KEY_ENTER>; };% h, p; G" P3 y5 L6 e8 ~ key_left { press-thresholds-mv = <1650>; zephyr,code = <INPUT_KEY_LEFT>; }; key_down { press-thresholds-mv = <2720>; zephyr,code = <INPUT_KEY_DOWN>; }; };) z ~1 L0 o# E& j3 r- r3 ?* d }; ADC 通道配置(v4.4 的 H5E5 设备树中 adc1 是独立节点,无 adc12_common 包装层,adc_ker 时钟和分频直接写在 &adc1 上): &adc1 {4 G9 F3 y) p( t: ?2 \clocks = <&rcc STM32_CLOCK(AHB2, 10)>,0 @2 D1 n s. N: _ <&rcc STM32_SRC_HCLK ADCDAC_SEL(0)>; clock-names = "adcx", "adc_ker"; pinctrl-0 = <&adc1_inp9_pb0>;0 q( `2 z( a% k% }; M& y r pinctrl-names = "default";4 \. [! ^/ ^& U st,adc-clock-source = "ASYNC"; st,adc-prescaler = <6>;; ~3 f: G$ L7 O: x. h( ]. t status = "okay";1 q! d, y/ v* a8 V5 P #address-cells = <1>;8 J4 X% ]) ^0 `2 U3 M+ X #size-cells = <0>;9 i5 U- B0 E* y( L4 F0 Z& s ! p$ @9 x) ~/ s ]$ ~8 P* N2 X: m channel@9 {% x g" n& L2 H& Z" g reg = <9>; zephyr,gain = "ADC_GAIN_1"; zephyr,reference = "ADC_REF_INTERNAL";1 e0 n* c4 k: e- i zephyr,vref-mv = <3300>; /* adc-keys 按 mV 判定,必须给基准 */1 P0 |9 i2 B2 U1 M zephyr,acquisition-time = <ADC_ACQ_TIME_MAX>;8 g9 _8 }6 k2 a& u- y zephyr,resolution = <12>; }; };第 3 步:overlay —— 输入事件映射给 LVGL(关键踩坑点) Zephyr 的 LVGL 模块提供 zephyr,lvgl-keypad-input 伪设备:监听指定输入设备的 INPUT_KEY_* 事件,按 input-codes→lvgl-codes 表翻译成 LV_KEY_* 注入 LVGL keypad 输入设备: / {4 T' X. m m3 g1 {lvgl_keypad { compatible = "zephyr,lvgl-keypad-input"; input = <&joystick>; C( X8 _8 @" q f/ h input-codes = <INPUT_KEY_UP INPUT_KEY_DOWN INPUT_KEY_LEFT INPUT_KEY_RIGHT INPUT_KEY_ENTER>; lvgl-codes = <LV_KEY_PREV LV_KEY_NEXT LV_KEY_PREV LV_KEY_NEXT L# o! |' Y3 y! T' O4 r( y5 I8 ~ LV_KEY_ENTER>;4 ]& I% ^2 T8 u }; };
LCD 部分(SPI4 + lcd_bare + lcd_io 节点)与纯 LCD 工程相同,不重复展开。 第 4 步:prj.confCONFIG_GPIO=y3 n- o" ~+ g( `$ CCONFIG_SPI=y CONFIG_DISPLAY=y" c/ d4 L3 `; v! P CONFIG_ADC=y CONFIG_INPUT=y # adc-keys / lvgl-keypad-input 均 default y(节点使能即生效) CONFIG_MAIN_STACK_SIZE=4096 CONFIG_LVGL=y: K1 Y9 V/ a" _6 t2 H: A CONFIG_LV_Z_MEM_POOL_SIZE=16384 CONFIG_LV_COLOR_DEPTH_16=y CONFIG_LV_COLOR_16_SWAP=y # 与 display_bare shim 约定:LVGL 缓冲即大端 RGB565,直透传 CONFIG_LV_USE_BUTTON=y CONFIG_LV_USE_LABEL=y CONFIG_LV_COLOR_16_SWAP=y 必须与 display shim 的字节序约定一致(shim 不做逐像素交换,直接透传 SPI)。 第 5 步:应用代码要点(src/main.c)/* 1. 找到 LVGL keypad 输入设备并绑定焦点组 */: v3 n; e9 J5 H, }/ Jlv_indev_t *indev = NULL;3 j' }5 \* a/ x5 g/ M while ((indev = lv_indev_get_next(indev)) != NULL) { if (lv_indev_get_type(indev) == LV_INDEV_TYPE_KEYPAD) { keypad = indev;3 c; _: [/ K" c1 Y: h }, F8 ?( h$ z+ { e* _8 q }1 O) E& w2 ^2 M) I0 w, L4 O+ Q! E lv_group_t *group = lv_group_create();+ V5 m3 P1 k) C9 z* o: f0 F /* lv_group_add_obj(group, btn); 每个菜单项都加入 */ lv_indev_set_group(keypad, group); - n2 f6 K4 o; H /* 2. 焦点可见性:给菜单按钮加 FOCUS_KEY/FOCUSED 两个状态的样式 */ lv_obj_add_style(btn, &style_focus, LV_STATE_FOCUS_KEY);* |" a# l5 ~3 |' K lv_obj_add_style(btn, &style_focus, LV_STATE_FOCUSED);$ m9 g. G, ]8 z 3 K) k5 I/ Q: W; b( ]. P /* 3. 主循环 */ display_blanking_off(display_dev);1 j, `% k1 H8 _/ ]+ w% N while (1) {' Z% r0 _) u! H" M' }6 d" C uint32_t sleep_ms = lv_timer_handler(); k_msleep(MIN(sleep_ms, 20));" Z7 y1 N1 ?6 R+ Q6 m# V } 输入事件在 lv_timer_handler() 内部从消息队列取出处理,主循环单线程即可,无需额外同步。 第 6 步:编译、烧录、验证cd /d/luglZephyrprojectexport ZEPHYR_SDK_INSTALL_DIR=/d/luglZephyrproject/zephyr-sdk-1.0.1/zephyr-sdk-1.0.1 west build -b nucleo_h5e5zj /d/STM32/STM32H5E5/NUCLEO_H5E5ZJ/apps/lvgl_demo \ -d build_h5e5_lvgl -p always -- -DBOARD_ROOT=D:/STM32/STM32H5E5/NUCLEO_H5E5ZJ1 \ w' Y. D& D( q) a n$ H1 z west flash -d build_h5e5_lvgl 实测结果(2026-10-16):
4. 经验总结
|
【STM32H5 评测】5、Flash和RAM读写速度测试
STM32C542RC开发板ADC转换实验
【NUCLEO-H5E5ZJ评测】NetXDuo 以太网测评:从 CubeMX 到网络 shell
【NUCLEO-H5E5ZJ评测】ThreadX 移植实录:从 CubeMX 到双线程
【NUCLEO-H5E5ZJ评测】HASH硬件加速实测
STM32C542RC开发板I2C通讯实验——AT24C32的读写操作
【STM32H5 评测】Part4 STM32H5E5 存储测试
【NUCLEO-H5E5ZJ评测】M.2存储扩展实测
【STM32H5 评测】+ 多外设同时开启稳定性简要评测
【NUCLEO-H5E5ZJ评测】CoreMark 移植实录:从 CubeMX 到 700.89 分
微信公众号
手机版