Proteus仿真STM32驱动OLED：软件I2C与SSD1306驱动详解

1. 项目概述：为什么选择Proteus仿真OLED？

很多刚接触STM32的朋友，尤其是学生或者自学者，常常会卡在第一步：硬件。买一块开发板、一块OLED屏幕、一堆杜邦线，听起来简单，但真到动手时，要么是焊接出了问题，要么是接线虚连导致通信失败，要么是屏幕本身就有暗病。折腾半天，代码还没开始写，信心先被硬件“劝退”了一半。我自己带学生做项目时，也经常遇到这种情况，明明程序逻辑都对，但屏幕就是不亮，最后发现是I2C的上拉电阻没接，或者SDA、SCL线接反了。

这就是为什么在入门阶段，尤其是在“零基础”这个前提下，我强烈推荐使用Proteus进行无实物仿真。Proteus ISIS这个软件，它本质上是一个虚拟的电子实验室。你不需要任何真实的单片机、屏幕、电阻电容，只需要在电脑上拖拽元件、连接电路、编写程序，就能看到近乎真实的运行效果。对于学习STM32的GPIO、定时器、中断，特别是像I2C这种有严格时序的通信协议，仿真环境提供了一个“零风险”、“可反复试错”的绝佳平台。你可以在几分钟内搭建好电路，立刻验证你的代码，把精力完全集中在理解单片机的工作原理和编程逻辑上，而不是和一堆物理连接较劲。

本次我们要实现的目标，就是在Proteus中，用STM32F103C8（也就是常说的“蓝桥杯”或“最小系统板”核心芯片）驱动一块0.96英寸的OLED显示屏（SSD1306驱动芯片），并通过I2C接口进行通信。我会带你从零开始，一步步完成电路搭建、软件配置、代码编写和调试，让你彻底搞懂STM32的I2C是如何“说话”，以及OLED屏幕是如何“听话”并显示内容的。整个过程，你只需要一台安装了Keil MDK（或STM32CubeIDE）和Proteus 8 Professional的电脑。

2. 核心元件与仿真电路搭建

在Proteus里“造”东西，第一步就是找到对的“零件”。和真实世界一样，用错了芯片，电路图画得再漂亮也没用。

2.1 关键仿真元件清单与搜索技巧

打开Proteus ISIS，点击左侧工具栏的“P”按钮（Pick Devices），进入元件库。根据我们的目标，你需要找到以下核心元件：

1. 单片机：在Keywords中输入STM32F103C8。注意，Proteus的元件库版本不同，包含的STM32型号也不同。如果找不到F103C8，可以尝试搜索STM32F103C6或更通用的STM32F103，它们内核相同，外设略有差异，但用于本实验的GPIO和I2C1是通用的。我使用的是 “STM32F103C6” 元件，它和C8引脚兼容，完全够用。

2. OLED显示屏：这是重点。SSD1306驱动的OLED在Proteus中有专用模型。关键词可以搜OLED或SSD1306。你应该能找到名为 “OLED 128x64” 或 “SSD1306 0.96” 的元件。我使用的是 “OLED 128x64-I2C” 这个模型，它已经将I2C通信接口集成好了，我们只需要连接SDA和SCL两根线即可，非常方便。

3. 电阻：用于I2C总线的上拉。搜索RES选择普通电阻。阻值通常选用4.7kΩ或10kΩ。在仿真中，这个阻值要求不严格，但必须有，否则I2C总线无法拉高，通信会失败。

4. 电源和地：搜索TERMINAL， 选择 “DEFAULT” 终端作为电源（VCC， 接3.3V）和地（GND）。

5. 虚拟仪器（可选但推荐）：为了更直观地调试I2C时序，可以添加一个虚拟I2C调试器。搜索I2C DEBUGGER， 把它也挂到SDA和SCL线上。这样在仿真运行时，你可以像使用逻辑分析仪一样，看到总线上传输的每一个数据包、地址和ACK/NACK信号，对理解协议有巨大帮助。

