OpenHarmony（鸿蒙南向）——平台驱动指南【I2C】

往期知识点记载：

• 鸿蒙（HarmonyOS）应用层开发（北向）知识点汇总
  
• 鸿蒙（OpenHarmony）南向开发保姆级知识点汇总~
  
• 连续更新中……
  

概述

功能简介

I2C（Inter Integrated Circuit）总线是由Philips公司开发的一种简朴、双向二线制同步串行总线。由于其硬件连接简朴、成本低廉，因此被广泛应用于各种短间隔通讯的场景。
运作机制

I2C以主从方式工作，通常有一个主设备和一个或者多个从设备，主从设备通过SDA（SerialData）串行数据线以及SCL（SerialClock）串行时钟线两根线相连（如图1）。
I2C数据的传输必须以一个起始信号作为开始条件，以一个结束信号作为传输的制止条件。数据传输以字节为单元，高位在前，逐个bit举行传输。
I2C总线上的每一个设备都可以作为主设备或者从设备，而且每一个设备都会对应一个唯一的地点，当主设备需要和某一个从设备通讯时，通过广播的方式，将从设备地点写到总线上，如果某个从设备符合此地点，将会发出应答信号，建立传输。
I2C接口界说了完成I2C传输的通用方法集合，包罗：

• I2C控制器管理：打开或关闭I2C控制器
  
• I2C消息传输：通过消息传输布局体数组举行自界说传输
  

图 1 I2C物理连线示意图

利用引导

场景介绍

I2C通常用于与各类支持I2C协议的传感器、执行器或输入输出设备举行通讯。
接口说明

I2C模块提供的主要接口如表1所示，具体API详见//drivers/hdf_core/framework/include/platform/i2c_if.h。
表 1 I2C驱动API接口功能介绍
接口名接口描述DevHandle I2cOpen(int16_t number)打开I2C控制器void I2cClose(DevHandle handle)关闭I2C控制器int32_t I2cTransfer(DevHandle handle, struct I2cMsg *msgs, int16_t count)自界说传输 利用流程

利用I2C设备的一般流程如下图所示。
图 2 I2C设备利用流程图

打开I2C控制器

在举行I2C通讯前，首先要调用I2cOpen打开I2C控制器。

1. DevHandle I2cOpen(int16_t number);

复制代码

表 2 I2cOpen参数和返回值描述
参数参数描述numberint16_t类型，I2C控制器号返回值返回值描述NULL打开I2C控制器失败设备句柄打开的I2C控制器设备句柄 假设体系中存在8个I2C控制器，编号从0到7，以下代码示例为获取3号控制器：

1. DevHandle i2cHandle = NULL;  // I2C控制器句柄
3. // 打开I2C控制器
4. i2cHandle = I2cOpen(3);
5. if (i2cHandle == NULL) {
6.     HDF_LOGE("I2cOpen: i2c open fail.\n");
7.     return NULL;
8. }

复制代码

举行I2C通讯

消息传输

1. int32_t I2cTransfer(DevHandle handle, struct I2cMsg *msgs, int16_t count);

复制代码

表 3 I2cTransfer参数和返回值描述
参数参数描述handleDevHandle类型，I2C控制器设备句柄msgs布局体指针，待传输数据的消息布局体数组countint16_t类型，消息数组长度返回值返回值描述正整数成功传输的消息布局体数量负数执行失败 I2C传输消息类型为I2cMsg，每个传输消息布局体表示一次读或写，通过一个消息数组，可以执行多少次的读写组合操作。组合读写示例：

