STM32F103C8T6最小系统板驱动1.8寸ST7735彩屏全流程实战指南当你第一次拿到那块蓝色PCB的ST7735屏幕和STM32F103C8T6核心板时可能会被密密麻麻的引脚和陌生的专业术语吓到。别担心这正是大多数嵌入式开发者入门图形显示的必经之路。本文将带你从零开始用CubeMX和HAL库搭建完整的显示系统重点解决实际开发中最棘手的三个问题SPIDMA高效传输、多品牌屏幕适配困境以及中文显示和图片嵌入的取模技巧。1. 硬件准备与环境搭建在开始编写代码前我们需要确保手头的硬件和软件环境准备就绪。不同厂商的ST7735屏幕虽然控制器相同但初始化序列和引脚定义可能存在差异这也是许多初学者第一个容易踩坑的地方。1.1 硬件连接检查以最常见的蓝板ST7735为例其典型引脚定义如下屏幕引脚STM32连接备注GNDGND必须共地VCC3.3V切勿接5VSCLPA5SPI1时钟线SDAPA7SPI1数据线RESPA1复位引脚低电平有效DCPA2数据/命令选择CSPA4片选低电平有效BLKPA3背光控制注意金逸晨等品牌屏幕可能使用不同的引脚排列务必对照随屏资料确认。我曾遇到过将RES和DC引脚接反导致屏幕无法初始化的情况调试了整整一个下午。1.2 软件工具准备需要安装的软件环境STM32CubeMX 6.x版本Keil MDK或STM32CubeIDEST7735驱动库推荐使用经过优化的开源版本取模工具如PCtoLCD2002安装CubeMX时建议勾选HAL库和对应芯片系列的软件包。有个容易忽略的细节在CubeMX 6.0之后部分外设配置界面有所调整特别是DMA设置部分变得更加直观。# 检查HAL库版本是否匹配 grep -rn STM32Cube FW_F1 Drivers/STM32F1xx_HAL_Driver/Inc/stm32f1xx_hal.h2. CubeMX工程配置详解CubeMX的图形化配置大大简化了外设初始化流程但对于SPIDMA这种需要精细控制的场景仍有几个关键点需要特别注意。2.1 SPI外设基础配置在CubeMX中启用SPI1模式选择Full-Duplex Master硬件NSS信号设置为Disable软件控制更灵活。参数配置建议Prescaler: 8分频在72MHz系统时钟下得到9MHz SPI速率Clock Polarity: LowClock Phase: 1 EdgeData Size: 8位First Bit: MSB first// 生成的SPI初始化代码片段 hspi1.Instance SPI1; hspi1.Init.Mode SPI_MODE_MASTER; hspi1.Init.Direction SPI_DIRECTION_2LINES; hspi1.Init.DataSize SPI_DATASIZE_8BIT; hspi1.Init.CLKPolarity SPI_POLARITY_LOW; hspi1.Init.CLKPhase SPI_PHASE_1EDGE; hspi1.Init.NSS SPI_NSS_SOFT; hspi1.Init.BaudRatePrescaler SPI_BAUDRATEPRESCALER_8; hspi1.Init.FirstBit SPI_FIRSTBIT_MSB; hspi1.Init.TIMode SPI_TIMODE_DISABLE; hspi1.Init.CRCCalculation SPI_CRCCALCULATION_DISABLE; hspi1.Init.CRCPolynomial 10;2.2 DMA传输高级配置DMA配置是提升显示性能的关键。我们需要为SPI_TX添加DMA通道配置为内存到外设模式Mode: Normal非循环模式Priority: MediumMemory Data Width: BytePeripheral Data Width: ByteMemory Increment: Enable重要Peripheral Increment: Disable// DMA控制器配置示例 hdma_spi1_tx.Instance DMA1_Channel3; hdma_spi1_tx.Init.Direction DMA_MEMORY_TO_PERIPHERAL; hdma_spi1_tx.Init.PeriphInc DMA_PINC_DISABLE; hdma_spi1_tx.Init.MemInc DMA_MINC_ENABLE; hdma_spi1_tx.Init.PeriphDataAlignment DMA_PDATAALIGN_BYTE; hdma_spi1_tx.Init.MemDataAlignment DMA_MDATAALIGN_BYTE; hdma_spi1_tx.Init.Mode DMA_NORMAL; hdma_spi1_tx.Init.Priority DMA_PRIORITY_MEDIUM;实际测试发现当发送大量数据时将DMA优先级设为High可以减少因中断延迟导致的传输停滞。但要注意这可能影响其他实时性要求高的外设。3. ST7735驱动移植与优化网上能找到的ST7735驱动代码质量参差不齐很多直接移植Arduino库的实现在STM32上效率低下。我们需要一个针对HAL库和DMA传输优化的版本。3.1 驱动文件结构推荐的文件组织方式/Drivers /ST7735 st7735.c st7735.h st7735_cfg.h # 硬件相关配置 fonts.h # 字库定义 images.h # 图片数据在st7735_cfg.h中通过宏定义适配不同品牌的屏幕// 根据屏幕品牌选择正确的初始化序列 #define ST7735_SPI_PORT hspi1 #define USE_SPI_DMA // 中景园1.8寸屏 #define ST7735_1_8_DEFAULT_ORIENTATION //#define ST7735S_1_8_DEFAULT_ORIENTATION // 微雪屏幕 //#define ST7735_1_44_DEFAULT_ORIENTATION // 1.44寸屏3.2 DMA发送函数实现传统的HAL_SPI_Transmit函数会阻塞CPU我们实现基于DMA的异步发送void ST7735_SendDataDMA(uint8_t* buff, size_t buff_size) { while(HAL_DMA_GetState(hdma_spi1_tx) HAL_DMA_STATE_BUSY) { // 等待上次DMA传输完成 } HAL_SPI_Transmit_DMA(ST7735_SPI_PORT, buff, buff_size); }配合信号量机制可以进一步优化osSemaphoreId_t spiTxSemaphore; void HAL_SPI_TxCpltCallback(SPI_HandleTypeDef *hspi) { if(hspi-Instance SPI1) { osSemaphoreRelease(spiTxSemaphore); } }4. 图形显示进阶技巧基础文本显示只是开始真正的挑战在于实现流畅的图形界面和中文支持。4.1 汉字显示解决方案使用取模工具生成字库是最可靠的方法。以PCtoLCD2002为例推荐设置取模方式逐行式取模走向逆向低位在前输出格式C51格式字体大小16x16或24x24生成的字体数据结构示例typedef struct { uint8_t width; uint8_t height; const uint16_t *data; } FontDef; // 16x16宋体汉字中 const uint16_t font_zhong[] { 0x0000,0x7FFC,0x4004,0x4004,0x4004,0x4004,0x4004,0x4004, 0x4004,0x4004,0x4004,0x4004,0x4004,0x7FFC,0x0000,0x0000 }; FontDef Font16x16_CN { .width 16, .height 16, .data font_zhong };显示函数实现void ST7735_DrawChinese(uint16_t x, uint16_t y, FontDef font, uint16_t color, uint16_t bgcolor) { uint16_t i, j; for(j0; jfont.height; j) { for(i0; ifont.width; i) { if(font.data[j] (1(15-i))) { ST7735_DrawPixel(xi, yj, color); } else if(bgcolor ! color) { ST7735_DrawPixel(xi, yj, bgcolor); } } } }4.2 图片显示优化技巧将图片转换为C数组时建议使用RGB565格式。Image2Lcd工具设置输出数据类型C语言数组扫描方式水平扫描输出灰度16位真彩色最大宽度和高度根据屏幕尺寸设置对于128x160的屏幕一张全屏图片需要const uint16_t test_img[128*160] { // 这里放置RGB565格式的像素数据 };优化后的显示函数void ST7735_DrawImageDMA(uint16_t x, uint16_t y, uint16_t w, uint16_t h, const uint16_t* img) { ST7735_SetAddressWindow(x, y, xw-1, yh-1); ST7735_Select(); ST7735_DC_Data(); ST7735_SendDataDMA((uint8_t*)img, w*h*2); ST7735_Unselect(); }实际测试表明使用DMA传输一张128x160的图片仅需约8ms而传统阻塞方式需要超过50ms。这个差异在动态刷新时尤为明显。