从裸屏到显示“Hello World”：我的STM32F103RFT6驱动1.3寸LCD全记录（附PCB设计）

从零点亮1.3寸LCDSTM32F103RFT6驱动ST7789全流程实战记得第一次拿到那块1.3寸的裸屏时我盯着24个引脚发呆——没有现成的底板没有即插即用的排针只有一份全英文的datasheet。作为嵌入式开发者这种从零开始的硬件集成正是最令人兴奋的挑战。本文将完整记录如何用STM32F103RFT6驱动ST7789芯片的LCD屏幕从PCB设计到Hello World显示的全过程。1. 硬件设计与选型考量1.1 核心器件选择选择STM32F103RFT6作为主控主要基于三点考虑96KB SRAM240x240分辨率下全屏刷新需要115.2KB缓冲区分3次刷写即可完成丰富的外设内置硬件SPI接口时钟频率可达18MHz扩展潜力后续可轻松添加SD卡存储功能屏幕选用中景园1.3寸IPS屏驱动芯片为ST7789V3主要参数如下参数规格分辨率240×240接口类型4线SPI/8位并口色彩深度262K色(18bit)可视角度178°(IPS特性)工作电压3.3V1.2 关键电路设计裸屏驱动需要自行设计以下电路模块背光驱动电路// 典型MOS管驱动电路 LCD_BLK ──┬── 10KΩ ──┬── SI2302(Gate) │ │ └── 100Ω ──┘── LEDA(阳极) LEDK(阴极)─┬─ GND └─ SI2302(Drain)提示PWM调光可通过TIM2_CH2(PA1)实现频率建议1-10kHz信号接口连接方案STM32引脚LCD功能备注PA4LCD_CS片选低电平有效PA3LCD_DC数据/命令选择PA2LCD_RES复位信号PA5SPI1_SCK时钟线PA7SPI1_MOSI数据线PA1LCD_BLK背光控制2. 底层驱动开发2.1 SPI接口配置ST7789的4线SPI模式时序要求严格初始化代码如下void SPI1_Init(void) { SPI_InitTypeDef SPI_InitStructure; SPI_InitStructure.SPI_Direction SPI_Direction_1Line_Tx; SPI_InitStructure.SPI_Mode SPI_Mode_Master; SPI_InitStructure.SPI_DataSize SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL SPI_CPOL_High; // 空闲时高电平 SPI_InitStructure.SPI_CPHA SPI_CPHA_2Edge; // 第二个边沿采样 SPI_InitStructure.SPI_NSS SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_2; SPI_InitStructure.SPI_FirstBit SPI_FirstBit_MSB; SPI_Init(SPI1, SPI_InitStructure); SPI_Cmd(SPI1, ENABLE); }关键时序参数来自ST7789手册第8.4.2节时钟极性(CPOL)1空闲状态高电平时钟相位(CPHA)1数据在第二个边沿捕获2.2 基础通信函数实现三种基本操作函数// 发送命令(DC0) void LCD_WR_CMD(uint8_t cmd) { LCD_DC_0; SPI1_SendData(cmd); while(SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) RESET); } // 发送8位数据(DC1) void LCD_WR_DATA8(uint8_t data) { LCD_DC_1; SPI1_SendData(data); while(SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) RESET); } // 发送16位数据(DC1) void LCD_WR_DATA16(uint16_t data) { LCD_DC_1; SPI1_SendData(data 8); // 先发高字节 SPI1_SendData(data 0xFF); // 后发低字节 while(SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_BSY) SET); }3. 屏幕初始化与配置3.1 硬件复位序列正确的复位时序对屏幕启动至关重要拉低RESET引脚至少10μs等待5ms让电源稳定释放RESET引脚再等待120ms完成内部初始化代码实现void LCD_Reset(void) { LCD_RES_0; Delay_us(20); LCD_RES_1; Delay_ms(120); }3.2 关键寄存器配置ST7789有超过50个可配置寄存器重点关注以下几个显示方向控制(MADCTL 0x36)void LCD_SetDirection(uint8_t direction) { LCD_WR_CMD(0x36); switch(direction) { case 0: LCD_WR_DATA8(0x00); break; // 竖屏 case 1: LCD_WR_DATA8(0xC0); break; // 竖屏镜像 case 2: LCD_WR_DATA8(0x70); break; // 横屏 case 3: LCD_WR_DATA8(0xA0); break; // 横屏镜像 } }像素格式(COLMOD 0x3A)LCD_WR_CMD(0x3A); LCD_WR_DATA8(0x05); // RGB565格式伽马校正// 正极性伽马校正 static const uint8_t gamma_pos[] {0xD0,0x04,0x0D,0x11,0x13,0x2B,0x3F,0x54, 0x4C,0x18,0x0D,0x0B,0x1F,0x23}; LCD_WR_CMD(0xE0); for(int i0; isizeof(gamma_pos); i) { LCD_WR_DATA8(gamma_pos[i]); }4. 显示功能实现4.1 设置显示区域ST7789采用行列地址机制管理显示区域void LCD_SetWindow(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2) { // 列地址设置 LCD_WR_CMD(0x2A); LCD_WR_DATA16(x1); LCD_WR_DATA16(x2); // 行地址设置 LCD_WR_CMD(0x2B); LCD_WR_DATA16(y1 80); // Y轴偏移80像素 LCD_WR_DATA16(y2 80); // 存储器写命令 LCD_WR_CMD(0x2C); }注意偏移量80与屏幕硬件布线有关不同厂商可能不同4.2 基础显示功能清屏函数void LCD_Clear(uint16_t color) { LCD_SetWindow(0, 0, LCD_WIDTH-1, LCD_HEIGHT-1); for(uint32_t i0; iLCD_WIDTH*LCD_HEIGHT; i) { LCD_WR_DATA16(color); } }显示字符void LCD_ShowChar(uint16_t x, uint16_t y, char chr, uint16_t color) { uint8_t temp; uint8_t mask; const uint8_t *pfont Font8x16[chr- ][0]; LCD_SetWindow(x, y, x7, y15); for(uint8_t j0; j16; j) { temp *pfont; for(mask0x80; mask!0; mask1) { LCD_WR_DATA16(tempmask ? color : BACKGROUND); } } }5. 调试经验与优化技巧5.1 常见问题排查现象1屏幕白屏无显示检查背光电路测量LEDA-LEDK间应有3V压降验证复位时序RESET信号需保持20μs低电平检测SPI信号用逻辑分析仪抓取CLK/MOSI波形现象2显示颜色异常确认COLMOD寄存器配置为0x05(RGB565)检查伽马校正参数是否与手册一致确保数据传输顺序为MSB优先5.2 性能优化手段DMA加速刷屏void LCD_Fill_DMA(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint16_t *color) { LCD_SetWindow(x1, y1, x2, y2); DMA_Cmd(DMA1_Channel3, DISABLE); DMA_SetCurrDataCounter(DMA1_Channel3, (x2-x11)*(y2-y11)); DMA_Cmd(DMA1_Channel3, ENABLE); SPI_I2S_DMACmd(SPI1, SPI_I2S_DMAReq_Tx, ENABLE); while(DMA_GetFlagStatus(DMA1_FLAG_TC3) RESET); SPI_I2S_DMACmd(SPI1, SPI_I2S_DMAReq_Tx, DISABLE); }双缓冲机制在SRAM中开辟两个240x240的缓冲区后台操作缓冲区B时前台显示缓冲区A通过LTDC接口实现无缝切换6. 进阶功能扩展6.1 触摸功能集成对于带触摸的屏幕通常使用XPT2046芯片uint16_t TP_Read_X(void) { TP_CS_0; SPI_WriteByte(0xD0); // X坐标读取命令 Delay_us(10); uint16_t temp SPI_ReadByte() 8; temp | SPI_ReadByte(); TP_CS_1; return temp 3; // 12位ADC值 }6.2 图形界面框架移植LittlevGL的配置要点修改lv_conf.h中的显示参数实现flush_cb回调函数void my_flush_cb(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p) { LCD_SetWindow(area-x1, area-y1, area-x2, area-y2); SPI_WriteBuffer((uint8_t*)color_p, (area-x2-area-x11)*(area-y2-area-y11)*2); lv_disp_flush_ready(disp_drv); }当第一个字符显示在屏幕上时那种成就感远超预期。硬件驱动开发最迷人的地方在于每一个信号、每一行代码都直接对应着物理世界的改变。从阅读datasheet到最终点亮屏幕这个过程教会我的不仅是技术细节更是一种系统级的思维方式——如何将抽象的数字信号转化为可见的现实反馈。