STM32F103RCT6开发实战：SPI液晶屏驱动与调试技巧

1. STM32F103RCT6开发环境搭建与基础配置

作为一名嵌入式开发工程师，我经常使用STM32系列单片机进行项目开发。今天我将分享一个完整的STM32F103RCT6开发流程，从工程创建到外设配置，再到1.8寸SPI液晶屏的驱动实现。这个方案已经在多个实际项目中验证过稳定性，特别适合初学者入门和中级开发者参考。

1.1 硬件准备与芯片选型

STM32F103RCT6属于STM32F1系列的中容量产品，具有256KB Flash和48KB RAM，主频可达72MHz。选择这款芯片主要基于以下几点考虑：

• 性价比高：相比同性能的ARM芯片价格更具优势
• 生态完善：有丰富的开发资料和社区支持
• 外设丰富：具备多个USART、SPI、I2C接口，满足大多数项目需求

开发板需要准备：

1. STM32F103RCT6核心板或最小系统板
2. 1.8寸SPI接口TFT液晶屏（分辨率通常为128x160）
3. ST-Link或DAP-Link调试器
4. USB转串口模块（用于串口通信调试）

1.2 CubeMX工程创建详解

使用STM32CubeMX创建工程是STM32开发的标准化流程，它能极大简化外设配置过程。以下是具体步骤：

1. 打开CubeMX，点击"New Project"，在芯片选择框中输入"STM32F103RCT6"并选择对应型号

2. 在Pinout视图中配置关键系统外设：

   • RCC：High Speed Clock (HSE)选择Crystal/Ceramic Resonator
   • SYS：Debug选择Serial Wire（否则可能导致芯片锁死）

3. 时钟树配置：

   • 在Clock Configuration标签页中，将HCLK输入72并回车
   • 系统会自动配置PLL倍频参数，确保最终系统时钟为72MHz
   • 这个步骤很关键，时钟配置错误会导致各种外设工作异常

4. 工程生成设置：

   • Project -> Generate Code
   • 设置工程名称和存储路径
   • Toolchain/IDE选择MDK-ARM（即Keil）
   • 在Code Generator中勾选"Generate peripheral initialization as a pair of .c/.h files"

注意：建议为每个外设生成独立的.c/.h文件，这样代码结构更清晰，后续维护更方便。

1.3 Keil工程配置与烧录设置

生成工程后，用Keil打开并进行以下关键配置：

1. 魔术棒（Options for Target）配置：

   • Target选项卡：勾选"Use MicroLIB"（这是printf重定向的必要条件）
   • Output选项卡：勾选"Create HEX File"（方便后续生产烧录）
   • C/C++选项卡：在Define中添加"USE_HAL_DRIVER,STM32F103xE"

2. 调试器配置：

   • Debug选项卡：选择对应的调试器（ST-Link或DAP-Link）
   • Settings子菜单：
     • 在Flash Download中勾选"Reset and Run"
     • 确认Programming Algorithm包含STM32F10x High-density Flash

3. 编译与下载：

   • 点击Rebuild All编译整个工程
   • 确保没有错误后点击Load下载到芯片
   • 如果使用串口下载，需要通过FlyMCU等工具将HEX文件烧录进去

2. 串口通信配置与printf重定向

2.1 USART外设配置

在CubeMX中配置USART1（或其他可用串口）：

1. 选择Asynchronous模式
2. 波特率设置为115200（常用值）
3. Word Length：8bits
4. Parity：None
5. Stop Bits：1
6. 其他参数保持默认

生成代码后，HAL库会自动完成USART的初始化。我们需要验证串口是否正常工作：

c复制HAL_UART_Transmit(&huart1, (uint8_t*)"Hello\r\n", 7, 1000);

2.2 printf函数重定向实现

为了方便调试，我们需要重定向printf到串口输出。在main.c文件中添加以下代码：

c复制#include <stdio.h>

extern UART_HandleTypeDef huart1;

int __io_putchar(int ch) {
    HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, HAL_MAX_DELAY);
    return ch;
}

int _write(int file, char *ptr, int len) {
    HAL_UART_Transmit(&huart1, (uint8_t *)ptr, len, HAL_MAX_DELAY);
    return len;
}

