1. 硬件准备与环境搭建
这次我们要在STM32F407探索者开发板上移植正点原子的LCD驱动，使用的是4.3寸TFT LCD屏幕。先说说硬件连接，这个环节经常被忽视但其实很重要。开发板的LCD接口是通过FSMC总线连接的，具体引脚对应关系需要查看开发板原理图。我用的探索者V3.4版本，LCD的RS信号线接在FSMC_A6上，这个细节后面配置FSMC时会用到。
开发环境方面，我们需要准备三样东西：Keil MDK、STM32CubeMX和正点原子的LCD例程包。建议Keil用5.30以上版本，CubeMX用6.0以上，兼容性会更好。第一次配置时我就踩过坑，用的CubeMX版本太老，生成的代码和HAL库不匹配，导致一堆编译错误。
安装完软件后，先在CubeMX里新建工程，选择STM32F407ZGTx芯片。时钟配置建议直接使用默认的168MHz主频，这是F407的典型工作频率。调试接口我习惯用SWD，占用的引脚少而且稳定。这些基础配置完成后，记得先保存工程，我遇到过CubeMX崩溃的情况，没保存的话又得重头来过。
2. FSMC接口配置详解
FSMC是STM32用来驱动外部存储器的接口，正好可以用来控制LCD。在CubeMX里配置FSMC有几个关键点需要注意，这也是我当初移植时花时间最多的地方。
首先在Pinout界面找到FSMC，选择Bank1下的NOR/PSRAM1。内存类型要选LCD Interface，数据宽度选16位，这个要和LCD控制器匹配。地址映射模式记得选Mode A，这个模式最适合LCD控制。
时序参数配置是个技术活，正点原子例程里用的是这些值：
- Address Setup Time: 2个HCLK周期
- Data Setup Time: 3个HCLK周期
- Bus Turnaround Time: 1个HCLK周期
这些参数直接影响LCD的读写稳定性。我第一次移植时没注意这些，结果屏幕显示总是有雪花点。后来发现是Data Setup Time设得太短，LCD控制器来不及响应。
还有一个容易出错的地方是Chip Select和Register Select的选择。探索者开发板上LCD的片选接在NE4上，所以Bank要选NOR/PSRAM4。Register Select信号对应FSMC的A6地址线，这个在原理图上能找到。配置错了的话，LCD根本不会有任何反应。
3. LCD驱动文件移植
配置好CubeMX生成代码后，接下来就是移植正点原子的驱动文件了。官方例程里有四个关键文件：lcd.c、lcd.h、lcd_ex.c和lcdfont.c。我建议新建一个BSP文件夹专门放这些驱动文件，保持工程结构清晰。
移植过程中会遇到几个典型的编译错误，这里分享下解决方案：
第一个问题是头文件包含冲突。原例程用的是标准库，我们需要改成HAL库的方式。在lcd.c里要把原来的stm32f4xx.h换成main.h，同时添加fsmc.h。我当初漏了fsmc.h，结果一堆未定义的错误。
第二个大坑是延时函数。正点原子例程里用的是自己实现的delay_ms和delay_us，但在HAL库里我们要用HAL_Delay。这里有个技巧：在Keil里用Ctrl+F全局替换，把delay_ms替换为HAL_Delay，把delay_us替换为HAL_Delay(1)。注意delay_us是微秒级延时，替换成HAL_Delay(1)其实精度不够，但对LCD初始化影响不大。
最麻烦的是FSMC初始化代码的修改。原例程的LCD_Init函数里有大段的GPIO和FSMC初始化代码，这些CubeMX已经帮我们生成了，所以要全部删掉，只保留FSMC_NORSRAM_TimingTypeDef的定义。同样，HAL_SRAM_MspInit函数也要整个删除，不然会导致重复初始化。
4. 背光控制与引脚适配
LCD的背光控制是个简单但容易忽略的环节。探索者开发板上背光控制接在PB15，我们需要在CubeMX里配置这个引脚为GPIO输出。在代码里有两种方式控制背光：
第一种是直接操作寄存器：
HAL_GPIO_WritePin(LCD_BL_GPIO_Port, LCD_BL_Pin, GPIO_PIN_SET);第二种是修改lcd.h里的宏定义：
#define LCD_BL(n) (n?HAL_GPIO_WritePin(LCD_BL_GPIO_Port, LCD_BL_Pin, GPIO_PIN_SET):\ HAL_GPIO_WritePin(LCD_BL_GPIO_Port, LCD_BL_Pin, GPIO_PIN_RESET))我推荐第一种方式，因为更直观也不容易出错。曾经有一次我改了宏定义但忘记包含对应的头文件，调试了半天才发现问题。
引脚适配还要注意数据线的定义。在lcd.h里有这样一段代码：
#define LCD_BASE ((uint32_t)(0x6C000000 | 0x0000007E)) #define LCD ((LCD_TypeDef *) LCD_BASE)这个0x6C000000是FSMC Bank1的起始地址，0x7E是地址偏移量，对应FSMC_A6。如果你的开发板RS信号接的是其他地址线，比如A18，这里就要改成0x0003FFFE。
5. 显示测试与常见问题
移植完成后，就该测试LCD是否正常工作了。最简单的测试代码是这样的：
lcd_init(); lcd_clear(WHITE); lcd_show_string(10, 40, 240, 32, 32, "STM32", RED);如果屏幕能正常显示文字，说明移植基本成功了。但实际过程中可能会遇到各种问题，我总结了几种常见情况：
第一种是白屏，背光亮但没显示。这种情况多半是FSMC配置有问题，检查时序参数和地址线设置是否正确。可以用示波器看下FSMC的信号波形，确认是否有数据输出。
第二种是显示错位或颜色不正常。这通常是数据线接反或LCD初始化序列有问题。检查lcd.c里的初始化代码，特别是ILI9341的初始化命令序列。
第三种是显示有雪花点或闪烁。这可能是时序参数不合适，尝试增加Data Setup Time。也可能是电源不稳定，检查开发板的3.3V电源是否干净。
我遇到过最诡异的问题是屏幕偶尔会花屏，最后发现是FSMC时钟没配置好。在CubeMX里需要确保FSMC时钟和系统时钟的比例正确，F407的FSMC时钟最高是84MHz。
6. 性能优化技巧
LCD驱动移植成功后，还可以做一些优化提升显示性能。这里分享几个实用的技巧：
第一个是使用DMA加速填充。当需要清屏或绘制大面积色块时，可以用DMA来传输数据，解放CPU资源。HAL库提供了HAL_SRAM_Write_DMA函数，配合FSMC可以大幅提升填充速度。
第二个优化点是减少局部刷新。比如更新数字时，可以只刷新变化的区域而不是整个屏幕。正点原子的例程里lcd_show_num函数就有这个问题，每次都会重绘整个数字区域。
字库处理也有优化空间。默认例程用的是全字库，占用了大量Flash空间。如果只需要显示英文和数字，可以裁剪字库，只保留需要的字符。比如12x6的ASCII字库，完整版占1KB，裁剪后可能只需要几百字节。
还有一个容易忽视的优化是帧缓冲。对于复杂的GUI，可以现在内存里绘制完成后再一次性更新到LCD。这样能避免频繁操作FSMC导致的闪烁问题。不过F407的内存有限，这个方案适合小尺寸屏幕。
7. 多屏幕适配经验
在实际项目中，我们可能需要适配不同型号的LCD屏幕。正点原子的驱动支持多种控制器，比如ILI9341、NT35510等，但需要做一些调整。
首先是初始化序列不同。每种LCD控制器都有自己的初始化命令，这些定义在lcd.c的LCD_Init函数里。移植新屏幕时，需要找到对应的初始化代码。我建议保留所有型号的初始化序列，用宏定义来切换。
其次是颜色格式。有些屏幕是RGB565，有些是RGB888，需要调整颜色转换函数。在lcd.c里有这样的代码：
#define RGB565(r,g,b) (((r>>3)<<11)|((g>>2)<<5)|(b>>3))如果换用RGB888的屏幕，这个宏定义就需要修改。
屏幕分辨率也不同。4.3寸屏通常是480x272，而2.8寸屏可能是320x240。在lcd.h里要修改这些定义：
#define LCD_W 480 #define LCD_H 272触摸屏的适配更复杂些，需要调整触摸控制器的驱动。不过这次我们聚焦在LCD显示上，触摸部分以后有机会再讨论。
8. 工程维护建议
最后分享一些工程维护的经验，这些是我踩过不少坑后总结出来的。
首先是CubeMX重新生成代码的问题。在main.c里我们添加了自己的代码，比如LCD初始化调用。这些代码要放在USER CODE BEGIN和USER CODE END注释之间，这样重新生成时不会被覆盖。我有次忘记加注释，结果辛苦写的代码全没了。
其次是版本控制。建议用Git管理工程，每次修改CubeMX配置前先提交一次。这样如果新配置导致问题，可以轻松回退。我在团队协作时就遇到过CubeMX配置冲突的情况，有版本控制就好解决多了。
调试建议用SWD接口配合STM32CubeProgrammer。它不仅支持烧录，还能实时查看变量和寄存器状态。当LCD显示不正常时，可以检查FSMC相关寄存器的值是否正确。
文档记录也很重要。我在工程里都会放一个README.txt，记录特殊的配置项和注意事项。比如某个版本需要特定的HAL库版本，或者某个屏幕需要特殊的初始化参数。这对后续维护和团队协作很有帮助。