一个实用技巧：如果你在库中找不到某个元件（比如特定的STM32型号），不要慌。Proteus支持用功能相近的元件替代。例如，用F103C6代替C8；对于OLED，只要确认是SSD1306驱动且支持I2C接口即可。也可以在网上搜索 “Proteus 元件库” 进行补充安装，但作为入门，使用软件自带库是最稳妥的。

2.2 电路连接图与关键细节解析

找到元件后，把它们拖放到图纸上，开始连线。电路原理图非常简单，但有几个细节必须注意：

+3.3V | | 4.7kΩ | | SDA -------------- PA2 (STM32F103C6) | | 4.7kΩ | | | | SCL -------------- PA1 (STM32F103C6) | | | | GND VCC GND SDA SCL | | | | | ------|-----|-----|-----|---- | | | | OLED 128x64 (I2C)

连接步骤与要点：

1. STM32电源：将STM32的VDD(引脚44， 具体请参考你选择的元件数据表) 连接至+3.3V，VSS(引脚43) 连接至GND。这是单片机工作的基础。
2. OLED电源：将OLED元件的VCC和GND引脚也分别连接到+3.3V和GND。务必确保STM32和OLED使用相同的参考地（GND），这是所有通信的电压基准。
3. I2C总线连接：
   • SDA（数据线）：连接OLED的SDA引脚到STM32的一个GPIO引脚，例如PA2。
   • SCL（时钟线）：连接OLED的SCL引脚到STM32的另一个GPIO引脚，例如PA1。
   • 为什么选PA1和PA2？在STM32F103上，I2C1的默认引脚是PB6(SCL)和PB7(SDA)。但在仿真中，我们可以灵活重映射。选择PA1和PA2只是为了布线方便，在代码中我们需要通过软件模拟I2C（Software I2C）或重映射硬件I2C来控制它们。对于入门，我强烈建议从软件模拟I2C开始，因为它不依赖特定的硬件引脚和复杂的寄存器配置，理解起来更直观。所以我们实际上是把PA1和PA2当作普通GPIO来模拟SCL和SDA的时序。
4. 上拉电阻：这是I2C总线正常工作的关键！在SDA和SCL线上，分别连接一个4.7kΩ的电阻到+3.3V。在Proteus中，电阻的一端接总线，另一端接电源终端。I2C总线是“开漏输出”结构，这意味着单片机只能把线拉低（输出0），而不能主动拉高（输出1）。总线的高电平是靠这两个上拉电阻将电压拉至VCC的。如果没有上拉电阻，总线将永远处于不确定状态，通信必然失败。
5. 虚拟I2C调试器：将调试器的SDA和SCL引脚也并联到总线上，GND接系统GND。这样它就能监听所有通信。

注意：在真实的硬件电路中，STM32的I2C引脚内部可能有弱上拉，但通常不足以驱动较长的导线或多个设备，因此外接上拉电阻是标准做法。在仿真中，这个电阻模型是必须的，否则Proteus的I2C模型无法正确识别高电平。

电路搭好后，你的Proteus图纸应该有一个STM32、一个OLED、两个电阻、电源、地，以及一个可选的调试器，所有连线清晰无误。接下来，我们就要让这个“虚拟大脑”STM32开始思考和工作了。

3. 软件开发环境配置与工程创建

电路是躯体，程序是灵魂。我们需要在Keil MDK（这里以Keil uVision5为例）中创建一个STM32工程，并编写驱动代码。

3.1 Keil工程创建与基础配置

1. 新建工程：打开Keil，点击Project -> New uVision Project...。选择一个空文件夹，为工程命名，例如STM32_OLED_I2C。
2. 选择设备：在弹出的设备选择窗口中，找到STMicroelectronics->STM32F1 Series->STM32F103->STM32F103C8（确保和你Proteus中使用的型号一致或兼容）。点击OK。
3. 管理运行时环境（RTE）：接着会弹出“Manage Run-Time Environment”窗口。对于软件模拟I2C，我们不需要复杂的HAL库或标准外设库，为了保持简洁和深入理解，我们选择“不使用软件包”，直接关闭这个窗口。我们将从底层寄存器或简单的宏定义开始。
4. 添加启动文件：对于STM32F103C8，你需要手动添加启动文件。通常，你可以在STM32CubeMX安装目录或从标准外设库中找到名为startup_stm32f103xb.s的汇编启动文件。将它复制到你的工程目录下，然后在Keil工程窗口中，右键点击Target 1->Add Existing Files to Group...， 选择这个.s文件添加进去。
5. 创建主程序文件：在工程中新建一个main.c文件。这是你编写代码的地方。

