当前位置：首页 > news >正文

STM32CubeMX+正点原子LCD代码移植保姆级教程（STM32F103ZET6精英版实测）

news 2026/6/5 16:42:08

STM32CubeMX与正点原子LCD代码无缝整合实战指南

第一次接触STM32CubeMX和正点原子开发板时，最令人头疼的莫过于将两者代码完美融合。特别是当你想使用正点原子那套经过千锤百炼的LCD驱动库，却发现它与CubeMX生成的HAL库存在各种兼容性问题。本文将手把手带你完成从CubeMX工程创建到LCD驱动移植的全过程，针对STM32F103ZET6精英版进行实测验证，确保每个步骤都清晰可执行。

1. 工程创建与环境准备

在开始移植前，我们需要一个干净的CubeMX工程作为基础。打开STM32CubeMX软件，选择"Start New Project"，然后按以下步骤配置：

芯片选择：在搜索框中输入"STM32F103ZET6"，选中对应型号
RCC配置：
- High Speed Clock (HSC)选择"Crystal/Ceramic Resonator"
- Low Speed Clock (LSC)保持默认
SYS配置：
- Debug选择"Serial Wire"（如果你使用ST-Link下载器）
- Timebase Source选择任意定时器（推荐TIM1或TIM4）
FSMC配置（关键步骤）：
- 激活FSMC控制器
- 选择"LCD Interface"模式
- 配置参数如下表所示：

参数名称	配置值
Bank	Bank1_NORSRAM1
Memory Type	SRAM
Data Width	16 bits
Address Setup	2 HCLK周期
Data Setup	5 HCLK周期
Bus Turnaround	0 HCLK周期

时钟树配置：
- 将HCLK设置为72MHz（直接输入72后回车）
- 确保各总线时钟不超过最大允许值
工程生成设置：
- 选择MDK-ARM作为Toolchain/IDE
- 勾选"Generate peripheral initialization as a pair of .c/.h files"
- 设置合适的工程名称和存储路径

点击"Generate Code"按钮生成基础工程。此时你应该得到一个可以编译通过的空白工程，这是我们后续工作的基础。

2. 正点原子LCD代码移植

正点原子的LCD驱动通常包含三个核心文件：lcd.c、lcd.h和font.h。这些文件需要被整合到我们的CubeMX工程中。以下是详细步骤：

文件结构准备：
- 在工程目录下创建Hardware/LCD文件夹
- 从正点原子例程中复制上述三个文件到该目录
MDK工程配置：
- 打开生成的MDK工程
- 在Project面板右键点击"Target 1"，选择"Add Group"创建"HARDWARE"组
- 右键点击新建的组，选择"Add Existing Files to Group"，添加lcd.c
包含路径设置：
- 点击魔术棒图标进入"Options for Target"
- 在"C/C++"选项卡的"Include Paths"中添加../Hardware/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中添加#include "lcd.h"

提示：正点原子代码通常使用自定义数据类型，而CubeMX生成的代码使用标准C类型，这是后续需要修改的重点。

3. 代码兼容性修改与错误修复

首次编译往往会遇到大量错误，不要惊慌，这是正常现象。我们需要系统性地解决这些问题：

数据类型替换：
- 使用全局替换功能（Ctrl+H）将以下类型进行转换：
  - u8→uint8_t
  - u16→uint16_t
  - u32→uint32_t
  - vu16→__IO uint16_t
延时函数适配：
- 将所有delay_us(1)替换为HAL_Delay(1)
- 将所有delay_ms(x)替换为HAL_Delay(x)
GPIO操作重写：
- 查找所有类似PBout(0)=1的语句
- 替换为HAL库风格的HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_SET)
printf相关处理：
- 如果不需要调试输出，直接注释掉相关代码
- 如需保留，需重定向printf（这需要额外配置，本文暂不展开）
FSMC初始化代码处理：
- 在lcd.c中找到HAL_SRAM_MspInit函数
- 将其内容全部注释掉（CubeMX已自动生成这部分初始化代码）

// 注释掉的示例： // void HAL_SRAM_MspInit(SRAM_HandleTypeDef *hsram) // { // // 原有初始化代码... // }

完成这些修改后，重新编译工程，错误数量应该大幅减少。如果仍有少量错误，通常是因为遗漏了某些特定函数的替换，可以逐个解决。

4. LCD功能测试与优化

当工程能够成功编译后，就可以进行实际功能测试了。在main.c的while(1)循环前添加以下测试代码：

LCD_Init(); POINT_COLOR = RED; LCD_ShowString(30, 40, 210, 24, 24, "STM32F103ZET6"); LCD_ShowString(30, 70, 200, 16, 16, "CubeMX + ALIENTEK"); LCD_ShowString(30, 90, 200, 16, 16, "LCD TEST DEMO"); LCD_ShowString(30, 110, 200, 12, 12, "2023/08/15");

下载程序到开发板后，你应该能看到LCD屏幕上显示上述文字。如果出现显示异常，检查以下常见问题：

FSMC时序配置：不同LCD模块可能需要调整FSMC时序参数
背光控制：确保LCD背光引脚已正确供电
复位时序：有些LCD需要特定的复位时序，可在LCD_Init函数中添加适当延时

为了提高显示性能，可以考虑以下优化措施：

使用DMA传输：对于大量像素数据，配置DMA可以显著提高刷新速度
双缓冲机制：在显示一帧内容的同时准备下一帧，减少闪烁
局部刷新：只更新屏幕上变化的部分，而不是全屏刷新

5. 高级功能扩展

基础显示功能实现后，可以进一步扩展LCD的应用：

图形界面开发：
- 移植轻量级GUI库如LittlevGL或emWin
- 实现按钮、滑块等交互元素
触摸屏支持：
- 如果LCD带触摸功能，配置相应的触摸控制器驱动
- 实现基本的触摸事件处理
自定义字体显示：
- 修改font.h添加新的字体数据
- 实现多语言支持
性能监控：
- 在屏幕角落显示CPU使用率、内存占用等信息
- 实现调试信息的可视化输出

// 示例：显示CPU使用率 void ShowCPUUsage(void) { static uint32_t lastTick = 0; uint32_t currentTick = HAL_GetTick(); uint32_t idleTime = currentTick - lastTick; float usage = 100.0f - (idleTime / 10.0f); char buf[20]; sprintf(buf, "CPU:%.1f%%", usage); LCD_ShowString(10, 10, 100, 12, 12, buf); lastTick = currentTick; }