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

实验经验 | LTDC RGB 接口 LCD TouchGFX 工程的移植步骤

[复制链接]
STMCU-管管 发布时间:2025-2-6 09:47
17 H9 Z0 T: ?8 O# T/ _: k
引言
4 |. l2 m; q0 G3 \# {2 z文档基于 STM32F746G_DISCO 硬件平台,参考从 TouchGFX Designer 下载的 STM32F746 的 TBS(TouchGFX Board Setup),讲解 STM32CubeMX 相关配置,介绍了LTDC RGB 接口 LCD 的 TouchGFX 工程的移植步骤。 ) r# h* H; F$ A' ^0 o- {% `! i
12.png
▲ 图1. TouchGFX Designer 中的 STM32F746G_DISCO TBS

8 D3 F9 I# t5 ~

: B7 n& C% S' V# z# s2 0 @+ r5 Q1 w$ V# v( L4 ~3 Y
STM32CubeMX 配置过程 $ d2 S2 C. X5 x: X6 A. T5 e, j
STM32F746G_DISCO 有两个外部存储器,SDRAM 和 QSPI Flash,SDRAM 用于帧缓冲器,QSPI Flash 用于存储图片、字体等素材,其图形实现过程如图 1 所示。本文档参考从 TouchGFX Desinger 上下载的 TBS,第一步首先完成 IOC 文件的配置,由于会使用 外部 RAM 和外部 Flash,生成代码后还需要添加相应的存储器驱动代码,以及修改链接文件。对于仅使用内部 Flash 和内部 RAM 的应用,用 STM32CubeMX 和 TouchGFX Desinger 生成代码后,就可以直接使用 TouchGFX 点亮屏幕了。
% u) K- q( p2 [/ |) E
13.png
▲ 图2. 图形实现过程

. }5 i" y1 p0 M4 B4 p5 g2.1. 新建 IOC 工程
: ^3 o" g' z3 g- y" A# O
6 k' O$ |  q: k' j

4 k! M& L1 H3 \+ ?* P& y5 v双击打开 STM32CubeMX 软件,按照图中 1-5 步骤操作,MCU 型号输入 STM32F746NGH6 进行选择,其中第 5 步提示配置默认 MPU 单元来优化内核的推测性 读取访问,请点击“YES”。
: q' S5 p3 E% }& M7 Z0 U
14.png
▲ 图3. 新建 STM32CubeMX 工程
然后点击“Project Manager”,配置工程名称,如图所示。
/ t$ T6 f* g2 ?8 P$ u' l7 r: U
15.png
▲ 图4. 配置工程名称
. B8 j6 t( `( M1 u# b) T, N
( i0 r" t% \$ m  X- W- `7 z. N' Y
2.2. CORTEX_M7
  P1 \! M) v" L" f' B  C) j; q4 h* y" R) Z
7 ^* I; ?# I# T% @
这里使能 ICACHE 和 DCACHE,并配置内存保护单元 MPU,要正确配置 MPU 属性 以避免由 Cortex®-M7 推测性读取访问和缓存维护引起的图形性能问题,使用 STM32CubeMX 可以轻松配置 MPU 存储器属性。详细配置过程可以参考 AN4861 4.6 小节 Special recommendations for Cortex-M7 (STM32F7/H7),其中介绍对嵌入了 Cortex®-M7 CPU 的 STM32F7 系列的一些建议,建议大家仔细阅读下。5 C0 V' x! x) E+ y

2 ~5 ~) X8 {" \0 }

3 V' I3 J; r" [, z2.3. CRC
  U5 M% Z8 T7 Y, b' z+ \  Y% |; F3 w* s9 ]6 r) O% i) v
9 u* B" u- h2 c, a
CRC 是循环冗余校验计算单元,如果要使用 TouchGFX,必须要使能 CRC,其配置保 持默认即可。
2 l. T' O' U6 j6 l, r8 [( I$ ~
" {) O5 K! s( R+ @5 B& r+ P' d: U$ X  O
0 z7 w+ f! \  n2 G, a. |% Y. N" h+ }7 e
16.png
▲ 图5. 使能 CRC
5 u8 K! q; J; |1 A+ _
2.4. DMA2D
6 [9 o# F7 u/ l- Z- ~, W! z. j2 Z6 F* ?9 G# P

6 b2 g) q% R7 y% U; q# i6 CDMA2D 是 AHB 总线矩阵上的主设备,它将图形数据传输到内存,也可用于图形渲 染,建议使用 DMA2D 来减轻 CPU 负载。DMA2D 使能后保持默认配置即可,当需要 DMA2D 来进行图形加速时,TouchGFX 引擎会自动调用 DMA2D。
6 ?. r' d+ S" e1 l1 c1 ?$ D# Z7 H4 L+ I/ m
17.png
▲ 图6. 使能 DMA2D

! m) ~5 ~2 V) L; H2.5. FMC 配置 LTDC 帧缓存区和 Video 缓冲区放在了外部 SDRAM 中。配置 FMC 相关参数时,需 要对照原理图和 SDRAM 的 datasheet,了解相关参数,然后进行配置。配置结束后,需 要添加相应的驱动代码,将其配置内存映射模式。 + ]8 U# e5 Q0 |' ^: Q
18.png
▲ 图7. FMC 配置