3.2 软件模拟I2C底层驱动编写

既然我们用了普通的PA1和PA2引脚来模拟I2C，那么首先就要定义这两个引脚，并实现最基本的GPIO控制函数，以及I2C的起始、停止、发送应答等时序函数。

// main.c #include "stm32f10x.h" // 包含STM32F10x系列的头文件，定义了寄存器地址 // 宏定义：方便修改引脚和端口 #define OLED_I2C_SDA_PORT GPIOA #define OLED_I2C_SDA_PIN GPIO_Pin_2 #define OLED_I2C_SCL_PORT GPIOA #define OLED_I2C_SCL_PIN GPIO_Pin_1 // 延时函数（粗略延时，用于模拟时序） void Delay_us(uint32_t nus) { while(nus--) { for(int i=0; i<8; i++); // 这个循环次数需要根据你的系统时钟调整，仿真中要求不精确 } } // GPIO初始化：将SDA和SCL引脚设置为开漏输出模式 void I2C_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; // 开启GPIOA时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); // 配置SDA和SCL为开漏输出，这样引脚可以输出低电平，也能被外部上拉电阻拉高，实现“线与” GPIO_InitStructure.GPIO_Pin = OLED_I2C_SDA_PIN | OLED_I2C_SCL_PIN; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_OD; // 开漏输出 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(OLED_I2C_SDA_PORT, &GPIO_InitStructure); // 初始状态释放总线（输出高电平，由上拉电阻拉高） GPIO_SetBits(OLED_I2C_SDA_PORT, OLED_I2C_SDA_PIN); GPIO_SetBits(OLED_I2C_SCL_PORT, OLED_I2C_SCL_PIN); } // 产生I2C起始信号：SCL高电平期间，SDA产生一个下降沿 void I2C_Start(void) { SDA_OUT(); // 设置SDA为输出模式（宏或函数，需自行实现，本质是配置GPIO为输出） I2C_SDA_HIGH(); I2C_SCL_HIGH(); Delay_us(5); // 保持时间 I2C_SDA_LOW(); Delay_us(5); I2C_SCL_LOW(); // 钳住总线，准备发送数据 } // 产生I2C停止信号：SCL高电平期间，SDA产生一个上升沿 void I2C_Stop(void) { SDA_OUT(); I2C_SDA_LOW(); Delay_us(5); I2C_SCL_HIGH(); Delay_us(5); I2C_SDA_HIGH(); Delay_us(5); } // 等待应答信号：发送完一个字节后，主机释放SDA（设置为输入），并检测在第9个时钟周期内，SDA是否被从机拉低 uint8_t I2C_Wait_Ack(void) { uint8_t ack = 0; SDA_IN(); // 设置SDA为输入模式 I2C_SDA_HIGH(); // 主机释放SDA线 Delay_us(1); I2C_SCL_HIGH(); Delay_us(1); if(GPIO_ReadInputDataBit(OLED_I2C_SDA_PORT, OLED_I2C_SDA_PIN) == 0) { ack = 1; // SDA为低，表示收到应答 } else { ack = 0; // SDA为高，表示无应答 } I2C_SCL_LOW(); SDA_OUT(); // 恢复SDA为输出，为下次发送做准备 return ack; }

以上是软件I2C最核心的几个时序函数。你需要补充SDA_OUT()、SDA_IN()、I2C_SDA_HIGH/LOW、I2C_SCL_HIGH/LOW这些宏或函数，它们本质上就是对GPIO寄存器进行置位和清零操作。例如：

#define I2C_SDA_LOW() GPIO_ResetBits(OLED_I2C_SDA_PORT, OLED_I2C_SDA_PIN) #define I2C_SDA_HIGH() GPIO_SetBits(OLED_I2C_SDA_PORT, OLED_I2C_SDA_PIN)

