STM32CubeMX实战指南（小熊派）：SPI接口点亮LCD屏的完整流程

1. 从零开始：你的第一个LCD显示项目

如果你手头正好有一块小熊派开发板和一块SPI接口的LCD屏幕，却不知道如何让它们“开口说话”，那你来对地方了。我当年第一次接触STM32和LCD屏的时候，也是对着密密麻麻的引脚和英文手册发愁，总觉得底层驱动深不可测。但后来我发现，有了STM32CubeMX这个“图形化外挂”，事情就变得像搭积木一样直观。今天，我就带你完整走一遍流程，从新建工程到屏幕上出现“Hello World”，保证你跟着做就能成功。这个项目特别适合刚学完单片机基础、想找个实战项目练手的同学，也适合那些厌倦了在调试器和屏幕间反复折腾、渴望一个稳定显示方案的开发者。我们的目标很明确：不深究SPI协议的每一个时钟边沿（那是以后的事），而是先用最省事的方法，把屏幕点亮，看到成果，建立信心。

为什么选择SPI接口的LCD？这其实是个非常实用的选择。相比于并口屏需要占用大量GPIO引脚，SPI屏通常只需要3到4根线（时钟、数据输入、数据输出、片选）就能完成通信，大大节省了宝贵的单片机引脚资源，尤其适合小熊派这种引脚数量有限的开发板。市面上常见的1.3寸、1.54寸、2.4寸TFT彩屏很多都提供了SPI接口，成本低，驱动库成熟，是入门图形显示的最佳拍档。整个过程我们会依赖STM32CubeMX完成硬件抽象层的初始化，我们自己则专注于调用API和编写应用逻辑，这种分工能让开发效率大幅提升。

在开始动手前，我们需要准备好“战场”。硬件方面，你需要一块小熊派开发板（我用的是BearPi-HM Nano，基于STM32L431RCT6），一块SPI接口的LCD屏幕（本文以常见的ST7789V驱动芯片的1.54寸屏为例），以及若干杜邦线进行连接。软件方面，确保你的电脑上已经安装了STM32CubeMX和Keil MDK（或者你喜欢的其他IDE，如IAR）。至于驱动代码，别担心，我会提供一份经过验证的、针对小熊派引脚定义适配好的LCD驱动库。你只需要关注如何将它们像拼图一样组合起来。

2. 硬件连接：给屏幕接上“神经”

在让CubeMX生成代码之前，我们必须先把硬件线路连接正确。这一步看似简单，但很多新手栽跟头就是因为线接错了或者接触不良。我建议你先对照开发板的原理图，找到SPI2对应的引脚。以小熊派BearPi-HM Nano为例，其SPI2接口的引脚定义如下：PB13是SCK（时钟线），PB14是MISO（主设备输入，从设备输出），PB15是MOSI（主设备输出，从设备输入）。这里有个关键点，我们驱动LCD屏通常只使用主设备输出（MOSI） 这一根数据线进行写命令和写数据，MISO线在很多情况下可以悬空不接，除非你的屏幕需要回读数据。

那么，屏幕那边怎么接呢？以我手头这块ST7789V屏幕为例，它一般会有以下几个关键引脚：VCC（接3.3V）、GND（接地）、SCL（接PB13）、SDA（接PB15）、RES（复位，接一个GPIO，如PB12）、DC（命令/数据选择，接一个GPIO，如PB11）、CS（片选，接一个GPIO，如PB10）。BLK（背光）可以接3.3V常亮，或者也用一个GPIO控制。所以，我们的连接关系就是：PB13 -> SCL, PB15 -> SDA, PB12 -> RES, PB11 -> DC, PB10 -> CS。电源务必接对，3.3V接3.3V，GND接GND，否则有烧坏屏幕的风险。接好线后，最好再检查两遍，我吃过太多次虚焊和线序接反的亏了。

为什么需要RES、DC、CS这些额外的GPIO？这和SPI屏的通信协议有关。SPI本身只负责传输原始的字节流，但屏幕需要区分你发送的字节是命令（比如设置扫描方向）还是数据（比如要显示的像素颜色）。DC引脚就是干这个的：拉高表示接下来是数据，拉低表示是命令。CS是片选，当有多个SPI设备挂在同一组总线上时，用来选择当前要和哪个设备通信，即使我们只接了一块屏，这个信号也必须按要求进行拉低和拉高操作。RES是硬复位，用于在上电或程序跑飞后让屏幕恢复初始状