HAL库驱动0.96寸OLED12864：汉字与图像显示的实战指南

1. 硬件准备与环境搭建

0.96寸OLED12864显示屏是嵌入式项目中非常实用的显示设备，它体积小巧、功耗低，特别适合物联网设备和便携式仪器。我刚开始接触这种屏幕时，发现网上资料虽然多，但真正能跑通的完整项目并不多。下面我就把自己实际调试成功的经验分享给大家。

首先需要准备硬件材料：STM32开发板（我用的是STM32F103C8T6）、0.96寸OLED屏幕（SSD1306驱动）、杜邦线若干。接线方面，OLED通常支持I2C和SPI两种通信方式，我建议初学者先用I2C，只需要4根线：VCC（3.3V）、GND、SCL（PB8）、SDA（PB9）。记得在CubeMX中将PB8和PB9配置为开漏输出（Open-Drain），初始电平设为高电平，这样符合I2C的电气特性。

打开STM32CubeMX新建工程时，选择你的芯片型号，在Pinout & Configuration页面中找到I2C1模块。如果你用的是其他型号的STM32，可能I2C接口的引脚不同，需要根据数据手册调整。配置完引脚后，在Project Manager里设置工程名称和路径，Toolchain选择MDK-ARM（Keil），然后生成代码。这个过程网上教程很多，我就不赘述了，关键是生成代码后要检查一下i2c.h和i2c.c文件是否正确生成。

2. 驱动移植与适配

我最初尝试自己写驱动，后来发现江协科技的开源驱动已经做得很完善了，就在这个基础上进行HAL库适配。下载驱动代码后，把Hardware文件夹里的四个文件（oled.c、oled.h、oled_data.c、oled_data.h）复制到你的工程目录。在Keil中右键点击Application/User文件夹，选择Add Existing Files，把这四个文件添加进去。

接下来是最关键的HAL库适配工作。原驱动是基于标准库写的，需要替换几个关键函数。打开oled.c文件，找到GPIO操作函数，把原来的标准库函数替换为HAL库版本。比如OLED_W_SCL函数中，将GPIO_WriteBit(GPIOB, GPIO_Pin_8, (BitAction)BitValue)改为HAL_GPIO