简介该资源是面向STM32H743IIT6高端微控制器的Cubemx与Touchgfx整合工程适合已掌握HAL库基础、希望进阶嵌入式GUI开发的工程师与学生。工程以4.3英寸800×480液晶屏为显示载体完成触摸驱动移植可构建带动画、图标与菜单的复杂交互界面适用于工业控制、消费电子及物联网设备的人机交互场景。压缩包共1172个文件约71.44MB以hpp、h、cpp、c等源码文件为主辅以d、o、crf等编译中间产物以及a、lib静态库、png图片资源、uvprojx与uvoptx工程配置、ioc与mxproject初始化文件另含hex烧录文件与map映射表完整保留从CubeMX配置到Touchgfx界面工程的目录结构。目前已有2220人学习下载。读者可据此快速搭建可编译运行的Touchgfx工程模板理解HAL层与图形框架的衔接方式并参考其资源组织与库文件配置减少从零移植触摸屏与GUI的试错成本。1. 拿到一块 H743 板子怎么把 TouchGFX 跑出丝滑感手里有块 STM32H743IIT6 的板子屏幕也焊好了供电正常但屏幕就是一片白或者卡在某个画面不动——这种场景搞嵌入式 GUI 的应该都不陌生。正点原子这套 STM32H743IIT6 的 CubeMX TouchGFX 工程解决的就是从「裸机点灯」到「带触摸交互的图形界面」之间那段最磨人的路。它把 CubeMX 的时钟树、SDRAM 配置、LTDC 显示接口、DMA2D 加速、I2C 触摸驱动以及 TouchGFX 的 Designer 工程和生成代码全部串好了。适合谁适合已经会 STM32 基础外设、想上手 TouchGFX 但被底层配置卡住的开发者也适合拿 H743 做产品原型、需要快速验证 UI 交互的团队。下面按「工程怎么搭起来 → 核心模块怎么跑 → 怎么改」的顺序拆。2. 工程结构拆解CubeMX 配置与 TouchGFX 的对接点2.1 目录分层与生成物关系这套工程的核心逻辑是「CubeMX 管底层TouchGFX Designer 管 UIKeil/IAR 管编译链接」。目录上通常长这样H743_TouchGFX/ ├── Core/ │ ├── Inc/ # main.h, stm32h7xx_hal_conf.h 等 │ └── Src/ # main.c, stm32h7xx_it.c, 外设初始化 ├── Drivers/ │ ├── STM32H7xx_HAL_Driver/ │ └── CMSIS/ ├── Middlewares/ │ └── ST/ │ └── TouchGFX/ # TouchGFX 库、OS 抽象层 ├── TouchGFX/ │ ├── App/ # 应用层Model, Presenter, View │ ├── gui/ # Designer 生成的界面代码 │ ├── generated/ # 生成代码fonts, images, texts │ └── target/ # 目标平台适配TouchGFXHAL, TouchGFXGeneratedHAL └── STM32H743IITx_FLASH.ld关键点在于TouchGFX/target/这个目录。CubeMX 生成的TouchGFXHAL.cpp继承自TouchGFXGeneratedHAL里面重写了initialize()、flushFrameBuffer()、touchGfxSignalVSync()这些函数。很多人第一次跑 TouchGFX 翻车就是没搞清「谁调谁」——CubeMX 初始化 LTDC 和 DMA2D 之后TouchGFX 的 HAL 层再接管帧缓冲刷新和触摸事件分发。2.2 CubeMX 里必须配对的外设在 CubeMX 的.ioc文件里下面这几个外设不是随便勾上就行参数配错一个屏幕要么不亮要么撕裂外设关键配置项典型值以 800×480 RGB 屏为例LTDCPixel Clock33 MHz 左右按屏手册算LTDCHSW/HBP/HFP根据屏时序填常见 48/88/40LTDCVSW/VBP/VFP常见 3/32/13DMA2D使能用于加速填充和混合FMC/SDRAM时钟、行列地址按板载 SDRAM 型号配I2C速率100kHz 或 400kHz看触摸芯片GPIO触摸中断引脚下降沿触发LTDC 的像素时钟不是随便给的。H743 的 LTDC 时钟源来自 PLL3CubeMX 里要先把 PLL3 的 R 分频算对否则像素时钟偏差超过 5%屏幕就会出现水波纹或者偏移。我一般会先用示波器量一下 LTDC_CLK 引脚确认频率和屏手册一致再往下走。2.3 TouchGFX Designer 工程怎么嵌进来TouchGFX Designer 生成的.touchgfx文件不直接参与编译它导出的是TouchGFX/gui/和TouchGFX/generated/下的 C 代码。CubeMX 工程里通过Middlewares/ST/TouchGFX/touchgfx.mk或者 Keil 的.uvprojx把这几层源码加进编译。一个容易忽略的点TouchGFX 的Application::create()是在main.c的MX_TouchGFX_Init()之后、MX_TouchGFX_Process()之前调用的。如果你在 CubeMX 里改了 FreeRTOS 的堆大小但没同步改 TouchGFX 的OSWrappers配置跑起来就会在osMessageQueueNew那里直接 HardFault。3. 核心模块跑通从 SDRAM 到触摸事件的完整链路3.1 SDRAM 初始化与帧缓冲分配H743IIT6 片内 SRAM 只有 1MB 左右800×480×2 字节的双缓冲就要 1.5MB所以帧缓冲必须放外部 SDRAM。CubeMX 里 FMC 配好之后代码里要手动做一次 SDRAM 初始化序列// fmc.c 中 SDRAM 初始化关键片段 void MX_FMC_Init(void) { FMC_SDRAM_TimingTypeDef SdramTiming {0}; hsdram1.Instance FMC_SDRAM_DEVICE; hsdram1.Init.SDBank FMC_SDRAM_BANK1; hsdram1.Init.ColumnBitsNumber FMC_SDRAM_COLUMN_BITS_NUM_9; hsdram1.Init.RowBitsNumber FMC_SDRAM_ROW_BITS_NUM_13; hsdram1.Init.MemoryDataWidth FMC_SDRAM_MEM_BUS_WIDTH_16; hsdram1.Init.InternalBankNumber FMC_SDRAM_INTERN_BANKS_NUM_4; hsdram1.Init.CASLatency FMC_SDRAM_CAS_LATENCY_3; hsdram1.Init.WriteProtection FMC_SDRAM_WRITE_PROTECTION_DISABLE; hsdram1.Init.SDClockPeriod FMC_SDRAM_CLOCK_PERIOD_2; hsdram1.Init.ReadBurst FMC_SDRAM_RBURST_ENABLE; hsdram1.Init.ReadPipeDelay FMC_SDRAM_RPIPE_DELAY_1; HAL_SDRAM_Init(hsdram1, SdramTiming); // 发送 SDRAM 初始化命令序列 FMC_SDRAM_CommandTypeDef Command; Command.CommandMode FMC_SDRAM_CMD_CLK_ENABLE; Command.CommandTarget FMC_SDRAM_CMD_TARGET_BANK1; Command.AutoRefreshNumber 1; Command.ModeRegisterDefinition 0; HAL_SDRAM_SendCommand(hsdram1, Command, 0xFFFF); HAL_Delay(1); Command.CommandMode FMC_SDRAM_CMD_PALL; HAL_SDRAM_SendCommand(hsdram1, Command, 0xFFFF); Command.CommandMode FMC_SDRAM_CMD_AUTOREFRESH_MODE; Command.AutoRefreshNumber 8; HAL_SDRAM_SendCommand(hsdram1, Command, 0xFFFF); Command.CommandMode FMC_SDRAM_CMD_LOAD_MODE; Command.ModeRegisterDefinition 0x220; // CAS3, 突发长度 4 HAL_SDRAM_SendCommand(hsdram1, Command, 0xFFFF); }这段代码里SdramTiming的TRCD、TWR、TRP这些参数必须按 SDRAM 芯片手册填填大了没事填小了数据读写会随机出错。ModeRegisterDefinition的0x220对应 CAS 延迟 3、突发长度 4和Init里的CASLatency要一致。初始化完之后帧缓冲地址一般定在0xC0000000开始的位置TouchGFX 的TouchGFXGeneratedHAL::initialize()里会通过setFrameBufferStartAddresses()把两个缓冲的地址传进去。3.2 LTDC 层配置与 DMA2D 加速LTDC 配两层一层背景层一层 UI 层。背景层可以关掉或者填纯色UI 层指向 SDRAM 里的帧缓冲。CubeMX 里 LTDC 的 Layer 配置要注意Alpha和BlendingFactor如果 UI 层不需要透明把 blending 关掉能省带宽。DMA2D 在 TouchGFX 里主要干两件事矩形填充和图像混合。TouchGFX 的flushFrameBuffer()默认走 LTDC 的垂直消隐中断但如果你在 Designer 里用了大量半透明控件DMA2D 的混合性能就关键了。H743 的 DMA2D 支持 RGB565 和 ARGB8888 互转TouchGFX 的LCD24bpp和LCD16bpp配置要和 LTDC 的像素格式对齐。// TouchGFXHAL.cpp 中 flushFrameBuffer 的典型实现 void TouchGFXHAL::flushFrameBuffer(const touchgfx::Rect rect) { // 等待 DMA2D 空闲 while (DMA2D-CR DMA2D_CR_START); // 配置 DMA2D 做矩形填充或拷贝 DMA2D-CR DMA2D_R2M; // 寄存器到内存模式 DMA2D-OPFCCR DMA2D_OUTPUT_RGB565; DMA2D-OCOLR 0x0000; // 填充色 DMA2D-OMAR (uint32_t)frameBuffer rect.y * 800 * 2 rect.x * 2; DMA2D-OOR 800 - rect.width; DMA2D-NLR (rect.height 16) | rect.width; DMA2D-CR | DMA2D_CR_START; // 通知 TouchGFX 这一帧已提交 touchgfx::HAL::flushFrameBuffer(rect); }这里OOR是行偏移NLR的高 16 位是行数、低 16 位是列数。如果屏幕出现花屏或者错位先查OMAR的地址计算有没有按像素字节数乘对。RGB565 每像素 2 字节RGB888 是 3 字节算错一个字节整个画面就斜了。3.3 触摸事件从 I2C 到 Presenter 的传递触摸芯片一般是 GT911 或 FT6236走 I2C。CubeMX 里配好 I2C 和外部中断引脚后中断服务函数里读触摸坐标然后通过 TouchGFX 的OSWrappers::signalTouch()或者直接调HAL::injectTouchEvent()把事件塞进去。// stm32h7xx_it.c 中触摸中断处理 void EXTI15_10_IRQHandler(void) { if (__HAL_GPIO_EXTI_GET_IT(TOUCH_INT_PIN) ! RESET) { __HAL_GPIO_EXTI_CLEAR_IT(TOUCH_INT_PIN); // 读取触摸坐标伪代码具体寄存器看芯片手册 uint16_t x, y; if (GT911_ReadPoint(x, y)) { touchgfx::TouchEvent evt(x, y, touchgfx::TouchEvent::PRESSED); touchgfx::HAL::getInstance()-injectTouchEvent(evt); } } }注意injectTouchEvent是线程安全的但如果你在中断里直接调要确保 TouchGFX 的任务优先级和中断优先级不冲突。常见做法是在中断里发一个信号量让 TouchGFX 的任务去读 I2C避免在中断里做慢速 I2C 传输。4. 避坑与排查H743 TouchGFX 最容易翻车的几个点4.1 屏幕白屏或背光亮但无图像现象上电后背光亮但屏幕全白或全黑没有 UI 画面。原因通常是 LTDC 的像素时钟没配好或者帧缓冲地址没指向 SDRAM 的正确位置。解决先用 CubeMX 的 LTDC 配置生成一个纯色填充测试确认 LTDC 本身能出图再检查setFrameBufferStartAddresses()传的地址是不是 SDRAM 映射区以及 MPU 配置有没有把 SDRAM 区域设成 Write-Through 或 Write-Back。4.2 TouchGFX 任务跑不起来卡在 osMessageQueueNew现象调试器停在OSWrappers::initialize()里的osMessageQueueNew返回 NULL。原因一般是 FreeRTOS 堆不够或者 CubeMX 里没使能 FreeRTOS 的USE_COUNTING_SEMAPHORES。解决把configTOTAL_HEAP_SIZE调到 60KB 以上TouchGFX 默认要几个队列和信号量堆太小直接分配失败。4.3 触摸坐标偏移或反向现象点屏幕左边UI 响应在右边或者上下颠倒。原因触摸芯片的坐标原点和屏幕原点不一致或者 I2C 读出来的 x/y 需要交换。解决在TouchGFXHAL::initialize()之后加一个坐标变换或者在 Designer 的TouchCalibration里做映射。常见做法是先在屏幕上画一个十字手动点四个角校准一次把偏移量写死到代码里。4.4 DMA2D 和 LTDC 抢带宽导致撕裂现象UI 刷新时画面上下半截不一致或者有横向撕裂线。原因DMA2D 在刷帧缓冲的同时 LTDC 也在读同一块内存SDRAM 带宽不够。解决开双缓冲TouchGFX 的setFrameBufferStartAddresses传两个地址让 DMA2D 写后台缓冲、LTDC 读前台缓冲在 VSYNC 中断里交换。H743 的 SDRAM 如果跑在 100MHz 以上双缓冲基本能消掉撕裂。4.5 编译通过但下载后 HardFault现象Keil 里编译零错误下载后一运行就进 HardFault_Handler。原因MPU 配置和 SDRAM 地址冲突或者栈溢出。H743 的默认 MPU 配置可能把 0xC0000000 区域设成 Strongly OrderedDMA2D 访问会触发总线错误。解决在main.c的MPU_Config()里把 SDRAM 区域设成 Normal, Non-cacheable 或 Write-Back并且确保栈指针指向 DTCM 而不是 SDRAM。5. 二次开发改 UI、加逻辑、调性能的入手点拿到这套工程之后最常改的三个地方是Designer 里的界面布局、TouchGFX/App/下的 Model 和 Presenter、以及TouchGFX/target/里的 HAL 适配。改 UI 最简单在 TouchGFX Designer 里拖控件、配交互点 Generate Code 之后gui/和generated/会自动更新。但要注意Designer 生成的代码会覆盖你手动改过的gui/文件所以自定义逻辑要写在App/层通过 Model 和 Presenter 跟 View 通信。加业务逻辑的入口在Model.cpp的tick()或者自定义的action回调里。比如你要加一个串口收数据的界面刷新就在 Model 里起一个定时器或者消息队列收到数据后调presenter-notifyDataUpdated()Presenter 再调 View 的updateXXX()。这套 MVP 架构的好处是 UI 和逻辑解耦但坑在于 Presenter 和 View 的指针生命周期——Designer 重新生成代码后View 的类名可能变Presenter 里的view.setXXX()就要跟着改。调性能的话先看 TouchGFX 的Performance面板里面会显示每帧的渲染时间和 DMA2D 占用率。如果帧率掉到 30fps 以下优先查三件事SDRAM 的刷新周期是不是太长、DMA2D 有没有开中断模式、以及 LTDC 的层数是不是开多了。H743 的 LTDC 支持两层但每层都占 SDRAM 带宽如果 UI 层不需要透明把背景层关掉能省不少。还有一个血泪经验TouchGFX 的Application::create()里如果调了setUseDRAM(true)但 SDRAM 没初始化好整个 UI 会直接卡死而且不报错。从那以后我每次改完 CubeMX 的 FMC 配置都强制先跑一遍 SDRAM 的读写测试确认0xC0000000开始的内存能读能写再往下调 TouchGFX。希望帮到你。本文还有配套的精品资源点击获取