简介从I2C总线协议基础讲起介绍GPIO模拟I2C的实现原理包括起始停止条件、数据位时序、ACK应答等核心机制。在硬件I2C资源紧张时使用空闲GPIO模拟I2C是一种灵活高效的替代方案尤其适用于QMI8658C这类6轴IMU传感器。详细解析了QMI8658C的寄存器读写、初始化流程和数据解析方法并提供了分层设计的驱动代码可轻松移植到不同MCU平台。面向可穿戴设备、无人机飞控、平衡小车等应用场景从工程实践角度给出GPIO模拟I2C的调试经验和配置技巧帮助开发者快速实现传感器驱动开发。 前阵子整理一份传感器驱动工程标题就是“QMI8658C驱程序源代码GPIO模拟I2C接口QMI8658C驱动.zip”。当时产品上硬件I2C外设不够用I2C1被触控和气压计占着I2C2要接外部存储新加的这颗QMI8658C只能用空闲GPIO飞线于是干脆写了一套纯GPIO模拟的I2C主机驱动把初始化、寄存器读写和数据解析全部跑通。这篇文章就把这套源码的设计思路、关键代码和调试中踩过的坑完整整理一遍给后面调这颗芯片、或者打算用GPIO模拟I2C的朋友做个参考。1. 先搞清楚 QMI8658C 和这个驱动要解决的核心问题1.1 QMI8658C 芯片特性QMI8658C是一颗6轴惯性测量单元内部集成了3轴加速度计和3轴陀螺仪。相比老款的MPU6050它的体积更小、功耗更低而且内置了DMP数字运动处理器可以输出姿态融合结果把主控从坐标变换和滤波运算里解放出来。可穿戴设备、遥控器、平衡小车、无人机飞控这些场景里都很常见。芯片支持I2C和SPI两种通信接口默认用I2C时只需要两根线SCL、SDA。关键特性说明加速度计量程±2g / ±4g / ±8g / ±16g陀螺仪量程常见配置支持 ±16dps 到 ±4096dps输出数据率从几十Hz到几千Hz按寄存器配置从机地址由 SA0 引脚决定常见 0x6A 或 0x6B内置功能DMP数字运动处理器、温度输出、FIFO对主控来说只要能发出符合I2C时序的电平变化就能和它通信。这正是GPIO模拟I2C能够成立的基础。1.2 为什么这套驱动选择 GPIO 模拟 I2C 而不是硬件 I2C这个问题我几乎每次分享都会被问到。用GPIO模拟I2C最直接的原因就是硬件资源不够。很多MCU的硬件I2C外设数量有限尤其是一些中低端型号整个芯片可能就只有一到两路I2C。一旦接了触控、气压计、EEPROM、RTCI2C总线就满了。而且硬件的I2C引脚往往是固定复用的如果那几个引脚被其他功能占掉想用也用不了。GPIO模拟方案最大的优势是灵活。任意两个空闲GPIO都能组合成I2C总线不受硬件外设和引脚复用的限制换平台时只需要改底层的引脚操作函数驱动层代码完全不用动。调试阶段还能随时调整时序不受芯片硬件I2C外设的固定时序约束。当然代价也明显需要占用CPU主动翻转电平SCL频率受延时函数影响如果系统里中断特别多时序容易被打乱。但对于QMI8658C这种IMU传感器来说常用ODR本来也就几百Hz模拟I2C的速率完全够用CPU占用也在可接受范围内。该用硬件I2C的场景果断用硬件资源不够时用GPIO模拟是性价比很高的替代方案。1.3 这套 ZIP 里的代码应该怎么分层看拿到源码先别急着往工程里拖先搞清楚代码的分层结构。这份驱动我按三层拆的平台抽象层管引脚宏、延时函数、GPIO时钟初始化I2C协议层实现起始、停止、写字节、读字节、ACK处理设备驱动层封装QMI8658C的寄存器读写、初始化序列、数据解析分层的好处是换平台时只动最底层。比如从STM32换到GD32、ESP32协议层和设备层代码一行都不用改只需要把底层的GPIO操作宏和延时函数替换掉。如果你的项目要长期维护或者后期有换主控的计划强烈建议一开始就按这个思路组织代码不然后面改起来会很痛苦。2. GPIO 模拟 I2C 的底层实现时序、模式和关键代码2.1 I2C 协议的四个关键时序模拟I2C的核心就是把协议时序用代码精确还原。I2C总线空闲时SCL和SDA都是高电平通信过程中有四个基础事件起始条件、停止条件、数据位、应答位。起始条件SCL保持高电平SDA产生一个下降沿。这个下降沿告诉总线上所有从机“主机要开始通信了”。停止条件SCL保持高电平SDA产生一个上升沿。表示本次通信结束总线释放。数据位一个字节分8次发送每次1位高位在前。关键规则是SCL低电平时SDA允许变化SCL高电平时SDA必须保持稳定。应答位每发完8个数据位第9个时钟周期由接收方拉低SDA表示ACK主机释放SDA读取电平判断是否成功。用表格总结事件条件说明起始条件SCL高SDA下降沿总线开始通信停止条件SCL高SDA上升沿总线结束通信数据位SCL低时改变SDASCL高时采样高位先发ACK第9个SCL周期SDA被拉低从机收到数据NACK第9个SCL周期SDA保持高从机未确认或读取结束理解了这个基础模拟I2C的代码就是这些时序的循环组合。2.2 GPIO 工作模式怎么选做GPIO模拟I2C引脚模式选不对后面会踩很多坑。这里展开说下GPIO的8种工作模式和模拟I2C的选型逻辑。输入浮空引脚无上下拉高阻态输入上拉 / 输入下拉内部接上拉或下拉电阻模拟输入用于ADC采样推挽输出强驱动高低电平翻转速度快开漏输出只能主动拉低高电平靠外部上拉电阻复用推挽 / 复用开漏用于外设功能引脚复用模拟I2C常用两种方案。第一种SCL和SDA都配置为开漏输出外部加上拉电阻读SDA时直接读输入数据寄存器。开漏输出写1时引脚释放由外部上拉拉高写0时引脚拉低这种模式天然符合I2C总线“线与”的特性。第二种SDA在输出和输入模式之间动态切换写数据时配成推挽输出读数据时切回输入模式读取电平。我实际项目里推荐第一种开漏输出加外部上拉最省心因为不需要频繁切换GPIO模式代码逻辑简单也不容易出错。如果板子上实在没位置上拉电阻可以用内部上拉凑合但稳定性不如外部电阻总线电容大时波形边沿会变缓。STM32上用CubeMX或HAL库初始化的时候大概是这样配的GPIO_InitTypeDef GPIO_InitStruct {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); GPIO_InitStruct.Pin GPIO_PIN_6 | GPIO_PIN_7; 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);如果SDA要动态切换模式代码里可以封装两个函数读之前切换成输入写完再切回输出。切换后加个小的延时等引脚状态稳定再操作。2.3 读写的完整代码实现接下来是协议层代码。这套代码我用了宏定义的方式抽象引脚操作这样换平台时只需要替换宏。#define I2C_SCL_PORT GPIOB #define I2C_SCL_PIN GPIO_PIN_6 #define I2C_SDA_PORT GPIOB #define I2C_SDA_PIN GPIO_PIN_7 #define I2C_SCL_H() HAL_GPIO_WritePin(I2C_SCL_PORT, I2C_SCL_PIN, GPIO_PIN_SET) #define I2C_SCL_L() HAL_GPIO_WritePin(I2C_SCL_PORT, I2C_SCL_PIN, GPIO_PIN_RESET) #define I2C_SDA_H() HAL_GPIO_WritePin(I2C_SDA_PORT, I2C_SDA_PIN, GPIO_PIN_SET) #define I2C_SDA_L() HAL_GPIO_WritePin(I2C_SDA_PORT, I2C_SDA_PIN, GPIO_PIN_RESET) #define I2C_SDA_READ() HAL_GPIO_ReadPin(I2C_SDA_PORT, I2C_SDA_PIN) static void i2c_delay(void) { // 空循环延时具体次数根据主频调整 // 目标是让 SCL 频率落在 100kHz ~ 400kHz 区间 for (volatile int i 0; i 50; i); } static void i2c_start(void) { I2C_SDA_H(); I2C_SCL_H(); i2c_delay(); I2C_SDA_L(); // SCL 高电平期间 SDA 拉低产生起始条件 i2c_delay(); I2C_SCL_L(); i2c_delay(); } static void i2c_stop(void) { I2C_SDA_L(); i2c_delay(); I2C_SCL_H(); i2c_delay(); I2C_SDA_H(); // SCL 高电平期间 SDA 拉高产生停止条件 i2c_delay(); } static uint8_t i2c_write_byte(uint8_t data) { uint8_t i; for (i 0; i 8; i) { if (data 0x80) { I2C_SDA_H(); } else { I2C_SDA_L(); } data 1; i2c_delay(); I2C_SCL_H(); // SCL 高电平期间主机发送数据位 i2c_delay(); I2C_SCL_L(); i2c_delay(); } // 第 9 个时钟释放 SDA读取从机 ACK I2C_SDA_H(); i2c_delay(); I2C_SCL_H(); i2c_delay(); uint8_t ack I2C_SDA_READ() ? 0 : 1; I2C_SCL_L(); i2c_delay(); return ack; } static uint8_t i2c_read_byte(uint8_t ack) { uint8_t i, data 0; I2C_SDA_H(); // 释放 SDA让从机驱动数据线 for (i 0; i 8; i) { data 1; I2C_SCL_H(); i2c_delay(); if (I2C_SDA_READ()) { data | 0x01; } I2C_SCL_L(); i2c_delay(); } // 主机发送 ACK 或 NACK if (ack) { I2C_SDA_L(); // 拉低 ACK继续读下一字节 } else { I2C_SDA_H(); // 拉高 NACK通知从机结束读取 } i2c_delay(); I2C_SCL_H(); i2c_delay(); I2C_SCL_L(); i2c_delay(); I2C_SDA_H(); return data; }再封装设备和寄存器级的读写函数。写寄存器的流程是起始 - 发送从机地址写位- 发送寄存器地址 - 发送数据 - 停止。读寄存器的流程是起始 - 发送从机地址写位- 发送寄存器地址 - 重新产生起始条件 - 发送从机地址读位- 读取数据 - 停止。uint8_t sw_i2c_write_reg(uint8_t dev_addr, uint8_t reg, uint8_t *data, uint16_t len) { uint8_t i; i2c_start(); if (!i2c_write_byte(dev_addr 1)) // 写地址 { i2c_stop(); return 1; } i2c_write_byte(reg); // 寄存器地址 for (i 0; i len; i) { i2c_write_byte(data[i]); } i2c_stop(); return 0; } uint8_t sw_i2c_read_reg(uint8_t dev_addr, uint8_t reg, uint8_t *buf, uint16_t len) { uint16_t i; i2c_start(); i2c_write_byte(dev_addr 1); // 写地址 i2c_write_byte(reg); // 寄存器地址 i2c_start(); // 重复起始条件 i2c_write_byte((dev_addr 1) | 0x01); // 读地址 for (i 0; i len; i) { buf[i] i2c_read_byte(i len - 1 ? 1 : 0); } i2c_stop(); return 0; }这里有个容易忽略的细节读多个字节时除了最后一个字节要回 NACK前面所有字节都要回 ACK。如果主机从头到尾都不回 ACK从机会以为你不想继续读了后面的数据就不会发。很多新手调不通多字节读取问题就出在这。3. QMI8658C 驱动层初始化、寄存器读写与数据解析3.1 寄存器地址与设备 ID 校验底层I2C通了之后接下来就是QMI8658C的驱动层。调任何一颗新传感器第一步永远都是读设备ID。这一步能同时验证三件事接线对不对、地址对不对、底层I2C通信通不通。QMI8658C的WHO_AM_I寄存器地址是0x00常见返回0x05。如果读出来是全FF或者00基本可以确定通信链路有问题先别急着配置寄存器返回去看时序。常用寄存器整理如下寄存器地址说明WHO_AM_I0x00设备ID常见返回0x05CTRL10x02地址自增、SPI模式等CTRL20x03加速度计配置ODR、量程、使能CTRL30x04陀螺仪配置ODR、量程、使能CTRL70x08传感器总使能状态寄存器0x2E数据就绪标志等温度输出0x33温度低字节连续2字节加速度计输出0x35X轴低字节起始连续6字节陀螺仪输出0x3BX轴低字节起始连续6字节不同批次或者不同版本的芯片寄存器细节可能存在差异拿到芯片后第一件事就是对着官方手册核对一遍这些地址和位域别完全依赖网上的代码。3.2 初始化流程初始化顺序很重要我踩过的坑是上来直接配置量程结果写入不生效。正确顺序应该是读ID校验 - 配置加速度计 - 配置陀螺仪 - 使能传感器 - 等数据稳定。#define QMI8658C_ADDR 0x6A // SA0 接地时的地址 #define QMI8658C_WHO_AM_I 0x00 #define QMI8658C_CTRL2 0x03 #define QMI8658C_CTRL3 0x04 #define QMI8658C_CTRL7 0x08 uint8_t qmi8658c_init(void) { uint8_t id; id 0; sw_i2c_read_reg(QMI8658C_ADDR, QMI8658C_WHO_AM_I, id, 1); if (id ! 0x05) { return 1; // 设备 ID 不对通信链路有问题 } // 配置加速度计125Hz 输出率±8g 量程 // 位域定义请以官方手册为准 uint8_t accel_cfg 0x43; sw_i2c_write_reg(QMI8658C_ADDR, QMI8658C_CTRL2, accel_cfg, 1); // 配置陀螺仪125Hz 输出率±500dps 量程 uint8_t gyro_cfg 0x43; sw_i2c_write_reg(QMI8658C_ADDR, QMI8658C_CTRL3, gyro_cfg, 1); // 使能加速度计和陀螺仪 uint8_t ctrl7 0x03; sw_i2c_write_reg(QMI8658C_ADDR, QMI8658C_CTRL7, ctrl7, 1); // 写完后读回确认配置真正写进去了 uint8_t check 0; sw_i2c_read_reg(QMI8658C_ADDR, QMI8658C_CTRL7, check, 1); if ((check 0x03) ! 0x03) { return 2; } return 0; }配置写完后一定要读回确认。别想着写入肯定成功总线干扰、时序不满足、从机忙等原因都可能导致写入失败读回校验是最快的定位手段。3.3 加速度和角速度数据的读取与转换QMI8658C的输出寄存器是16位有符号数低字节在前高字节在后。读取时可以一次读完12个字节把加速度计和陀螺仪原始数据同时拿出来。typedef struct { int16_t ax; int16_t ay; int16_t az; int16_t gx; int16_t gy; int16_t gz; } imu_raw_t; uint8_t qmi8658c_read_sensor(imu_raw_t *data) { uint8_t buf[12]; if (sw_i2c_read_reg(QMI8658C_ADDR, 0x35, buf, 12) ! 0) { return 1; } style="width:16px;margin-left:4px;vertical-align:text-bottom;cursor:text;" />