当你的STM32项目需要驱动10个IIC设备时，我是这样用C语言‘面向对象’重构软件IIC的
用C语言面向对象思想重构STM32软件IIC驱动框架
在嵌入式开发中，IIC总线因其简单性和多设备支持特性被广泛应用。但当项目中需要同时驱动多个IIC设备，特别是遇到地址冲突的情况时，传统的宏定义方式很快就会变得难以维护。最近我在一个STM32项目中遇到了需要驱动10个IIC设备的情况，其中有8个设备的地址完全相同且无法修改。这促使我重新思考软件IIC的实现方式。
1. 传统IIC驱动方式的局限性
大多数STM32开发者最初接触的IIC驱动都是基于宏定义实现的。这种方式的典型特征是将SCL和SDA引脚通过宏定义固定，所有操作都直接针对这两个特定引脚。当只有一个IIC设备时，这种方式简单直接，但随着设备数量增加，问题开始显现。
宏定义方式的主要问题：
- 代码重复：每个设备都需要一套几乎相同的操作函数
- 难以扩展：新增设备需要复制大量代码
- 维护困难：引脚变更需要修改多处宏定义
- 无法处理地址冲突：同一地址的设备无法区分
// 传统宏定义方式的典型代码 #define IIC1_SCL_PORT GPIOB #define IIC1_SCL_PIN GPIO_PIN_6 #define IIC1_SDA_PORT GPIOB #define IIC1_SDA_PIN GPIO_PIN_7 void IIC1_Start(void) { HAL_GPIO_WritePin(IIC1_SCL_PORT, IIC1_SCL_PIN, GPIO_PIN_SET); HAL_GPIO_WritePin(IIC1_SDA_PORT, IIC1_SDA_PIN, GPIO_PIN_SET); // ... 其他时序代码 }2. 面向对象思想在C语言中的实现
虽然C语言不是面向对象语言，但我们可以利用结构体和函数指针来模拟对象的概念。一个IIC设备本质上包含两部分：
- 数据成员：SCL引脚、SDA引脚、设备地址等
- 方法成员：起始信号、停止信号、读写数据等操作
IIC设备结构体设计：
typedef struct { GPIO_TypeDef* SCL_Port; uint16_t SCL_Pin; GPIO_TypeDef* SDA_Port; uint16_t SDA_Pin; uint8_t DevAddr; } IIC_Device;通过将IIC设备抽象为结构体，我们可以为每个物理设备创建独立的实例，所有操作函数都接收这个结构体指针作为参数。这种方式完美解决了多设备管理的问题。
3. 软件IIC驱动框架设计
基于上述思想，我们可以构建一个完整的软件IIC驱动框架。这个框架的核心是统一的操作接口和灵活的设备管理。
3.1 驱动接口定义
// IIC操作函数指针类型 typedef void (*IIC_StartFunc)(IIC_Device*); typedef void (*IIC_StopFunc)(IIC_Device*); typedef uint8_t (*IIC_ReadByteFunc)(IIC_Device*); typedef void (*IIC_WriteByteFunc)(IIC_Device*, uint8_t); // 完整的IIC驱动结构体 typedef struct { IIC_Device device; IIC_StartFunc Start; IIC_StopFunc Stop; IIC_ReadByteFunc ReadByte; IIC_WriteByteFunc WriteByte; // 其他操作函数... } IIC_Driver;3.2 具体实现示例
void IIC_Start(IIC_Device* dev) { HAL_GPIO_WritePin(dev->SDA_Port, dev->SDA_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(dev->SCL_Port, dev->SCL_Pin, GPIO_PIN_SET); Delay_us(1); HAL_GPIO_WritePin(dev->SDA_Port, dev->SDA_Pin, GPIO_PIN_RESET); Delay_us(1); HAL_GPIO_WritePin(dev->SCL_Port, dev->SCL_Pin, GPIO_PIN_RESET); Delay_us(1); } uint8_t IIC_ReadByte(IIC_Device* dev) { uint8_t value = 0; HAL_GPIO_WritePin(dev->SDA_Port, dev->SDA_Pin, GPIO_PIN_SET); // 释放SDA for(int i=0; i<8; i++) { HAL_GPIO_WritePin(dev->SCL_Port, dev->SCL_Pin, GPIO_PIN_SET); Delay_us(1); value <<= 1; if(HAL_GPIO_ReadPin(dev->SDA_Port, dev->SDA_Pin)) { value |= 0x01; } HAL_GPIO_WritePin(dev->SCL_Port, dev->SCL_Pin, GPIO_PIN_RESET); Delay_us(1); } return value; }4. 多IIC设备管理实践
有了这个框架，管理多个IIC设备变得非常简单。我们可以为每个物理设备创建一个IIC_Driver实例，并通过统一的接口进行操作。
4.1 设备初始化
// 定义两个IIC设备 IIC_Device eeprom1 = { .SCL_Port = GPIOB, .SCL_Pin = GPIO_PIN_6, .SDA_Port = GPIOB, .SDA_Pin = GPIO_PIN_7, .DevAddr = 0xA0 }; IIC_Device eeprom2 = { .SCL_Port = GPIOB, .SCL_Pin = GPIO_PIN_6, .SDA_Port = GPIOB, .SDA_Pin = GPIO_PIN_8, .DevAddr = 0xA0 }; // 创建驱动实例 IIC_Driver driver1 = { .device = eeprom1, .Start = IIC_Start, .Stop = IIC_Stop, .ReadByte = IIC_ReadByte, .WriteByte = IIC_WriteByte }; IIC_Driver driver2 = { .device = eeprom2, .Start = IIC_Start, .Stop = IIC_Stop, .ReadByte = IIC_ReadByte, .WriteByte = IIC_WriteByte };4.2 设备操作示例
// 向eeprom1写入数据 driver1.Start(&driver1.device); driver1.WriteByte(&driver1.device, 0xA0); // 设备地址+写 driver1.WriteByte(&driver1.device, 0x00); // 内存地址 driver1.WriteByte(&driver1.device, 0x55); // 数据 driver1.Stop(&driver1.device); // 从eeprom2读取数据 driver2.Start(&driver2.device); driver2.WriteByte(&driver2.device, 0xA1); // 设备地址+读 uint8_t data = driver2.ReadByte(&driver2.device); driver2.Stop(&driver2.device);5. 性能优化与注意事项
虽然软件IIC提供了极大的灵活性，但在实际应用中还需要考虑一些性能因素：
时序精度：
- 确保延时函数精度满足IIC设备要求
- 不同设备可能有不同的时序要求
- 考虑使用硬件定时器实现更精确的延时
多设备共享SCL线：
- 当多个设备共享SCL线但使用不同SDA线时
- 需要特别注意总线竞争问题
- 可以考虑添加互斥锁机制
错误处理：
- 添加超时机制防止总线锁死
- 实现ACK检查确保通信可靠
- 提供重试机制处理临时错误
// 带错误检查的写函数示例 uint8_t IIC_WriteWithCheck(IIC_Device* dev, uint8_t data) { uint8_t retry = 3; while(retry--) { IIC_Start(dev); IIC_WriteByte(dev, dev->DevAddr | 0x00); // 写地址 if(!IIC_CheckACK(dev)) continue; IIC_WriteByte(dev, data); if(!IIC_CheckACK(dev)) continue; IIC_Stop(dev); return 1; // 成功 } IIC_Stop(dev); return 0; // 失败 }在实际项目中采用这种面向对象的设计后，代码的可维护性得到了显著提升。新增设备只需添加一个新的IIC_Driver实例，而无需修改任何驱动代码。对于地址相同的设备，通过使用不同的SDA引脚完美解决了冲突问题。