esp32s3iic

### ESP32-S3 IIC (I2C) 使用教程

#### 配置 IIC 总线接口
ESP32-S3 提供两个 IIC 总线接口，可以根据需求配置为主机或从机模式。为了初始化这些接口，需调用 `i2c_param_config` 函数设置参数并启用驱动程序。

#include "driver/i2c.h"

#define I2C_MASTER_SCL_IO    22      /*!< GPIO number used for I2C master clock */
#define I2C_MASTER_SDA_IO    21      /*!< GPIO number used for I2C master data  */

void i2c_master_init(void)
{
    int i2c_master_port = I2C_NUM_0;
    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 = 100000,  // Speed of the bus in Hz.
    };
    
    i2c_param_config(i2c_master_port, &conf);
    i2c_driver_install(i2c_master_port, conf.mode, 0, 0, 0);
}

此代码片段展示了如何通过指定引脚和速率来启动 I2C 主设备[^1]。

#### 数据传输函数
对于数据读写操作，可以利用如下所示的 API：

- **写入单字节命令**

int write_command(uint8_t command){
    esp_err_t ret;
    i2c_cmd_handle_t cmd = i2c_cmd_link_create();
    i2c_master_start(cmd);
    i2c_master_write_byte(cmd, (SLAVE_ADDRESS << 1) | WRITE_BIT, ACK_CHECK_EN);
    i2c_master_write_byte(cmd, command, ACK_CHECK_DIS);
    i2c_master_stop(cmd);
    ret = i2c_master_cmd_begin(I2C_EXAMPLE_MASTER_NUM, cmd, 1000 / portTICK_RATE_MS);
    i2c_cmd_link_delete(cmd);
    return ret;
}

- **读取多字节数组**

int read_data(uint8_t *data_rd, size_t size){
    if (size == 0) {
        return ESP_OK;
    }
    i2c_cmd_handle_t cmd = i2c_cmd_link_create();
    i2c_master_start(cmd);
    i2c_master_write_byte(cmd, (SLAVE_ADDRESS << 1) | READ_BIT, ACK_CHECK_EN);
    i2c_master_read(cmd, data_rd, size, I2C_MASTER_LAST_NACK);
    i2c_master_stop(cmd);
    esp_err_t ret = i2c_master_cmd_begin(I2C_EXAMPLE_MASTER_NUM, cmd, 1000 / portTICK_RATE_MS);
    i2c_cmd_link_delete(cmd);
    return ret;
}

上述 C 语言代码实现了向从器件发送指令以及接收来自该器件的数据流的功能。

#### 常见问题解答

当遇到连接不稳定的情况时，应检查上拉电阻是否合适；因为即使硬件设计允许高达 800 Kbps 的速度，在实际应用中可能由于外部因素而降低性能。另外需要注意的是，如果使用了较长的电缆，则建议减慢通信频率以确保信号质量良好。