你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

NUCLEO-H5E5ZJ 移植 LVGL

[复制链接]
lugl 发布时间:2026-10-16 22:34
NUCLEO-H5E5ZJ 移植 LVGL(ST7735 LCD + 五向摇杆)
日期:2026-10-16Zephyr 版本:v4.4.0(LVGL v9)目标板:NUCLEO-H5E5ZJ(STM32H5E5ZJT6)移植产物:D:\STM32\STM32H5E5\NUCLEO_H5E5ZJ\apps\lvgl_demo


. V. L! a& u$ I  h+ t4 x0. 效果
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 ~
       │                                  ▲
' f% e3 u! T3 ]2 _       ▼ 模拟电压                          │ SPI4 @10MHz
! ]" C; H! q* v0 GADC1_INP9 (PB0, Arduino A3)               │
. F4 v' E' ^5 m       │                                  │
' n& R+ U. v+ Q' `8 }0 y. m) p       ▼                                  │8 u' `/ ^3 C9 S/ ?  l5 E' j
Zephyr adc-keys 输入驱动                   │   ┌─────────────────────┐
2 L. G5 N& H9 A+ L0 d! j! j(50ms 轮询 + 最近阈值匹配 + 消抖)            │   │ lcd_bare 裸 SPI 驱动  │
2 D) i% V9 R3 _1 l$ |       │ INPUT_KEY_* 事件                  ├──▶│ display_bare shim    │
1 a' Y% u; M% N3 e       ▼                                  │   │ (Zephyr display API) │
8 R; T" {* g# b. Mzephyr,lvgl-keypad-input                  │   └─────────────────────┘
2 l- s; s5 k+ X(input-codes → lvgl-codes 映射)            │            ▲" {, t7 ]. m* V; I& z4 G# c8 q9 n
       │ LV_KEY_*                         │ display_write(RGB565)
