HAL_I2C_Mem_Read

hal_i2c_mem_read函数是一个用于读取I2C设备中指定地址的数据的函数。该函数的详细解释如下：

函数原型：esp_err_t hal_i2c_mem_read(i2c_port_t i2c_num, uint8_t dev_addr, uint16_t mem_addr, uint8_t *data, size_t size, TickType_t ticks_to_wait)

参数说明：

i2c_num：I2C总线的编号，取值为I2C_NUM_或I2C_NUM_1。

dev_addr：I2C设备的地址。

mem_addr：要读取的寄存器地址。

data：读取到的数据将存储在该指针所指向的缓冲区中。

size：要读取的数据的字节数。

ticks_to_wait：等待I2C总线空闲的时间，单位为系统时钟节拍数。

返回值说明：

该函数返回一个esp_err_t类型的错误码，如果执行成功，则返回ESP_OK。

函数功能：

该函数用于读取I2C设备中指定地址的数据。在读取数据之前，需要先向I2C设备发送一个寄存器地址，然后再读取该地址中存储的数据。该函数会自动处理I2C总线的起始和停止信号，并等待I2C总线空闲后再执行读取操作。

使用示例：

以下是一个使用hal_i2c_mem_read函数读取I2C设备数据的示例代码：

#include "driver/i2c.h"

#define I2C_NUM I2C_NUM_
#define I2C_ADDR x50
#define MEM_ADDR x00
#define DATA_SIZE 4

void i2c_master_init()
{
    i2c_config_t conf;
    conf.mode = I2C_MODE_MASTER;
    conf.sda_io_num = 21;
    conf.sda_pullup_en = GPIO_PULLUP_ENABLE;
    conf.scl_io_num = 22;
    conf.scl_pullup_en = GPIO_PULLUP_ENABLE;
    conf.master.clk_speed = 100000;
    i2c_param_config(I2C_NUM, &conf);
    i2c_driver_install(I2C_NUM, conf.mode, , , );
}

void i2c_mem_read()
{
    uint8_t data[DATA_SIZE];
    esp_err_t ret = hal_i2c_mem_read(I2C_NUM, I2C_ADDR, MEM_ADDR, data, DATA_SIZE, 100 / portTICK_RATE_MS);
    if (ret == ESP_OK) {
        printf("Read data: ");
        for (int i = ; i < DATA_SIZE; i++) {
            printf("%02x ", data[i]);
        }
        printf("\n");
    } else {
        printf("Read data failed\n");
    }
}

void app_main()
{
    i2c_master_init();
    i2c_mem_read();
}

该示例代码中，首先调用i2c_master_init函数初始化I2C总线，然后调用i2c_mem_read函数读取I2C设备中地址为x00的4个字节数据。如果读取成功，则将读取到的数据打印出来，否则打印读取失败的提示信息。