关键注意事项：

1. 必须在Keil的Target选项中勾选"Use MicroLIB"
2. 这段代码要放在/* USER CODE BEGIN 0 /和/ USER CODE END 0 */之间，否则重新生成代码时会被清除
3. 避免在中断服务程序中调用printf，可能导致阻塞

2.3 串口调试技巧

在实际开发中，我总结了几个串口调试的经验：

1. 使用\r\n而不仅仅是\n，确保在不同终端都能正确换行
2. 对于频繁输出的调试信息，可以添加时间戳：

   c复制printf("[%lu] Debug message\r\n", HAL_GetTick());
   

3. 使用十六进制格式输出变量值更直观：

   c复制printf("Value: 0x%02X\r\n", variable);
   

4. 在串口助手中设置正确的波特率、数据位和停止位，否则会出现乱码

3. 软件SPI驱动1.8寸TFT液晶屏

3.1 硬件连接与GPIO配置

根据液晶屏的接口定义，我们需要连接以下信号线：

• SCLK：时钟信号
• MOSI：数据输出
• RESET：复位信号
• DC：数据/命令选择
• CS：片选信号
• BLK：背光控制

在CubeMX中将这6个引脚配置为GPIO Output：

1. PB4 - LCD_SCLK
2. PB5 - LCD_MOSI
3. PB6 - LCD_RES
4. PB7 - LCD_DC
5. PB8 - LCD_CS
6. PB9 - LCD_BLK

将GPIO速度设置为High，以提高SPI通信速率。生成代码后，HAL库会自动初始化这些GPIO。

3.2 软件SPI实现原理

软件SPI通过GPIO模拟SPI时序，相比硬件SPI更灵活但速度较慢。以下是关键函数实现：

c复制void LCD_Writ_Bus(u8 dat) {
    u8 i;
    LCD_CS_Clr(); // 片选使能
    for(i=0; i<8; i++) {
        LCD_SCLK_Clr(); // 时钟拉低
        if(dat & 0x80) LCD_MOSI_Set();
        else LCD_MOSI_Clr();
        LCD_SCLK_Set(); // 时钟上升沿，数据采样
        dat <<= 1;
    }
    LCD_CS_Set(); // 片选禁用
}

这个函数实现了SPI的8位数据传输，注意：

1. 数据在时钟上升沿被采样
2. 先传输高位(MSB first)
3. 片选信号在传输期间保持有效

3.3 LCD初始化序列

不同型号的LCD需要不同的初始化序列。以下是典型的ST7735初始化代码：

c复制void LCD_Init(void) {
    LCD_RES_Clr(); // 复位LCD
    HAL_Delay(100);
    LCD_RES_Set();
    HAL_Delay(100);
    
    LCD_BLK_Set(); // 开启背光
    
    // 发送初始化命令序列
    LCD_WR_REG(0x11); // Sleep out
    HAL_Delay(120);
    
    LCD_WR_REG(0xB1); // FRMCTR1
    LCD_WR_DATA8(0x05); 
    LCD_WR_DATA8(0x3C);
    LCD_WR_DATA8(0x3C);
    
    // 更多初始化命令...
    
    LCD_WR_REG(0x29); // Display on
}

3.4 基本图形绘制函数

实现基本的图形绘制功能是GUI开发的基础。以下是几个关键函数：

1. 画点函数：

c复制void LCD_DrawPoint(u16 x,u16 y,u16 color) {
    LCD_Address_Set(x,y,x,y);
    LCD_WR_DATA(color);
}

2. 画线函数（使用Bresenham算法）：

c复制void LCD_DrawLine(u16 x1,u16 y1,u16 x2,u16 y2,u16 color) {
    u16 t; 
    int xerr=0,yerr=0,delta_x,delta_y,distance;
    int incx,incy,uRow,uCol;
    
    delta_x=x2-x1; 
    delta_y=y2-y1;
    uRow=x1;
    uCol=y1;
    
    if(delta_x>0) incx=1; 
    else if(delta_x==0) incx=0;
    else {incx=-1;delta_x=-delta_x;}
    
    if(delta_y>0) incy=1;
    else if(delta_y==0) incy=0;
    else {incy=-1;delta_y=-delta_y;}
    
    if(delta_x>delta_y) distance=delta_x; 
    else distance=delta_y;
    
    for(t=0;t<distance+1;t++) {
        LCD_DrawPoint(uRow,uCol,color);
        xerr+=delta_x;
        yerr+=delta_y;
        if(xerr>distance) {
            xerr-=distance;
            uRow+=incx;
        }
        if(yerr>distance) {
            yerr-=distance;
            uCol+=incy;
        }
    }
}

