STM32中I2C协议初始化配置：手把手教你从零实现硬件级通信
你有没有遇到过这样的情况？——用HAL库调用HAL_I2C_Master_Transmit()函数，结果返回HAL_ERROR，但不知道问题出在哪儿。查遍了代码、引脚、地址，就是找不到原因。
如果你也曾被I2C“黑盒”折磨过，那这篇教程就是为你准备的。
我们不讲API封装，也不依赖任何库函数。今天，我们要直接操作寄存器，从最底层开始，一步步点亮STM32的I2C外设。当你真正理解每一个位、每一个时序背后的含义后，你会发现：原来I2C并不可怕，它只是需要被“看懂”。
为什么I2C总线值得深入研究？
在嵌入式世界里，I2C（Inter-Integrated Circuit）就像是一条微型高速公路，连接着MCU和各种传感器、EEPROM、RTC、触摸屏控制器等低速外设。它的最大魅力在于：仅用两根线（SDA + SCL）就能构建一个多设备通信网络。
相比SPI需要四根线（MOSI/MISO/SCK/CS），UART只能点对点通信，I2C凭借其简洁性和寻址机制，在资源紧张的小型系统中脱颖而出。
而STM32作为目前最受欢迎的ARM Cortex-M系列MCU之一，几乎每款芯片都集成了至少一个硬件I2C模块。然而，很多人只停留在“会用HAL库”的层面，一旦脱离库支持或遇到通信异常，立刻束手无策。
要真正掌控I2C，就必须下探到寄存器层。只有这样，你才能回答这些问题：
- 为什么SCL频率总是不准？
- NACK是怎么产生的？
- 总线卡死时如何恢复？
- 如何手动计算CCR值？
接下来，我们就以STM32F103C8T6为例，带你亲手完成一次完整的I2C1主模式初始化，全程不使用HAL或LL库。
I2C通信的核心机制：不只是“发数据”
在动手写代码之前，先搞清楚I2C到底怎么工作。
两条线，三种状态
I2C只有两个信号线：
- SDA：串行数据线，双向传输；
- SCL：串行时钟线，由主设备控制。
它们都是开漏输出（Open-Drain），这意味着每个设备只能将线路拉低，不能主动拉高。因此，必须通过外部上拉电阻将SDA和SCL默认拉至高电平。
✅ 典型上拉电阻阻值为4.7kΩ（3.3V系统），若通信速率较高可降至2.2kΩ。
这种设计允许多个设备共享同一总线——谁要说话就拉低，不说话就释放，避免冲突。
起始与停止：通信的开关
所有I2C事务都以起始条件（Start）开始，以停止条件（Stop）结束。
| 条件 | SCL | SDA 变化 |
|---|---|---|
| Start | 高 → 高 | 高 → 低 |
| Stop | 高 → 高 | 低 → 高 |
注意：SCL必须保持高电平时，SDA的变化才有效。这也是为什么I2C被称为“同步串行总线”——时钟决定了数据的有效窗口。
地址帧与ACK机制
每次通信的第一步是发送地址帧，格式如下：
[7位从机地址][R/W bit]例如，向地址为0x50的EEPROM写数据，则发送0xA0；读则发送0xA1。
每传输完一个字节（包括地址帧），接收方必须给出应答信号（ACK）：
- ACK：接收方在第9个时钟周期将SDA拉低；
- NACK：保持高电平，表示拒绝接收或结束通信。
这个机制是I2C可靠性的关键所在。
支持哪些速率？
| 模式 | 最高速率 | 应用场景 |
|---|---|---|
| 标准模式（Sm） | 100 kbps | 温度传感器、RTC |
| 快速模式（Fm） | 400 kbps | 加速度计、OLED屏 |
| 高速模式（Hs） | 3.4 Mbps | 特殊需求，需额外使能 |
STM32F1系列最高支持快速模式。
STM32的I2C外设架构解析
STM32不是靠GPIO模拟I2C，而是内置了专用硬件模块。以STM32F1为例，I2C挂载在APB1总线上（PCLK1），具备以下能力：
- 自动产生起始/停止信号
- 硬件生成SCL时钟
- 内置数据缓冲区（DR）
- 完整的状态标志监控（SR1/SR2）
- 支持DMA请求和中断触发
这些功能让CPU不必全程参与通信过程，极大降低负载。
关键寄存器一览
| 寄存器 | 功能说明 |
|---|---|
CR1 | 控制位：使能、ACK、STOP生成等 |
CR2 | 外设时钟配置、事件中断使能 |
OAR1/OAR2 | 本机地址（从机模式用） |
DR | 数据寄存器，读写一字节 |
SR1/SR2 | 状态寄存器，反映当前通信状态 |
CCR | 时钟控制寄存器，决定SCL频率 |
TRISE | 上升时间补偿寄存器 |
我们将重点操作其中几个核心寄存器来完成初始化。
手把手实现：寄存器级I2C1初始化
现在进入实战环节。目标：在STM32F103上配置I2C1为主模式，运行于标准模式（100kHz）。
第一步：开启时钟
任何外设工作前都必须先供电。I2C1依赖两个时钟源：
- APB1时钟：供给I2C1模块本身；
- APB2时钟：供给GPIOB（PB6/PB7）。
假设系统时钟HCLK=72MHz，APB1分频系数为2 → PCLK1 = 36MHz。
// 启用GPIOB和I2C1时钟 RCC->APB2ENR |= RCC_APB2ENR_IOPBEN; // 使能GPIOB RCC->APB1ENR |= RCC_APB1ENR_I2C1EN; // 使能I2C1⚠️ 注意：如果不打开对应时钟，后续所有寄存器操作都将无效！
第二步：配置GPIO为复用开漏输出
I2C引脚必须设置为复用功能 + 开漏输出，否则无法正确驱动总线。
对于I2C1，默认引脚是：
- PB6 → SCL
- PB7 → SDA
使用GPIOB->CRL寄存器配置低8位引脚（0~7）：
// 清除PB6和PB7原有配置 GPIOB->CRL &= ~(GPIO_CRL_MODE6 | GPIO_CRL_CNF6); GPIOB->CRL &= ~(GPIO_CRL_MODE7 | GPIO_CRL_CNF7); // 设置为复用开漏输出，最大输出速度2MHz GPIOB->CRL |= GPIO_CRL_MODE6_1; // MODE6[1:0] = 10 → 2MHz GPIOB->CRL |= GPIO_CRL_CNF6_1; // CNF6[1:0] = 10 → 复用开漏 GPIOB->CRL |= GPIO_CRL_MODE7_1; GPIOB->CRL |= GPIO_CRL_CNF7_1;🔍 小知识：
CNF位决定输出类型，“10”表示复用开漏，符合I2C电气规范。
第三步：进入配置模式
在修改关键寄存器前，必须先关闭I2C模块：
I2C1->CR1 &= ~I2C_CR1_PE; // 清除PE位，禁用I2C只有PE=0时，才能安全地修改CCR、TRISE等寄存器。
第四步：设置SCL频率 —— 计算CCR值
这是最关键的一步。CCR寄存器控制SCL的高低电平周期。
标准模式（≤100kHz）
公式如下：
CCR = PCLK1 / (2 × I2C_CLK)代入数值：
- PCLK1 = 36,000,000 Hz
- I2C_CLK = 100,000 Hz
→ CCR = 36e6 / (2 × 100e3) = 180
所以：
I2C1->CCR = 180; // 标准模式，占空比50%同时，根据I2C规范，最大上升时间为1000ns。PCLK1周期约为27.8ns（1/36MHz），因此允许最多36个周期上升。
取保守值：
I2C1->TRISE = 37; // ≤ 1000ns / 27.8ns ≈ 36 → +1补偿第五步：设置自身地址（主模式可忽略）
虽然我们工作在主模式，但某些从机会进行地址响应检测，建议设置一个合法的7位地址：
I2C1->OAR1 = (0x20 << 1); // 左移一位，保留最低位为R/W标志这不会影响主模式操作，但有助于调试兼容性问题。
第六步：启用I2C模块
一切就绪后，重新开启I2C：
I2C1->CR1 |= I2C_CR1_PE; // 使能I2C外设此时硬件模块已激活，但尚未开始通信。
第七步：启用自动应答（ACK）
当我们作为主机接收数据时，需要在最后一个字节前关闭ACK，通知从机停止发送。为此，先全局开启ACK：
I2C1->CR1 |= I2C_CR1_ACK; // 使能自动应答后续可根据接收长度动态关闭。
第八步：清除状态寄存器
刚启动时，状态寄存器可能残留旧标志，容易误判。建议读取一次SR1和SR2：
volatile uint32_t tmp; tmp = I2C1->SR1; tmp = I2C1->SR2; (void)tmp; // 避免编译警告至此，I2C1已完成初始化！
完整初始化函数封装
#include "stm32f10x.h" #define I2C_SPEED 100000UL #define PCLK1_FREQ 36000000UL void I2C1_Init(void) { volatile uint32_t tmp; // 1. 开启时钟 RCC->APB2ENR |= RCC_APB2ENR_IOPBEN; RCC->APB1ENR |= RCC_APB1ENR_I2C1EN; // 2. 配置PB6(SCL)和PB7(SDA) GPIOB->CRL &= ~(GPIO_CRL_MODE6 | GPIO_CRL_CNF6); GPIOB->CRL |= GPIO_CRL_MODE6_1 | GPIO_CRL_CNF6_1; GPIOB->CRL &= ~(GPIO_CRL_MODE7 | GPIO_CRL_CNF7); GPIOB->CRL |= GPIO_CRL_MODE7_1 | GPIO_CRL_CNF7_1; // 3. 进入配置模式 I2C1->CR1 &= ~I2C_CR1_PE; // 4. 设置CCR和TRISE if (I2C_SPEED <= 100000) { I2C1->CCR = (PCLK1_FREQ / (I2C_SPEED * 2)); I2C1->TRISE = 37; // 1000ns limit } else { // 快速模式（略） } // 5. 设置本机地址 I2C1->OAR1 = 0x20 << 1; // 6. 使能I2C I2C1->CR1 |= I2C_CR1_PE; // 7. 开启ACK I2C1->CR1 |= I2C_CR1_ACK; // 8. 清除状态 tmp = I2C1->SR1; tmp = I2C1->SR2; }常见问题排查指南
即使配置正确，I2C也常因硬件或逻辑问题失败。以下是几个典型坑点及应对策略。
❌ 问题1：总线卡死，SCL或SDA一直为低
现象：测量发现SCL或SDA始终拉低，无法通信。
原因：
- 从设备故障未释放总线；
- MCU复位后GPIO未配置为开漏，变成推挽输出强行拉低；
- 上拉电阻缺失或断路。
解决方案：
- 手动模拟9个SCL脉冲，迫使从设备释放SDA；
- 使用GPIO临时接管SCL，输出9个时钟后再切回I2C功能；
- 检查PCB焊接和上拉电阻是否存在。
❌ 问题2：总是收到NACK
现象：地址帧发出后，SR1中的AF（Acknowledge Failure）位置位。
可能原因：
- 从设备地址错误（注意左移！）；
- 从设备未上电或未初始化完成；
- 通信速率过高，从设备响应不过来；
- 接线反接或虚焊。
解决方法：
- 使用逻辑分析仪抓包确认发送的地址是否匹配；
- 在初始化后添加延时（如5ms）等待从设备稳定；
- 降速测试（改为50kHz试试）；
- 检查器件手册中的实际地址（有些是固定+引脚电平组合）。
实际应用场景示例：读取AT24C02 EEPROM
假设我们要从地址为0x50的EEPROM读取一个字节，流程如下：
- 发送起始条件；
- 发送写地址（0xA0）；
- 发送内存地址（如0x00）；
- 重复起始；
- 发送读地址（0xA1）；
- 读取数据；
- 发送停止。
这部分可以通过封装I2C_Start()、I2C_WriteByte()、I2C_ReadByte()等函数实现模块化调用，留作练习。
设计最佳实践总结
| 项目 | 推荐做法 |
|---|---|
| 上拉电阻 | 4.7kΩ（标准模式），2.2kΩ（快速模式） |
| PCB布局 | SDA/SCL走线尽量短且等长，远离电源和高频信号 |
| 多设备共存 | 确保各从机地址唯一，避免冲突 |
| 调试工具 | 使用逻辑分析仪观察波形，推荐Saleae或DSLogic |
| 初始化顺序 | 先配GPIO → 再配I2C寄存器 → 最后使能PE |
写在最后：掌握底层，才能驾驭复杂系统
今天我们完成了从零开始的I2C初始化全过程。没有HAL库，没有抽象层，每一行代码都在和硬件对话。
这种能力的价值在哪里？
- 当你移植Bootloader到新平台时，不需要等厂商提供库；
- 当你在RTOS中编写驱动时，能精准控制中断和DMA；
- 当通信出错时，你能看懂SR1里的每一位意味着什么；
- 当别人还在猜“是不是地址错了”，你已经用逻辑分析仪定位到了上升时间超标。
更重要的是，理解I2C的本质，是你迈向I3C（Improved I2C）、掌握现代传感器互联技术的第一步。
未来属于那些不仅能“调通”，还能“讲清”的工程师。
如果你觉得这篇文章帮你打通了任督二脉，欢迎点赞、收藏，并在评论区分享你的I2C踩坑经历。我们一起把嵌入式这条路走得更稳、更远。
