1. 项目缘起为什么要在STM32上用软件模拟I2C在嵌入式开发中I2CInter-Integrated Circuit总线因其简洁的两线制SDA数据线、SCL时钟线和多主多从的架构成为了连接各类传感器、EEPROM、RTC等外设的经典选择。STM32系列MCU几乎都配备了硬件I2C外设按理说直接调用HAL库的HAL_I2C_Master_Transmit等函数应该是最省事、最高效的方案。但现实往往比理想骨感很多开发者包括我自己在内都曾遇到过硬件I2C的“玄学”问题通信不稳定、在某些特定从设备上卡死、中断/DMA配置复杂尤其是在项目初期调试阶段硬件I2C的时序问题常常让人抓狂。这就是软件模拟I2CSoftware I2C或Bit-Banging I2C的价值所在。它不依赖MCU的硬件I2C外设而是通过程序控制任意两个通用输入输出GPIO引脚的电平高低和时序来模拟出标准的I2C通信波形。听起来像是开倒车但实际上在以下场景中软件模拟方案往往是更优甚至唯一的选择硬件资源冲突你的MCU硬件I2C引脚可能已经被其他功能如USB、CAN占用或者PCB布线已经固定无法更改。软件模拟可以让你使用任意空闲的GPIO灵活性极高。调试与排错当硬件I2C通信失败时你很难直观地看到底层的时序波形。而软件模拟的代码完全由你控制你可以在任意位置插入调试语句、翻转测试引脚或者用逻辑分析仪观察你“制造”的波形从而精准定位问题是出在起始信号、应答位还是数据位上。这对于理解I2C协议本身也大有裨益。兼容“非标”设备有些从设备特别是一些老旧的或成本极低的芯片的I2C时序可能不完全符合标准比如SCL低电平时间、数据建立保持时间比较特殊。硬件I2C的时序通常由寄存器固定配置调整范围有限。而软件模拟可以让你微调每一个延时轻松适配这些“非标”设备。多路I2C需求STM32的硬件I2C外设数量有限通常1-3个。如果你需要连接超过这个数量的I2C设备软件模拟可以轻松扩展出“第N路”I2C只需多分配一对GPIO即可。基于HAL库来实现软件模拟I2C则是结合了灵活性与便捷性。HAL库提供了统一的GPIO操作接口HAL_GPIO_WritePin,HAL_GPIO_ReadPin和精准的延时函数HAL_Delay或更精确的DWT延时让我们可以专注于I2C协议的逻辑而无需深入底层寄存器。接下来我将分享一套经过多个项目验证、稳定可靠的HAL库软件模拟I2C实现方案并深入每一个细节。2. 软件模拟I2C的核心时序精准控制软件模拟I2C的本质就是用代码“画”出符合I2C协议规范的波形图。因此理解并精确控制时序是成败的关键。I2C协议有标准模式100kHz、快速模式400kHz和高速模式3.4MHz等。对于软件模拟我们通常瞄准标准模式或快速模式。2.1 关键时序参数解析首先我们必须弄清楚I2C总线在传输一个比特Bit时需要满足的几个关键时间参数。下图是一个典型的数据传输时序以标准模式为例SDA ___ ... SCL _____| |_____________________| |______ | | | | | | | | | | | | | Start Bit7 ... Bit0 ACK Stop起始条件S与停止条件P当SCL为高电平时SDA一个从高到低的跳变是起始条件一个从低到高的跳变是停止条件。这是总线状态切换的标志。数据有效性在SCL线为高电平期间SDA线上的数据必须保持稳定。SDA线上的数据只能在SCL线为低电平期间改变。建立时间t_SU;DAT与保持时间t_HD;DAT这是最容易被忽略也最容易出错的地方。建立时间 t_SU;DAT在SCL上升沿到来之前数据线SDA上的数据必须已经稳定保持一段时间。标准模式下最小为100ns。保持时间 t_HD;DAT在SCL下降沿之后数据线SDA上的数据还必须继续保持稳定一段时间。标准模式下最小为0ns对于总线器件但通常我们也会留一点余量。时钟低电平周期t_LOW与高电平周期t_HIGH它们共同决定了SCL的频率。例如对于100kHz周期为10us通常高低电平各占约5us。对于软件模拟我们无法做到纳秒级的精确控制但可以通过微秒us级的延时来满足时序要求。关键在于我们的延时必须大于协议规定的最小值同时尽量接近目标周期以保证通信速率和可靠性。2.2 基于HAL_Delay的微秒级延时实现HAL库提供的HAL_Delay()函数是基于SysTick中断的毫秒ms级延时对于I2C通信来说太慢了。我们必须自己实现一个微秒us级的延时函数。这里推荐两种常见方法方法一使用DWTData Watchpoint and Trace单元周期计数器这是最精确的方法但需要MCU支持DWT。在STM32F1/F4等系列上通常可用。// 初始化DWT在系统初始化后调用一次 void DWT_Init(void) { if (!(CoreDebug-DEMCR CoreDebug_DEMCR_TRCENA_Msk)) { CoreDebug-DEMCR | CoreDebug_DEMCR_TRCENA_Msk; } DWT-CYCCNT 0; DWT-CTRL | DWT_CTRL_CYCCNTENA_Msk; } // 微秒延时函数 void delay_us(uint32_t us) { uint32_t start_tick DWT-CYCCNT; uint32_t delay_ticks us * (SystemCoreClock / 1000000); // 将us转换为CPU周期数 while ((DWT-CYCCNT - start_tick) delay_ticks) { // 空循环等待 } }方法二使用定时器配置一个基本定时器使其每1us产生一次更新然后在延时函数中查询计数。这种方法占用一个定时器资源但通用性更好。方法三简易NOP循环不推荐用于精确时序对于时序要求不极端严格如100kHz标准模式且CPU主频已知且固定时可以用汇编NOP指令或空循环来估算。这种方法受编译器优化和中断影响大稳定性差。在本方案中我们假设使用DWT延时法因为它不占用外设且精度高。后续所有delay_us调用均基于此。2.3 GPIO模式配置开漏输出与上拉电阻I2C总线是一个“线与”逻辑这意味着任何设备都可以将总线拉低输出0但释放总线时输出1需要依靠外部上拉电阻将电平拉高。因此GPIO的配置至关重要。SDA线必须配置为开漏输出模式Open-Drain并启用内部或外部上拉电阻。输出0时MCU内部MOS管导通将引脚强制拉低到GND。输出1时MCU内部MOS管关闭引脚呈现高阻态由上拉电阻将电压拉至高电平。同时为了读取从机的应答信号或数据我们还需要能够读取SDA线的电平。在开漏模式下直接读取输入数据寄存器是可行的因为当引脚输出1高阻态时实际电平由上拉电阻和总线上的其他设备决定。在HAL库中我们可以动态切换SDA引脚的方向但更常见的做法是始终将SDA配置为开漏输出模式。当需要读取时我们先让MCU输出“1”即释放总线然后调用HAL_GPIO_ReadPin读取实际电平。这是一个关键技巧。SCL线通常也配置为开漏输出模式。理由同上在多主机系统中其他主机也可能拉低SCL。但在纯单主机软件模拟中配置为推挽输出也能工作因为时钟完全由主机控制。为了规范性和兼容多主机场景建议也使用开漏输出。配置示例使用CubeMX或代码GPIO_InitTypeDef GPIO_InitStruct {0}; // 配置SDA引脚 (例如 GPIOB, GPIO_PIN_9) GPIO_InitStruct.Pin GPIO_PIN_9; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_OD; // 开漏输出 GPIO_InitStruct.Pull GPIO_PULLUP; // 启用内部上拉 GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, GPIO_InitStruct); // 配置SCL引脚 (例如 GPIOB, GPIO_PIN_8) GPIO_InitStruct.Pin GPIO_PIN_8; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_OD; // 开漏输出 GPIO_InitStruct.Pull GPIO_PULLUP; // 启用内部上拉 GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, GPIO_InitStruct);注意STM32的内部上拉电阻通常较大约40kΩ对于高速400kHz或长距离通信可能不足以提供快速的上升沿导致波形畸变。此时必须使用外部上拉电阻通常在4.7kΩ到10kΩ之间并禁用内部上拉GPIO_NOPULL。3. 从零构建软件I2C驱动层代码有了时序和GPIO的基础我们就可以开始编写最底层的信号生成函数了。我们将按照自底向上的顺序构建整个驱动。3.1 宏定义与引脚抽象首先为了代码的通用性和可移植性我们将使用的GPIO端口和引脚号用宏定义起来。// 软件I2C端口引脚定义 #define SOFT_I2C_PORT GPIOB #define SOFT_I2C_SCL_PIN GPIO_PIN_8 #define SOFT_I2C_SDA_PIN GPIO_PIN_9 // 总线操作宏提高代码可读性 #define SOFT_I2C_SCL_HIGH() HAL_GPIO_WritePin(SOFT_I2C_PORT, SOFT_I2C_SCL_PIN, GPIO_PIN_SET) #define SOFT_I2C_SCL_LOW() HAL_GPIO_WritePin(SOFT_I2C_PORT, SOFT_I2C_SCL_PIN, GPIO_PIN_RESET) #define SOFT_I2C_SDA_HIGH() HAL_GPIO_WritePin(SOFT_I2C_PORT, SOFT_I2C_SDA_PIN, GPIO_PIN_SET) // 注意输出1释放总线 #define SOFT_I2C_SDA_LOW() HAL_GPIO_WritePin(SOFT_I2C_PORT, SOFT_I2C_SDA_PIN, GPIO_PIN_RESET) #define SOFT_I2C_SDA_READ() HAL_GPIO_ReadPin(SOFT_I2C_PORT, SOFT_I2C_SDA_PIN) // 时序延时单位微秒以100kHz标准模式为例周期10us半周期5us。 // 实际值需要根据CPU主频和DWT延时精度进行调整和测试。 #define SOFT_I2C_DELAY_HALF() delay_us(5) // 半周期延时用于控制SCL高低电平时间 #define SOFT_I2C_DELAY_FULL() delay_us(10) // 全周期延时可用于起始、停止信号后的延时3.2 基础信号生成起始、停止、应答这些是I2C协议的“标点符号”必须严格符合时序。起始信号Start Conditionvoid I2C_Start(void) { /* 确保总线空闲状态SCL和SDA都为高 */ SOFT_I2C_SDA_HIGH(); // 先释放SDA SOFT_I2C_SCL_HIGH(); SOFT_I2C_DELAY_HALF(); // 保持一段时间确保总线稳定 /* 产生起始条件SCL高期间SDA产生下降沿 */ SOFT_I2C_SDA_LOW(); // SDA拉低 SOFT_I2C_DELAY_HALF(); // 满足起始条件保持时间 SOFT_I2C_SCL_LOW(); // 随后将SCL拉低准备发送数据 SOFT_I2C_DELAY_HALF(); }关键点起始信号前必须有一个总线空闲状态。SOFT_I2C_DELAY_HALF()的插入确保了SDA低电平的保持时间这对于某些严格的从设备是必要的。停止信号Stop Conditionvoid I2C_Stop(void) { /* 停止前SCL应为低SDA为任意值通常是最后一位数据或ACK位后的状态 */ SOFT_I2C_SCL_LOW(); SOFT_I2C_DELAY_HALF(); SOFT_I2C_SDA_LOW(); // 先将SDA拉低 SOFT_I2C_DELAY_HALF(); /* 产生停止条件SCL高期间SDA产生上升沿 */ SOFT_I2C_SCL_HIGH(); SOFT_I2C_DELAY_HALF(); SOFT_I2C_SDA_HIGH(); // SDA释放变高 SOFT_I2C_DELAY_FULL(); // 停止信号后延时保证总线进入空闲状态 }关键点停止信号前需要先将SDA拉低再拉高SCL最后在SCL高时释放SDA。最后的SOFT_I2C_DELAY_FULL()给了总线足够的时间恢复空闲避免连续起始信号时出现问题。发送应答ACK与非应答NACK主机在接收完一个字节后需要向从机发送一个应答信号。// 主机发送ACK void I2C_SendAck(void) { SOFT_I2C_SCL_LOW(); SOFT_I2C_DELAY_HALF(); SOFT_I2C_SDA_LOW(); // 拉低SDA表示ACK SOFT_I2C_DELAY_HALF(); SOFT_I2C_SCL_HIGH(); // 产生一个时钟脉冲 SOFT_I2C_DELAY_HALF(); SOFT_I2C_SCL_LOW(); SOFT_I2C_DELAY_HALF(); // 之后SDA状态可以改变为发送下一字节做准备 } // 主机发送NACK void I2C_SendNAck(void) { SOFT_I2C_SCL_LOW(); SOFT_I2C_DELAY_HALF(); SOFT_I2C_SDA_HIGH(); // 释放SDA高电平表示NACK SOFT_I2C_DELAY_HALF(); SOFT_I2C_SCL_HIGH(); // 产生一个时钟脉冲 SOFT_I2C_DELAY_HALF(); SOFT_I2C_SCL_LOW(); SOFT_I2C_DELAY_HALF(); }等待并读取从机应答Check ACK主机发送完一个字节地址或数据后需要释放SDA并读取从机在第9个时钟周期拉低的ACK信号。uint8_t I2C_WaitAck(void) { uint8_t ack 0; SOFT_I2C_SCL_LOW(); SOFT_I2C_DELAY_HALF(); SOFT_I2C_SDA_HIGH(); // 主机释放SDA线将控制权交给从机 SOFT_I2C_DELAY_HALF(); SOFT_I2C_SCL_HIGH(); // 产生第9个时钟脉冲 SOFT_I2C_DELAY_HALF(); if (SOFT_I2C_SDA_READ() GPIO_PIN_RESET) { ack 1; // 从机拉低了SDA表示应答 } else { ack 0; // SDA仍为高表示非应答 } SOFT_I2C_SCL_LOW(); // 拉低SCL结束ACK周期 SOFT_I2C_DELAY_HALF(); return ack; // 返回1表示收到ACK0表示NACK }实操心得I2C_WaitAck函数的返回值处理非常重要。如果返回0NACK通常意味着从设备地址错误、设备不存在、设备忙或写入的寄存器地址非法。上层函数必须根据此返回值做出判断是重试、报错还是终止通信。3.3 字节读写协议的核心拼图有了基础信号读写一个字节就是按位操作了。注意I2C协议规定数据高位MSB先传。发送一个字节void I2C_SendByte(uint8_t byte) { uint8_t i; SOFT_I2C_SCL_LOW(); // 确保从低电平开始 for (i 0; i 8; i) { // 先设置SDA数据位 if (byte 0x80) { // 判断最高位 SOFT_I2C_SDA_HIGH(); } else { SOFT_I2C_SDA_LOW(); } SOFT_I2C_DELAY_HALF(); // 数据建立时间 // 再产生一个SCL上升沿从机在此时采样数据 SOFT_I2C_SCL_HIGH(); SOFT_I2C_DELAY_HALF(); // 确保SCL高电平时间足够 SOFT_I2C_SCL_LOW(); SOFT_I2C_DELAY_HALF(); // 数据保持时间并为下一位做准备 byte 1; // 左移准备发送下一位 } // 发送完8位后SDA线状态保持准备后续的ACK检测 }接收一个字节uint8_t I2C_ReceiveByte(void) { uint8_t i, byte 0; SOFT_I2C_SDA_HIGH(); // 主机释放SDA设置为输入模式通过输出1实现 for (i 0; i 8; i) { byte 1; // 先左移第一次左移0无影响 SOFT_I2C_SCL_LOW(); SOFT_I2C_DELAY_HALF(); SOFT_I2C_SCL_HIGH(); // 产生时钟上升沿从机将数据放到SDA上 SOFT_I2C_DELAY_HALF(); if (SOFT_I2C_SDA_READ()) { byte | 0x01; // 读取SDA电平存入最低位 } SOFT_I2C_DELAY_HALF(); } SOFT_I2C_SCL_LOW(); // 最后将SCL拉低结束字节接收 return byte; }关键点接收字节时循环内先byte 1再读位这样读到的第一位MSB最终会移到最高位符合协议。循环结束后SCL处于低电平主机此时应该发送ACK或NACK。4. 封装应用层API与实战调试技巧底层信号函数完成后我们需要将它们组合成面向应用的API模仿标准HAL库或类似库的接口风格方便调用。4.1 仿HAL库风格API封装我们设计几个最常用的函数初始化、发送数据、接收数据。// 软件I2C初始化主要初始化GPIO和延时 void SOFT_I2C_Init(void) { GPIO_InitTypeDef GPIO_InitStruct {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); // 使能GPIOB时钟 GPIO_InitStruct.Pin SOFT_I2C_SCL_PIN | SOFT_I2C_SDA_PIN; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_OD; GPIO_InitStruct.Pull GPIO_PULLUP; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(SOFT_I2C_PORT, GPIO_InitStruct); // 初始化DWT延时如果使用 DWT_Init(); // 让总线处于空闲状态 SOFT_I2C_SCL_HIGH(); SOFT_I2C_SDA_HIGH(); delay_us(10); } // 主机向从机发送一系列数据 // addr: 7位从机地址左对齐即实际发送 addr 1 | 0 // reg: 从机内部寄存器地址可选取决于设备 // pData: 要发送的数据缓冲区 // size: 数据大小 uint8_t SOFT_I2C_Master_Transmit(uint8_t addr, uint8_t reg, uint8_t *pData, uint16_t size) { uint16_t i; I2C_Start(); // 发送设备地址写模式 I2C_SendByte((addr 1) | 0x00); if (!I2C_WaitAck()) { I2C_Stop(); return 0; // 地址无应答失败 } // 发送寄存器地址如果设备需要 I2C_SendByte(reg); if (!I2C_WaitAck()) { I2C_Stop(); return 0; // 寄存器地址无应答失败 } // 发送数据 for (i 0; i size; i) { I2C_SendByte(pData[i]); if (!I2C_WaitAck()) { I2C_Stop(); return 0; // 数据无应答失败 } } I2C_Stop(); return 1; // 成功 } // 主机从从机读取一系列数据 // addr: 7位从机地址 // reg: 要读取的起始寄存器地址 // pData: 接收数据缓冲区 // size: 要读取的数据大小 uint8_t SOFT_I2C_Master_Receive(uint8_t addr, uint8_t reg, uint8_t *pData, uint16_t size) { uint16_t i; // 第一阶段发送设备地址写和寄存器地址即“写指针” I2C_Start(); I2C_SendByte((addr 1) | 0x00); // 写模式 if (!I2C_WaitAck()) { I2C_Stop(); return 0; } I2C_SendByte(reg); if (!I2C_WaitAck()) { I2C_Stop(); return 0; } // 第二阶段重新起始条件切换为读模式 I2C_Start(); // 重复起始条件 I2C_SendByte((addr 1) | 0x01); // 读模式 if (!I2C_WaitAck()) { I2C_Stop(); return 0; } // 第三阶段连续读取数据 for (i 0; i size; i) { pData[i] I2C_ReceiveByte(); // 发送ACK非最后一个字节或NACK最后一个字节 if (i size - 1) { I2C_SendAck(); // 中间字节发送ACK } else { I2C_SendNAck(); // 最后一个字节发送NACK } } I2C_Stop(); return 1; // 成功 }4.2 实战调试逻辑分析仪与示波器是关键代码写完了怎么验证它是对的光看代码运行是否报错远远不够。I2C是时序敏感的协议必须用工具看波形。必备工具逻辑分析仪。一个几十块钱的USB逻辑分析仪配合Saleae Logic或PulseView软件就足够了。将SCL和SDA引脚连接到分析仪设置好触发条件如SDA下降沿。抓取一次完整的通信调用你的SOFT_I2C_Master_Transmit函数发送几个字节用逻辑分析仪抓取波形。对照检查起始/停止信号SCL高期间SDA的下降沿和上升沿是否清晰数据位每个SCL高电平期间对应的SDA数据是否稳定有没有毛刺ACK位第9个时钟周期SDA是否被从机拉低如果从机不应答这里就是高电平。时序参数使用软件的测量工具检查SCL的频率是否接近100kHz周期10usSDA的变化是否发生在SCL低电平期间数据有效性常见问题与调优通信完全失败无ACK首先检查从设备地址是否正确7位地址需要左移一位并加上读写位。用逻辑分析仪看主机发送的地址字节是否正确。其次检查上拉电阻如果波形上升沿非常缓慢可能是上拉电阻太大或负载电容太大。偶尔通信失败可能是时序过于紧张。尝试增加SOFT_I2C_DELAY_HALF的延时值特别是SCL高电平时间给从设备足够的采样时间。中断干扰也可能导致时序错乱在关键通信段可以临时关闭全局中断。波形畸变如果使用杜邦线连接可能会引入振铃和反射。尽量缩短连线或在靠近MCU引脚处串联一个几十欧姆的电阻。示波器辅助逻辑分析仪看数字逻辑示波器看模拟质量。如果通信不稳定用示波器观察SDA/SCL线上的电压幅值、上升/下降时间、过冲等确保电气特性合规。4.3 进阶优化提升速度与稳定性当基本通信调通后可以考虑以下优化动态延时调整不同速度的从设备需要不同的延时。可以定义几组延时宏如I2C_DELAY_100K、I2C_DELAY_400K并在初始化时选择。超时机制在I2C_WaitAck等等待从机响应的环节加入超时判断避免程序死锁。uint32_t timeout 1000; // 超时计数 while (SOFT_I2C_SDA_READ() ! 0 timeout--) { delay_us(1); } if (timeout 0) { // 超时处理 }中断友好设计如果通信过程可能被高优先级中断打断会导致时序严重错乱。有两种策略一是在整个通信函数开始前关闭中断结束后再打开二是将时序延时函数改为基于系统Tick的检查而不是死循环但实现更复杂。对于软件模拟I2C通常建议在单次通信期间关闭中断。多实例支持将GPIO引脚、延时参数等封装到一个结构体如Soft_I2C_HandleTypeDef中这样就能轻松管理多组软件I2C总线。5. 与硬件I2C的对比及选型建议最后我们来系统性地对比一下软件模拟I2C和硬件I2C帮助你在项目中做出正确选择。特性维度软件模拟I2C (Bit-Banging)硬件I2C (HAL库驱动)引脚灵活性极高任意GPIO均可固定由芯片数据手册指定时序控制完全可控可灵活调整以适应非标设备固定由硬件寄存器配置调整范围有限通信速率较低受CPU处理延时限制通常不超过400kHz高由硬件时钟驱动可达标准/快速/高速模式CPU占用率高通信时CPU被完全占用极低通信由硬件完成CPU可处理其他任务多主机支持可实现但逻辑复杂需仲裁硬件原生支持多主机仲裁中断/DMA支持不支持或需复杂软件模拟原生支持可释放CPU提高效率开发调试难度较低代码透明易于用逻辑分析仪调试较高遇到硬件问题时排查复杂代码复杂度中等需自己实现协议栈低直接调用HAL库API稳定性高时序完全由代码决定确定性好取决于硬件部分STM32型号早期硬件I2C有缺陷选型建议优先选择硬件I2C的情况通信速率要求高400kHz。需要频繁、大数据量传输且不希望占用过多CPU资源。项目需要使用DMA或中断来异步处理I2C通信。硬件引脚恰好空闲且从设备时序标准。优先选择软件模拟I2C的情况硬件I2C引脚被占用无法更改PCB。需要连接多个I2C设备硬件接口数量不足。从设备时序特殊需要微调。项目处于早期调试阶段需要深入排查通信问题。作为硬件I2C失效时的备用方案冗余设计。我个人在项目中的习惯是默认先尝试硬件I2C因为它更高效、更省心。一旦遇到棘手的兼容性问题或调试瓶颈我会毫不犹豫地切换到软件模拟方案。手头拥有一套经过验证的、稳定的软件I2C代码就像是嵌入式工程师的“瑞士军刀”总能在一个意想不到的时刻派上大用场。尤其是当你需要快速验证一个I2C设备或者在一个引脚资源紧张的老项目上增加新功能时软件模拟I2C的灵活性价值就凸显无疑了。