简介这份工程面向使用STM32H743IIT6进行嵌入式GUI开发的工程师与学习者基于STM32CubeMX配置环境集成TouchGFX图形框架并完成4.3英寸800×480液晶屏与触摸驱动的移植可用于工业控制、消费电子及物联网设备的界面开发。压缩包共1172个文件约71.44MB以hpp、h、cpp、c等源码文件为主配合d、o、crf等编译中间文件以及a、lib静态库、png图片资源、uvprojx与uvoptx工程文件、ioc配置文件和hex烧录文件完整保留了从CubeMX配置到TouchGFX界面工程的目录结构。目前已有2220人学习下载。通过该工程可掌握HAL库编程、TouchGFX布局管理与事件处理机制并参考触摸屏适配与资源优化思路适合具备一定STM32基础、希望深入图形界面开发的读者。1. 从一块 H743 板子说起为什么这套 TouchGFX 工程值得你花时间手里有正点原子 STM32H743IIT6 这块板子的人不少但真正把 TouchGFX 跑通、跑顺、跑出可用界面的人不多。原因很直接H743 的 LTDC 外设、SDRAM 显存映射、CubeMX 的时钟树配置、TouchGFX Designer 的生成链路这四样东西任何一环配错屏幕要么白屏、要么花屏、要么触摸偏移而且报错信息往往指向一个跟根因无关的地方。这套工程的价值就在于它把上面这条链路完整地串了一遍从 CubeMX 的 .ioc 配置到 TouchGFX 的 UI 工程再到 Keil 或 STM32CubeIDE 下的编译烧录是一个可以直接对照复现的参考实现。它适合两类人一类是刚拿到 H743 开发板、想快速验证屏幕和触摸是否正常的嵌入式新手另一类是做过 F4/F7 上的 TouchGFX、想迁移到 H7 平台但被 SDRAM 时序和 LTDC 层配置卡住的老手。H743 主频 480MHz、带 Chrom-ART 图形加速器跑 TouchGFX 的帧率表现和 F4 完全不是一个量级但前提是显存和 DMA2D 配置对了。这套工程能帮你省掉的正是那些配置看起来都对、屏幕就是不动的排查时间。2. 拆开这套工程CubeMX 配置与 TouchGFX 的对接逻辑2.1 先搞清楚 H743 上 TouchGFX 的硬件依赖链TouchGFX 在 STM32 上不是纯软件库它依赖一整套硬件外设协同工作。在 H743IIT6 上这条链路是这样的LTDC 负责把帧缓冲区的数据扫描输出到 RGB 屏幕SDRAM 通过 FMC 控制器挂载充当帧缓冲区因为 H743 内部 SRAM 装不下一个 800×480×2 字节的显存DMA2DChrom-ART负责图形加速做填充、拷贝、混合时不用 CPU 插手触摸部分通常走 I2C 接电容触摸芯片中断引脚触发读取。这四者里最容易翻车的是 SDRAM。正点原子 H743 板子用的是 W9825G6KH 这类 SDRAM 颗粒时序参数CAS 延迟、刷新周期、读写恢复时间必须跟颗粒手册对上。CubeMX 里 FMC 的 SDRAM 配置页有一堆参数很多人直接抄别的例程结果颗粒型号不同跑起来时好时坏——这就是典型的玄学花屏来源。2.2 CubeMX 里必须确认的几组参数打开工程里的 .ioc 文件重点核对这几处。时钟树部分H743 的 LTDC 时钟来自 PLL3通常配到 30~50MHz 之间具体取决于屏幕的像素时钟要求。SDRAM 时钟来自 HCLK3注意 H743 的 FMC 时钟分频要保证不超过 SDRAM 颗粒的额定频率。FMC 的 SDRAM 参数区关键几项参数典型值W9825G6KH说明LoadToActiveDelay2tMRD模式寄存器设置到激活的延迟ExitSelfRefreshDelay7tXSR退出自刷新时间SelfRefreshTime4tRAS自刷新周期RowCycleDelay7tRC行循环延迟WriteRecoveryTime2tWR写恢复时间RPDelay2tRP预充电延迟RCDDelay2tRCD行到列延迟这些值不是拍脑袋填的是按 SDRAM 颗粒手册的纳秒值除以 FMC 时钟周期算出来的。比如 tRCD 是 18nsFMC 时钟 100MHz周期 10ns那 RCDDelay 至少填 2。填小了读写不稳定填大了性能下降但不会崩。我一般会先按手册算一遍再往上取整留余量。LTDC 配置里注意 Layer 的帧缓冲区地址要指向 SDRAM 映射后的地址比如 0xC0000000 起始。像素格式选 RGB565 还是 ARGB8888 取决于你的 UI 资源RGB565 省显存但没透明度ARGB8888 效果好但一个 800×480 的层就要 1.5MB。2.3 TouchGFX Designer 工程的生成与对接CubeMX 配好之后在 Middleware 里勾选 TouchGFX指定好 LTDC 层和 DMA2D然后生成代码。生成的工程里会有一个 TouchGFX 文件夹里面是 Designer 的工程文件。用 TouchGFX Designer 打开这个 .touchgfx 文件就能开始拖控件、做界面。这里有个关键点Designer 里生成的代码和 CubeMX 生成的代码是分开的但通过TouchGFXHAL和TouchGFXGeneratedHAL两个类对接。你自定义的硬件初始化比如触摸读取、背光控制要写在TouchGFXHAL里而不是去改生成的文件否则下次 CubeMX 重新生成就覆盖了。// TouchGFXHAL.cpp 中自定义触摸读取的典型写法 void TouchGFXHAL::askForTouchEvent() { // 读取触摸芯片的坐标通过 I2C uint16_t x, y; if (touch_read(x, y)) { // 把坐标转成 TouchGFX 的坐标系 // 注意屏幕方向和触摸方向要一致否则会出现点左出右 touchgfx::Point pos(x, y); // 交给 TouchGFX 处理 handleTouchEvent(pos); } }这段逻辑说明askForTouchEvent是 TouchGFX 每帧回调的触摸采样入口你在这里读硬件。参数上x、y 要跟 LTDC 输出的分辨率对齐如果屏幕旋转了 90 度这里也要做坐标变换。常见坑是触摸芯片的坐标原点和屏幕原点不一致导致触摸偏移解决方法是先在屏幕上画十字准星读原始坐标算出偏移量再补偿。3. 从零编译到点亮工程导入与首次运行的完整步骤3.1 开发环境准备与工程导入这套工程支持 Keil MDK 和 STM32CubeIDE 两条路。Keil 的话需要装好 H7 的 Device Family PackCubeIDE 则要确认固件包版本跟 .ioc 里声明的一致。我一般推荐 CubeIDE因为 CubeMX 和 IDE 是一家的重新生成代码时不容易出幺蛾子。导入步骤如果是 Keil直接打开工程目录下的 .uvprojx如果是 CubeIDE用 File → Import → Existing Projects into Workspace指向工程根目录。导入后先别急着编译检查一下头文件路径里有没有指向 TouchGFX 的 include 目录以及链接脚本里 SDRAM 区域的地址范围是否覆盖了帧缓冲区。# 以 CubeIDE 命令行编译为例确认工具链可用 arm-none-eabi-gcc --version # 进入工程 Debug 目录后执行 make make -j8 all编译通过后用 ST-Link 烧录。烧录前确认 BOOT 引脚状态H743 从 Flash 启动。第一次烧录后如果屏幕没反应先别怀疑代码用调试器读一下 LTDC 的寄存器看层是否使能、帧缓冲区地址是否写进去了。3.2 首次上电的检查清单上电后按这个顺序排查能省很多时间。第一步量背光电压确认背光电路工作了屏幕至少应该亮起来哪怕白屏。第二步用示波器看 LTDC 的像素时钟输出没有时钟说明 LTDC 没使能。第三步读 SDRAM 的测试结果很多工程会跑一个 SDRAM 读写测试如果这步没过后面全是白搭。如果屏幕显示花屏但能看到图像轮廓八成是 SDRAM 时序偏了或者帧缓冲区地址不对。如果屏幕纯白或纯黑先查 LTDC 层使能和背光。如果图像正常但触摸没反应查 I2C 地址和中断引脚配置。3.3 触摸校准与坐标映射触摸能读到坐标但点不准是这套工程最常见的最后一公里问题。电容屏一般不需要像电阻屏那样做四点校准但坐标映射关系要对。假设屏幕分辨率 800×480触摸芯片返回的原始坐标范围是 0~4095那映射就是简单的线性缩放。// 触摸坐标线性映射 #define SCREEN_WIDTH 800 #define SCREEN_HEIGHT 480 #define TOUCH_MAX_X 4095 #define TOUCH_MAX_Y 4095 void map_touch(uint16_t raw_x, uint16_t raw_y, uint16_t *out_x, uint16_t *out_y) { // 先做方向判断如果 X 轴反了就把 raw_x 取反 *out_x (uint32_t)raw_x * SCREEN_WIDTH / TOUCH_MAX_X; *out_y (uint32_t)raw_y * SCREEN_HEIGHT / TOUCH_MAX_Y; // 边界钳位防止溢出到屏幕外 if (*out_x SCREEN_WIDTH) *out_x SCREEN_WIDTH - 1; if (*out_y SCREEN_HEIGHT) *out_y SCREEN_HEIGHT - 1; }参数说明TOUCH_MAX_X/Y 要按你实际触摸芯片的手册填不是所有芯片都是 4095。如果发现 X 轴方向反了把 raw_x 用 TOUCH_MAX_X 减去即可。这段代码放在TouchGFXHAL::askForTouchEvent里调用映射完再交给 TouchGFX。4. 避坑与排查H743 跑 TouchGFX 最容易翻车的五个地方4.1 现象屏幕花屏图像像被撕裂原因SDRAM 时序参数偏小或者 FMC 时钟超了颗粒额定频率。H743 的 FMC 时钟如果配到 120MHz 而颗粒只支持 100MHz就会出现这种间歇性花屏。解决把 FMC 时钟分频调大一档或者把 SDRAM 时序参数按手册重新算一遍每个值往上取整。改完跑一遍 SDRAM 全片读写测试确认无误再跑 UI。4.2 现象白屏背光亮但没有任何图像原因LTDC 层没使能或者帧缓冲区地址指向了未初始化的内存区域。CubeMX 里如果忘了勾选 LTDC 的 Layer生成的代码里就不会初始化。解决在调试器里读 LTDC_LxCR 寄存器确认 LEN 位为 1。再读 LTDC_LxCFBAR确认地址落在 SDRAM 映射范围内。如果地址是 0说明 CubeMX 里没配帧缓冲区地址。4.3 现象触摸点偏点左边触发右边原因触摸坐标和屏幕坐标方向不一致或者触摸芯片的坐标原点在右下角而屏幕在左上角。解决在askForTouchEvent里加坐标变换先判断方向再映射。最直接的办法是画一个全屏的十字准星点四个角记录原始坐标反推变换公式。4.4 现象UI 切换卡顿动画掉帧原因DMA2D 没使能或者帧缓冲区用了内部 SRAM 导致带宽不够。H743 的 AXI SRAM 虽然快但容量小跑大分辨率 UI 必须用 SDRAM。解决确认 CubeMX 里 DMA2D 已勾选TouchGFX 的配置里把USE_DMA2D打开。另外检查 SDRAM 的突发长度配置设成 8 或 16 能提升带宽。4.5 现象CubeMX 重新生成代码后自定义逻辑丢失原因把自定义代码写在了 CubeMX 生成的文件里重新生成时被覆盖。解决所有自定义逻辑写在TouchGFXHAL.cpp或者用户自己的 .c/.cpp 文件里CubeMX 生成的文件只放初始化。TouchGFX 的TouchGFXGeneratedHAL和TouchGFXHAL分离设计就是为了这个别去动 Generated 那个。5. 进阶技巧用 DMA2D 加速和帧率验证5.1 确认 DMA2D 真的在工作DMA2D 是 H743 跑 TouchGFX 流畅的关键但很多人配了却没生效。验证方法很简单在 TouchGFX 的HAL::flushFrameBuffer里打个断点看是否走了 DMA2D 的路径。或者直接读 DMA2D 的 ISR 寄存器看传输完成标志有没有置位。如果发现 DMA2D 没工作检查两处一是 CubeMX 里 DMA2D 的时钟使能了没二是 TouchGFX 的配置文件touchgfx_generated_config.hpp里USE_DMA2D是不是 1。有些工程模板默认关掉了需要手动开。5.2 帧率测量与优化方向TouchGFX 自带一个帧率显示组件在 Designer 里拖一个FPS控件到界面上就能看到实时帧率。H743 跑 800×480 的 RGB565 界面正常应该在 30~60fps 之间。如果低于 20fps按这个顺序优化先确认 DMA2D 开了再检查 SDRAM 带宽突发长度、时钟频率最后看 UI 里有没有大面积的透明混合操作——ARGB8888 的混合很吃带宽能不用就不用。// 在 TouchGFXHAL 里手动统计帧率如果不想用 Designer 控件 static uint32_t frame_count 0; static uint32_t last_tick 0; void TouchGFXHAL::endFrame() { frame_count; uint32_t now HAL_GetTick(); if (now - last_tick 1000) { // 每秒打印一次帧率 printf(FPS: %lu\r\n, frame_count); frame_count 0; last_tick now; } // 调用父类实现别漏了 TouchGFXGeneratedHAL::endFrame(); }这段代码在每帧结束时计数每秒输出一次。参数上HAL_GetTick是 1ms 精度够用了。注意endFrame里一定要调父类实现否则 TouchGFX 的帧同步会出问题。5.3 一个我踩过的坑SDRAM 刷新和 LTDC 抢带宽有次调一个 1024×600 的屏UI 静态时正常一播放动画就闪屏。查了半天发现是 SDRAM 的自动刷新周期配得太密跟 LTDC 的扫描抢带宽。后来把刷新周期从 64ms 调到 128ms颗粒支持的话闪屏就消失了。这个参数在 FMC 的 SDRAM 配置里叫RefreshCount值越小刷新越频繁、越占带宽。从那以后我每次配 SDRAM都会先确认颗粒手册里的刷新周期再算 RefreshCount不敢随便抄。希望这套工程的拆解能帮你少走点弯路屏幕点亮的那个瞬间前面的折腾都值了。本文还有配套的精品资源点击获取