3、硬件连接实战：STM32与OLED模块的SPI接线图、电源去耦与电平匹配
硬件连接这事儿，看着简单，翻车率其实挺高的。我见过不少朋友，代码调得飞起，结果板子一上电，屏幕死活不亮——最后发现是杜邦线松了，或者电平没对上。这一章，咱们就把STM32和OLED模块之间的物理连线掰扯清楚。
3.1 标准SPI四线接线图
市面上常见的0.96寸OLED模块，大部分是7脚或6脚接口。咱们以最通用的7脚SSD1306模块为例，走硬件SPI模式。说白了，就是四根信号线加两根电源线。
| OLED模块引脚 | 功能说明 | STM32推荐引脚 | 备注 |
|---|---|---|---|
| GND | 电源地 | GND | 共地必须接 |
| VCC | 电源正（3.3V） | 3.3V | 严禁接5V！ |
| D0 / SCLK | SPI时钟线 | PA5 (SPI1_SCK) | 我习惯用SPI1 |
| D1 / MOSI | SPI主机输出 | PA7 (SPI1_MOSI) | OLED只收不发 |
| RES / RST | 复位引脚（低电平复位） | PB0 | 任意GPIO即可 |
| DC / A0 | 数据/命令选择 | PB1 | 高电平=数据，低电平=命令 |
| CS | 片选（低电平有效） | PB2 | 直接接地也可 |
关键点：OLED模块的SPI是单工通信——主机只管发，从机只管收。所以MISO引脚不需要接。如果你用的是软件模拟SPI，那任意GPIO都能当SCLK和MOSI用。
3.2 电源去耦——这个小电容能救你一命
嗯，这里要重点说一下。OLED模块内部有电荷泵，用来产生驱动屏幕所需的高电压。这个电荷泵工作时，会从VCC线上抽取瞬间大电流。如果电源纹波太大，屏幕就会出现闪烁、花屏，甚至初始化失败。
我的标准做法：在OLED模块的VCC和GND之间，紧挨着模块引脚，并联两个电容——一个10μF电解电容（或者钽电容），再加一个0.1μF陶瓷电容。10μF负责稳住低频波动，0.1μF负责滤除高频噪声。
实战技巧：电容要尽量靠近模块的电源引脚，走线越短越好。我曾经在一个项目里，因为电容放远了5厘米，屏幕在低温下就疯狂闪屏。后来把电容焊到模块背面，问题直接解决。
3.3 电平匹配——3.3V vs 5V，别烧片子
STM32的GPIO电平是3.3V，而有些OLED模块（尤其是老款）标称是5V供电。这里有个常见的坑：供电电压和IO逻辑电平是两回事。
大部分0.96寸OLED模块，虽然VCC可以接3.3V~5V，但它的SPI逻辑输入阈值是跟着VCC走的。如果你给模块供5V，那它的逻辑高电平阈值可能接近0.7×VCC=3.5V。STM32输出的3.3V，刚好卡在临界区——模块可能识别不到高电平。
警告：千万不要把STM32的3.3V引脚直接连到5V供电的OLED模块IO上！虽然STM32的IO是5V容忍，但长期这样用，芯片寿命会打折扣。我见过有人这么干，三个月后IO口就烧了。
解决方案其实很简单：
- 方案一（推荐）：OLED模块也用3.3V供电。大多数模块在3.3V下都能正常工作，只是亮度稍微低一点点，肉眼几乎看不出区别。
- 方案二：如果模块必须用5V，那就在SPI信号线上串一个330Ω电阻做限流，或者用电平转换芯片（比如TXB0104）。
- 方案三（我常用的土办法）：用两个电阻分压，把STM32的3.3V抬到3.6V左右。但这个方法不推荐新手用，阻抗匹配容易出问题。
3.4 完整接线示意图（SVG）
下面这张图，把上面说的所有连线都画出来了。你照着接，基本不会出错。
3.5 硬件连接检查清单
每次焊完线或者插好杜邦线，别急着上电。按下面这个清单过一遍，能省掉你至少两小时的调试时间。
- 电源检查：万用表量一下OLED模块的VCC和GND之间，是不是3.3V ± 0.1V。
- 共地确认：STM32的GND和OLED的GND是不是连在一起的？不共地，SPI绝对不通。
- 信号线顺序：SCLK接SCLK，MOSI接MOSI，别交叉。我见过有人把SCLK和MOSI接反了，屏幕也能亮，但显示内容全是乱的。
- 复位引脚：RES引脚有没有被拉高？如果悬空，模块可能一直处在复位状态。
- CS片选：如果CS直接接地，那没问题。如果接GPIO，记得初始化时拉低。
- 电容位置：去耦电容是不是紧挨着模块的VCC引脚？离远了效果打折扣。
我的血泪教训：有一次，我偷懒没焊去耦电容，结果屏幕在显示大面积白色时，会出现横条纹。查了两天，最后发现是电源纹波太大，电荷泵工作不稳定。加上电容后，世界清净了。
3.6 电平匹配速查表
不同供电组合下，到底该怎么处理？我整理了一张表，你直接对着看就行。
| STM32供电 | OLED供电 | 是否直接连接 | 推荐处理方式 |
|---|---|---|---|
| 3.3V | 3.3V | ✅ 可以 | 直接连，加去耦电容 |
| 3.3V | 5V | ⚠️ 有风险 | 串330Ω电阻或用电平转换芯片 |
| 5V | 3.3V | ❌ 不行 | 必须用降压转换，否则烧OLED |
| 5V | 5V | ✅ 可以 | 但STM32的IO是3.3V，仍需电平匹配 |
说白了，最省心的方案就是：STM32和OLED都用3.3V供电。这样电平天然匹配，不用加任何转换电路，去耦电容焊好就能跑。