NUCLEO-H5E5ZJ 移植 ST7735 SPI LCD 驱动
0. 效果 LCD 显示黑底三行文字(NUCLEO-H5E5ZJ / ST7735 160x128 / SPI4 10MHz OK),下半屏每秒循环刷红→绿→蓝→白色块;串口同步打印进度。已在实物上验证通过。 1. 硬件分析1.1 LCD 扩展板
UM3601 的 Arduino 表格是双栏排版,PDF 文本提取后行列错位无法直接使用,因此直接渲染 MB2129 原理图第 5 页(Connectors)确认:
放大 CN5(Arduino D8~D15)/ CN9(D0~D7)区域:
读图结果(左侧青色为 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 D11 (MOSI)PE14SPI4_MOSI D10 (NSS)PE11SPI4_NSS, N- e6 y* e" b* S6 g4 ? D9PF4TIM2_CH4 D8PA9TIM1_CH2 D7PE9TIM1_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/├── CMakeLists.txt7 U" E7 t5 X% U( W6 \ ├── prj.conf ├── boards/ │ └── 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 绑定 │ └── uniknect,lcd-io.yaml # DC/CS GPIO 绑定(见第 3 步) └── src/ ├── main.c # 演示:刷屏 + 文字; j* M% t, B8 R6 M( H) v ├── lcd_bare.c / lcd_bare.h # ST7735 裸 SPI 驱动 ├── 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)/ { chosen { zephyr,display = &lcd_bare; }; /* display shim:供 LVGL */ lcd_bare: lcd-bare { compatible = "uniknect,lcd-bare";! U* j" j6 R& A3 _: h8 a% F$ ~ g width = <160>; height = <128>; 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"; 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 aliases { 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 /* Arduino SPI(D11~D13),本板为 SPI4 */ &spi4 { pinctrl-0 = <&spi4_sck_pe12 &spi4_miso_pe13 &spi4_mosi_pe14>; pinctrl-names = "default"; status = "okay"; };第 3 步:驱动通过设备树取资源(板级无关设计) 驱动不硬编码任何引脚/总线,全部从设备树读取: static const struct device *const spi_dev = DEVICE_DT_GET(DT_ALIAS(lcd_spi));static 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 rcompatible: "uniknect,lcd-io"( {7 G7 ]$ c; M6 P! N properties: dc-gpios: type: phandle-array- o* W# N4 w7 l( [; y# [ required: true cs-gpios:2 M# `( a. k# b& y2 d8 J( I type: phandle-array required: true 并在节点上加 compatible = "uniknect,lcd-io";。经验:自定义节点的 GPIO 属性必须在绑定里声明 type: phandle-array,不能依赖类型猜测。 第 5 步:应用骨架prj.conf: CONFIG_GPIO=yCONFIG_SPI=y CONFIG_DISPLAY=y CMakeLists.txt: cmake_minimum_required(VERSION 3.20.0)find_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 \ -d build_h5e5_lcd -p always -- -DBOARD_ROOT=D:/STM32/STM32H5E5/NUCLEO_H5E5ZJ west 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 CSPI_SCKD13PE12SPI4_SCK9 \& t" ]$ l$ {' f- ?# B9 V SPI_MISOD12PE13SPI4_MISO6 v- J* |; D! ~! J y' m SPI_MOSID11PE14SPI4_MOSI LCD CSD10PE11GPIO(软件控制) LCD DCD8PA9GPIO 背光—硬件常亮无需控制 RST—板级复位线无需控制4. 经验总结
nucleo_h5e5zj_lcd_demo.zip
(11.16 KB, 下载次数: 0)
|
【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 分
微信公众号
手机版