U8g2库在STM32上的硬件SPI（DMA）优化移植指南（HAL库、OLED驱动、四线SPI配置）

1. 为什么你的OLED显示还是那么慢？试试硬件SPI+DMA吧！

如果你玩过STM32驱动OLED，大概率用过软件模拟SPI，或者直接调用HAL库的阻塞式SPI发送。刚开始可能觉得还行，画个简单的图形、显示几行文字，速度感知不强。但当你尝试做动画效果、刷新整屏数据，或者主循环里还有其他任务要跑时，就会发现屏幕刷新成了整个系统的“拖油瓶”，CPU大量时间被耗在等待数据发送完成上，画面还可能卡顿、闪烁。

我刚开始用U8g2库的时候也踩过这个坑。当时为了图省事，直接用了库自带的软件SPI模拟，在STM32F103上跑，刷新一屏数据要十几毫秒，做个菜单滚动动画简直没法看。后来项目要求显示实时波形，数据更新频率一高，CPU占用率直接飙升，其他传感器数据采集都受到了影响。这才下定决心，必须把显示这块的性能瓶颈给打掉。

硬件SPI配合DMA（直接存储器访问），就是解决这个问题的“黄金搭档”。简单来说，SPI是MCU内置的一个专门负责高速串行通信的硬件模块，你只需要配置好参数，它就能自动按照时钟节拍把数据一位位发出去，速度远超软件模拟。而DMA更像一个“数据搬运工”，它能在不打扰CPU（CPU可以继续执行其他代码）的情况下，自动把内存里准备好的显示数据，搬运到SPI的数据寄存器里发送出去。

这样一来，CPU只需要在开始时告诉DMA：“把这100个字节的数据从A地址搬到SPI那里”，然后就可以潇洒地去处理其他任务了。等DMA搬完，它会发个中断通知一下CPU：“活儿干完了”。整个过程CPU参与度极低，显示刷新从一项“繁重的体力活”变成了“自动化的流水线”，系统整体性能和响应速度自然就上去了。

所以，这篇指南就是带你一步步，把U8g2这个强大的图形库，用硬件SPI和DMA的方式，高效地“嫁接”到STM32上。无论你是做智能手表、便携仪表还是需要酷炫UI的小设备，这套方案都能让你的显示部分又快又稳，把CPU资源解放出来。我们用的工具是STM32CubeMX和HAL库，这是目前最主流、最快捷的开发方式，哪怕你刚接触STM32，跟着做也能搞定。

2. 动手前的准备：硬件连接与CubeMX工程创建

万事开头准没错。我们先确保硬件连接正确，并用CubeMX搭建好整个工程的骨架。

2.1 硬件连接清单

我以最常见的STM32F103C8T6（蓝色小药丸）和0.96寸128x64的SSD1306 OLED屏（四线SPI接口）为例。其他STM32系列（如F4、G0等）和同型号屏幕，操作方法几乎一模一样。

你需要连接以下6根线：

注意：这里的PA5、PA7、PA4是STM32F103 SPI1的默认硬件引脚。如果你用的其他型号MCU或者想用SPI2/3，需要查阅芯片数据手册的“引脚复用功能”章节，找到对应的SCK、MOSI、NSS引脚。使用硬件SPI，就必须接到这些指定的引脚上，不能随意接。

2.2 CubeMX基础配置详解

打开STM32CubeMX，新建工程，选择你的MCU型号。

1. RCC（复位和时钟控制）： 在“System Core” -> “RCC”里，将“High Speed Clock (HSE)”设置为“Crystal/Ceramic Resonator”。这样我们使用外部高速晶振（比如8MHz）作为时钟源，精度和稳定性都比内部RC振荡器好，也是让SPI跑在高速度的基础。

2. SYS（系统）： 在“System Core” -> “SYS”里，将“De