news 2026/6/14 3:56:04

STM32CubeIDE实战：手把手教你将正点原子LCD驱动移植到F103精英板（附完整代码）

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
STM32CubeIDE实战：手把手教你将正点原子LCD驱动移植到F103精英板（附完整代码）

STM32CubeIDE实战：手把手教你将正点原子LCD驱动移植到F103精英板（附完整代码）

对于刚接触STM32 HAL库和CubeIDE的开发者来说，LCD屏幕的驱动移植往往是一个令人头疼的问题。特别是当你手头有一块正点原子的精英开发板，想要快速点亮LCD屏幕时，可能会遇到各种意想不到的挑战。本文将带你一步步完成从标准库到HAL库的驱动移植，避开那些常见的"坑"，让你能够快速实现LCD显示功能。

1. 环境准备与硬件连接

在开始移植工作之前，我们需要确保开发环境已经正确搭建。以下是需要准备的软硬件资源：

  • 硬件设备：

    • 正点原子F103精英开发板
    • 配套的LCD显示屏（如2.8寸TFT LCD）
    • ST-Link调试器

  • 软件工具：

    • STM32CubeIDE（建议使用最新版本）
    • 正点原子官方提供的标准库例程

注意：精英板和Mini板的LCD驱动有细微差别，请确认你使用的是精英板对应的驱动代码。

硬件连接方面，确保LCD模块已正确插入开发板的LCD接口。精英板通常使用FSMC接口连接LCD，具体引脚对应关系可以在开发板原理图中找到。

2. CubeMX基础配置

STM32CubeMX的图形化配置大大简化了外设初始化过程。以下是关键配置步骤：

2.1 创建新工程

  1. 打开STM32CubeIDE，选择"File"→"New"→"STM32 Project"
  2. 在MCU选择器中输入"STM32F103ZE"（精英板主控型号）
  3. 设置项目名称和保存路径

2.2 时钟配置

在"Clock Configuration"标签页中，按以下步骤配置时钟树：

  1. 选择外部晶振（HSE）作为时钟源
  2. 设置系统时钟为72MHz
  3. 确保FSMC时钟已使能
// 生成的时钟配置代码示例 void SystemClock_Config(void) { RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_ClkInitTypeDef RCC_ClkInitStruct = {0}; // HSE配置 RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState = RCC_HSE_ON; RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON; RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE; RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9; HAL_RCC_OscConfig(&RCC_OscInitStruct); // 时钟树配置 RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2; RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK; RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2; RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1; HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2); }

2.3 FSMC接口配置

FSMC（Flexible Static Memory Controller）是STM32与LCD通信的关键接口。在CubeMX中按以下步骤配置：

  1. 左侧导航栏选择"Connectivity"→"FSMC"
  2. 启用"FSMC"并选择"LCD Interface"
  3. 配置参数如下表所示：
参数项配置值
BankBank1_NORSRAM4
Memory typeSRAM
Data width16-bit
Address setup time2 HCLK周期
Data setup time5 HCLK周期
Bus turnaround time0 HCLK周期

特别注意：LCD Register Select引脚在精英板上通常使用FSMC_A10（而非某些教程中的A6），这需要根据实际原理图确认。

3. 驱动文件移植与修改

正点原子提供的标准库驱动需要经过适当修改才能用于HAL库环境。以下是关键修改步骤：

3.1 文件结构准备

  1. 在项目"Core"目录下创建"LCD"文件夹
  2. 添加以下文件到项目中：
    • lcd.c
    • lcd.h
    • font.h

3.2 关键代码修改

在lcd.c文件中，需要进行以下修改：

  1. 头文件调整：
// 注释掉标准库头文件 // #include "sys.h" // #include "delay.h" // 添加HAL库头文件 #include "main.h"
  1. 数据类型替换：
// 将u8/u16/u32替换为标准类型 // 原代码：u8 -> uint8_t // u16 -> uint16_t // u32 -> uint32_t
  1. 延时函数替换：
// 将delay_ms替换为HAL_Delay // 原代码：delay_ms(50) -> HAL_Delay(50)
  1. FSMC初始化代码处理：
// 注释掉原有的FSMC初始化代码 // 因为CubeMX已经生成这部分配置 // void HAL_SRAM_MspInit(SRAM_HandleTypeDef *hsram) // { // ... // }
  1. LCD初始化简化：
