要在STM32F446上驱动OLED显示器（通常指SSD1306芯片的0.96英寸OLED），以下是详细步骤：

1. 硬件连接

注意：I2C引脚需配置为开漏模式（Open Drain），并加上拉电阻（通常OLED模块已内置）。

2. 软件配置（使用HAL库）

(1) 初始化I2C

在STM32CubeMX中配置：

• 选择I2C1（或I2C2）
• SCL: PB8, SDA: PB9
• 速度：标准模式（100KHz）或快速模式（400KHz）
• 生成代码。

(2) OLED驱动代码

创建oled.c和oled.h文件，实现以下核心函数：

// oled.h
#include "stm32f4xx_hal.h"
#define OLED_I2C_ADDR 0x78  // SSD1306 I2C地址（0x3C << 1）

void OLED_Init(void);
void OLED_WriteCommand(uint8_t cmd);
void OLED_WriteData(uint8_t data);
void OLED_Clear(void);
void OLED_SetCursor(uint8_t x, uint8_t page);
void OLED_DisplayString(uint8_t x, uint8_t page, char *str);

// oled.c
extern I2C_HandleTypeDef hi2c1;  // CubeMX生成的I2C句柄

// 发送命令
void OLED_WriteCommand(uint8_t cmd) {
    uint8_t buf[2] = {0x00, cmd}; // 控制字节+命令
    HAL_I2C_Master_Transmit(&hi2c1, OLED_I2C_ADDR, buf, 2, 10);
}

// 发送数据
void OLED_WriteData(uint8_t data) {
    uint8_t buf[2] = {0x40, data}; // 控制字节+数据
    HAL_I2C_Master_Transmit(&hi2c1, OLED_I2C_ADDR, buf, 2, 10);
}

// 初始化序列
void OLED_Init(void) {
    HAL_Delay(100);
    OLED_WriteCommand(0xAE); // 关闭显示
    OLED_WriteCommand(0xD5); // 设置时钟分频
    OLED_WriteCommand(0x80);
    OLED_WriteCommand(0xA8); // 设置多路复用率
    OLED_WriteCommand(0x3F);
    OLED_WriteCommand(0xD3); // 设置显示偏移
    OLED_WriteCommand(0x00);
    OLED_WriteCommand(0x40); // 设置起始行
    OLED_WriteCommand(0x8D); // 电荷泵设置
    OLED_WriteCommand(0x14);
    OLED_WriteCommand(0x20); // 存储器模式
    OLED_WriteCommand(0x00);
    OLED_WriteCommand(0xA1); // 段重映射
    OLED_WriteCommand(0xC8); // 扫描方向
    OLED_WriteCommand(0xDA); // COM引脚配置
    OLED_WriteCommand(0x12);
    OLED_WriteCommand(0x81); // 对比度
    OLED_WriteCommand(0xCF);
    OLED_WriteCommand(0xD9); // 预充电周期
    OLED_WriteCommand(0xF1);
    OLED_WriteCommand(0xDB); // VCOMH电平
    OLED_WriteCommand(0x30);
    OLED_WriteCommand(0xA4); // 显示内容跟随RAM
    OLED_WriteCommand(0xA6); // 正常显示（非反色）
    OLED_WriteCommand(0xAF); // 开启显示
    OLED_Clear();
}

// 清屏
void OLED_Clear(void) {
    for(uint8_t page = 0; page < 8; page++) {
        OLED_SetCursor(0, page);
        for(uint8_t i = 0; i < 128; i++) OLED_WriteData(0x00);
    }
}

// 设置光标位置 (x: 列0-127, page: 页0-7)
void OLED_SetCursor(uint8_t x, uint8_t page) {
    OLED_WriteCommand(0xB0 + page);       // 设置页地址
    OLED_WriteCommand(0x00 + (x & 0x0F)); // 列低4位
    OLED_WriteCommand(0x10 + (x >> 4));   // 列高4位
}

// 显示字符串（需字库）
void OLED_DisplayString(uint8_t x, uint8_t page, char *str) {
    while (*str) {
        // 遍历字库（例如6x8字体）
        for (uint8_t i = 0; i < 6; i++) {
            uint8_t font_data = font_6x8[*str - 32][i]; // 从ASCII字库获取
            OLED_WriteData(font_data);
        }
        x += 6;
        if (x > 122) { x = 0; page++; } // 换行处理
        str++;
    }
}

3. 字库制作

使用工具（如PCtoLCD2002）生成ASCII字符点阵，保存为数组：

// 6x8 ASCII字库示例
const uint8_t font_6x8[][6] = {
    {0x00,0x00,0x00,0x00,0x00,0x00}, // 空格
    {0x00,0x00,0x5F,0x00,0x00,0x00}, // !
    // ... 其他字符
    {0x7C,0x12,0x11,0x12,0x7C,0x00}  // A
};

4. 主函数调用

#include "oled.h"

int main(void) {
    HAL_Init();
    SystemClock_Config();
    MX_I2C1_Init();
    OLED_Init();
    OLED_DisplayString(0, 0, "Hello STM32F446!");
    while(1) {}
}

5. 调试技巧

• I2C地址错误：尝试 0x78 或 0x7A。
• 无显示：检查电源、I2C波形（逻辑分析仪）。
• 花屏：检查初始化序列是否正确。
• 内存优化：使用OLED_UpdateScreen()局部刷新减少数据量。

6. 扩展功能

• 绘制图形：实现画点、画线函数。
• 显示图片：将图片转换为位图数组。
• 动画效果：局部刷新+双缓冲。

通过以上步骤，即可在STM32F446上驱动OLED显示文本和图形。