1. int32_t ret;
2. uint8_t wbuff[2] = { 0x12, 0x13 };
3. uint8_t rbuff[2] = { 0 };
4. struct I2cMsg msgs[2];        // 自定义传输的消息结构体数组
5. msgs[0].buf = wbuff;          // 写入的数据
6. msgs[0].len = 2;              // 写入数据长度为2
7. msgs[0].addr = 0x5A;          // 写入设备地址为0x5A
8. msgs[0].flags = 0;            // 传输标记为0，默认为写
9. msgs[1].buf = rbuff;          // 要读取的数据
10. msgs[1].len = 2;              // 读取数据长度为2
11. msgs[1].addr = 0x5A;          // 读取设备地址为0x5A
12. msgs[1].flags = I2C_FLAG_READ // I2C_FLAG_READ置位
13. // 进行一次自定义传输，传输的消息个数为2
14. ret = I2cTransfer(i2cHandle, msgs, 2);
15. if (ret != 2) {
16.     HDF_LOGE("I2cTransfer: i2c transfer fail, ret:%d\n", ret);
17.     return HDF_FAILURE;
18. }

复制代码

  注意：
  

• I2cMsg布局体中的设备地点不包罗读写标志位，读写信息由flags成员变量的读写控制位转达。
  
• 本函数不对消息布局体个数count做限定，其最大个数度由具体I2C控制器决定。
  
• 本函数也不对每个消息布局体中的数据长度做限定，同样由具体I2C控制器决定。
  
• 本函数可能会引起体系休眠，不允许在制止上下文调用
  

  关闭I2C控制器

I2C通讯完成之后，需要关闭I2C控制器，关闭函数如下所述：

1. void I2cClose(DevHandle handle);

复制代码

表 4 I2cClose参数和返回值描述
参数参数描述handleDevHandle类型，I2C控制器设备句柄 关闭I2C控制器示例：

1. I2cClose(i2cHandle); // 关闭I2C控制器

复制代码

利用示例

本例程以操作开发板上的I2C设备为例，详细展示I2C接口的完备利用流程。
本例拟对Hi3516DV300开发板上TouchPad设备举行简朴的寄存器读写访问，基本硬件信息如下：

• SOC：hi3516dv300。
  
• Touch IC：I2C地点为0x38，IC内部寄存器位宽为1字节。
  
• 硬件连接：TouchPad设备挂接在3号I2C控制器下；IC的复位管脚为3号GPIO。
  

本例程首先对Touch IC举行复位操作（开发板上电默认会给TouchIC供电，本例程不考虑供电），然后对其内部寄存器举行随机读写，测试I2C通路是否正常。
   说明：
本示例重点在于展示I2C设备访问流程，并验证I2C通路，所以对于设备寄存器读写值不做关注，读写寄存器导致的行为由设备自身决定。
  示例如下：

