2. ESP32的I2C外设详解：I2C控制器模式、I2C从机模式、时钟拉伸、速率配置、SDA/SCL引脚映射

好，咱们直接进入正题。ESP32 的 I2C 外设，说白了就是它内部集成的硬件 I2C 控制器。你不需要用软件去模拟时序，硬件自己就把活儿干了。这玩意儿在低功耗场景下特别重要——因为硬件处理比软件模拟省电得多。

我个人习惯，拿到一个新芯片，第一件事就是看它的外设框图。ESP32 有两个 I2C 控制器，编号是 0 和 1。它们功能完全一样，可以独立工作。这意味着你可以同时挂两路不同的 I2C 总线，互不干扰。

2.1 I2C 控制器模式

控制器模式，就是咱们常说的主机模式。ESP32 作为总线上的老大，负责产生时钟信号、发起通信、决定什么时候读什么时候写。

我记得第一次用 ESP32 的 I2C 时，最让我舒服的是它的硬件 FIFO。内部有个 32 字节的 FIFO 缓冲区，你可以一次性把要发的数据丢进去，然后等着中断或者轮询完成就行。不用像用 GPIO 模拟 I2C 那样，一个 bit 一个 bit 地折腾。

控制器模式下，典型的操作流程是这样的：

1. 配置 I2C 参数——时钟频率、引脚映射、是否启用内部上拉
2. 启动总线——调用初始化函数
3. 发起通信——写入从机地址、寄存器地址、数据
4. 等待完成——轮询状态寄存器或等待中断
5. 处理错误——比如从机无应答、仲裁丢失

2.2 I2C 从机模式

从机模式用得少，但用对了地方很巧妙。ESP32 作为从机时，它不产生时钟，而是被动响应控制器的请求。

我曾经在一个多传感器节点项目里用过这个模式。一个 ESP32 做主控，另一个 ESP32 专门采集温度数据，通过 I2C 从机模式把数据传给主控。这样从机可以大部分时间睡大觉，主控需要数据时再唤醒它。

从机模式需要配置几个关键东西：

• 从机地址——7 位或 10 位，不能和总线上其他设备冲突
• 应答策略——收到数据后是否自动应答
• TX/RX FIFO——发送缓冲区和接收缓冲区

2.3 时钟拉伸

时钟拉伸，英文叫 Clock Stretching。这是个容易让人迷糊的概念。

简单说，就是从机把 SCL 线拉低，告诉主机“我还没准备好，你等一会儿”。主机检测到 SCL 被拉低后，会停止发送时钟脉冲，直到从机释放 SCL 线。

为什么会这样？因为有些从机设备处理数据比较慢，比如 EEPROM 写入需要时间，或者某些传感器转换数据需要时间。这时候从机就通过时钟拉伸来“刹车”。

ESP32 作为控制器时，默认支持时钟拉伸。但有个细节——ESP32 的硬件 I2C 控制器在时钟拉伸时，会一直等待，不会超时退出。这意味着如果从机一直拉着 SCL 不放，你的程序就卡死了。

2.4 速率配置

ESP32 的 I2C 支持标准模式（100kHz）和快速模式（400kHz）。理论上还能跑到更高，但官方文档建议不要超过 400kHz，尤其是连接多个设备时。

速率配置其实就一个参数——时钟分频系数。ESP32 的 I2C 时钟源是 APB 时钟（通常 80MHz），通过分频得到 SCL 频率。

计算公式很简单：

SCL 频率 = APB 时钟频率 / (分频系数 × 2)

举个例子：
APB = 80MHz
想要 100kHz → 分频系数 = 80M / (100k × 2) = 400
想要 400kHz → 分频系数 = 80M / (400k × 2) = 100

实际配置时，ESP-IDF 提供了结构体，你直接填目标频率就行，驱动库会自动计算分频系数。

模式	标准频率	典型应用场景	注意事项
标准模式	100 kHz	大多数传感器、EEPROM	兼容性最好，线长可达 1 米
快速模式	400 kHz	高速传感器、显示驱动	总线电容要小，线长建议 30cm 以内
高速模式	1 MHz 以上	不推荐在 ESP32 上使用	官方未保证稳定性

2.5 SDA/SCL 引脚映射

ESP32 的一大特色就是引脚可任意映射。I2C 的 SDA 和 SCL 不绑定在固定引脚上，你可以自由选择。

但自由不等于随便。我踩过不少引脚的坑，总结几条经验：

• 避开 ADC2 引脚——Wi-Fi 开启时，ADC2 会被占用，I2C 用这些引脚会出问题
• 避开 Strapping 引脚——GPIO0、GPIO2、GPIO12 这些引脚在芯片启动时有特殊功能，乱用可能导致无法下载程序
• 优先用 GPIO21、GPIO22——这是 ESP32 开发板默认的 I2C 引脚，兼容性最好
• 注意电平匹配——如果传感器是 3.3V，ESP32 也是 3.3V，直接连。如果传感器是 5V，需要加电平转换

引脚映射在代码里就是两个参数：

i2c_config_t conf = {
    .mode = I2C_MODE_MASTER,
    .sda_io_num = GPIO_NUM_21,      // SDA 引脚
    .scl_io_num = GPIO_NUM_22,      // SCL 引脚
    .sda_pullup_en = GPIO_PULLUP_ENABLE,
    .scl_pullup_en = GPIO_PULLUP_ENABLE,
    .master.clk_speed = 100000      // 100kHz
};

2.6 知识结构总览

下面这张图把 ESP32 I2C 外设的核心知识点串起来了。你可以把它当作一个快速参考。

2.7 实际项目中的配置步骤

说了这么多理论，咱们看看实际代码怎么写。下面是一个完整的 I2C 初始化流程，我一般把它放在 app_main() 的开头：

#include "driver/i2c.h"

#define I2C_MASTER_NUM       I2C_NUM_0
#define I2C_MASTER_SDA_IO    GPIO_NUM_21
#define I2C_MASTER_SCL_IO    GPIO_NUM_22
#define I2C_MASTER_FREQ_HZ   100000

void i2c_master_init(void)
{
    i2c_config_t conf = {
        .mode = I2C_MODE_MASTER,
        .sda_io_num = I2C_MASTER_SDA_IO,
        .scl_io_num = I2C_MASTER_SCL_IO,
        .sda_pullup_en = GPIO_PULLUP_ENABLE,
        .scl_pullup_en = GPIO_PULLUP_ENABLE,
        .master.clk_speed = I2C_MASTER_FREQ_HZ,
    };
    
    ESP_ERROR_CHECK(i2c_param_config(I2C_MASTER_NUM, &conf));
    ESP_ERROR_CHECK(i2c_driver_install(I2C_MASTER_NUM, conf.mode, 0, 0, 0));
}

这段代码做了三件事：配置参数、写入寄存器、安装驱动。注意 i2c_driver_install 的最后三个参数，分别是 RX 缓冲区大小、TX 缓冲区大小和中断标志。控制器模式下，如果不用中断，填 0 就行。