HAL_I2C_Mem_Write函数详解

HAL_I2C_Mem_Write函数是STM32 HAL库中的一个函数，用于向I2C设备的指定内存地址写入数据。

函数原型如下：

HAL_StatusTypeDef HAL_I2C_Mem_Write(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout)

参数说明：

- hi2c：I2C句柄
- DevAddress：I2C设备地址
- MemAddress：要写入的内存地址
- MemAddSize：内存地址大小，可以是I2C_MEMADD_SIZE_8BIT或I2C_MEMADD_SIZE_16BIT
- pData：要写入的数据指针
- Size：要写入的数据长度
- Timeout：超时时间

函数返回值：

返回值是一个枚举类型，表示函数执行结果。常见返回值有：

- HAL_OK：函数执行成功
- HAL_BUSY：总线忙
- HAL_ERROR：函数执行出错
- HAL_TIMEOUT：超时

函数详解：

HAL_I2C_Mem_Write函数用于向I2C设备的指定内存地址写入数据。函数执行过程如下：

1. 检查I2C总线是否忙，如果忙则返回HAL_BUSY。

2. 向I2C设备发送起始信号，等待设备响应。

3. 发送设备地址和写命令，等待设备响应。

4. 发送内存地址，等待设备响应。如果内存地址大小为16位，则要先发送高位，再发送低位。

5. 发送要写入的数据，等待设备响应。

6. 发送停止信号，等待设备响应。

7. 检查发送数据的长度是否与要写入的数据长度相等，如果不相等则返回HAL_ERROR。

8. 返回函数执行成功。

函数调用示例：

以下是一个使用HAL_I2C_Mem_Write函数向I2C设备写入数据的示例代码：

uint8_t data[4] = {0x01, 0x02, 0x03, 0x04}; // 要写入的数据
HAL_StatusTypeDef status = HAL_I2C_Mem_Write(&hi2c1, 0xA0, 0x0000, I2C_MEMADD_SIZE_16BIT, data, sizeof(data), 1000);
if (status != HAL_OK) {
  // 写入失败
} else {
  // 写入成功
}

该示例代码使用hi2c1句柄向I2C设备0xA0的0x0000地址写入4个字节的数据。函数执行超时时间为1000ms。如果写入失败，status变量的值不等于HAL_OK，可以根据返回值判断写入是否成功。