OpenHarmony：如何使用HDF平臺(tái)驅(qū)動(dòng)控制I2C
想了解更多關(guān)于開(kāi)源的內(nèi)容，請(qǐng)?jiān)L問(wèn)：
一、程序介紹
本程序是基于OpenHarmony標(biāo)準(zhǔn)系統(tǒng)編寫(xiě)的平臺(tái)驅(qū)動(dòng)案例：I2C
目前已在凌蒙派-RK3568開(kāi)發(fā)板跑通。詳細(xì)資料請(qǐng)參考官網(wǎng)：https://gitee.com/Lockzhiner-Electronics/lockzhiner-rk3568-openharmony/tree/master/samples/b06_platform_device_i2c。
詳細(xì)資料請(qǐng)參考官網(wǎng)：
二、基礎(chǔ)知識(shí)
1、I2C簡(jiǎn)介
I2C（Inter Integrated Circuit）總線是由Philips公司開(kāi)發(fā)的一種簡(jiǎn)單、雙向二線制同步串行總線。由于其硬件連接簡(jiǎn)單、成本低廉，因此被廣泛應(yīng)用于各種短距離通信的場(chǎng)景。
I2C以主從方式工作，通常有一個(gè)主設(shè)備和一個(gè)或者多個(gè)從設(shè)備，主從設(shè)備通過(guò)SDA（SerialData）串行數(shù)據(jù)線以及SCL（SerialClock）串行時(shí)鐘線兩根線相連（如圖1）。
I2C數(shù)據(jù)的傳輸必須以一個(gè)起始信號(hào)作為開(kāi)始條件，以一個(gè)結(jié)束信號(hào)作為傳輸?shù)耐Ｖ箺l件。數(shù)據(jù)傳輸以字節(jié)為單位，高位在前，逐個(gè)bit進(jìn)行傳輸。
I2C總線上的每一個(gè)設(shè)備都可以作為主設(shè)備或者從設(shè)備，而且每一個(gè)設(shè)備都會(huì)對(duì)應(yīng)一個(gè)唯一的地址，當(dāng)主設(shè)備需要和某一個(gè)從設(shè)備通信時(shí)，通過(guò)廣播的方式，將從設(shè)備地址寫(xiě)到總線上，如果某個(gè)從設(shè)備符合此地址，將會(huì)發(fā)出應(yīng)答信號(hào)，建立傳輸。
I2C接口定義了完成I2C傳輸?shù)耐ㄓ梅椒?，包括?/p>
- I2C控制器管理：打開(kāi)或關(guān)閉I2C控制器。
- I2C消息傳輸：通過(guò)消息傳輸結(jié)構(gòu)體數(shù)組進(jìn)行自定義傳輸。
I2C物理連線示意圖：
OpenHarmony：如何使用HDF平臺(tái)驅(qū)動(dòng)控制I2C-開(kāi)源基礎(chǔ)軟件社區(qū)
2、I2C驅(qū)動(dòng)開(kāi)發(fā)
（1）I2C驅(qū)動(dòng)開(kāi)發(fā)接口
為了保證上層在調(diào)用I2C接口時(shí)能夠正確的操作硬件，核心層在//drivers/hdf_core/framework/support/platform/include/i2c/i2c_core.h中定義了以下鉤子函數(shù)。驅(qū)動(dòng)適配者需要在適配層實(shí)現(xiàn)這些函數(shù)的具體功能，并與這些鉤子函數(shù)掛接，從而完成接口層與核心層的交互。
I2cMethod和I2cLockMethod定義：
struct I2cMethod {
int32_t (*transfer)(struct I2cCntlr *cntlr, struct I2cMsg *msgs, int16_t count);
};
struct I2cLockMethod { // 鎖機(jī)制操作結(jié)構(gòu)體
int32_t (*lock)(struct I2cCntlr *cntlr);
void (*unlock)(struct I2cCntlr *cntlr);
};在適配層中，I2cMethod必須被實(shí)現(xiàn)，I2cLockMethod可根據(jù)實(shí)際情況考慮是否實(shí)現(xiàn)。核心層提供了默認(rèn)的I2cLockMethod，其中使用mutex作為保護(hù)臨界區(qū)的鎖：
static int32_t I2cCntlrLockDefault(struct I2cCntlr *cntlr)
{
if (cntlr == NULL) {
return HDF_ERR_INVALID_OBJECT;
}
return OsalMutexLock(&cntlr->lock);
}
static void I2cCntlrUnlockDefault(struct I2cCntlr *cntlr)
{
if (cntlr == NULL) {
return;
}
(void)OsalMutexUnlock(&cntlr->lock);
}
static const struct I2cLockMethod g_i2cLockOpsDefault = {
.lock = I2cCntlrLockDefault,
.unlock = I2cCntlrUnlockDefault,
};若實(shí)際情況不允許使用mutex（例如使用者可能在中斷上下文調(diào)用I2C接口，mutex可能導(dǎo)致休眠，而中斷上下文不允許休眠）時(shí)，驅(qū)動(dòng)適配者可以考慮使用其他類型的鎖來(lái)實(shí)現(xiàn)一個(gè)自定義的I2cLockMethod。一旦實(shí)現(xiàn)了自定義的I2cLockMethod，默認(rèn)的I2cLockMethod將被覆蓋。
I2cMethod結(jié)構(gòu)體成員函數(shù)功能說(shuō)明：
函數(shù)成員 | 入?yún)?/p> | 出參 | 返回值 | 功能 |
transfer | cntlr：結(jié)構(gòu)體指針，核心層I2C控制器。 msgs：結(jié)構(gòu)體指針，用戶消息。 count：uint16_t，消息數(shù)量。 | 無(wú) | HDF_STATUS相關(guān)狀態(tài) | 傳遞用戶消息 |
I2cLockMethod結(jié)構(gòu)體成員函數(shù)功能說(shuō)明：
函數(shù)成員 | 入?yún)?/p> | 出參 | 返回值 | 功能 |
lock | cntlr：結(jié)構(gòu)體指針，核心層I2C控制器。 | 無(wú) | HDF_STATUS相關(guān)狀態(tài) | 獲取臨界區(qū)鎖 |
unlock | cntlr：結(jié)構(gòu)體指針，核心層I2C控制器。 | 無(wú) | HDF_STATUS相關(guān)狀態(tài) | 釋放臨界區(qū)鎖 |
（2）I2C驅(qū)動(dòng)開(kāi)發(fā)步驟
I2C模塊適配HDF框架包含以下四個(gè)步驟：
- 實(shí)例化驅(qū)動(dòng)入口。
- 配置屬性文件。
- 實(shí)例化I2C控制器對(duì)象。
- 驅(qū)動(dòng)調(diào)試。
我們以///drivers/hdf_core/adapter/khdf/linux/platform/i2c/i2c_adapter.c為例（該I2C驅(qū)動(dòng)是建立于Linux I2C子系統(tǒng)基礎(chǔ)上創(chuàng)建）。
驅(qū)動(dòng)實(shí)例化驅(qū)動(dòng)入口
I2C控制器會(huì)出現(xiàn)很多個(gè)設(shè)備掛接的情況，因而在HDF框架中首先會(huì)為此類型的設(shè)備創(chuàng)建一個(gè)管理器對(duì)象，并同時(shí)對(duì)外發(fā)布一個(gè)管理器服務(wù)來(lái)統(tǒng)一處理外部訪問(wèn)。這樣，用戶需要打開(kāi)某個(gè)設(shè)備時(shí)，會(huì)先獲取到管理器服務(wù)，然后管理器服務(wù)根據(jù)用戶指定參數(shù)查找到指定設(shè)備。
I2C管理器服務(wù)的驅(qū)動(dòng)由核心層實(shí)現(xiàn)，驅(qū)動(dòng)適配者不需要關(guān)注這部分內(nèi)容的實(shí)現(xiàn)，但在實(shí)現(xiàn)Init函數(shù)的時(shí)候需要調(diào)用核心層的I2cCntlrAdd函數(shù)，它會(huì)實(shí)現(xiàn)相應(yīng)功能。
I2C驅(qū)動(dòng)入口開(kāi)發(fā)參考：
struct HdfDriverEntry g_i2cLinuxDriverEntry = {
.moduleVersion = 1,
.Bind = LinuxI2cBind,
.Init = LinuxI2cInit,
.Release = LinuxI2cRelease,
.moduleName = "linux_i2c_adapter", // 【必要且與device_info.hcs文件里面匹配】
};
HDF_INIT(g_i2cLinuxDriverEntry); // 調(diào)用HDF_INIT將驅(qū)動(dòng)入口注冊(cè)到HDF框架中
/* 核心層i2c_core.c管理器服務(wù)的驅(qū)動(dòng)入口 */
struct HdfDriverEntry g_i2cManagerEntry = {
.moduleVersion = 1,
.Bind = I2cManagerBind,
.Init = I2cManagerInit,
.Release = I2cManagerRelease,
.moduleName = "HDF_PLATFORM_I2C_MANAGER", // 這與device_info.hcs文件中device0對(duì)應(yīng)
};
HDF_INIT(g_i2cManagerEntry);配置屬性文件
deviceNode信息與驅(qū)動(dòng)入口注冊(cè)相關(guān)，器件屬性值對(duì)于驅(qū)動(dòng)適配者的驅(qū)動(dòng)實(shí)現(xiàn)以及核心層I2cCntlr相關(guān)成員的默認(rèn)值或限制范圍有密切關(guān)系。
統(tǒng)一服務(wù)模式的特點(diǎn)是device_info.hcs文件中第一個(gè)設(shè)備節(jié)點(diǎn)必須為I2C管理器，其各項(xiàng)參數(shù)如下所示：
成員名 | 值 |
moduleName | 固定為HDF_PLATFORM_I2C_MANAGER |
serviceName | 固定為HDF_PLATFORM_I2C_MANAGER |
policy | 具體配置為1或2取決于是否對(duì)用戶態(tài)可見(jiàn) |
deviceMatchAttr | 沒(méi)有使用，可忽略 |
從第二個(gè)節(jié)點(diǎn)開(kāi)始配置具體I2C控制器信息，此節(jié)點(diǎn)并不表示某一路I2C控制器，而是代表一個(gè)資源性質(zhì)設(shè)備，用于描述一類I2C控制器的信息。多個(gè)控制器之間相互區(qū)分的參數(shù)是busId和reg_pbase，這在i2c_config.hcs文件中有所體現(xiàn)。
本次案例以rk3568為案例（即文件//vendor/lockzhiner/rk3568/hdf_config/khdf/device_info/device_info.hcs），添加deviceNode描述，具體修改如下：
device_i2c :: device {
device0 :: deviceNode {
policy = 2;
priority = 50;
permission = 0644;
moduleName = "HDF_PLATFORM_I2C_MANAGER";
serviceName = "HDF_PLATFORM_I2C_MANAGER";
deviceMatchAttr = "hdf_platform_i2c_manager";
}
device1 :: deviceNode {
policy = 0; // 等于0，不需要發(fā)布服務(wù)
priority = 55; // 驅(qū)動(dòng)啟動(dòng)優(yōu)先級(jí)
permission = 0644; // 驅(qū)動(dòng)創(chuàng)建設(shè)備節(jié)點(diǎn)權(quán)限
moduleName = "linux_i2c_adapter"; // 用于指定驅(qū)動(dòng)名稱，需要與期望的驅(qū)動(dòng)Entry中的moduleName一致，必須是linux_i2c_adapter
deviceMatchAttr = "linux_i2c_adapter"; // 用于配置控制器私有數(shù)據(jù)，要與i2c_config.hcs中對(duì)應(yīng)控制器保持一致
}
}i2c_config.hcs 配置參考//vendor/lockzhiner/rk3568/hdf_config/khdf/platform/i2c_config.hcs，具體修改如下：
root {
platform {
i2c_config {
match_attr = "linux_i2c_adapter"; // 需要和device_info.hcs中的deviceMatchAttr值一致
template i2c_controller {
bus = 0; // i2c控制器序號(hào)
}
controller_0x120b0000 :: i2c_controller {
bus = 0;
}
controller_0x120b1000 :: i2c_controller {
bus = 1;
}
controller_0x120b2000 :: i2c_controller {
bus = 2;
}
controller_0x120b3000 :: i2c_controller {
bus = 3;
}
controller_0x120b4000 :: i2c_controller {
bus = 4;
}
controller_0x120b5000 :: i2c_controller {
bus = 5;
}
controller_0x120b6000 :: i2c_controller {
bus = 6;
}
controller_0x120b7000 :: i2c_controller {
bus = 7;
}
}
}
}實(shí)例化I2C控制器對(duì)象
完成驅(qū)動(dòng)入口注冊(cè)之后，下一步就是以核心層I2cCntlr對(duì)象的初始化為核心，包括驅(qū)動(dòng)適配者自定義結(jié)構(gòu)體（傳遞參數(shù)和數(shù)據(jù)），實(shí)例化I2cCntlr成員I2cMethod（讓用戶可以通過(guò)接口來(lái)調(diào)用驅(qū)動(dòng)底層函數(shù)），實(shí)現(xiàn)HdfDriverEntry成員函數(shù)（Bind，Init，Release）。
static int32_t LinuxI2cTransfer(struct I2cCntlr *cntlr, struct I2cMsg *msgs, int16_t count);
// 定義I2cMethod結(jié)構(gòu)體變量g_method，實(shí)現(xiàn)i2c相應(yīng)接口
static struct I2cMethod g_method = {
.transfer = LinuxI2cTransfer,
};
static int32_t LinuxI2cBind(struct HdfDeviceObject *device);
static int32_t LinuxI2cInit(struct HdfDeviceObject *device);
static void LinuxI2cRelease(struct HdfDeviceObject *device);
struct HdfDriverEntry g_i2cLinuxDriverEntry = {
.moduleVersion = 1,
.Bind = LinuxI2cBind,
.Init = LinuxI2cInit,
.Release = LinuxI2cRelease,
.moduleName = "linux_i2c_adapter",
};
HDF_INIT(g_i2cLinuxDriverEntry);驅(qū)動(dòng)調(diào)試
建議先在Linux下修改確認(rèn)，再移植到OpenHarmony。
3、I2C應(yīng)用開(kāi)發(fā)
（1）接口說(shuō)明
I2C模塊提供的主要接口如表1所示，具體API詳見(jiàn)//drivers/hdf_core/framework/include/platform/i2c_if.h。
I2C驅(qū)動(dòng)API接口功能介紹如下所示：
接口名 | 接口描述 |
DevHandle I2cOpen(int16_t number) | 打開(kāi)I2C控制器 |
void I2cClose(DevHandle handle) | 關(guān)閉I2C控制器 |
int32_t I2cTransfer(DevHandle handle, struct I2cMsg *msgs, int16_t count) | 自定義傳輸 |
I2cOpen
在進(jìn)行I2C通信前，首先要調(diào)用I2cOpen打開(kāi)I2C控制器。
DevHandle I2cOpen(int16_t number);I2cOpen參數(shù)定義如下：
參數(shù) | 參數(shù)描述 |
number | I2C控制器號(hào) |
I2cOpen返回值定義如下：
返回值 | 返回值描述 |
NULL | 打開(kāi)I2C控制器失敗 |
設(shè)備句柄 | 打開(kāi)的I2C控制器設(shè)備句柄 |
假設(shè)系統(tǒng)中存在8個(gè)I2C控制器，編號(hào)從0到7，以下代碼示例為獲取3號(hào)控制器：
DevHandle i2cHandle = NULL; /* I2C控制器句柄 /
/* 打開(kāi)I2C控制器 */
i2cHandle = I2cOpen(3);
if (i2cHandle == NULL) {
HDF_LOGE("I2cOpen: failed\n");
return;
}I2cClose
I2C通信完成之后，需要關(guān)閉I2C控制器。
void I2cClose(DevHandle handle);I2cClose參數(shù)定義如下：
參數(shù) | 參數(shù)描述 |
handle | I2C控制器設(shè)備句柄 |
I2cTransfer
i2c消息傳輸。
int32_t I2cTransfer(DevHandle handle, struct I2cMsg \*msgs, int16_t count);I2cTransfer參數(shù)定義如下：
參數(shù) | 參數(shù)描述 |
handle | I2C控制器設(shè)備句柄 |
msgs | 待傳輸數(shù)據(jù)的消息結(jié)構(gòu)體數(shù)組 |
count | 消息數(shù)組長(zhǎng)度 |
I2cTransfer返回值定義如下：
返回值 | 返回值描述 |
正整數(shù) | 成功傳輸?shù)南⒔Y(jié)構(gòu)體數(shù)目 |
負(fù)數(shù) | 執(zhí)行失敗 |
I2C傳輸消息類型為I2cMsg，每個(gè)傳輸消息結(jié)構(gòu)體表示一次讀或?qū)懀ㄟ^(guò)一個(gè)消息數(shù)組，可以執(zhí)行若干次的讀寫(xiě)組合操作。組合讀寫(xiě)示例：
int32_t ret;
uint8_t wbuff[2] = { 0x12, 0x13 };
uint8_t rbuff[2] = { 0 };
struct I2cMsg msgs[2]; /* 自定義傳輸?shù)南⒔Y(jié)構(gòu)體數(shù)組 */
msgs[0].buf = wbuff; /* 寫(xiě)入的數(shù)據(jù) */
msgs[0].len = 2; /* 寫(xiě)入數(shù)據(jù)長(zhǎng)度為2 */
msgs[0].addr = 0x5A; /* 寫(xiě)入設(shè)備地址為0x5A */
msgs[0].flags = 0; /* 傳輸標(biāo)記為0，默認(rèn)為寫(xiě) */
msgs[1].buf = rbuff; /* 要讀取的數(shù)據(jù) */
msgs[1].len = 2; /* 讀取數(shù)據(jù)長(zhǎng)度為2 */
msgs[1].addr = 0x5A; /* 讀取設(shè)備地址為0x5A */
msgs[1].flags = I2C_FLAG_READ /* I2C_FLAG_READ置位 */
/* 進(jìn)行一次自定義傳輸，傳輸?shù)南€(gè)數(shù)為2 */
ret = I2cTransfer(i2cHandle, msgs, 2);
if (ret != 2) {
HDF_LOGE("I2cTransfer: failed, ret %d\n", ret);
return;
}（2）開(kāi)發(fā)流程
使用I2C設(shè)備的一般流程如下圖所示：
OpenHarmony：如何使用HDF平臺(tái)驅(qū)動(dòng)控制I2C-開(kāi)源基礎(chǔ)軟件社區(qū)
三、程序解析
1、準(zhǔn)備工作
查看《凌蒙派-RK3568開(kāi)發(fā)板_排針說(shuō)明表_》（即Git倉(cāng)庫(kù)的//docs/board/凌蒙派-RK3568開(kāi)發(fā)板_排針說(shuō)明表_v1.0.xlsx），具體如下：
排針名稱 | GPIO引腳 | 復(fù)用功能 |
0_B5 | GPIO0_B5 | I2C2_SCL_M0 |
0_B6 | GPIO0_B6 | I2C2_SDA_M0 |
2、Linux內(nèi)核解析
（1）創(chuàng)建Linux內(nèi)核Git
請(qǐng)參考《OpenHarmony如何為內(nèi)核打patch》（即Git倉(cāng)庫(kù)的//docs/OpenHarmony如何為內(nèi)核打patch.docx）。
（2）修改設(shè)備樹(shù)I2C2配置
修改//arch/arm64/boot/dts/rockchip/rk3568-lockzhiner.dtsi（即該目錄是指已打Patch后的Linux內(nèi)核，不是OpenHarmony主目錄），定義i2c2啟用，具體如下所示：
&i2c2 {
status = "okay";
};（3）創(chuàng)建內(nèi)核patch
請(qǐng)參考《OpenHarmony如何為內(nèi)核打patch》（即Git倉(cāng)庫(kù)的//docs/OpenHarmony如何為內(nèi)核打patch.docx）。
（4）替換OpenHarmony的內(nèi)核patch
將制作出的kernel.patch替換到//kernel/linux/patches/linux-5.10/rk3568_patch/kernel.patch即可。
3、OpenHarmony配置樹(shù)配置
（1）device_info.hcs
//vendor/lockzhiner/rk3568/hdf_config/khdf/device_info/device_info.hcs已定義好，具體如下：
device_i2c :: device {
device0 :: deviceNode {
policy = 2;
priority = 50;
permission = 0644;
moduleName = "HDF_PLATFORM_I2C_MANAGER";
serviceName = "HDF_PLATFORM_I2C_MANAGER";
deviceMatchAttr = "hdf_platform_i2c_manager";
}
device1 :: deviceNode {
policy = 0; // 等于0，不需要發(fā)布服務(wù)
priority = 55;
permission = 0644;
moduleName = "linux_i2c_adapter";
deviceMatchAttr = "linux_i2c_adapter";
}
}注意：
- device1是rk3568原有的配置，也是我們需要的，作為OpenHarmony的i2c配置。
- moduleName定義為linux_i2c_adapter，表示該節(jié)點(diǎn)對(duì)應(yīng)于//drivers/hdf_core/adapter/khdf/linux/platform/i2c/i2c_adapter.c，該驅(qū)動(dòng)是對(duì)接Linux i2c子系統(tǒng)。
（2）i2c_config.hcs
在//vendor/lockzhiner/rk3568/hdf_config/khdf/platform/i2c_config.hcs，具體內(nèi)容如下：
root {
platform {
i2c_config {
match_attr = "linux_i2c_adapter";
template i2c_controller {
bus = 0;
}
controller_0x120b0000 :: i2c_controller {
bus = 0;
}
controller_0x120b1000 :: i2c_controller {
bus = 1;
}
controller_0x120b2000 :: i2c_controller {
bus = 2;
}
controller_0x120b3000 :: i2c_controller {
bus = 3;
}
controller_0x120b4000 :: i2c_controller {
bus = 4;
}
controller_0x120b5000 :: i2c_controller {
bus = 5;
}
controller_0x120b6000 :: i2c_controller {
bus = 6;
}
controller_0x120b7000 :: i2c_controller {
bus = 7;
}
}
}
}注意：
- controller_0x120b2000是為i2c2準(zhǔn)備的。
- bus用于定于Linux i2c控制器序號(hào)。
4、OpenHarmony I2C平臺(tái)驅(qū)動(dòng)
在//drivers/hdf_core/adapter/khdf/linux/platform/i2c/i2c_adapter.c已編寫(xiě)對(duì)接Linux I2C驅(qū)動(dòng)的相關(guān)代碼，具體內(nèi)容如下：
struct HdfDriverEntry g_i2cLinuxDriverEntry = {
.moduleVersion = 1,
.Bind = LinuxI2cBind,
.Init = LinuxI2cInit,
.Release = LinuxI2cRelease,
.moduleName = "linux_i2c_adapter",
};
HDF_INIT(g_i2cLinuxDriverEntry);該部分代碼不細(xì)述，感興趣的讀者可以去詳讀。
5、應(yīng)用程序
（1）i2c_test.c
i2c相關(guān)頭文件如下所示：
#include "i2c_if.h" // i2c標(biāo)準(zhǔn)接口頭文件主函數(shù)負(fù)責(zé)i2c讀寫(xiě)操作。
其中，讀操作源代碼具體如下：
int main(int argc, char* argv[])
{
DevHandle handle = NULL;
int32_t ret = 0;
struct I2cMsg msgs[2]; // 消息結(jié)構(gòu)體數(shù)組
int16_t msgs_count = 0;
uint8_t wbuff[STRING_MAXSIZE] = { 0 };
uint8_t rbuff[STRING_MAXSIZE] = { 0 };
// 解析參數(shù)
......
// 打開(kāi)i2c控制器
handle = I2cOpen(m_i2c_number);
if (handle == NULL) {
PRINT_ERROR("I2cOpen failed\n");
return -1;
}
if (m_i2c_flags_read == 1) {
// 讀操作
// 設(shè)置msgs數(shù)組有效數(shù)目
msgs_count = 2;
// 初始化msgs[0]，該部分為主設(shè)備發(fā)送從設(shè)備的i2c內(nèi)容
msgs[0].addr = m_i2c_slave_address;
msgs[0].flags = toI2cFlags(0, m_i2c_flags_addr_10bit, m_i2c_flags_read_no_ack, m_i2c_flags_ignore_no_ack, m_i2c_flags_no_start, m_i2c_flags_stop);
msgs[0].len = 1;
wbuff[0] = m_i2c_reg_address; // 本案例的i2c從設(shè)備是第1字節(jié)是寄存器地址
msgs[0].buf = wbuff;
// 初始化msgs[1]，該部分為主設(shè)備讀取從設(shè)備發(fā)送的i2c內(nèi)容
msgs[1].addr = m_i2c_slave_address;
msgs[1].flags = toI2cFlags(1, m_i2c_flags_addr_10bit, m_i2c_flags_read_no_ack, m_i2c_flags_ignore_no_ack, m_i2c_flags_no_start, m_i2c_flags_stop);
msgs[1].len = m_i2c_read_data_length;
msgs[1].buf = rbuff;
// i2c數(shù)據(jù)傳輸，傳輸次數(shù)為2次
ret = I2cTransfer(handle, msgs, msgs_count);
if (ret != msgs_count) {
PRINT_ERROR("I2cTransfer(read) failed and ret = %d\n", ret);
goto out;
}
printf("I2cTransfer success and read data length = %d\n", strlen((char *)rbuff));
for (uint32_t i = 0; i < strlen((char *)rbuff); i++) {
printf("rbuff[%d] = 0x%x\n", i, rbuff[i]);
}
} else {
......
}
out:
// 關(guān)閉i2c控制器
I2cClose(handle);
return ret;
}寫(xiě)操作源代碼如下所示：
int main(int argc, char* argv[])
{
DevHandle handle = NULL;
int32_t ret = 0;
struct I2cMsg msgs[2]; // 消息結(jié)構(gòu)體數(shù)組
int16_t msgs_count = 0;
uint8_t wbuff[STRING_MAXSIZE] = { 0 };
uint8_t rbuff[STRING_MAXSIZE] = { 0 };
// 解析參數(shù)
......
// 打開(kāi)i2c控制器
handle = I2cOpen(m_i2c_number);
if (handle == NULL) {
PRINT_ERROR("I2cOpen failed\n");
return -1;
}
if (m_i2c_flags_read == 1) {
......
} else {
// 寫(xiě)操作
// 設(shè)置msgs數(shù)組有效數(shù)目
msgs_count = 1;
// 初始化msgs[0]，該部分為主設(shè)備發(fā)送從設(shè)備的i2c內(nèi)容
msgs[0].addr = m_i2c_slave_address;
msgs[0].flags = toI2cFlags(0, m_i2c_flags_addr_10bit, m_i2c_flags_read_no_ack, m_i2c_flags_ignore_no_ack, m_i2c_flags_no_start, m_i2c_flags_stop);
msgs[0].len = 2;
wbuff[0] = m_i2c_reg_address; // 本案例的i2c從設(shè)備是第1字節(jié)是寄存器地址
wbuff[1] = m_i2c_reg_value; // 本案例的i2c從設(shè)備是第2字節(jié)是寄存器數(shù)值
msgs[0].buf = wbuff;
// i2c數(shù)據(jù)傳輸，傳輸次數(shù)為2次
ret = I2cTransfer(handle, msgs, msgs_count);
if (ret != msgs_count) {
PRINT_ERROR("I2cTransfer(write) failed and ret = %d\n", ret);
goto out;
}
printf("I2cTransfer success and write reg(%d), data(%d)\n", m_i2c_reg_address, m_i2c_reg_value);
}
out:
// 關(guān)閉i2c控制器
I2cClose(handle);
return ret;
}（2）BUILD.gn
編寫(xiě)應(yīng)用程序的BUILD.gn，具體內(nèi)容如下：
import("http://build/ohos.gni")
import("http://drivers/hdf_core/adapter/uhdf2/uhdf.gni")
print("samples: compile rk3568_i2c_test")
ohos_executable("rk3568_i2c_test") {
sources = [ "i2c_test.c" ]
include_dirs = [
"$hdf_framework_path/include",
"$hdf_framework_path/include/core",
"$hdf_framework_path/include/osal",
"$hdf_framework_path/include/platform",
"$hdf_framework_path/include/utils",
"$hdf_uhdf_path/osal/include",
"$hdf_uhdf_path/ipc/include",
"http://base/hiviewdfx/hilog/interfaces/native/kits/include",
"http://third_party/bounds_checking_function/include",
]
deps = [
"$hdf_uhdf_path/platform:libhdf_platform",
"$hdf_uhdf_path/utils:libhdf_utils",
"http://base/hiviewdfx/hilog/interfaces/native/innerkits:libhilog",
]
cflags = [
"-Wall",
"-Wextra",
"-Werror",
"-Wno-format",
"-Wno-format-extra-args",
]
part_name = "product_rk3568"
install_enable = true
}（3）參與應(yīng)用程序編譯
編輯//vendor/lockzhiner/rk3568/samples/BUILD.gn，開(kāi)啟編譯選項(xiàng)。具體如下：
"b06_platform_device_i2c/app:rk3568_i2c_test",四、程序編譯
建議使用docker編譯方法，運(yùn)行如下：
hb set -root .
hb set
# 選擇lockzhiner下的rk3568編譯分支。
hb build -f五、運(yùn)行結(jié)果
運(yùn)行如下：
# rk3568_i2c_test -n 2 -a 115 -r 0 -l 1
i2c number: 2
i2c slave address: 115
i2c reg address: 0
i2c reg value: 0
i2c read data length: 1
i2c flags read: 1
i2c flags addr 10bit: 0
i2c flags read no ack: 0
i2c flags ignore no ack: 0
i2c flags no start: 0
i2c flags stop: 0
I2cTransfer success and read data length = 1
rbuff[0] = 0x20
#上述命令為：查看i2c2控制器，從設(shè)備地址115（即0x73，該地址為個(gè)人外接i2c芯片），讀取寄存器地址0，數(shù)據(jù)長(zhǎng)度為1。
在調(diào)試過(guò)程中，OpenHarmony還提供Linux i2c-tools工具。
查看i2c控制器
# i2cdetect -l
i2c-1 i2c rk3x-i2c I2C Adapter
i2c-6 i2c DesignWare HDMI I2C Adapter
i2c-2 i2c rk3x-i2c I2C Adapter
i2c-0 i2c rk3x-i2c I2C Adapter
i2c-5 i2c rk3x-i2c I2C Adapter
#查看i2c2控制器所有從設(shè)備地址
# i2cdetect -y 2
0 1 2 3 4 5 6 7 8 9 a b c d e f
00: -- -- -- -- -- -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
50: -- 51 -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
70: -- -- -- 73 -- -- -- --
#讀取i2c2控制器的從設(shè)備地址0x73的所有寄存器數(shù)據(jù)
# i2cdump -y 2 0x73
0 1 2 3 4 5 6 7 8 9 a b c d e f 0123456789abcdef
00: 20 76 01 00 00 00 00 00 00 00 00 00 00 00 00 00 v?.............
10: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
20: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
30: 00 00 29 01 00 01 00 09 15 0a 12 80 04 00 05 00 ..)?.?.??????.?.
40: 02 ff ff 00 00 00 60 20 20 03 c8 00 14 00 1a 14 ???...` ??.?.??
50: 00 05 00 00 14 20 03 02 20 00 00 02 02 00 00 3f .?..? ?? ..??..?
60: 23 23 00 03 f7 03 d9 03 01 c8 40 00 00 04 00 00 ##.???????@..?..
70: 80 00 00 00 f0 00 3f ff ff 7f 7f f2 34 92 00 00 ?...?.??????4?..
80: 66 66 0c 20 20 00 10 00 05 18 10 10 37 00 f0 81 ff? .?.????7.??
90: 0c 06 1e 0d 0a 0c 0a 04 0a 41 0a 0a 2b 33 ae f9 ?????????A??+3??
a0: 48 13 10 08 30 11 10 08 24 04 1e 1e 00 00 00 00 H???0???$???....
b0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
c0: 00 00 00 00 00 00 00 00 00 00 00 00 1a 0d 03 63 ............???c
d0: 22 0f 88 00 00 00 00 00 00 00 00 00 00 00 00 00 "??.............
e0: 01 04 41 d6 00 0c 0a 00 00 00 00 00 00 00 07 00 ??A?.??.......?.
f0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
#