# |4 R3 n2 W- K- @, U
7 n9 A: w3 G7 L- L
2.6. FREERTOS - ^, k% U; j! M- q
7 ]" `: C1 o# E' O' l1 _, V
' o4 M! l& s) f
TouchGFX 可以运行在有 RTOS 和无 RTOS 的工程中,本工程移植的是带有 RTOS, RTOS 选择 FreeRTOS,在本工程中新增了 2 个 task,TouchGFXTask 任务用于运行ToucGFX 图形引擎,VideoTask 任务用于进行 Mjpeg 视频的编解码,如果您的项目不用 video 控件,那么 videoTask 可以不用添加。8 q9 o. Z. b/ b5 c* C8 H
19.png
▲ 图8. FreeRTOS 新增任务
1 L' b( b! q- G& `

4 U0 H5 W, C: [# }# |1 i  d3 M注意新增总的堆空间大小,防止新建任务的栈大小不足。3 i* W8 C1 K/ o  c$ Y: l9 F9 O6 B9 U
4 a) }7 j, I6 H/ h1 \) w

% Z4 @2 D4 Y, |8 y$ j0 A( Z
20.png
▲ 图9. 堆空间大小配置

. X$ q1 f* J. ?3 H. s. k2.7. GPIO 1 ]# ?* x0 C8 u& x, c& |: Y5 t

$ p' z0 ~* N7 E8 c6 M& r
# N. {) X6 o/ n( ?4 e' ?, S
在官方下载的 TBS,配置的 GPIO 如图 9 所示。与 LCD 显示相关的引脚有 2 个, LCD_DISP 和 LCD_BL_CTRL。LCD_DISP 用来启用/禁用显示待机模式,需要将 LCD_DISP 配置为高电平来启用显示器,否则显示器将保持待机模式。LCD_BL_CTRL 信 号上的高电平可以点亮背光,而低电平则将其关闭。
+ `8 Y% M* C( v+ H$ L3 v$ E  E' Y
6 E' H) [7 H, |2 u

& f; K* O3 o, S% }1 ]另外几个 GPIO 引脚可以用来测试性能的,它们的解释说明可以查看 TouchGFXGPIO.cpp 中注释,其中 RENDER_TIME,可以用来查看实际的渲染时间。
! G/ u: c8 I* l& D' c
4 f# l. d' }0 C2 s: `6 S; R% T
  j! Y8 g1 `' G
21.png
▲ 图10. GPIO 配置

. |- f$ b. S7 B: C0 d  b2.8. I2C3 - M! g$ v6 b& Q4 J( N. O

$ \1 S" t* i7 L% J
+ b4 j! [, S! @0 g1 I
STM32F746G_DISCO 的电容 LCD 的触摸的接口是 I2C3 的 PH7 和 PH8,相关参数 的配置参数如图所示。
; |) f9 b: r8 [! f0 T; ?, s" ]% C5 B7 R, J7 o$ q
22.png
▲ 图11. I2C3 配置

9 @9 W; b9 B: i# l: `# S

7 U2 A3 o/ m5 s' [2.9. LIBJPEG
  a5 x3 ^" x& b8 ?% i6 f- a  _: \' U! X! d" o
- U0 `) @( ?4 d9 |
如果 TouchGFX 使用 Video 控件,要使能 LIBJPEG,用于视频流的软件编解码。如果 您的工程用不到 Video 控件,那么可以不用使能 LIBJPEG。3 T* h# c& p0 E/ K( I' o

# s; g: I. q* V: J; z: C
23.png
▲ 图12. GPIO 配置
0 P3 h6 f; F, a* b7 B# g/ a

6 G' `& @/ k! q; g! F2.10. LTDC
4 R2 o! G, ^& g2 @/ g
6 O; E$ P) V+ ~2 o3 d, j, ~) t, B