7 G1 S: ~7 h; k9 t       ▼                                  │            │! {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 u
SPI_SCKD13PE12SPI4_SCK
6 k6 m( r- @3 W5 LSPI_MISOD12PE13SPI4_MISO
: X, q  D5 f# [% p# F" D6 aSPI_MOSID11PE14SPI4_MOSI
  J4 n; }( v/ ^* m- G( @$ eLCD CSD10PE11GPIO(软件控制)
1 T7 y" B" ?4 B7 }: NLCD DCD8PA9GPIO9 z7 T7 [* _- Y3 b6 }0 \
五向摇杆A3PB0ADC1_INP9
引脚依据为 MB2129 原理图第 5 页连接器部分:
mb2129_arduino_cn5_cn9.png
摇杆原理
电阻分压式:3.3 V 经上拉,拨向某方向把对应电阻短到 GND,输出不同分压。ADC(12 位,3.3 V 基准)实测各方向电压:
方向ADC raw(约)电压(约)press-thresholds-mv5 Z$ D$ P, a5 T' ^* d, m
右8871 mV71
' [; Z8 a0 |! G上738595 mV595  z7 o) \  X) Y5 m+ ~: q9 `( F- N
确认(按下)13101055 mV1055
+ Q# R5 `2 A) d3 I, U左20481650 mV1650( r; i  J, \7 F/ O8 D
下33762720 mV27200 @' w3 c1 x8 |3 W9 @
松开(开路)40953298 mVkeyup = 33003. 逐步实现第 1 步:应用骨架apps/lvgl_demo/
7 p0 K8 U3 d4 X* j* ^5 O2 A├── CMakeLists.txt; D& N" c4 p( D8 y% K# N0 Z
├── prj.conf* ]0 r! `. }, i4 c
├── boards/nucleo_h5e5zj.overlay
- f1 I' F% y6 @. R  j# q3 k├── dts/bindings/display/8 M( x3 n( `& q* {1 q0 h7 Z
│   ├── uniknect,lcd-bare.yaml   # display shim 绑定
9 K* v4 u4 I% }& u│   └── uniknect,lcd-io.yaml     # LCD DC/CS GPIO 绑定
) m- `5 P1 {! F& B2 i' h/ ?- z9 G└── 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>
* D  `* L9 g. w0 L​
- u; K  J) h8 g/ {
. |6 z* e$ W, o6 z  v# K) v# r9 X    joystick: joystick {
' c+ t/ q2 d3 V. K$ n" H% E        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>;
# `" t6 Y8 o' U6 k' x. x        keyup-threshold-mv = <3300>;          /* 松开=开路电压 */
0 V# M6 d2 a% `# F( Y% S9 i​
. e( Q' o9 q  [        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>; };
* x, D0 X0 z5 I* Z  |        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>; };
& c2 Q( F, {, U: T# M& y- A; U        key_down   { press-thresholds-mv = <2720>; zephyr,code = <INPUT_KEY_DOWN>; };
+ V! ^' u& l7 X5 j    };) 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)>;
" V" ^1 _5 q% P$ L, A    clock-names = "adcx", "adc_ker";
) A2 b: \' @2 F( a/ G% U5 ?    pinctrl-0 = <&adc1_inp9_pb0>;0 q( `2 z( a% k% }; M& y  r
    pinctrl-names = "default";4 \. [! ^/ ^& U
    st,adc-clock-source = "ASYNC";
) X# s% {. X( x1 ?5 D8 v    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>;
5 U: K' \: V3 J        zephyr,gain = "ADC_GAIN_1";
8 N5 q7 I- B. ]$ e( z        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>;
: L8 D, M# L8 `' C' [4 L2 T    };
6 W* C) d# M4 }  _) C' |% M};第 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 {
! [+ G7 V# F+ t# D; @( R  [3 p0 ?& A        compatible = "zephyr,lvgl-keypad-input";
& ]9 ]2 Z* r8 D* @        input = <&joystick>;  C( X8 _8 @" q  f/ h
        input-codes = <INPUT_KEY_UP INPUT_KEY_DOWN INPUT_KEY_LEFT INPUT_KEY_RIGHT
9 _" n/ `; A; o0 Q! ]0 U                   INPUT_KEY_ENTER>;
/ C% I4 c# g, y+ ~2 v        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
    };
