STM32F412-Discovery + TouchGFX项目仿真正常烧录后显示异常求助

我编写了一个包含按钮和两个图形的简单TouchGFX项目，在模拟器中运行完全正常，但通过Designer或IDE下载到STM32F412-Discovery开发板后显示异常（实际表现为画面错乱、元素偏移重叠）。换用两块开发板结果一致，但官方1.27固件包中的Hello World项目可正常运行，说明硬件无问题，推测是项目配置遗漏了关键步骤，以下是具体排查思路：

• 核对LCD驱动核心参数
  确认项目中LCD的分辨率、像素格式、接口模式是否与STM32F412-Discovery硬件匹配：该开发板搭载的是480×272分辨率的LCD，像素格式默认为RGB565。可在TouchGFX Designer的Config -> Display中核对参数，同时检查STM32CubeMX里LCD外设的配置是否与TouchGFX设置完全对应，若分辨率或格式不匹配，必然导致显示错乱。

• 检查Framebuffer配置合理性
  TouchGFX依赖Framebuffer缓存实现画面渲染，需确认Framebuffer的地址、大小是否正确，且未与其他外设（如DMA、SRAM）地址空间冲突。STM32F412的SRAM总容量为256KB，480×272的RGB565格式Framebuffer需占用480×272×2=261120字节，已接近SRAM上限，若项目额外开启了其他占用SRAM的功能，会导致Framebuffer空间不足。可在TouchGFX Designer的Config -> Framebuffer中调整参数，或在CubeMX里优化SRAM分配策略。

• 验证代码生成与CubeMX的兼容性
  手动修改CubeMX配置后，TouchGFX生成的代码可能与CubeMX初始化代码冲突。需核对LCD的GPIO引脚配置、时钟使能逻辑，确保TouchGFX初始化代码（如TouchGFXHAL.cpp）中的LCD启动逻辑，与CubeMX生成的MX_LCD_Init()完全一致。可对比官方Hello World项目的配置文件，排查是否遗漏引脚复用、时钟树关键节点启用等步骤。

• 排查DMA2D配置正确性
  STM32F412支持DMA2D硬件加速，TouchGFX默认启用该功能。若DMA2D的通道、优先级配置错误，会导致画面渲染异常。可在CubeMX中检查DMA2D的配置参数，或在TouchGFX的HAL文件中确认DMA2D初始化代码是否符合硬件要求。

• 清理缓存并重新生成项目
  项目生成的中间文件可能残留错误，建议先删除TouchGFX生成的generated文件夹及IDE编译缓存，再通过TouchGFX Designer重新生成代码，最后用IDE重新编译下载，避免旧代码残留影响运行。

• 核对时钟树参数
  LCD与TouchGFX的正常运行依赖正确的时钟频率，若LCD接口时钟（如SPI时钟、LCD控制器时钟）配置过高或过低，会引发显示异常。对比官方Hello World项目的时钟树设置，确保自身项目的HCLK、PCLK等核心时钟参数与官方配置一致。

内容的提问来源于stack exchange，提问作者andy_egor_johnson