1. 环境准备与工程创建第一次接触STM32CubeMX和LCD移植的朋友可能会觉得无从下手其实整个过程就像搭积木一样简单。我用的开发板是STM32F103ZET6精英版搭配3.5寸TFTLCD屏幕这个组合在市场上非常常见兼容性也很好。打开STM32CubeMX后第一步要配置系统时钟。在RCC配置界面将HSE选择为Crystal/Ceramic Resonator这是最常用的外部时钟源配置。接着来到SYS选项卡这里要根据你使用的下载器类型选择调试接口比如我用的是ST-Link就选择Serial Wire模式。FSMC配置是整个工程的关键。在Connectivity选项卡下找到FSMC勾选NOR Flash/PSRAM 1然后在Configuration界面选择Bank1 - NOR/PSRAM 1Memory type选择LCD InterfaceData size选择16位。这些参数一定要设置正确否则后续LCD通信会出问题。时钟树配置有个小技巧直接点击HCLK输入框输入72后回车系统会自动帮你计算各分频系数。这是STM32F103系列的最高工作频率性能足够应对大多数应用场景。最后记得在Project Manager选项卡中设置工程名称和保存路径把Toolchain/IDE改为MDK-ARM V5勾选Generate peripheral initialization as a pair of .c/.h files per peripheral选项。这个选项会让代码结构更清晰方便后续维护。2. 移植正点原子LCD驱动代码工程创建完成后接下来要处理正点原子的LCD驱动代码。我建议在项目目录下新建一个Hardware文件夹专门存放各种外设驱动。然后在Hardware下再建一个LCD子文件夹把正点原子例程中的lcd.c、lcd.h和font.h三个文件复制过来。打开MDK-ARM工程在Project面板右键点击Target选择Add Group新建一个HARDWARE分组。然后右键这个分组选择Add Existing Files to Group把刚才复制的lcd.c添加进来。接着进入Options for Target的C/C选项卡在Include Paths里添加LCD文件夹的路径。头文件修改是移植过程中最容易出错的地方。需要把lcd.c中的头文件引用改为#include lcd.h #include stdlib.h #include main.h #include font.h同时修改lcd.h保留#include stdlib.h #include main.h最后别忘了在main.c中添加对lcd.h的引用。这些修改看似简单但漏掉任何一个都可能导致编译失败。3. 数据类型与函数适配第一次编译时你会看到满屏的错误提示别慌这都是正常现象。正点原子的代码使用了大量简写数据类型需要替换成HAL库的标准类型使用全局替换功能CtrlH将u8替换为uint8_t将u16替换为uint16_t将u32替换为uint32_t将vu16替换为__IO uint16_t替换完成后再次编译错误数量会大幅减少。接下来处理延时函数的问题正点原子使用的是自定义的delay_us和delay_ms我们需要改为HAL库的HAL_Delay。注意这里有个小技巧delay_us(1)可以直接替换为HAL_Delay(1)虽然精度有所下降但在LCD驱动中完全够用。遇到printf相关的错误可以直接注释掉这是调试输出用的不影响核心功能。GPIO操作也需要修改比如PBout(0)1要改为HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_SET);4. FSMC底层驱动处理在lcd.c文件中大约440行左右会有一个HAL_SRAM_MspInit函数这个函数需要特别注意。因为STM32CubeMX已经帮我们生成了FSMC的初始化代码所以这部分内容要全部注释掉否则会导致硬件冲突。具体要注释的内容包括所有GPIO时钟使能代码各个GPIO引脚的初始化配置整个函数体内容保留函数声明即可因为HAL库需要这个函数存在但我们不需要它做任何实际操作。这个步骤经常被新手忽略导致LCD无法正常工作。5. 主函数编写与测试所有修改完成后就可以在主函数中调用LCD的显示功能了。建议先写一个简单的测试程序LCD_Init(); POINT_COLOR RED; LCD_ShowString(30, 40, 210, 24, 24, Hello STM32); LCD_ShowString(30, 70, 200, 16, 16, LCD Test Demo); LCD_ShowString(30, 90, 200, 16, 16, By Your Name);如果一切正常屏幕上应该会显示出这些文字。如果出现花屏或者无显示建议按以下步骤排查检查FSMC配置是否正确特别是数据宽度和时序参数确认LCD背光是否点亮用万用表测量FSMC相关引脚的电平是否正常检查LCD初始化序列是否正确执行6. 常见问题解决方案在实际移植过程中我遇到过几个典型问题这里分享下解决方法第一个问题是屏幕显示错位。这是因为正点原子的LCD驱动默认是针对特定分辨率编写的如果你的屏幕分辨率不同需要修改lcd.h中的LCD_WIDTH和LCD_HEIGHT定义。同时也要调整显示坐标的计算方式。第二个问题是显示颜色异常。这种情况多半是数据线接反或者颜色格式不匹配导致的。STM32的FSMC接口是16位RGB565格式而有些LCD模块可能使用其他格式需要在初始化时配置正确的像素格式。第三个问题是触摸屏不准。如果项目中还用到了触摸功能记得校准触摸屏参数。正点原子的驱动中提供了触摸校准函数可以在初始化时调用。最后一个建议是如果项目中有多个外设需要使用FSMC比如同时连接LCD和SRAM一定要合理分配存储区域。STM32的FSMC支持多个存储块每个块可以独立配置。