1. #include "i2c_if.h"          /* I2C标准接口头文件 */
2. #include "gpio_if.h"         /* GPIO标准接口头文件 */
3. #include "hdf_log.h"         /* 标准日志打印头文件 */
4. #include "osal_io.h"         /* 标准IO读写接口头文件 */
5. #include "osal_time.h"       /* 标准延迟&睡眠接口头文件 */
7. /* 定义一个表示TP设备的结构体，存储i2c及gpio相关硬件信息 */
8. struct TpI2cDevice {
9.     uint16_t rstGpio;             /* 复位管脚 */
10.     uint16_t busId;               /* I2C总线号 */
11.     uint16_t addr;                /* I2C设备地址 */
12.     uint16_t regLen;              /* 寄存器字节宽度 */
13.     DevHandle i2cHandle;  /* I2C控制器句柄 */
14. };
16. /* I2C管脚io配置，需要查阅SOC寄存器手册  */
17. #define I2C3_DATA_REG_ADDR 0x112f008c /* 3号I2C控制器SDA管脚配置寄存器地址 */
18. #define I2C3_CLK_REG_ADDR 0x112f0090  /* 3号I2C控制器SCL管脚配置寄存器地址 */
19. #define I2C_REG_CFG 0x5f1             /* 3号I2C控制器SDA及SCL管脚配置值 */
21. static void TpSocIoCfg(void)
22. {
23.     /* 将3号I2C控制器对应两个管脚的IO功能设置为I2C */
24.     OSAL_WRITEL(I2C_REG_CFG, IO_DEVICE_ADDR(I2C3_DATA_REG_ADDR));
25.     OSAL_WRITEL(I2C_REG_CFG, IO_DEVICE_ADDR(I2C3_CLK_REG_ADDR));
26. }
28. /* 对TP的复位管脚进行初始化， 拉高维持20ms, 再拉底维持50ms，最后再拉高维持20ms， 完成复位动作 */
29. static int32_t TestCaseGpioInit(struct TpI2cDevice *tpDevice)
30. {
31.     int32_t ret;
33.     /* 设置复位管脚方向为输出 */
34.     ret = GpioSetDir(tpDevice->rstGpio, GPIO_DIR_OUT);
35.     if (ret != HDF_SUCCESS) {
36.         HDF_LOGE("%s: set rst dir fail!:%d", __func__, ret);
37.         return ret;
38.     }
40.     ret = GpioWrite(tpDevice->rstGpio, GPIO_VAL_HIGH);
41.     if (ret != HDF_SUCCESS) {
42.         HDF_LOGE("%s: set rst hight fail!:%d", __func__, ret);
43.         return ret;
44.     }
45.     OsalMSleep(20);
47.     ret = GpioWrite(tpDevice->rstGpio, GPIO_VAL_LOW);
48.     if (ret != HDF_SUCCESS) {
49.         HDF_LOGE("%s: set rst low fail!:%d", __func__, ret);
50.         return ret;
51.     }
52.     OsalMSleep(50);
54.     ret = GpioWrite(tpDevice->rstGpio, GPIO_VAL_HIGH);
55.     if (ret != HDF_SUCCESS) {
56.         HDF_LOGE("%s: set rst high fail!:%d", __func__, ret);
57.         return ret;
58.     }
59.     OsalMSleep(20);
61.     return HDF_SUCCESS;
62. }
64. /* 基于I2cTransfer方法封装一个寄存器读写的辅助函数， 通过flag表示读或写 */
65. static int TpI2cReadWrite(struct TpI2cDevice *tpDevice, unsigned int regAddr,
66.     unsigned char *regData, unsigned int dataLen, uint8_t flag)
67. {
68.     int index = 0;
69.     unsigned char regBuf[4] = {0};
70.     struct I2cMsg msgs[2] = {0};
72.     /* 单双字节寄存器长度适配 */
73.     if (tpDevice->regLen == 1) {
74.         regBuf[index++] = regAddr & 0xFF;
75.     } else {
76.         regBuf[index++] = (regAddr >> 8) & 0xFF;
77.         regBuf[index++] = regAddr & 0xFF;
78.     }
80.     /* 填充I2cMsg消息结构 */
81.     msgs[0].addr = tpDevice->addr;
82.     msgs[0].flags = 0; /* 标记为0，表示写入 */
83.     msgs[0].len = tpDevice->regLen;
84.     msgs[0].buf = regBuf;
86.     msgs[1].addr = tpDevice->addr;
87.     msgs[1].flags = (flag == 1) ? I2C_FLAG_READ : 0; /* 添加读标记位，表示读取 */
88.     msgs[1].len = dataLen;
89.     msgs[1].buf = regData;
91.     if (I2cTransfer(tpDevice->i2cHandle, msgs, 2) != 2) {
92.         HDF_LOGE("%s: i2c read err", __func__);
93.         return HDF_FAILURE;
94.     }
95.     return HDF_SUCCESS;
96. }
98. /* TP寄存器读函数 */
99. static inline int TpI2cReadReg(struct TpI2cDevice *tpDevice, unsigned int regAddr,
100.     unsigned char *regData, unsigned int dataLen)
101. {
102.     return TpI2cReadWrite(tpDevice, regAddr, regData, dataLen, 1);
103. }
105. /* TP寄存器写函数 */
106. static inline int TpI2cWriteReg(struct TpI2cDevice *tpDevice, unsigned int regAddr,
107.     unsigned char *regData, unsigned int dataLen)
108. {
109.     return TpI2cReadWrite(tpDevice, regAddr, regData, dataLen, 0);
110. }
112. /* I2C例程总入口 */
113. static int32_t TestCaseI2c(void)
114. {
115.     int32_t i;
116.     int32_t ret;
117.     unsigned char bufWrite[7] = { 0xFF, 0xFF, 0xFF, 0xFF, 0xA, 0xB, 0xC };
118.     unsigned char bufRead[7] = {0};
119.     static struct TpI2cDevice tpDevice;
121.     /* IO管脚功能配置 */
122.     TpSocIoCfg();
124.     /* TP设备信息初始化 */
125.     tpDevice.rstGpio = 3;
126.     tpDevice.busId = 3;
127.     tpDevice.addr = 0x38;
128.     tpDevice.regLen = 1;
129.     tpDevice.i2cHandle = NULL;
131.     /* GPIO管脚初始化 */
132.     ret = TestCaseGpioInit(&tpDevice);
133.     if (ret != HDF_SUCCESS) {
134.         HDF_LOGE("%s: gpio init fail!:%d", __func__, ret);
135.         return ret;
136.     }
138.     /* 打开I2C控制器 */
139.     tpDevice.i2cHandle = I2cOpen(tpDevice.busId);
140.     if (tpDevice.i2cHandle == NULL) {
141.         HDF_LOGE("%s: Open I2c:%u fail!", __func__, tpDevice.busId);
142.         return -1;
143.     }
145.     /* 向TP-IC的0xD5寄存器连续写7字节数据 */
146.     ret = TpI2cWriteReg(&tpDevice, 0xD5, bufWrite, 7);
147.     if (ret != HDF_SUCCESS) {
148.         HDF_LOGE("%s: tp i2c write reg fail!:%d", __func__, ret);
149.         I2cClose(tpDevice.i2cHandle);
150.         return -1;
151.     }
152.     OsalMSleep(10);
154.     /* 从TP-IC的0xD5寄存器连续读7字节数据 */
155.     ret = TpI2cReadReg(&tpDevice, 0xD5, bufRead, 7);
156.     if (ret != HDF_SUCCESS) {
157.         HDF_LOGE("%s: tp i2c read reg fail!:%d", __func__, ret);
158.         I2cClose(tpDevice.i2cHandle);
159.         return -1;
160.     }
162.     HDF_LOGE("%s: tp i2c write&read reg success!", __func__);
163.     for (i = 0; i < 7; i++) {
164.         HDF_LOGE("%s: bufRead[%d] = 0x%x", __func__, i, bufRead[i]);
165.     }
167.     /* 访问完毕关闭I2C控制器 */
168.     I2cClose(tpDevice.i2cHandle);
169.     return ret;
170. }

复制代码

末了

经常有很多小同伴诉苦说：不知道学习鸿蒙开发哪些技能？不知道需要重点把握哪些鸿蒙应用开发知识点？
为了可以或许资助到大家可以或许有规划的学习，这里特殊整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技能的学习门路，包罗了鸿蒙开发必把握的焦点知识要点，内容有（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技能、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、体系定制移植等等）鸿蒙（HarmonyOS NEXT）技能知识点。

《鸿蒙 (Harmony OS)开发学习手册》（共计892页）:https://gitcode.com/HarmonyOS_MN/733GH/overview

怎样快速入门？

1.基本概念
2.构建第一个ArkTS应用
3.……

鸿蒙开发口试真题（含参考答案）:

《OpenHarmony源码剖析》:

• 搭建开发环境
  
• Windows 开发环境的搭建
  
• Ubuntu 开发环境搭建
  
• Linux 与 Windows 之间的文件共享
  
• ……
  
• 体系架构分析
  
• 构建子体系
  
• 启动流程
  
• 子体系
  
• 分布式使命调理子体系
  
• 分布式通讯子体系
  
• 驱动子体系
  
• ……
  

OpenHarmony 设备开发学习手册:https://gitcode.com/HarmonyOS_MN/733GH/overview

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。