用CubeMX+Keil5快速搞定1.8寸LCD屏驱动：从零配置到显示‘Hello World’
STM32CubeMX与Keil5实战：1.8寸LCD屏驱动开发全流程解析
第一次点亮LCD屏幕的瞬间，那种成就感是难以言喻的。作为嵌入式开发的经典入门项目，LCD驱动不仅能帮助新手快速理解硬件交互原理，更是掌握STM32图形化开发工具链的绝佳切入点。本文将使用STM32CubeMX和Keil5这对黄金组合，带你从零开始实现1.8寸SPI接口LCD屏的驱动开发，最终完成"Hello World"显示。不同于传统寄存器操作方式，我们全程采用HAL库和图形化配置工具，即使没有任何底层开发经验也能轻松上手。
1. 硬件准备与环境搭建
1.1 硬件选型与连接
市面上常见的1.8寸TFT LCD屏大多采用ST7735S驱动芯片，通过SPI接口通信。这种屏幕价格低廉（约15-30元）、分辨率通常为128x160，非常适合入门学习。以下是典型硬件配置方案：
- 主控芯片：STM32F103C8T6（蓝色药丸开发板）
- 显示屏：1.8寸TFT LCD（ST7735S驱动）
- 接口类型：4线SPI（模拟SPI也可实现）
硬件连接需要特别注意电平匹配。虽然STM32的IO口可承受5V输入，但建议统一使用3.3V供电以确保稳定性。典型接线方式如下：
| LCD引脚 | STM32连接 | 功能说明 |
|---|---|---|
| VCC | 3.3V | 电源正极 |
| GND | GND | 电源地 |
| SCL | PA5 | SPI时钟线 |
| SDA | PA7 | SPI数据线 |
| RES | PB0 | 复位信号 |
| DC | PB1 | 数据/命令选择 |
| CS | PB10 | 片选信号 |
| BL | PB11 | 背光控制 |
提示：若使用硬件SPI，SCLK应连接到PA5(SPI1_SCK)，MOSI连接到PA7(SPI1_MOSI)。本文为简化操作，采用模拟SPI实现。
1.2 开发环境安装
确保已安装以下软件工具：
- STM32CubeMX：6.5.0或更高版本
- Keil MDK-ARM：5.30以上（需安装STM32F1xx Device Family Pack）
- ST-Link驱动：用于程序下载调试
安装完成后，建议在CubeMX中检查更新，确保HAL库为最新版本。Keil的license管理也不容忽视，社区版有32KB代码限制，但对于本实验完全够用。
# 验证Keil安装成功的简单方法 armcc --version # 应输出类似: MDK-ARM Plus Version: 5.302. CubeMX工程配置
2.1 新建工程与时钟配置
启动CubeMX，选择"Access to MCU Selector"，在搜索框中输入STM32F103C8，选择对应型号后进入配置界面：
系统时钟配置：
- 在RCC选项卡中，将HSE设置为"Crystal/Ceramic Resonator"
- 时钟配置图中，将系统时钟源选择为HSE，输入8MHz
- 调节PLL倍频，使系统时钟达到72MHz（最大频率）
调试接口配置：
- 在SYS选项卡中，将Debug设为"Serial Wire"
- 这样可保留SWD下载接口，避免占用用户IO
// 生成的时钟配置代码示例（system_stm32f1xx.c） #define PLL_MUL 9 #define PLL_SRC RCC_PLLSRC_HSE_DIV1 #define PLL_NODE RCC_PLLMul_92.2 GPIO配置
根据接线表配置各GPIO引脚：
在Pinout视图中找到对应引脚，右键选择"GPIO_Output"
为每个引脚设置用户自定义标签：
- PB0 → LCD_RES
- PB1 → LCD_DC
- PB10 → LCD_CS
- PB11 → LCD_BL
- PA5 → LCD_SCL (模拟SPI时钟)
- PA7 → LCD_SDA (模拟SPI数据)
GPIO参数保持默认：
- Mode: Output Push Pull
- Pull-up/Pull-down: No pull-up and no pull-down
- Maximum output speed: Low
注意：CubeMX会自动生成宏定义，如
#define LCD_RES_Pin GPIO_PIN_0，后续编程可直接使用这些宏。
2.3 工程生成设置
进入Project Manager选项卡进行以下关键设置：
Project：
- 输入工程名称（如LCD_ST7735）
- 选择工程存储路径
- Toolchain/IDE选择MDK-ARM V5
Code Generator：
- 勾选"Generate peripheral initialization as a pair of .c/.h files"
- 选择"Copy only the necessary library files"
- 勾选"Generate peripheral initialization as a pair of .c/.h files"
点击GENERATE CODE按钮生成工程，完成后点击"Open Project"自动启动Keil。
3. Keil工程开发
3.1 工程结构概览
CubeMX生成的Keil工程包含以下关键部分：
Application/User：用户代码区
- main.c：主程序入口
- stm32f1xx_it.c：中断服务程序
- stm32f1xx_hal_msp.c：硬件抽象层初始化
Drivers：HAL库驱动
MDK-ARM：启动文件和链接脚本
我们需要在Application/User组中添加新的源文件：
- 右键User组 → Add New Item → User Code Template
- 创建lcd.c和lcd.h文件，用于存放LCD驱动代码
3.2 LCD驱动实现
在lcd.h中定义基本宏和函数原型：
#ifndef __LCD_H #define __LCD_H #include "main.h" // 颜色定义(RGB565) #define WHITE 0xFFFF #define BLACK 0x0000 #define BLUE 0x001F #define RED 0xF800 #define GREEN 0x07E0 // 函数声明 void LCD_Init(void); void LCD_WriteCmd(uint8_t cmd); void LCD_WriteData(uint8_t data); void LCD_SetWindow(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2); void LCD_Clear(uint16_t color); void LCD_DrawPixel(uint16_t x, uint16_t y, uint16_t color); void LCD_ShowChar(uint16_t x, uint16_t y, char ch, uint16_t color); #endif在lcd.c中实现核心驱动函数：
#include "lcd.h" #include "delay.h" // 需要实现简单的延时函数 // 模拟SPI写数据 static void SPI_Write(uint8_t data) { for(uint8_t i=0; i<8; i++) { HAL_GPIO_WritePin(LCD_SCL_GPIO_Port, LCD_SCL_Pin, GPIO_PIN_RESET); if(data & 0x80) HAL_GPIO_WritePin(LCD_SDA_GPIO_Port, LCD_SDA_Pin, GPIO_PIN_SET); else HAL_GPIO_WritePin(LCD_SDA_GPIO_Port, LCD_SDA_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(LCD_SCL_GPIO_Port, LCD_SCL_Pin, GPIO_PIN_SET); data <<= 1; } } // 写命令 void LCD_WriteCmd(uint8_t cmd) { HAL_GPIO_WritePin(LCD_DC_GPIO_Port, LCD_DC_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_RESET); SPI_Write(cmd); HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_SET); } // 写数据 void LCD_WriteData(uint8_t data) { HAL_GPIO_WritePin(LCD_DC_GPIO_Port, LCD_DC_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_RESET); SPI_Write(data); HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_SET); }3.3 LCD初始化序列
ST7735S驱动芯片需要特定的初始化序列才能正常工作。在LCD_Init()函数中添加以下代码：
void LCD_Init(void) { // 硬件复位 HAL_GPIO_WritePin(LCD_RES_GPIO_Port, LCD_RES_Pin, GPIO_PIN_RESET); HAL_Delay(100); HAL_GPIO_WritePin(LCD_RES_GPIO_Port, LCD_RES_Pin, GPIO_PIN_SET); HAL_Delay(120); // 软件复位 LCD_WriteCmd(0x01); HAL_Delay(120); // 睡眠模式退出 LCD_WriteCmd(0x11); HAL_Delay(120); // 内存数据访问控制 LCD_WriteCmd(0x36); LCD_WriteData(0xC0); // MY=1, MX=1, MV=0, RGB顺序 // 接口像素格式 LCD_WriteCmd(0x3A); LCD_WriteData(0x05); // 16位/pixel // 显示开 LCD_WriteCmd(0x29); // 背光开启 HAL_GPIO_WritePin(LCD_BL_GPIO_Port, LCD_BL_Pin, GPIO_PIN_SET); }4. 基础显示功能实现
4.1 清屏与像素绘制
在lcd.c中添加以下基础显示函数：
// 设置显示窗口 void LCD_SetWindow(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2) { LCD_WriteCmd(0x2A); // 列地址设置 LCD_WriteData(x1 >> 8); LCD_WriteData(x1 & 0xFF); LCD_WriteData(x2 >> 8); LCD_WriteData(x2 & 0xFF); LCD_WriteCmd(0x2B); // 行地址设置 LCD_WriteData(y1 >> 8); LCD_WriteData(y1 & 0xFF); LCD_WriteData(y2 >> 8); LCD_WriteData(y2 & 0xFF); LCD_WriteCmd(0x2C); // 内存写入 } // 清屏 void LCD_Clear(uint16_t color) { uint32_t i; LCD_SetWindow(0, 0, 127, 159); for(i=0; i<128*160; i++) { LCD_WriteData(color >> 8); LCD_WriteData(color & 0xFF); } } // 画点 void LCD_DrawPixel(uint16_t x, uint16_t y, uint16_t color) { LCD_SetWindow(x, y, x+1, y+1); LCD_WriteData(color >> 8); LCD_WriteData(color & 0xFF); }4.2 字符显示实现
显示字符需要先定义字模数据。我们使用8x16点阵ASCII字符集：
// 在lcd.c中添加字模数据 static const uint8_t font8x16[] = { // 空格(0x20) 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, // '!' (0x21) 0x00,0x00,0x18,0x18,0x18,0x18,0x18,0x18, 0x18,0x18,0x00,0x00,0x18,0x18,0x00,0x00, // 更多字符数据... }; // 显示单个字符 void LCD_ShowChar(uint16_t x, uint16_t y, char ch, uint16_t color) { uint8_t i,j; uint8_t mask; const uint8_t *p = &font8x16[(ch-32)*16]; for(i=0; i<16; i++) { mask = 0x80; for(j=0; j<8; j++) { if(*p & mask) LCD_DrawPixel(x+j, y+i, color); mask >>= 1; } p++; } } // 显示字符串 void LCD_ShowString(uint16_t x, uint16_t y, const char *str, uint16_t color) { while(*str) { LCD_ShowChar(x, y, *str++, color); x += 8; if(x > 120) { x = 0; y += 16; } } }5. 主程序实现与调试
5.1 main函数实现
在main.c中添加以下代码：
#include "lcd.h" int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); // LCD初始化 LCD_Init(); LCD_Clear(BLUE); // 显示Hello World LCD_ShowString(40, 72, "Hello World!", WHITE); while(1) { // 可添加其他功能 } }5.2 常见问题排查
屏幕无任何显示：
- 检查背光控制引脚是否拉高
- 测量各引脚电压，确认电源正常
- 用逻辑分析仪或示波器检查SPI信号
显示花屏或错乱：
- 确认初始化序列正确
- 检查GPIO配置是否正确
- 降低SPI时钟频率测试
Keil编译错误：
- 确保包含路径设置正确
- 检查HAL库版本兼容性
- 清理工程后重新编译
调试技巧：在初始化过程中添加延时，逐步排查各阶段问题。可使用HAL_GPIO_TogglePin()函数配合示波器验证GPIO操作。
5.3 效果优化建议
- 双缓冲技术：减少屏幕闪烁
- DMA传输：提高SPI传输效率
- 硬件SPI：替换模拟SPI提升速度
- 图形库集成：移植u8g2或LVGL等图形库
// 使用硬件SPI的示例修改 void SPI_Write(uint8_t data) { HAL_SPI_Transmit(&hspi1, &data, 1, HAL_MAX_DELAY); }通过本项目的完整实践，你不仅掌握了LCD驱动的基本原理，更重要的是建立了使用STM32CubeMX进行图形化配置的信心。这种开发模式可以扩展到其他外设开发中，大幅提高开发效率。当看到屏幕上首次显示出清晰的"Hello World"时，相信你已经为后续更复杂的嵌入式图形开发打下了坚实基础。