OpenHarmony API-I2cWrite()向 I2C 设备写数据-马育民老师

# 介绍

通过I2C总线向外部设备（如OLED屏、传感器等）写入数据

### 头文件

```
base\iot_hardware\interfaces\kits\wifiiot_lite\wifiiot_i2c.h
```

```
#include "wifiiot_i2c.h"
```

### 定义

```
/**
 * @brief Writes data to an I2C device.
 *
 *
 *
 * @param id Indicates the I2C device ID.
 * @param deviceAddr Indicates the I2C device address.
 * @param i2cData Indicates the pointer to the data descriptor to write.
 * @return Returns {@link WIFI_IOT_SUCCESS} if the operation is successful;
 * returns an error code defined in {@link wifiiot_errno.h} otherwise.
 * @since 1.0
 * @version 1.0
 */
unsigned int I2cWrite(WifiIotI2cIdx id, unsigned short deviceAddr, const WifiIotI2cData *i2cData);
```

**参数：**

| 参数名        | 类型                  | 含义说明                                                                 |
|---------------|-----------------------|--------------------------------------------------------------------------|
| `id`          | `WifiIotI2cIdx`       | I2C总线编号（ID），用于指定使用哪一路I2C硬件接口。<br>例如Hi3861开发板通常支持`WIFI_IOT_I2C_IDX_0`（I2C0）。 |
| `deviceAddr`  | `unsigned short`      | 目标I2C设备的地址（7位或10位地址，取决于设备）。<br>例如OLED屏常见地址为`0x78`、`0x3C`或`0x3D`。                |
| `i2cData`     | `const WifiIotI2cData *` | 指向待发送数据的结构体指针，包含发送缓冲区和数据长度（见下方结构体说明）。 |

**返回值：**

- 成功：返回 `WIFI_IOT_SUCCESS`（通常定义为 `0` ）。
- 失败：返回错误码

以上都定义在 `wifiiot_errno.h` 中，如I2C总线未初始化、通信超时等

# 相关结构体 WifiIotI2cData

详见链接：
https://www.malaoshi.top/show_1GW200V68QBl.html

# 注意事项

1. **I2C总线初始化**：使用 `I2cWrite()` 前，需先通过 `I2cInit()` 初始化对应I2C总线（设置通信速率等），否则会返回失败。
   
2. **设备地址格式**：`deviceAddr` 需与外设实际地址一致（注意是7位地址，无需左移1位，鸿蒙驱动会自动处理）。

3. **数据缓冲区**：`sendBuf` 必须指向有效内存（提前分配），且 `sendLen` 不能超过外设支持的最大单次传输长度（避免溢出）。

4. **协议适配**：不同I2C设备（如OLED、传感器）对数据格式的要求不同（如OLED需要区分“指令”和“数据”），需根据外设 datasheet 填充 `sendBuf`。

该函数是鸿蒙I2C通信的基础接口，掌握其用法是实现OLED显示、传感器数据写入等功能的关键。

# 例子

详见链接：
https://www.malaoshi.top/show_1GW200V68QBl.html

原文出处：http://malaoshi.top/show_1GW20314KsMw.html