void LCD_Init(void) { // 保留LCD控制器初始化部分 // 但移除GPIO和FSMC的硬件初始化代码 // 因为这些已由CubeMX配置 // 示例保留部分： LCD_WR_REG(0xCF); LCD_WR_DATA(0x00); LCD_WR_DATA(0xC1); LCD_WR_DATA(0X30); // ...其他LCD控制器初始化命令 }

3.3 背光控制调整

精英板的背光控制通常通过PB0引脚实现，需要在CubeMX中配置该引脚为GPIO输出：

// 在main.c的初始化部分添加背光控制 HAL_GPIO_WritePin(LCD_BL_GPIO_Port, LCD_BL_Pin, GPIO_PIN_SET);

4. 主程序集成与测试

完成驱动移植后，需要在主程序中集成LCD功能并进行测试。

4.1 头文件包含

在main.c中添加必要的头文件：

/* USER CODE BEGIN Includes */ #include "lcd.h" #include <stdio.h> /* USER CODE END Includes */

4.2 初始化调用

在main()函数中找到"/* USER CODE BEGIN 2 */"部分，添加LCD初始化代码：

/* USER CODE BEGIN 2 */ LCD_Init(); LCD_DisplayOn(); LCD_Clear(RED); HAL_GPIO_WritePin(LCD_BL_GPIO_Port, LCD_BL_Pin, GPIO_PIN_SET); /* USER CODE END 2 */

4.3 测试代码

在main循环中添加简单的显示测试：

/* USER CODE BEGIN WHILE */ while (1) { LCD_ShowString(30, 40, 210, 24, 24, "Hello World"); HAL_Delay(1000); LCD_Clear(BLUE); HAL_Delay(1000); /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ } /* USER CODE END 3 */

5. 常见问题与解决方案

在实际移植过程中，你可能会遇到以下问题：

5.1 屏幕无显示

  • 检查步骤：

    1. 确认背光是否点亮
    2. 检查FSMC引脚配置是否正确
    3. 验证LCD初始化序列是否完整执行

  • 解决方案：

// 可以添加调试输出，检查初始化流程 printf("LCD Init Start...\n"); LCD_Init(); printf("LCD Init Done.\n");

5.2 显示内容错位

  • 可能原因：

    • 扫描方向设置不正确
    • 显存地址映射错误

  • 调整方法：

// 尝试不同的扫描方向 LCD_Scan_Dir(DFT_SCAN_DIR); // 默认方向 // 或 LCD_Scan_Dir(L2R_U2D); // 从左到右，从上到下

5.3 性能优化

对于需要频繁刷新的应用，可以考虑以下优化：

  1. 使用DMA加速数据传输：
// 示例DMA配置（需在CubeMX中启用） hdma_memtomem_dma2.Init.Direction = DMA_MEMORY_TO_MEMORY; hdma_memtomem_dma2.Init.PeriphInc = DMA_PINC_ENABLE; hdma_memtomem_dma2.Init.MemInc = DMA_MINC_ENABLE;
  1. 减少不必要的全屏刷新：
// 只更新需要改变的区域 LCD_Set_Window(x, y, width, height); LCD_Color_Fill(x, y, x+width-1, y+height-1, color_buf);
  1. 使用硬件加速功能：
// 某些LCD控制器支持硬件加速 LCD_WriteReg(0x36, 0x48); // 设置内存访问控制

在实际项目中，LCD驱动移植只是第一步。后续你可能还需要添加触摸屏支持、GUI界面等更多功能。通过这次移植实践，你应该已经掌握了HAL库下LCD驱动的基本原理和调试方法。

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/6/14 3:55:02

[译]我们为了继续使用 Golang 而对自己说的谎言

本文是对 Lies we tell ourselves to keep using Golang的整理与翻译。观点仅代表原作者 内容结构概览 开篇&#xff1a;Go 的吸引力与长期成本第一层自我安慰&#xff1a;质疑批评者&#xff0c;而不是讨论问题第二层自我安慰&#xff1a;大厂在用&#xff0c;所以我们也能用…

作者头像 李华
网站建设 2026/6/14 3:51:02

Flowable UI 6.6.0 保姆级安装教程：从Tomcat部署到第一个流程启动

Flowable UI 6.6.0 零基础实战指南&#xff1a;从环境搭建到流程自动化在数字化转型浪潮中&#xff0c;业务流程自动化已成为企业提升效率的关键。作为轻量级开源BPM引擎&#xff0c;Flowable以其简洁的架构和丰富的功能组件&#xff0c;成为技术团队快速实现工作流管理的首选方…

作者头像 李华
网站建设 2026/6/14 3:49:59

7-Zip ZS版(开源免费解压缩软件)

链接&#xff1a;https://pan.quark.cn/s/17e9dc47d1757-Zip ZS版是一个基于著名开源压缩软件 7-Zip 的修改版&#xff0c;它由第三方开发者维护&#xff0c;并引入了额外的压缩算法和其他改进。软件本身是一款开源、免费的文件压缩和解压缩工具&#xff0c;而 ZS版则在此基础上…

作者头像 李华
网站建设 2026/6/14 3:45:00

告别官方U盘依赖？聊聊KUKA机器人系统备份的‘平替’方案与安全风险

告别官方U盘依赖&#xff1f;KUKA机器人系统备份的替代方案与安全实践在工业自动化领域&#xff0c;KUKA机器人系统的稳定运行直接关系到生产线效率。当系统出现故障时&#xff0c;快速恢复的关键在于是否拥有可靠的备份。传统做法依赖官方KUKA.RecoveryUSB&#xff0c;但动辄数…

作者头像 李华