0 f' ^' g( G3 I& y. N, b1 q3 ?" PLTDC 外设主要用来配置 LCD 显示接口,对于 STM32F746G_DISCO 的 LCD 可以参 考下载的 TBS 进行配置。如果是其他型号的 LCD,需要查看 LCD 的屏幕时序表进行配 置。关于 LTDC 的 layer,虽然在 STM32CubeMX 可以配置为 2 个 layers,但是 TouchGFX Designer 是采用 1 个 layer 来做 GUI 开发的,这是因为 2 个 layer 会占用更 多带宽,同时打开 LTDC 全局中断和错误中断。! E0 O& z' V' v! E; _* F
7 G) m2 ]  [' Z: `  d6 h
24.png
▲ 图13. LTDC 参数配置

( N4 i+ j, R3 J% W% Z6 L6 h$ \( P
25.png
▲ 图14. LTDC layer 配置
26.png
▲ 图15. 打开 LTDC 全局中断和错误中断

5 c7 @) ~+ P1 {
& {. f" v% Q, j& n; A, ?' [! l
2.11. QUADSPI
5 A  G6 u/ D+ \0 \( i: V当要存储的数据量相对较少时,可以使用内部 FLASH 存储器。否则,应将图形内容放 置在外部存储器中。QUADSPI 外接了一个 128-Mbit Quad-SPI NOR Flash。
# z% P" H' d4 x4 n. a
* z- I. j. U; P& W2 v( u; z2 n1 C
27.png
▲ 图16. QUADSPI 配置

; M8 T5 z0 x& ~0 l2 B$ Z

% a0 X7 d, R# m# R1 Q+ @: i0 A2.12.SYS
. Q0 C; f1 C* F8 I; P0 [由于 SysTick 被 RTOS 使用,这里 HAL 库的时基选择 TIM6。, E7 Z2 U- V( A$ S, Z# R& L' s1 ?3 Q
: E  T- e6 G8 Z. A2 ~2 f
28.png
▲ 图17. 系统时钟配置
5 @% U4 W, y) [4 k1 k. s
9 ]' G6 Z$ \! r7 S) V# ~
2.13. X-CUBE-TOUCHGFX
8 h% U7 u/ ^7 p+ _" ]Interface:接口选择 Parallel RGB(LTDC)
, B2 n* Y& k- V, Z5 R3 O对于 RGB 接口的 LCD 来说,通常无内置 GRAM,FrameBuffer Strategy 无法使用 Partial Buffer 策略。在 RAM 足够时,可选择 Double Buffer 策略。存放位置选择 By Allocation。这个可以通过链接文件配置放置在什么位置。: {2 n0 Y6 [! @
Application Tick Source:应用滴答时钟来源,选择 LTDC,它的实现代码可以在 TouchGFXGeneratedHAL.cpp 中 HAL_LTDC_LineEventCallback 函数找到。
% U( I, \3 h1 w4 w8 ]) o: F2 E1 B! R! l  Z3 x
29.png
▲ 图18. TouchGFX 配置

* |2 E0 x  D. w& y# B, W4 R
5 L9 f* k$ C2 R) `% n6 ^4 m* A+ D
2.14.Clock Configuration 0 E* l% T: j& z, f6 }  R/ x
系统时钟配置为 216MHz,LTDC 时钟配置为 9.6MHz,这个 LTDC 时钟的配置是参 考 LCD 时序参数表确定的,它与 LCD 的刷新率相关。
) O" r8 Z, M7 y7 i( W6 @
. w% G/ c' d5 }! t% F; N
30.png
▲ 图19. 时钟树配置
3 W" d* w# l& @$ Z
至此,外设配置基本完成,选择所使用的 IDE(这里选择的是 STM32CubeIDE),点 击 Generate Code 按钮,生成代码。然后使用 TouchGFX Designer 打开 TouchGFX 文 件夹下的 ApplicationTemplate.touchgfx.part,在 TouchGFX Designer 中生成 UI 相关 代码。3 R+ i$ J* _# c0 Q; D& z

/ i- q# O8 F* x' a: u8 X8 E' r' X

2 n) ]% P( l6 i3: t; O! G, o) e, M3 Z- Z( f
添加驱动代码
0 E" R; t7 g2 }8 E3 s+ \" S+ S对于 LTDC 接口的 TouchGFX 工程,使用 TouchGFX Desiger 生成代码后,如果仅使 用内部 RAM 和 Flash,那么在 TouchGFX 生成代码后,整个软件架构就建好了,可以使 用 TouchGFX 来点亮屏幕了。
- m2 W. f) r# T" u' n- F3 x# p# Q7 E- J" v
对于使用外部 SDRAM、 QSPI Flash 以及触摸功能的应用可以参考下载的 TBS 进行对 照检查,添加相应的驱动代码和修改链接文件,完善整个工程代码后实现 TouchGFX 点亮 LCD 的效果。3 n4 K: N( q6 c" J1 [2 C& ?$ m

+ Y# E( r* ]" ^7 s" W/ \4 l

( a8 r( Y; @, }& b" U3.1. 添加 SDRAM 驱动代码
' S9 U9 B6 |! R1 K* U+ V查看下载的 TBS,可以在 main.c 中的 MX_FMC_Init()函数的用户代码区域看到添 加的驱动代码。这里有一点要说明的是最后的 FMC_Bank1->BTCR[0] = 0x000030D2 代 码是禁用 FMC bank1,这点在 AN4861 的 4.6.1 Disable FMC bank1 if not used 有详 细介绍。为了防止 FMC bank1 上的 CPU 推测性读取访问,建议在不使用时将其禁用。这可以通过复位 FMC_BCR1 寄存器中的 MBKEN 位来完成,默认情况下该位在复位后使能。9 g- R! v! b  z  O3 m8 s
( i0 e- ]6 P+ R3 I5 }) u* z

3 E2 j, m. ?$ z1 ?7 m1 |! V, x1 ?$ r. e3.2. 添加 QSPI Flash 驱动代码
; g* S- _( t! L% ~4 a: C0 b+ o添加驱动代码把 QSPI Flash 配置成 memory mapped 模式。
/ ^& o& k" a+ N* ~; @8 ]9 h& r9 Y0 ~3 z" U1 H

( O( [1 _, \1 b2 h& y3.3. 添加 Touch 功能
# {' m2 D( G! O6 G) M3 f触摸功能在 STM32TouchController.cpp 中实现,具体代码请参考 TBS。- A/ D; v* A8 W1 Q4 G8 y2 v
: L  q  I& k: r+ D6 j1 P
1 P# b; \( n- _: ?) p7 |- m
3.4. 修改链接文件
* Y& s) f" s* z8 a7 h4 e& P) r$ J为了把帧缓冲区和视频缓冲放到外部 SDRAM,把字体、图片等素材放到外部 Flash, 需要修改链接文件。不同的 IDE,它的链接文件是不同的。对于 STM32CubeIDE,它的 链接文件是 STM32F746NGHX_FLASH.ld,对于 EWARM,它的链接文件是 stm32f746xx_flash.icf,对于 MDK-ARM,它的链接文件是 STM32F746G_DISCO.sct, 它们的语法略有不同。大家可以参考它的结构进行修改。
+ t* D. p2 m9 a$ R2 D3 v* P8 U* K0 Q* l/ }* v4 J! c
3 j0 B( ^" P3 @2 E- k) I# f
4
( S% @3 P. |. z小结 0 T7 W: g( i! K  Q
以上就是 LTDC RGB 接口 LCD 的 TouchGFX 工程的移植步骤,本文档对关键步骤进 行了解释说明,具体细节可参考 AN4861 和官方的 TBS。
! z; D3 |& ?+ ~, c# V# S% x& v
( G+ }7 w7 c2 F3 y" }! J) z: ^

: b4 w2 N# I+ W
▼▼▼
点击按钮下载《LTDC RGB 接口 LCD TouchGFX 工程的移植步骤》原文档。5 \3 a+ Z' D# _
点击下载$ B7 K% o* h& i
" ]4 x; {* |7 f0 w, c  n. G) {
赞 收藏 评论2 发布时间:2025-2-6 09:47

举报

2个回答
电子烂人 回答时间:2025-2-8 10:51:28

挺有趣的,抽空试一下移植到H743上

STMCU-管管 回答时间:2025-2-12 13:51:17

<br /> <br />

可以试试

所属标签

相似技术帖

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