3. 硬件连接实战：OLED模块与STM32/MCU的SPI引脚连接、电源与去耦电容设计、电平匹配注意事项
好，咱们进入实战环节。前面两章讲了协议和坐标，现在该真刀真枪接线了。硬件连接这事儿，说简单也简单——几根线一焊就能亮。但说复杂也复杂，我见过太多“软件调通了，硬件死活不亮”的案例，最后查出来都是接线或者电源的问题。
这一章，咱们就把OLED模块和STM32（或者其他MCU）之间的物理连接讲透。包括SPI引脚怎么接、电源怎么处理、去耦电容放哪儿、电平不匹配怎么办。嗯，这些都是实战中绕不开的坑。
3.1 OLED模块的典型引脚定义
市面上常见的0.96寸OLED模块（SSD1306驱动），大多是7脚或8脚。我以最常用的7脚SPI版本为例：
| 引脚 | 名称 | 功能说明 |
|---|---|---|
| 1 | GND | 电源地 |
| 2 | VCC | 电源正（3.3V 或 5V，视模块而定） |
| 3 | SCL / D0 | SPI时钟线（SCLK） |
| 4 | SDA / D1 | SPI数据线（MOSI） |
| 5 | RES / RST | 复位引脚（低电平复位） |
| 6 | DC | 数据/命令选择（高电平数据，低电平命令） |
| 7 | CS | 片选引脚（低电平使能） |
我的习惯：拿到新模块，第一件事不是焊，而是拿万用表量一下VCC和GND之间有没有短路。别笑，我真遇到过出厂就焊反的模块。
3.2 STM32的SPI引脚连接方案
STM32的SPI外设通常有多个，比如SPI1、SPI2。我一般用SPI1，因为它的引脚在默认复用功能下比较好布线。以STM32F103C8T6为例：
| OLED引脚 | STM32引脚 | 备注 |
|---|---|---|
| SCL (D0) | PA5 (SPI1_SCK) | 时钟，必须接 |
| SDA (D1) | PA7 (SPI1_MOSI) | 数据输出，OLED只收不发，所以MISO不用接 |
| RES | PB0 (任意GPIO) | 软件控制复位 |
| DC | PB1 (任意GPIO) | 数据/命令选择 |
| CS | PB2 (任意GPIO) | 片选，软件控制 |
注意：OLED模块是SPI从机，只接收数据，不发送数据。所以STM32的MISO引脚（PA6）可以空着，或者配置为普通GPIO。我曾经手贱把MISO也连上了，结果干扰了SPI时序，折腾了半天。
3.3 电源与去耦电容设计
OLED模块工作时，瞬间电流变化挺大的。尤其是全屏点亮白色时，电流可能从几毫安跳到十几毫安。如果电源纹波大，屏幕会出现闪烁、花屏。
我的做法是：
- VCC引脚：接3.3V。虽然有些模块标称支持5V，但我建议统一用3.3V，方便和MCU电平匹配。
- 去耦电容：在OLED模块的VCC和GND之间，紧贴引脚放置一个10µF电解电容 + 一个0.1µF陶瓷电容。
为什么是两个电容？
10µF负责低频纹波抑制，0.1µF负责高频噪声滤除。两个电容并联，覆盖的频段更宽。电容离模块越近效果越好，别放在面包板另一端。
10µF负责低频纹波抑制，0.1µF负责高频噪声滤除。两个电容并联，覆盖的频段更宽。电容离模块越近效果越好，别放在面包板另一端。
另外，如果OLED模块和MCU共用同一路3.3V电源，建议在总电源入口也加一个10µF电容。我遇到过一种情况：电机一启动，OLED就闪——就是因为电源被拉垮了。
3.4 电平匹配注意事项
这是个大坑。很多OLED模块是3.3V逻辑，但有些“兼容5V”的模块，其实只是电源能承受5V，IO口仍然是3.3V电平。
如果你用5V的MCU（比如Arduino Uno、STM32的5V容忍引脚），直接连3.3V的OLED，IO口电压可能烧坏模块。
我的建议：
- MCU是3.3V：直接连，没问题。
- MCU是5V：必须加电平转换。最简单的办法是串联一个1kΩ电阻限流，或者用两个电阻分压（比如2.2kΩ + 3.3kΩ）。
- STM32的5V容忍引脚：虽然引脚标着“5V tolerant”，但输出高电平仍然是3.3V。所以接3.3V的OLED没问题，不用额外处理。
我曾经犯过的错：用STM32的PB5（5V容忍）直接驱动OLED的RES引脚，结果模块复位不正常。后来发现PB5配置成了开漏输出，高电平被拉到了5V，超过了OLED的IO耐压。改成推挽输出就好了。
3.5 完整接线示意图
下面这张SVG图，把整个硬件连接关系画清楚了。包括电源、去耦电容、SPI信号线、控制线，一目了然。
3.6 实际布线中的几个细节
说几个我在项目中踩过的坑：
- SCL和SDA不要交叉：有些模块的引脚顺序是反的，焊之前一定对照原理图确认。我有一块板子就是SCL和SDA焊反了，结果SPI通信一直超时。
- RES引脚不要悬空：有些教程说RES可以接VCC，但我建议用GPIO控制。因为上电时序不确定，RES悬空可能导致模块初始化失败。
- CS引脚必须接：虽然有些模块支持CS接地（一直使能），但多模块共用SPI总线时，CS必须独立控制。
- 电源线尽量粗：OLED瞬间电流大，细线会产生压降。我一般用0.5mm²以上的线。
我的调试习惯：先焊VCC和GND，上电测电压。正常了再焊其他信号线。这样万一模块烧了，至少知道是电源的问题还是信号的问题。
3.7 电平匹配的几种方案对比
| 方案 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 直接连接（3.3V MCU） | 简单，无需额外元件 | 仅限3.3V系统 | STM32、ESP32等3.3V MCU |
| 串联限流电阻（1kΩ） | 成本低，一个电阻搞定 | 信号速率受限，不适合高频 | 低速SPI（<1MHz） |
| 电阻分压（2.2k+3.3k） | 电平精确，可靠 | 占用空间，增加BOM | 5V MCU，中等速率 |
| 电平转换芯片（如TXS0102） | 双向，高速，可靠 | 成本高，需要额外供电 | 高速SPI（>10MHz）或批量产品 |
我个人习惯：如果MCU是3.3V，直接连。如果是5V，用电阻分压。批量产品才考虑专用芯片。
3.8 上电前的最后检查清单
焊完线，别急着上电。按这个清单过一遍：
- 万用表量VCC和GND，确认没有短路。
- 确认VCC电压是3.3V（或模块标称电压）。
- 确认SCL、SDA、RES、DC、CS都接到了正确的GPIO。
- 确认去耦电容已经焊好，且靠近模块。
- 如果用了电平转换，确认转换方向正确。
血的教训：我曾经有一块板子，所有连线都对了，但OLED就是不亮。查了半天，发现是模块的VCC和GND在PCB上画反了。从那以后，我每次打板前都会用万用表蜂鸣档扫一遍电源网络。