SDA_OUT/IN则需要切换GPIO的配置寄存器，稍微复杂一些，但对于理解GPIO模式切换很有帮助。

4. SSD1306 OLED驱动芯片指令与数据发送

我们的STM32现在有了“说话”（I2C通信）的能力，接下来要学习对OLED屏幕（SSD1306）“说什么”。SSD1306有两种操作：发送命令（配置屏幕）和发送数据（显示内容）。

4.1 I2C设备地址与通信格式

首先，要找到设备的“门牌号”——I2C设备地址。对于大多数0.96寸OLED，SSD1306的I2C地址是0x78（7位地址，如果算上读写位，写地址是0x78，读地址是0x79）。但请注意，这个地址可能因屏幕厂商而异，常见的是0x78或0x7A。在Proteus的OLED模型属性中，通常可以查看或设置其I2C地址，请确保与代码一致。

I2C通信一次传输的基本单位是一个字节。对于SSD1306，每次传输以一个“控制字节”开始，用来区分接下来发送的是命令还是数据。

• 控制字节 =0x00： 表示后续的一个或多个字节是命令。
• 控制字节 =0x40： 表示后续的一个或多个字节是显示数据，这些数据会被存入SSD1306的GDDRAM（图形显示数据RAM）中，最终点亮对应的像素。

因此，一次完整的I2C传输帧结构如下：

起始信号 -> [设备写地址(0x78)] -> 等待应答 -> [控制字节(0x00或0x40)] -> 等待应答 -> [字节1] -> 等待应答 -> [字节2] -> 等待应答 -> ... -> 停止信号

4.2 核心初始化命令序列详解

要让OLED正常工作，必须在上电后发送一系列初始化命令。这些命令设置了对比度、扫描方向、显示开关等。下面是一个典型的初始化序列，我会解释关键命令的作用：