3. 填充矩形函数：

c复制void LCD_Fill(u16 xsta,u16 ysta,u16 xend,u16 yend,u16 color) {          
    u16 i,j; 
    LCD_Address_Set(xsta,ysta,xend-1,yend-1);
    for(i=ysta;i<yend;i++) {
        for(j=xsta;j<xend;j++) {
            LCD_WR_DATA(color);
        }
    }
}

3.5 字符与汉字显示

显示字符需要字库支持。我们通常使用两种字库：

1. ASCII字符：内置在程序中
2. 汉字：使用外部字库或内置部分常用汉字

以下是字符显示函数示例：

c复制void LCD_ShowChar(u16 x,u16 y,u8 num,u16 fc,u16 bc,u8 sizey,u8 mode) {
    u8 temp,sizex,t,m=0;
    u16 i,TypefaceNum;
    u16 x0=x;
    sizex=sizey/2;
    TypefaceNum=(sizex/8+((sizex%8)?1:0))*sizey;
    num=num-' '; // 计算在字库中的偏移量
    
    LCD_Address_Set(x,y,x+sizex-1,y+sizey-1); 
    for(i=0;i<TypefaceNum;i++) { 
        if(sizey==12) temp=ascii_1206[num][i];
        else if(sizey==16) temp=ascii_1608[num][i];
        else if(sizey==24) temp=ascii_2412[num][i];
        else if(sizey==32) temp=ascii_3216[num][i];
        else return;
        
        for(t=0;t<8;t++) {
            if(!mode) {
                if(temp&(0x01<<t)) LCD_WR_DATA(fc);
                else LCD_WR_DATA(bc);
                m++;
                if(m%sizex==0) {
                    m=0;
                    break;
                }
            } else {
                if(temp&(0x01<<t)) LCD_DrawPoint(x,y,fc);
                x++;
                if((x-x0)==sizex) {
                    x=x0;
                    y++;
                    break;
                }
            }
        }
    }       
}

汉字显示原理类似，只是字模数据更大，通常使用16x16或24x24点阵。

4. 项目优化与常见问题解决

4.1 性能优化技巧

1. 提高刷新速度：

   • 使用DMA传输（如果使用硬件SPI）
   • 减少函数调用层级
   • 使用寄存器操作替代HAL库函数
   • 批量传输数据而非单点绘制

2. 内存优化：

   • 使用const修饰字库数组，将其存放在Flash而非RAM
   • 对于不常变化的内容，使用缓存机制
   • 合理使用局部变量和全局变量

3. 电源管理：

   • 不需要显示时关闭背光
   • 使用睡眠模式降低功耗

4.2 常见问题排查

1. 屏幕无显示：

   • 检查背光是否开启
   • 确认复位信号正常
   • 检查电源电压是否稳定
   • 验证SPI信号线连接是否正确

2. 显示花屏：

   • 检查初始化序列是否正确
   • 确认颜色格式是否匹配（RGB565/RGB888）
   • 检查显存是否溢出

3. 通信不稳定：

   • 降低SPI时钟频率测试
   • 检查信号线是否有干扰
   • 确保地线连接良好

4.3 扩展功能实现

基于这个基础框架，可以进一步实现：

1. 触摸屏支持
2. 图形用户界面(GUI)
3. 动画效果
4. 多级菜单系统
5. 与传感器数据联动显示

在实际项目中，我发现将显示逻辑与业务逻辑分离非常重要。可以采用分层架构：

• 底层：硬件驱动层（SPI通信、GPIO控制）
• 中间层：图形基本元素（点、线、面、文字）
• 应用层：具体业务逻辑和界面设计

这种结构使得代码更易维护，也方便在不同硬件平台间移植。