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

NUCLEO-H5E5ZJ 移植 ST7735 SPI LCD 驱动

[复制链接]
lugl 发布时间:2026-10-16 22:02
NUCLEO-H5E5ZJ 移植 ST7735 SPI LCD 驱动
日期:2026-10-16Zephyr 版本:v4.4.0目标板:NUCLEO-H5E5ZJ(STM32H5E5ZJT6)移植产物:D:\STM32\STM32H5E5\NUCLEO_H5E5ZJ\apps\lcd_demo


, J6 `0 h! e+ T* s0. 效果
LCD 显示黑底三行文字(NUCLEO-H5E5ZJ / ST7735 160x128 / SPI4 10MHz OK),下半屏每秒循环刷红→绿→蓝→白色块;串口同步打印进度。已在实物上验证通过。
1. 硬件分析1.1 LCD 扩展板
  • 屏幕:1.8" ST7735,128×160,RGB565,SPI 模式 0,10 MHz;
  • 驱动为裸 SPI 时序(lcd_bare.c),初始化序列:SWRESET → SLPOUT → COLMOD(0x05) → MADCTL(0x60,rotation 3 横屏 160×128) → DISPON,列偏移 1、行偏移 2;
  • CS、DC 为软件 GPIO 控制;背光 LEDA 硬件常亮(+5V 经 220Ω),RST 接板级复位线,软件均无需控制;
  • 扩展板插在 Arduino 排针上,占用 D8(DC)、D10(CS)、D11~D13(SPI)。

    $ z+ D* O: f/ D% u! k! g- D
1.2 确定 H5E5ZJ 的 Arduino 引脚:看原理图,别看 UM 表格
UM3601 的 Arduino 表格是双栏排版,PDF 文本提取后行列错位无法直接使用,因此直接渲染 MB2129 原理图第 5 页(Connectors)确认:
mb2129_connectors_p5.png
放大 CN5(Arduino D8~D15)/ CN9(D0~D7)区域:
mb2129_arduino_cn5_cn9.png
读图结果(左侧青色为 Arduino 丝印,右侧为 MCU 引脚与复用功能):
Arduino 位H5E5ZJ 引脚复用功能5 G/ h/ |% _% p# H  E7 y4 E" _
D13 (SCK)PE12SPI4_SCK2 j  r- t$ M3 y$ }7 S
D12 (MISO)PE13SPI4_MISO
7 b* @3 c) K% [" WD11 (MOSI)PE14SPI4_MOSI
" F( W3 A  f. D. ]D10 (NSS)PE11SPI4_NSS, N- e6 y* e" b* S6 g4 ?
D9PF4TIM2_CH4
, j+ ]) h4 ?+ N. Y" n5 }% u7 ID8PA9TIM1_CH2
2 A6 n; _* b/ o! u; jD7PE9TIM1_CH1  O! l9 X5 k; n) K# _$ E
D6PF3TIM2_CH3
结论:H5E5ZJ 的 Arduino SPI 是 SPI4(PE12/PE13/PE14)。LCD CS 用 D10=PE11(GPIO 软件控制),DC 用 D8=PA9(GPIO)。
1.3 pinctrl 可行性与资源冲突核对
在 hal_stm32 模块的 dts/st/h5/stm32h5e5zjtx-pinctrl.dtsi 中确认四个 SPI4 引脚节点都存在:
spi4_sck_pe12 / spi4_miso_pe13 / spi4_mosi_pe14 / spi4_nss_pe11
同时确认无资源冲突:已移植的以太网(RMII)占用 PA1/PA2/PA5/PB12/PC1/PC4/PC5/PD1/PG12,与 SPI4 引脚、PE11、PA9 均无交叠。
2. 逐步实现第 1 步:准备驱动源码
应用目录 apps/lcd_demo/ 结构如下:
apps/lcd_demo/
2 ^! G1 L5 H+ [' P" w$ ]├── CMakeLists.txt7 U" E7 t5 X% U( W6 \
├── prj.conf
4 m! j. z! u7 Y├── boards/
8 A: C. }- ?! C0 \' L│   └── nucleo_h5e5zj.overlay6 j& q# ]3 W9 V1 k4 m' J
├── dts/bindings/display/1 G( K7 ]% v# a' t) ?, i* k9 O
│   ├── uniknect,lcd-bare.yaml      # display shim 绑定
* O, y+ F' L' U( E! S│   └── uniknect,lcd-io.yaml        # DC/CS GPIO 绑定(见第 3 步)
2 M6 l2 @) H: \9 ~└── src/
1 v4 Z% n: R- E7 y$ X% M- G    ├── main.c                      # 演示:刷屏 + 文字; j* M% t, B8 R6 M( H) v
    ├── lcd_bare.c / lcd_bare.h     # ST7735 裸 SPI 驱动
) n; s" b6 l- D# G2 B! _    ├── display_bare.c              # 包装成 Zephyr display API 的 shim(供 LVGL)% B' g& n2 g& c$ K& k: N
    └── font_petme128_8x8.h         # 8×8 字库第 2 步:写板级 overlay(boards/nucleo_h5e5zj.overlay)/ {
* K" k; u# u- B# G, A" y. B% C    chosen {
7 \( @$ N: x2 ?1 ~% }: u. _, w) S        zephyr,display = &lcd_bare;
. e" P% r" V  S$ E6 O    };
' ^0 i( M6 {7 ^​
6 [. U3 i3 U3 @    /* display shim:供 LVGL */
1 w$ {3 R1 c1 _( e6 w6 a    lcd_bare: lcd-bare {
1 a) z* Y% Q! B% ~0 V        compatible = "uniknect,lcd-bare";! U* j" j6 R& A3 _: h8 a% F$ ~  g
        width = <160>;
: w+ t" Y) ]+ F2 ?        height = <128>;
6 C% `3 T! x$ W* ?# F; [        status = "okay";# ]: W+ ]! m4 j! `2 D  j
    };( d. @" ^5 y% Y* I/ d
​& T# s5 `, t: z9 E
    /* lcd_bare 驱动的板级 IO 配置 */9 k( l# v+ l0 d, ~* o/ C
    lcd_io: lcd-io {/ d+ y/ e1 n+ w9 D' q2 G! i
        compatible = "uniknect,lcd-io";
! u6 [( \+ `3 l9 Y  }" N# E  t7 Y' E        dc-gpios = <&gpioa 9 GPIO_ACTIVE_HIGH>;   /* Arduino D8 */% n; c6 X3 S. d' K. e
        cs-gpios = <&gpioe 11 GPIO_ACTIVE_LOW>;   /* Arduino D10 */$ O5 g" H0 o0 _* ^6 A5 }& `
    };* Y( G4 Z& ]6 ~, h
​
6 P& g+ _* U* c0 C2 a1 Q) v( f5 x7 `    aliases {
5 v1 k4 h# A+ t! k: m8 `2 e* O0 e        lcd-spi = &spi4;% u& X# x1 b2 {/ W( p. E  _
    };& C6 U% o8 e' \' {% T, }2 z1 T
};) i) f3 X! v/ J/ g( r
​
+ [; t' U- W3 s2 i8 ?7 s9 |! m/* Arduino SPI(D11~D13),本板为 SPI4 */
( o+ ^7 _& w7 |1 n0 F% X+ `0 l&spi4 {
$ b3 I! p, |( V) r& w1 L    pinctrl-0 = <&spi4_sck_pe12 &spi4_miso_pe13 &spi4_mosi_pe14>;
1 `- X- {+ [/ p% k0 k( z8 d    pinctrl-names = "default";
# {8 w2 R, d: e    status = "okay";
# R. K/ }5 W9 |};第 3 步:驱动通过设备树取资源(板级无关设计)
驱动不硬编码任何引脚/总线,全部从设备树读取:
static const struct device *const spi_dev = DEVICE_DT_GET(DT_ALIAS(lcd_spi));
7 ^" u) F* [; @1 n: Z- R! Z2 Lstatic const struct gpio_dt_spec lcd_dc = GPIO_DT_SPEC_GET(DT_NODELABEL(lcd_io), dc_gpios);" c* R& P3 x; C' O& l# a* J0 u: X, ?3 ~
static const struct gpio_dt_spec lcd_cs = GPIO_DT_SPEC_GET(DT_NODELABEL(lcd_io), cs_gpios);
GPIO 操作用 gpio_pin_set_dt(&lcd_dc, x) 这类按逻辑电平的 API:cs-gpios 声明为 GPIO_ACTIVE_LOW 后,set_dt(1) 即"选中",语义清晰。以后换板子只改 overlay,驱动一行不动。
第 4 步:自定义节点必须配绑定文件(踩坑点)
第一次编译报错:
error: 'DT_N_S_lcd_io_P_dc_gpios_IDX_0_VAL_pin' undeclared
原因:lcd-io 节点若没有绑定文件,devicetree 对 <&gpioa 9 GPIO_ACTIVE_HIGH> 这种带宏的属性值无法猜出类型,GPIO_DT_SPEC_GET 需要的 VAL_pin 宏就不会生成。
修复:新建 dts/bindings/display/uniknect,lcd-io.yaml(Zephyr 会自动把应用源码目录下的 dts/bindings 加入绑定搜索路径):
description: UniKnect bare LCD IO config (SPI alias + DC/CS GPIOs)) L5 j& k: x4 d% e0 r
compatible: "uniknect,lcd-io"( {7 G7 ]$ c; M6 P! N
properties:
; J" d* T9 `6 X' `. |  [  dc-gpios:
* O! Q4 w/ N" v0 t) m    type: phandle-array- o* W# N4 w7 l( [; y# [
    required: true
# x" g2 ~  I/ }8 x# e" H  cs-gpios:2 M# `( a. k# b& y2 d8 J( I
    type: phandle-array
. d9 a% `3 h; x, N; s( O: O3 N7 P- F    required: true
并在节点上加 compatible = "uniknect,lcd-io";。经验:自定义节点的 GPIO 属性必须在绑定里声明 type: phandle-array,不能依赖类型猜测。
第 5 步:应用骨架
prj.conf:
CONFIG_GPIO=y
% G, l! j9 k0 }" u2 v, N, ~; ICONFIG_SPI=y
" o5 S- u  e; n# P. x& E3 h$ _CONFIG_DISPLAY=y
CMakeLists.txt:
cmake_minimum_required(VERSION 3.20.0)
5 F" y2 z& t" G! [5 s( a# e. qfind_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})8 }! n2 V+ c2 |, e1 C# j$ X0 M% h
project(lcd_demo)* I+ }' l1 a$ h+ n, w' [9 G
target_sources(app PRIVATE src/main.c src/lcd_bare.c src/display_bare.c)
main.c 演示逻辑:display shim 在 POST_KERNEL 阶段自动完成 LCD 初始化(display_bare_init → lcd_bare_init),main 延时 500 ms 后直接调 lcd_bare_fill / lcd_bare_text / lcd_bare_fill_rect 刷屏和写文字。
第 6 步:编译、烧录、验证cd /d/luglZephyrproject# [2 o1 U  C) E, u  ]
export ZEPHYR_SDK_INSTALL_DIR=/d/luglZephyrproject/zephyr-sdk-1.0.1/zephyr-sdk-1.0.1: ?3 O+ m2 F/ X( d  n. U# U- t7 z
​5 P1 u- j, F" o. i
west build -b nucleo_h5e5zj /d/STM32/STM32H5E5/NUCLEO_H5E5ZJ/apps/lcd_demo \
, W. W5 n4 v  ?: B1 P/ f" b; V  -d build_h5e5_lcd -p always -- -DBOARD_ROOT=D:/STM32/STM32H5E5/NUCLEO_H5E5ZJ
. }# ]+ v6 x+ z% z$ ]. d! cwest flash -d build_h5e5_lcd
实测结果:LCD 正常点亮,文字与四色刷屏显示正确,SPI4 @ 10 MHz 工作正常,串口日志同步输出 lcd_demo: fill RED/GREEN/BLUE/WHITE。
3. 引脚速查表LCD 信号Arduino 位H5E5ZJ 引脚外设9 n- l* {+ u1 h/ j* N8 C
SPI_SCKD13PE12SPI4_SCK9 \& t" ]$ l$ {' f- ?# B9 V
SPI_MISOD12PE13SPI4_MISO6 v- J* |; D! ~! J  y' m
SPI_MOSID11PE14SPI4_MOSI
5 N! f7 n  W) d2 w: ]LCD CSD10PE11GPIO(软件控制)
% |# u7 f' q! P8 n( lLCD DCD8PA9GPIO
) Y" r" g4 ?9 F1 I$ t背光—硬件常亮无需控制
# b: j$ L, T* `8 f+ H7 xRST—板级复位线无需控制4. 经验总结
  • 扩展板移植按 Arduino 位号对接,不要按 MCU 引脚名硬套——不同 Nucleo 的同一位号可能落在不同 SPI 外设上;
  • UM 的 Arduino 表格不可信(双栏 PDF 提取错位),以原理图连接器页为准,必要时渲染成图片读图;
  • 驱动里的设备引用全部下沉到设备树(alias + 自定义节点 + GPIO_DT_SPEC_GET),换板只改 overlay;
  • 自定义 dts 节点的 GPIO 属性必须写绑定(type: phandle-array),否则带宏的属性值类型猜测失败,GPIO_DT_SPEC_GET 编译报 undeclared;
  • pinctrl 节点名以 hal_stm32 模块中本芯片的 *-pinctrl.dtsi 为准,写 overlay 前先确认节点存在。

    9 u  ?6 l8 D! k  B/ ?* Q
5.附件,工程源码 nucleo_h5e5zj_lcd_demo.zip (11.16 KB, 下载次数: 0)
赞 收藏 评论0 发布时间:2026-10-16 22:02

举报

0个回答

所属标签

相似技术帖

官网相关资源

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