void OLED_Init(void) { Delay_ms(200); // 上电后等待屏幕稳定 // 发送一系列初始化命令 OLED_Write_Cmd(0xAE); // 关闭显示（Display OFF） OLED_Write_Cmd(0xD5); // 设置显示时钟分频比/振荡器频率 OLED_Write_Cmd(0x80); // 建议值 OLED_Write_Cmd(0xA8); // 设置多路复用率（Multiplex Ratio） OLED_Write_Cmd(0x3F); // 对于128x64的屏幕，值为63 (0x3F) OLED_Write_Cmd(0xD3); // 设置显示偏移（Display Offset） OLED_Write_Cmd(0x00); // 无偏移 OLED_Write_Cmd(0x40); // 设置显示起始行（Set Display Start Line）为0 OLED_Write_Cmd(0x8D); // 电荷泵设置（Charge Pump Setting） OLED_Write_Cmd(0x14); // 使能电荷泵（必须，否则屏幕不亮） OLED_Write_Cmd(0x20); // 设置内存地址模式（Set Memory Addressing Mode） OLED_Write_Cmd(0x00); // 水平地址模式（Horizontal Addressing Mode） OLED_Write_Cmd(0xA1); // 段重映射设置（Set Segment Re-map），A1为列地址127映射到SEG0 OLED_Write_Cmd(0xC8); // 扫描方向设置（COM Output Scan Direction），C8为从COM63到COM0扫描 OLED_Write_Cmd(0xDA); // 设置COM引脚硬件配置（Set COM Pins Hardware Configuration） OLED_Write_Cmd(0x12); // 对于128x64，通常为0x12 OLED_Write_Cmd(0x81); // 设置对比度控制（Set Contrast Control） OLED_Write_Cmd(0xCF); // 对比度值，可调范围0x00~0xFF OLED_Write_Cmd(0xD9); // 设置预充电周期（Set Pre-charge Period） OLED_Write_Cmd(0xF1); // 建议值 OLED_Write_Cmd(0xDB); // 设置VCOMH电压倍率（Set VCOMH Deselect Level） OLED_Write_Cmd(0x40); // 建议值 OLED_Write_Cmd(0xA4); // 关闭整体显示开启（Disable Entire Display On） OLED_Write_Cmd(0xA6); // 设置正常显示（Set Normal Display，非反色） OLED_Write_Cmd(0xAF); // 开启显示（Display ON） }

关键命令解析：

• 0xAE/AF： 显示开关。初始化时先关显示，配置完再打开，避免中间出现乱码。
• 0x8D, 0x14：电荷泵使能。这是最关键的命令之一！SSD1306需要较高的电压驱动OLED像素，电荷泵是一个内部升压电路。如果不发送这个命令，屏幕可能完全无显示或非常暗。很多初学者调不通屏幕，问题就出在这里。
• 0x20, 0x00： 设置寻址模式。我们常用水平寻址模式，这样在连续写入数据时，列地址会自动递增，换行也自动处理，方便全屏刷新。
• 0xA1, 0xC8： 控制显示方向。A1和C8的组合是常见的“正向”显示。如果你发现显示的内容是镜像或颠倒的，可以尝试修改这两个值（A0和C0）。
• 0x81, 0xCF： 对比度设置。如果屏幕显示过亮或过暗，可以调整这个值。

OLED_Write_Cmd函数的实现，就是组合前面写好的I2C底层函数：

void OLED_Write_Cmd(uint8_t cmd) { I2C_Start(); I2C_Send_Byte(0x78); // 发送设备地址（写） I2C_Wait_Ack(); I2C_Send_Byte(0x00); // 发送控制字节，表示是命令 I2C_Wait_Ack(); I2C_Send_Byte(cmd); // 发送具体的命令字节 I2C_Wait_Ack(); I2C_Stop(); }

OLED_Write_Data函数与之类似，只是将控制字节0x00替换为0x40。

5. 显示缓存管理与基础图形绘制

OLED屏幕本身不带显存，我们发送的数据直接写入其内部的GDDRAM。这块RAM可以看作一个二维位图，每一位对应屏幕上的一个像素（1点亮，0熄灭）。对于128x64的屏幕，其GDDRAM组织方式通常以“页”（Page）为单位，每页8行像素（即一个字节的8个bit），共8页（64/8=8）。水平方向有128列。

5.1 建立本地显存与更新机制

为了高效地操作屏幕（比如局部更新、绘制复杂图形），我们通常在单片机内存中开辟一块同样大小的缓冲区（OLED_GRAM[8][128]），所有绘图操作都先在这个缓冲区中进行，完成后再一次性将整个缓冲区刷新到屏幕。这避免了频繁的、零碎的I2C通信，提高了效率，也消除了闪烁。

uint8_t OLED_GRAM[8][128]; // 全局显示缓冲区，8页，每页128列 // 全屏更新函数：将OLED_GRAM缓冲区的内容全部发送到OLED void OLED_Refresh(void) { for (uint8_t page = 0; page < 8; page++) { // 1. 设置页地址（0xB0 ~ 0xB7） OLED_Write_Cmd(0xB0 + page); // 2. 设置列地址的低4位和高4位（水平寻址模式下，设置起始列为0） OLED_Write_Cmd(0x00); // 设置列地址低4位为0 OLED_Write_Cmd(0x10); // 设置列地址高4位为0 // 3. 连续发送这一页的128个字节数据 for (uint8_t col = 0; col < 128; col++) { OLED_Write_Data(OLED_GRAM[page][col]); } } } // 清屏函数：将缓冲区全部填0，并刷新屏幕 void OLED_Clear(void) { for (uint8_t i = 0; i < 8; i++) { for (uint8_t j = 0; j < 128; j++) { OLED_GRAM[i][j] = 0x00; } } OLED_Refresh(); }

5.2 画点函数：一切图形显示的基础

所有复杂的图形、文字，归根结底都是操作一个个像素点。因此，实现一个高效的画点函数是核心。

// 在指定坐标(x,y)画点，color: 1-点亮，0-熄灭 void OLED_DrawPoint(uint8_t x, uint8_t y, uint8_t color) { if (x >= 128 || y >= 64) return; // 边界检查 uint8_t page = y / 8; // 计算点在哪一页（0~7） uint8_t bit_pos = y % 8; // 计算点在该页的哪一位（0~7） if (color) { OLED_GRAM[page][x] |= (1 << bit_pos); // 将对应位置1 } else { OLED_GRAM[page][x] &= ~(1 << bit_pos); // 将对应位置0 } // 注意：这里没有立即刷新屏幕，只更新了缓冲区。需要调用OLED_Refresh()才能显示。 }

这个函数理解起来不难，但有一个极易出错的地方：坐标系统。x是列，范围0~127；y是行，范围0~63。而GDDRAM是按页组织的，每页8行。所以y=10的点，位于第page = 10/8 = 1页（即第二页），在该页的bit_pos = 10%8 = 2（即字节的bit2，从0开始计数）。很多显示错位、文字断裂的问题，都源于此处的计算错误。

有了画点函数，我们就可以在此基础上构建画线、画矩形、画圆等函数，以及最重要的——显示字符和汉字。

6. 字库提取与字符显示实战

OLED本身不含字库，显示任何字符都需要我们提供点阵数据。这就需要用到“取模软件”。

6.1 使用PCtoLCD2002进行字模提取

PCtoLCD2002是一款经典的字模提取软件。以显示一个16x16像素的汉字“中”为例：

1. 设置参数：打开软件，选择“字符模式”。设置宽度16，高度16。取消“阴码”、“逐列式”、“逆向”等选项（这是为了匹配我们常见的取模方式）。通常选择“逐行式”扫描，输出格式为“C51格式”。
2. 输入汉字：在输入框输入“中”，点击“生成字模”。
3. 得到数组：你会得到类似下面这样的数组，共32个字节（16行 * 16列 / 8位每字节 = 32字节）：

   /*-- 文字: 中 --*/ /*-- 宋体16; 此字体下对应的点阵为：宽x高=16x16 --*/ 0x00,0x80,0x00,0x80,0xFC,0x80,0x04,0x80,0x04,0xFC,0x04,0x84,0x04,0x84,0xFC,0x84, 0x04,0x84,0x04,0x84,0x04,0xFC,0x04,0x80,0x04,0x80,0xFC,0x80,0x00,0x80,0x00,0x00

   这32个字节，每两个字节代表一行（16列）。第一个字节是左半部分8列，第二个字节是右半部分8列。

6.2 编写通用字符显示函数

我们需要一个函数，能够将取模得到的数组，正确地绘制到缓冲区的指定位置。

// 在指定位置显示一个16x16的汉字 // x,y: 左上角坐标 // ch: 指向字模数组的指针 void OLED_ShowChinese(uint8_t x, uint8_t y, const uint8_t *ch) { uint8_t i, j; for (j = 0; j < 16; j++) { // 遍历16行 for (i = 0; i < 2; i++) { // 每行2个字节 uint8_t temp = ch[j * 2 + i]; for (uint8_t k = 0; k < 8; k++) { // 遍历一个字节的8个bit if (temp & (0x80 >> k)) { // 从最高位开始判断 OLED_DrawPoint(x + i * 8 + k, y + j, 1); } else { OLED_DrawPoint(x + i * 8 + k, y + j, 0); } } } } } // 显示一个8x16的ASCII字符（类似16x16的一半） void OLED_ShowChar(uint8_t x, uint8_t y, char chr) { // 假设有一个ASCII字库数组 asc2_8x16[]，每个字符16字节 const uint8_t *p = &asc2_8x16[(chr - ' ') * 16]; // 计算字符在字库中的偏移 for (uint8_t j = 0; j < 16; j++) { // 16行 uint8_t temp = p[j]; for (uint8_t k = 0; k < 8; k++) { // 每行8列 if (temp & (0x80 >> k)) { OLED_DrawPoint(x + k, y + j, 1); } } } } // 显示字符串 void OLED_ShowString(uint8_t x, uint8_t y, const char *str) { uint8_t x_offset = x; while (*str != '\0') { OLED_ShowChar(x_offset, y, *str); x_offset += 8; // 字符宽度为8，留1像素间距可改为 += 9 str++; } }

在主函数中，你可以这样调用：

int main(void) { // ... 初始化GPIO、I2C、OLED OLED_Clear(); // 显示汉字 OLED_ShowChinese(0, 0, Chinese_16x16_Zhong); // “中”的字模数组 OLED_ShowChinese(16, 0, Chinese_16x16_Wen); // “文” // 显示字符串 OLED_ShowString(0, 20, "Hello, OLED!"); OLED_ShowString(0, 40, "I2C Test OK."); // 刷新到屏幕 OLED_Refresh(); while(1) { // 主循环 } }

7. Proteus仿真联调与问题排查

代码写好了，电路也画好了，最激动人心的联调时刻到了。这一步也是问题集中爆发的地方。

7.1 生成Hex文件与加载到Proteus

1. 编译工程：在Keil中，确保所有代码无误，点击Build(F7) 编译。在下方Build Output窗口看到“0 Error(s), 0 Warning(s)”。
2. 配置输出：点击Options for Target(魔术棒图标) ->Output选项卡。勾选Create HEX File。这样编译后会生成一个.hex文件，这是单片机的可执行文件。
3. 找到Hex文件：该文件通常位于工程目录下的Objects文件夹里，名为工程名.hex。
4. 加载到Proteus：回到Proteus，双击原理图中的STM32芯片，会弹出属性编辑窗口。在Program File一栏，点击文件夹图标，找到并选择刚才生成的.hex文件。在Clock Frequency一栏，输入8M（或根据你的代码配置填写，STM32F103C8默认外部晶振是8MHz）。点击OK。
5. 开始仿真：点击Proteus左下角的运行按钮（三角形）。如果一切配置正确，你应该能看到OLED屏幕上显示出你程序里设定的文字！

7.2 常见仿真问题与深度排查

如果屏幕一片漆黑，别着急，这是学习过程的一部分。我们可以按照以下链路系统排查：

问题1：Proteus仿真直接报错或STM32不运行。

• 检查Hex文件路径：确保路径中没有中文或特殊字符。最好将Hex文件复制到工程根目录再加载。
• 检查晶振频率：在Proteus中设置的Clock Frequency必须和代码中SystemInit()函数（或你配置的系统时钟）期望的频率一致。如果不一致，延时函数会不准，可能导致I2C时序错误。在入门阶段，可以暂时在Keil中不配置复杂的时钟树，使用默认的内部RC振荡器（HSI， 8MHz），并在Proteus中也设置为8M。
• 检查启动文件：确保工程中添加了正确的启动文件（.s文件）。没有它，程序无法从复位向量开始执行。

问题2：程序运行，但OLED无任何显示（背光可能亮，但无内容）。

• 这是最常见的情况。首先，打开我们之前添加的I2C Debugger。运行仿真后，右键点击它，选择“Digital Oscilloscope”。
• 观察波形：你应该能看到SCL线上有规律的时钟脉冲，SDA线上有对应的数据变化。如果没有波形，说明I2C通信根本没启动。
  • 无波形：检查代码中I2C_Start()函数是否被调用。检查I2C_GPIO_Init()中是否将引脚正确初始化为开漏输出并拉高。重中之重：检查原理图中SDA和SCL线上是否接了上拉电阻到VCC！这是仿真中最容易遗漏的一步。
  • 有波形但地址不对：在示波器或调试器的数据窗口中，查看主机发送的第一个字节（设备地址）。应该是0x78（写地址）。如果不是，检查代码中I2C_Send_Byte(0x78)这部分。
  • 有波形，地址正确，但无后续数据：检查从机是否发送了ACK（应答）。在波形上，主机发送完地址字节后的第9个时钟周期，SDA线应该被从机（OLED）拉低。如果SDA保持高电平（NACK），说明从机未应答。可能原因：I2C地址错误、OLED屏幕模型未上电（检查VCC和GND）、OLED模型本身有问题（尝试更换另一个OLED模型，如OLED 128x64不带I2C后缀的，并注意其属性中的地址配置）。
• 检查初始化命令：如果I2C通信有应答，但屏幕不亮，极大概率是初始化命令序列有问题，特别是电荷泵命令0x8D, 0x14没有发送或发送错误。仔细核对OLED_Init()函数中的每一个命令值。可以尝试注释掉其他命令，只发送0xAE,0x8D,0x14,0xAF这三个最基本的命令（关显示、开电荷泵、开显示），看屏幕是否亮起（全亮或全暗）。如果亮了，再逐步添加其他命令。

问题3：屏幕有显示，但内容乱码、错位或镜像。

• 内容错位：检查画点函数OLED_DrawPoint中的坐标计算，特别是页（page）和位（bit_pos）的计算逻辑。检查显示字符串/汉字函数中的坐标递增逻辑。
• 内容镜像或颠倒：检查初始化命令中的0xA1（段重映射）和0xC8（COM扫描方向）。将它们分别改为0xA0和0xC0试试，这会将显示进行水平或垂直翻转。
• 对比度问题：显示过淡或过深，调整初始化命令0x81后面的对比度值（0xCF）。

问题4：显示闪烁或刷新慢。

• 这是因为你在每次画点后都调用了OLED_Refresh()（全屏刷新）。正确的做法是：所有绘图操作都在缓冲区OLED_GRAM中进行，等一帧画面全部绘制完成（比如一句文字显示完），再调用一次OLED_Refresh()。这能极大提升刷新效率。

一个高效的调试习惯：在代码中，将初始化序列分阶段进行，并在每个阶段后添加一个明显的显示内容（比如第一阶段后显示“Init Step1”），这样在仿真时就能知道程序执行到哪一步卡住了。

8. 项目总结与进阶思考

通过这个完整的项目，我们从零开始在Proteus中搭建了一个STM32驱动OLED的仿真环境。这个过程看似只是让屏幕显示几个字，但实际上，你已亲自动手实践了以下关键技能：

1. Proteus仿真电路设计：理解了无实物开发的基本流程，学会了查找元件、连接电路、设置关键参数（如上拉电阻）。
2. 软件模拟I2C协议：从GPIO操作层面，深刻理解了I2C的起始、停止、应答、数据发送等时序，这是理解任何同步串行通信协议的基础。
3. STM32 GPIO配置：掌握了开漏输出模式的原理与应用场景，知道了为什么I2C总线需要外加上拉。
4. 设备驱动开发：学会了查阅SSD1306数据手册（命令集），并能够根据手册编写初始化代码和基本驱动函数。
5. 显示缓冲机制：建立了“后台缓冲区+全屏刷新”的高效显示模型，这是图形界面编程的常见思想。
6. 字模提取与显示：了解了点阵字库的原理，并能使用工具生成字模，实现任意图形的显示。
7. 系统调试能力：学会了使用Proteus的虚拟仪器（如I2C调试器）来诊断通信问题，形成了“观察现象 -> 定位模块 -> 检查代码/电路 -> 验证”的排查思路。

这个项目是一个坚实的起点。基于此，你可以进行大量的扩展：

• 显示动态内容：在while(1)循环中不断更新缓冲区内容并刷新，实现动画、滚动字幕、实时数据（如模拟传感器数值）显示。
• 移植到硬件：当你用仿真调通所有代码后，将其移植到真实的STM32开发板和OLED屏幕上，成功率会非常高。只需要注意将软件I2C的引脚定义改为你硬件上实际连接的引脚，并确保物理上连接了上拉电阻。
• 使用硬件I2C：尝试使用STM32内部的硬件I2C外设来驱动OLED。这需要配置复杂的寄存器或使用库函数（如标准库或HAL库），但效率更高，能释放CPU资源。你会遇到硬件I2C的“卡死”等问题，这又是另一个值得深入学习的课题。
• 构建简单GUI：利用画点、画线、画矩形函数，可以构建更复杂的用户界面，如菜单、进度条、图表等。

仿真学习的最大优势在于容错成本极低。你可以大胆地修改I2C时序中的延时，观察通信如何失败；可以故意写错一个命令，看看屏幕有何反应。这种即时反馈，对于建立扎实的底层硬件理解至关重要。希望这篇超详细的教程能帮你扫清入门路上的障碍，真正理解STM32与外围设备通信的奥秘。