! T, d: e5 T' M( U) `};
踩坑记录:最初把方向映射成 LV_KEY_UP/DOWN/LEFT/RIGHT,结果确认键正常、方向完全不动。原因是 LVGL 中 LV_KEY_PREV/NEXT 才负责移动焦点组焦点,方向键是派发给当前焦点控件自己处理的(按钮不处理方向)。用 INPUT_CALLBACK_DEFINE(NULL, cb, NULL) 打印全部输入事件确认事件码正确(上=103/下=108/左=105/右=106)后,定位为 LVGL 侧映射问题,改映射为 PREV/NEXT 即恢复。菜单类导航的正确映射:上/左→LV_KEY_PREV,下/右→LV_KEY_NEXT,确认→LV_KEY_ENTER。
LCD 部分(SPI4 + lcd_bare + lcd_io 节点)与纯 LCD 工程相同,不重复展开。
第 4 步:prj.confCONFIG_GPIO=y3 n- o" ~+ g( `$ C
CONFIG_SPI=y
0 ^7 m$ A9 }7 E+ F; S+ F/ M  GCONFIG_DISPLAY=y" c/ d4 L3 `; v! P
CONFIG_ADC=y
6 g& ^  s" K9 E* P8 {" _% V' d% hCONFIG_INPUT=y          # adc-keys / lvgl-keypad-input 均 default y(节点使能即生效)
4 H; q* ?# K( g/ n% t​
7 I0 x8 ^) d$ R1 xCONFIG_MAIN_STACK_SIZE=4096
% L) Y/ S( P0 f6 g# G3 }3 k9 L​
. j% s' x/ k( G* c* E/ w  QCONFIG_LVGL=y: K1 Y9 V/ a" _6 t2 H: A
CONFIG_LV_Z_MEM_POOL_SIZE=16384
9 N6 |/ ?" m' O$ uCONFIG_LV_COLOR_DEPTH_16=y
6 M% D) k, D% @1 nCONFIG_LV_COLOR_16_SWAP=y    # 与 display_bare shim 约定:LVGL 缓冲即大端 RGB565,直透传
: B$ F6 J/ K+ R, `: r+ sCONFIG_LV_USE_BUTTON=y
  h* D% ^, e) t1 E1 ~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, }/ J
lv_indev_t *indev = NULL;3 j' }5 \* a/ x5 g/ M
while ((indev = lv_indev_get_next(indev)) != NULL) {
* s; y/ r/ }. t' ?    if (lv_indev_get_type(indev) == LV_INDEV_TYPE_KEYPAD) {
! T6 K+ m1 D. @/ h& @        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); 每个菜单项都加入 */
& Y  e5 b  l" |0 m: Rlv_indev_set_group(keypad, group);
" `  s' K5 m1 o7 _​- n2 f6 K4 o; H
/* 2. 焦点可见性:给菜单按钮加 FOCUS_KEY/FOCUSED 两个状态的样式 */
) @" ]: [- Q) u/ k! ^  Alv_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. 主循环 */
, o! |! K! x( J2 ~% z* F1 ?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();
' Q" Q1 O& e9 ?1 _: j/ ?# ]6 G0 c+ V    k_msleep(MIN(sleep_ms, 20));" Z7 y1 N1 ?6 R+ Q6 m# V
}
输入事件在 lv_timer_handler() 内部从消息队列取出处理,主循环单线程即可,无需额外同步。
第 6 步:编译、烧录、验证cd /d/luglZephyrproject
+ R. \0 s8 C" @: B& a' J/ Kexport ZEPHYR_SDK_INSTALL_DIR=/d/luglZephyrproject/zephyr-sdk-1.0.1/zephyr-sdk-1.0.1
" @- b7 i9 |' p; b" i* u/ J7 y​
) e7 C; S9 _6 V9 V. ?3 D7 Hwest build -b nucleo_h5e5zj /d/STM32/STM32H5E5/NUCLEO_H5E5ZJ/apps/lvgl_demo \
4 Y2 W* M+ U" r3 y  -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):
  • 菜单正常渲染,字体/颜色正确(RGB565 字节序约定有效);
  • 摇杆上/下/左/右:焦点框在 4 个菜单项间循环移动;
  • 摇杆按下:触发当前项,板载 LD1/LD2/LD3 随之翻转,状态行显示 LDx ON/OFF。

    0 M: G9 b- e& y9 J" {; i* u
nucleo_h5e5zj_lvgl.png 2 @* p0 m) j: O7 p! A/ a& X
4. 经验总结
  • 电阻分压式摇杆不要自己写驱动:Zephyr 自带 adc-keys 输入驱动(最近阈值匹配 + 消抖),dts 里填电压阈值即可;通道记得配 zephyr,vref-mv,驱动按 mV 判定;
  • LVGL 菜单导航映射 LV_KEY_PREV/NEXT,不是方向键——方向键发给焦点控件自用,这是本次唯一的逻辑踩坑点;
  • 输入链路可分段验证:INPUT_CALLBACK_DEFINE(NULL, cb, NULL) 全局打印输入事件,先确认事件码(上=103/下=108/左=105/右=106/确认=28)再查 LVGL 侧;
  • 显示与输入的对接全部在设备树声明(zephyr,display + zephyr,lvgl-keypad-input),应用代码只负责建 UI 和焦点组;
  • 自定义 dts 节点的 GPIO 属性必须写绑定(type: phandle-array),同 LCD 工程的经验。
    1 G$ `8 F/ o! g1 g' j" O' M
lvgl_系统架构图.png
赞 收藏 评论0 发布时间:2026-10-16 22:34

举报

0个回答

所属标签

相似技术帖

官网相关资源

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版