1. 从一根线到一套体系I2C 在 OpenHarmony 里的真实定位I2C 这东西搞嵌入式的基本都绕不开。两根线一根 SCL 时钟一根 SDA 数据挂上一堆传感器、EEPROM、OLED 屏看起来简单得不行。但真到了 OpenHarmony 这种带 HDF 驱动框架、设备树描述、用户态和内核态分离的系统上很多人第一次上手就懵了——明明在裸机或者 Linux 字符设备下跑得飞起的代码搬到 OpenHarmony 上就是读不出数据ioctl返回-1errno一看是ENODEV或者EIO查半天查不出所以然。这篇东西就是冲着这个问题来的。我拿 RK3568 这块板子做载体把 I2C 从硬件时序、设备树配置、HDF 驱动注册、用户态ioctl调用一直到实际排障的完整链路捋一遍。适合两类人看一类是刚接触 OpenHarmony 驱动开发、想搞明白 I2C 到底怎么接进去的另一类是在 RK3568 上调试传感器、OLED、EEPROM 这类 I2C 外设时卡住了需要一套能直接抄的排查思路。核心关键词就几个I2C 通信协议、OpenHarmony HDF、RK3568 设备树、ioctl。把这四个东西串起来I2C 在 OpenHarmony 上的用法和排障基本就通了。2. I2C 协议本身别急着写代码先把时序吃透2.1 两根线到底怎么传数据I2C 是同步串行总线SCL 负责节拍SDA 负责数据。所有通信都由主机发起从机只能被动响应。起始条件Start是 SCL 高电平期间 SDA 从高拉低停止条件Stop是 SCL 高电平期间 SDA 从低拉高。这两个条件之外SDA 上的数据变化必须发生在 SCL 低电平期间因为 SCL 高电平期间 SDA 必须保持稳定否则会被误判成起始或停止。数据帧格式是这样的起始位之后主机发一个 7 位从机地址加 1 位读写方向位组成第一个字节。从机如果在线并且地址匹配会在第 9 个时钟周期把 SDA 拉低这就是 ACK。之后每传一个字节接收方都要回一个 ACK。读操作稍微绕一点主机先以写方向发地址然后重新发起始条件再以读方向发地址从机才开始吐数据。最后一个字节主机不回 ACK而是发 NACK 再发停止条件。注意很多初学者写 I2C 读时序时忘了中间的 Repeated Start直接从写切到读结果从机根本不响应。这个坑在软件模拟 I2C 时特别常见。2.2 时钟频率和上拉电阻的取舍标准模式 100kHz快速模式 400kHz高速模式 3.4MHz。RK3568 的 I2C 控制器支持到 400kHz 甚至更高但实际能跑多快取决于总线电容和上拉电阻。上拉电阻典型值 4.7kΩ如果总线挂的设备多、走线长电容大了上升沿变缓高速下波形就塌了。这时候要么减小上拉电阻到 2.2kΩ要么降速。我实测过一块板子I2C 挂了一个 OLED 和一个 EEPROM400kHz 下 EEPROM 偶尔读失败示波器一看 SDA 上升沿明显变圆。把上拉从 4.7k 换成 2.2k问题消失。所以排障时示波器或者逻辑分析仪是刚需光看代码猜没用。2.3 0.9 寸 OLED 的兼容性坑热搜词里有个“0.9寸oled对i2c兼容问题”这个我踩过。0.9 寸 SSD1306 OLED 有些批次上电后需要额外延时才能响应 I2C而且它的 I2C 地址有时候是 0x3C有时候是 0x3D取决于模块背面的电阻配置。更坑的是部分模块内部上拉很弱如果主控端没有外部上拉通信直接失败。解决办法很简单确认地址、加上拉、上电后延时 100ms 再初始化。3. RK3568 设备树I2C 控制器的描述方式3.1 设备树里 I2C 节点长什么样RK3568 的 I2C 控制器在设备树里是以i2cfe5x0000这种形式存在的。以 I2C3 为例典型配置如下i2c3 { status okay; clock-frequency 400000; pinctrl-names default; pinctrl-0 i2c3m0_xfer; ssd1306: oled3c { compatible solomon,ssd1306; reg 0x3c; status okay; }; };这里几个关键点status必须是okay否则控制器根本不初始化clock-frequency决定总线速率pinctrl把引脚复用成 I2C 功能RK3568 的引脚复用很灵活配错了就是没波形。子节点里的reg就是从机地址7 位地址直接写不要左移。3.2 引脚复用和电气属性RK3568 的 I2C 引脚通常和 GPIO、UART 等功能复用。设备树里通过pinctrl指定。如果忘了配pinctrl或者配到了错误的 pin group控制器寄存器能读到但物理线上没波形。排查时先用万用表量 SCL 和 SDA 的静态电平正常应该是高电平被上拉如果是低电平说明引脚没复用成 I2C 或者被其他驱动占了。另外 RK3568 的 I2C 引脚驱动能力可以在 pinctrl 里调默认一般够用但如果挂的设备多可以适当增强。3.3 设备树调试的实用手段设备树改完编译烧录后进系统先看/proc/device-tree下对应节点是否存在再看/sys/bus/i2c/devices/下有没有生成对应的设备。如果设备树里写了子节点但/sys/bus/i2c/devices/下没有大概率是compatible没匹配上驱动或者status不是okay。还有一个常用命令i2cdetect -y 3能扫描 I2C3 总线上所有响应的地址。这个工具在调试阶段极其有用能快速确认从机是否在线、地址是否正确。如果i2cdetect扫不到那就不用往下查驱动了先解决硬件和引脚问题。4. OpenHarmony HDF 驱动框架下的 I2C 接入4.1 HDF 驱动模型的基本结构OpenHarmony 的 HDF 驱动框架把驱动分成内核态和用户态两部分。I2C 控制器驱动通常在内核态由 SoC 厂商提供而具体外设驱动可以放在内核态也可以放在用户态通过 HDI 接口访问。对于大多数传感器、OLED 这类外设推荐放在用户态通过 HDF 提供的 I2C 接口操作这样调试方便崩溃了也不影响内核。一个典型的用户态 I2C 驱动包含几个部分驱动入口HdfDriverEntry、Bind和Init回调、设备服务接口。在Init里通过DeviceResourceGetI2cBus或者直接打开/dev/i2c-3设备节点来获取总线句柄。4.2 通过 ioctl 操作 I2C 的完整流程OpenHarmony 用户态访问 I2C 最直接的方式就是ioctl。核心结构体是struct i2c_rdwr_ioctl_data和struct i2c_msg。一次典型的读操作分两步先写寄存器地址再读数据。用I2C_RDWR可以一次 ioctl 完成组合操作。#include linux/i2c.h #include linux/i2c-dev.h #include sys/ioctl.h #include fcntl.h int fd open(/dev/i2c-3, O_RDWR); if (fd 0) { // 打开失败检查权限和设备节点是否存在 } uint8_t reg_addr 0x00; uint8_t buf[2] {0}; struct i2c_msg msgs[2]; msgs[0].addr 0x3c; msgs[0].flags 0; msgs[0].len 1; msgs[0].buf reg_addr; msgs[1].addr 0x3c; msgs[1].flags I2C_M_RD; msgs[1].len 2; msgs[1].buf buf; struct i2c_rdwr_ioctl_data data; data.msgs msgs; data.nmsgs 2; if (ioctl(fd, I2C_RDWR, data) 0) { // 读失败检查 errno }这段代码的关键在于msgs数组的顺序和flags的设置。第一个 msg 是写方向发寄存器地址第二个是读方向收数据。I2C_RDWR会自动在两次传输之间插入 Repeated Start不需要手动处理。注意open的时候要确认/dev/i2c-3的权限OpenHarmony 默认可能只有 root 能访问。可以在init配置里加权限规则或者把应用跑在有权限的账户下。4.3 HDF 提供的 I2C 接口封装如果不想直接碰ioctlHDF 也提供了封装好的接口比如I2cOpen、I2cTransfer、I2cClose。这些接口在hdf_i2c.h里声明底层还是走ioctl但屏蔽了部分细节。用 HDF 接口的好处是跨平台换 SoC 时上层代码不用大改。不过实际调试时我建议先用ioctl把链路跑通确认硬件和驱动都没问题再考虑用 HDF 封装。因为ioctl出错时errno更直观排查更快。5. 实操全流程从零把一颗 I2C 传感器接进 OpenHarmony5.1 硬件准备和连线检查以 AS5600 磁编码器为例它支持 I2C 接口地址 0x36。接线就四根VCC、GND、SCL、SDA。接之前先用万用表确认板子 I2C3 的 SCL 和 SDA 静态电压正常应该是 3.3V 左右。如果只有 1V 多说明上拉不够或者引脚没配好。连线时注意 SDA 和 SCL 不要接反虽然接反了一般不会烧但肯定通信失败。另外 AS5600 的 VCC 是 3.3V别接 5V。5.2 设备树配置和内核编译在 RK3568 的设备树里找到i2c3加上 AS5600 子节点i2c3 { status okay; clock-frequency 400000; pinctrl-names default; pinctrl-0 i2c3m0_xfer; as5600: as560036 { compatible ams,as5600; reg 0x36; status okay; }; };如果内核里没有 AS5600 的驱动compatible匹配不上也没关系设备节点还是会生成用户态可以直接通过/dev/i2c-3访问。编译设备树后烧录重启进系统。5.3 用 i2cdetect 确认设备在线进系统后先执行i2cdetect -y 3如果输出里 0x36 位置显示36说明设备在线。如果显示--说明没响应。这时候依次检查设备供电是否正常、上拉是否到位、引脚复用是否正确、设备地址是否真的是 0x36有些模块地址可配。5.4 用户态读写代码实现确认设备在线后写一个简单的测试程序读 AS5600 的角度寄存器。AS5600 的角度值在寄存器 0x0C 和 0x0D12 位数据。#include stdio.h #include stdint.h #include fcntl.h #include sys/ioctl.h #include linux/i2c.h #include linux/i2c-dev.h #include unistd.h #include errno.h #include string.h int main() { int fd open(/dev/i2c-3, O_RDWR); if (fd 0) { printf(open failed: %s\n, strerror(errno)); return -1; } uint8_t reg 0x0C; uint8_t buf[2] {0}; struct i2c_msg msgs[2]; msgs[0].addr 0x36; msgs[0].flags 0; msgs[0].len 1; msgs[0].buf reg; msgs[1].addr 0x36; msgs[1].flags I2C_M_RD; msgs[1].len 2; msgs[1].buf buf; struct i2c_rdwr_ioctl_data data; data.msgs msgs; data.nmsgs 2; if (ioctl(fd, I2C_RDWR, data) 0) { printf(ioctl failed: %s\n, strerror(errno)); close(fd); return -1; } uint16_t angle ((buf[0] 0x0F) 8) | buf[1]; printf(angle raw: %u\n, angle); close(fd); return 0; }编译时注意用 RK3568 的交叉编译工具链链接时不需要额外库ioctl和i2c-dev都是系统自带的。5.5 交叉编译和部署野火 RK3568 的交叉编译工具链一般在 SDK 的prebuilts/gcc/linux-x86/aarch64/下。编译命令aarch64-linux-gnu-gcc -o i2c_test i2c_test.c然后把可执行文件推到板子上adb push i2c_test /data/ adb shell chmod x /data/i2c_test adb shell /data/i2c_test如果输出角度值并且转动磁铁时数值变化说明整条链路通了。6. 排障实录那些让你抓狂的典型问题6.1 ioctl 返回 -1 的几种常见原因errno含义排查方向ENODEV设备不存在检查/dev/i2c-3是否存在设备树 status 是否 okayEIO总线错误检查上拉、波形、从机地址EBUSY总线忙是否有其他进程占用或者上一次传输没正确结束EINVAL参数错误检查 msgs 结构体、addr 是否合法EREMOTEIO从机无应答从机不在线或地址错误EREMOTEIO 是最常见的基本就是从机没响应。先用i2cdetect确认再查硬件。6.2 读出来全是 0xFF 或 0x00全 0xFF 通常意味着 SDA 一直被拉高从机根本没驱动数据线。可能是从机没供电、地址不对、或者 SDA 断线。全 0x00 则可能是 SDA 被拉死或者从机返回了全零数据。用逻辑分析仪抓一次完整波形看 ACK 位是否正常一目了然。6.3 偶发性读失败如果大部分时候能读偶尔失败优先怀疑时序和上拉。400kHz 下如果上升沿太慢某些从机会错过采样点。降速到 100kHz 试试如果稳定了就是上拉或走线问题。另外电源纹波也会影响示波器看 VCC 是否有毛刺。6.4 ESP32 休眠后 I2C 复位问题热搜里提到“esp32 休眠 i2c复位”这个在 OpenHarmony 上也有类似场景。系统休眠时 I2C 控制器可能掉电唤醒后需要重新初始化。如果驱动没做恢复处理唤醒后第一次读就会失败。解决办法是在驱动里监听电源状态变化唤醒后重新配置 I2C 控制器寄存器。7. 几个容易被忽略的细节和我的实操心得7.1 地址左移问题Linux 的i2c_msg里addr是 7 位地址不需要左移。但有些从机手册给的是 8 位地址含读写位比如写地址 0x78、读地址 0x79实际 7 位地址是 0x3C。搞错了就永远通信不上。我一般拿到手册先确认地址是 7 位还是 8 位8 位就右移一位。7.2 寄存器地址宽度有些传感器寄存器地址是 8 位有些是 16 位。AS5600 是 8 位但像某些 EEPROM 是 16 位。发寄存器地址时len要对应16 位地址要发两个字节高字节在前。这个在msgs[0].len和buf里体现写错了读出来的数据就是错的。7.3 连续读的地址自增大部分 I2C 从机支持连续读时寄存器地址自增但有些低端芯片不支持每次读都要重新发地址。如果发现连续读第二个字节开始就不对查手册确认是否支持自增。不支持的话就拆成多次单字节读。7.4 逻辑分析仪比示波器更好用排 I2C 问题逻辑分析仪能直接解码出地址、数据、ACK比示波器看模拟波形直观得多。几十块钱的 USB 逻辑分析仪配合开源软件就能用强烈建议入手一个。7.5 OpenHarmony 权限配置OpenHarmony 默认对/dev/i2c-*的权限控制比较严普通应用可能打不开。可以在init.cfg或者ueventd规则里加权限比如chmod 0666 /dev/i2c-3。但生产环境不建议这么干最好通过 HDF 服务接口做权限隔离。8. 从 I2C 扩展到整个 OpenHarmony 外设开发I2C 只是 OpenHarmony 外设开发的一个切面。把这套流程走通之后SPI、UART、GPIO 的接入思路基本一致设备树描述硬件、HDF 注册驱动、用户态通过标准接口访问。区别只在于协议细节和接口函数。RK3568 这块板子外设资源丰富I2C 控制器有好几路挂 EEPROM、OLED、传感器、编码器都够用。调试时养成习惯先确认硬件、再确认设备树、再确认驱动、最后查应用代码。这个顺序能帮你省掉大量来回折腾的时间。我在实际项目里遇到最多次的问题归根结底都是设备树引脚复用配错或者上拉不够。代码本身反而很少出问题。所以每次新板子到手第一件事就是量 I2C 静态电平第二件事就是跑i2cdetect。这两步过了后面基本就是顺水推舟。
OpenHarmony I2C驱动开发实战：RK3568设备树配置与ioctl排障指南
1. 从一根线到一套体系I2C 在 OpenHarmony 里的真实定位I2C 这东西搞嵌入式的基本都绕不开。两根线一根 SCL 时钟一根 SDA 数据挂上一堆传感器、EEPROM、OLED 屏看起来简单得不行。但真到了 OpenHarmony 这种带 HDF 驱动框架、设备树描述、用户态和内核态分离的系统上很多人第一次上手就懵了——明明在裸机或者 Linux 字符设备下跑得飞起的代码搬到 OpenHarmony 上就是读不出数据ioctl返回-1errno一看是ENODEV或者EIO查半天查不出所以然。这篇东西就是冲着这个问题来的。我拿 RK3568 这块板子做载体把 I2C 从硬件时序、设备树配置、HDF 驱动注册、用户态ioctl调用一直到实际排障的完整链路捋一遍。适合两类人看一类是刚接触 OpenHarmony 驱动开发、想搞明白 I2C 到底怎么接进去的另一类是在 RK3568 上调试传感器、OLED、EEPROM 这类 I2C 外设时卡住了需要一套能直接抄的排查思路。核心关键词就几个I2C 通信协议、OpenHarmony HDF、RK3568 设备树、ioctl。把这四个东西串起来I2C 在 OpenHarmony 上的用法和排障基本就通了。2. I2C 协议本身别急着写代码先把时序吃透2.1 两根线到底怎么传数据I2C 是同步串行总线SCL 负责节拍SDA 负责数据。所有通信都由主机发起从机只能被动响应。起始条件Start是 SCL 高电平期间 SDA 从高拉低停止条件Stop是 SCL 高电平期间 SDA 从低拉高。这两个条件之外SDA 上的数据变化必须发生在 SCL 低电平期间因为 SCL 高电平期间 SDA 必须保持稳定否则会被误判成起始或停止。数据帧格式是这样的起始位之后主机发一个 7 位从机地址加 1 位读写方向位组成第一个字节。从机如果在线并且地址匹配会在第 9 个时钟周期把 SDA 拉低这就是 ACK。之后每传一个字节接收方都要回一个 ACK。读操作稍微绕一点主机先以写方向发地址然后重新发起始条件再以读方向发地址从机才开始吐数据。最后一个字节主机不回 ACK而是发 NACK 再发停止条件。注意很多初学者写 I2C 读时序时忘了中间的 Repeated Start直接从写切到读结果从机根本不响应。这个坑在软件模拟 I2C 时特别常见。2.2 时钟频率和上拉电阻的取舍标准模式 100kHz快速模式 400kHz高速模式 3.4MHz。RK3568 的 I2C 控制器支持到 400kHz 甚至更高但实际能跑多快取决于总线电容和上拉电阻。上拉电阻典型值 4.7kΩ如果总线挂的设备多、走线长电容大了上升沿变缓高速下波形就塌了。这时候要么减小上拉电阻到 2.2kΩ要么降速。我实测过一块板子I2C 挂了一个 OLED 和一个 EEPROM400kHz 下 EEPROM 偶尔读失败示波器一看 SDA 上升沿明显变圆。把上拉从 4.7k 换成 2.2k问题消失。所以排障时示波器或者逻辑分析仪是刚需光看代码猜没用。2.3 0.9 寸 OLED 的兼容性坑热搜词里有个“0.9寸oled对i2c兼容问题”这个我踩过。0.9 寸 SSD1306 OLED 有些批次上电后需要额外延时才能响应 I2C而且它的 I2C 地址有时候是 0x3C有时候是 0x3D取决于模块背面的电阻配置。更坑的是部分模块内部上拉很弱如果主控端没有外部上拉通信直接失败。解决办法很简单确认地址、加上拉、上电后延时 100ms 再初始化。3. RK3568 设备树I2C 控制器的描述方式3.1 设备树里 I2C 节点长什么样RK3568 的 I2C 控制器在设备树里是以i2cfe5x0000这种形式存在的。以 I2C3 为例典型配置如下i2c3 { status okay; clock-frequency 400000; pinctrl-names default; pinctrl-0 i2c3m0_xfer; ssd1306: oled3c { compatible solomon,ssd1306; reg 0x3c; status okay; }; };这里几个关键点status必须是okay否则控制器根本不初始化clock-frequency决定总线速率pinctrl把引脚复用成 I2C 功能RK3568 的引脚复用很灵活配错了就是没波形。子节点里的reg就是从机地址7 位地址直接写不要左移。3.2 引脚复用和电气属性RK3568 的 I2C 引脚通常和 GPIO、UART 等功能复用。设备树里通过pinctrl指定。如果忘了配pinctrl或者配到了错误的 pin group控制器寄存器能读到但物理线上没波形。排查时先用万用表量 SCL 和 SDA 的静态电平正常应该是高电平被上拉如果是低电平说明引脚没复用成 I2C 或者被其他驱动占了。另外 RK3568 的 I2C 引脚驱动能力可以在 pinctrl 里调默认一般够用但如果挂的设备多可以适当增强。3.3 设备树调试的实用手段设备树改完编译烧录后进系统先看/proc/device-tree下对应节点是否存在再看/sys/bus/i2c/devices/下有没有生成对应的设备。如果设备树里写了子节点但/sys/bus/i2c/devices/下没有大概率是compatible没匹配上驱动或者status不是okay。还有一个常用命令i2cdetect -y 3能扫描 I2C3 总线上所有响应的地址。这个工具在调试阶段极其有用能快速确认从机是否在线、地址是否正确。如果i2cdetect扫不到那就不用往下查驱动了先解决硬件和引脚问题。4. OpenHarmony HDF 驱动框架下的 I2C 接入4.1 HDF 驱动模型的基本结构OpenHarmony 的 HDF 驱动框架把驱动分成内核态和用户态两部分。I2C 控制器驱动通常在内核态由 SoC 厂商提供而具体外设驱动可以放在内核态也可以放在用户态通过 HDI 接口访问。对于大多数传感器、OLED 这类外设推荐放在用户态通过 HDF 提供的 I2C 接口操作这样调试方便崩溃了也不影响内核。一个典型的用户态 I2C 驱动包含几个部分驱动入口HdfDriverEntry、Bind和Init回调、设备服务接口。在Init里通过DeviceResourceGetI2cBus或者直接打开/dev/i2c-3设备节点来获取总线句柄。4.2 通过 ioctl 操作 I2C 的完整流程OpenHarmony 用户态访问 I2C 最直接的方式就是ioctl。核心结构体是struct i2c_rdwr_ioctl_data和struct i2c_msg。一次典型的读操作分两步先写寄存器地址再读数据。用I2C_RDWR可以一次 ioctl 完成组合操作。#include linux/i2c.h #include linux/i2c-dev.h #include sys/ioctl.h #include fcntl.h int fd open(/dev/i2c-3, O_RDWR); if (fd 0) { // 打开失败检查权限和设备节点是否存在 } uint8_t reg_addr 0x00; uint8_t buf[2] {0}; struct i2c_msg msgs[2]; msgs[0].addr 0x3c; msgs[0].flags 0; msgs[0].len 1; msgs[0].buf reg_addr; msgs[1].addr 0x3c; msgs[1].flags I2C_M_RD; msgs[1].len 2; msgs[1].buf buf; struct i2c_rdwr_ioctl_data data; data.msgs msgs; data.nmsgs 2; if (ioctl(fd, I2C_RDWR, data) 0) { // 读失败检查 errno }这段代码的关键在于msgs数组的顺序和flags的设置。第一个 msg 是写方向发寄存器地址第二个是读方向收数据。I2C_RDWR会自动在两次传输之间插入 Repeated Start不需要手动处理。注意open的时候要确认/dev/i2c-3的权限OpenHarmony 默认可能只有 root 能访问。可以在init配置里加权限规则或者把应用跑在有权限的账户下。4.3 HDF 提供的 I2C 接口封装如果不想直接碰ioctlHDF 也提供了封装好的接口比如I2cOpen、I2cTransfer、I2cClose。这些接口在hdf_i2c.h里声明底层还是走ioctl但屏蔽了部分细节。用 HDF 接口的好处是跨平台换 SoC 时上层代码不用大改。不过实际调试时我建议先用ioctl把链路跑通确认硬件和驱动都没问题再考虑用 HDF 封装。因为ioctl出错时errno更直观排查更快。5. 实操全流程从零把一颗 I2C 传感器接进 OpenHarmony5.1 硬件准备和连线检查以 AS5600 磁编码器为例它支持 I2C 接口地址 0x36。接线就四根VCC、GND、SCL、SDA。接之前先用万用表确认板子 I2C3 的 SCL 和 SDA 静态电压正常应该是 3.3V 左右。如果只有 1V 多说明上拉不够或者引脚没配好。连线时注意 SDA 和 SCL 不要接反虽然接反了一般不会烧但肯定通信失败。另外 AS5600 的 VCC 是 3.3V别接 5V。5.2 设备树配置和内核编译在 RK3568 的设备树里找到i2c3加上 AS5600 子节点i2c3 { status okay; clock-frequency 400000; pinctrl-names default; pinctrl-0 i2c3m0_xfer; as5600: as560036 { compatible ams,as5600; reg 0x36; status okay; }; };如果内核里没有 AS5600 的驱动compatible匹配不上也没关系设备节点还是会生成用户态可以直接通过/dev/i2c-3访问。编译设备树后烧录重启进系统。5.3 用 i2cdetect 确认设备在线进系统后先执行i2cdetect -y 3如果输出里 0x36 位置显示36说明设备在线。如果显示--说明没响应。这时候依次检查设备供电是否正常、上拉是否到位、引脚复用是否正确、设备地址是否真的是 0x36有些模块地址可配。5.4 用户态读写代码实现确认设备在线后写一个简单的测试程序读 AS5600 的角度寄存器。AS5600 的角度值在寄存器 0x0C 和 0x0D12 位数据。#include stdio.h #include stdint.h #include fcntl.h #include sys/ioctl.h #include linux/i2c.h #include linux/i2c-dev.h #include unistd.h #include errno.h #include string.h int main() { int fd open(/dev/i2c-3, O_RDWR); if (fd 0) { printf(open failed: %s\n, strerror(errno)); return -1; } uint8_t reg 0x0C; uint8_t buf[2] {0}; struct i2c_msg msgs[2]; msgs[0].addr 0x36; msgs[0].flags 0; msgs[0].len 1; msgs[0].buf reg; msgs[1].addr 0x36; msgs[1].flags I2C_M_RD; msgs[1].len 2; msgs[1].buf buf; struct i2c_rdwr_ioctl_data data; data.msgs msgs; data.nmsgs 2; if (ioctl(fd, I2C_RDWR, data) 0) { printf(ioctl failed: %s\n, strerror(errno)); close(fd); return -1; } uint16_t angle ((buf[0] 0x0F) 8) | buf[1]; printf(angle raw: %u\n, angle); close(fd); return 0; }编译时注意用 RK3568 的交叉编译工具链链接时不需要额外库ioctl和i2c-dev都是系统自带的。5.5 交叉编译和部署野火 RK3568 的交叉编译工具链一般在 SDK 的prebuilts/gcc/linux-x86/aarch64/下。编译命令aarch64-linux-gnu-gcc -o i2c_test i2c_test.c然后把可执行文件推到板子上adb push i2c_test /data/ adb shell chmod x /data/i2c_test adb shell /data/i2c_test如果输出角度值并且转动磁铁时数值变化说明整条链路通了。6. 排障实录那些让你抓狂的典型问题6.1 ioctl 返回 -1 的几种常见原因errno含义排查方向ENODEV设备不存在检查/dev/i2c-3是否存在设备树 status 是否 okayEIO总线错误检查上拉、波形、从机地址EBUSY总线忙是否有其他进程占用或者上一次传输没正确结束EINVAL参数错误检查 msgs 结构体、addr 是否合法EREMOTEIO从机无应答从机不在线或地址错误EREMOTEIO 是最常见的基本就是从机没响应。先用i2cdetect确认再查硬件。6.2 读出来全是 0xFF 或 0x00全 0xFF 通常意味着 SDA 一直被拉高从机根本没驱动数据线。可能是从机没供电、地址不对、或者 SDA 断线。全 0x00 则可能是 SDA 被拉死或者从机返回了全零数据。用逻辑分析仪抓一次完整波形看 ACK 位是否正常一目了然。6.3 偶发性读失败如果大部分时候能读偶尔失败优先怀疑时序和上拉。400kHz 下如果上升沿太慢某些从机会错过采样点。降速到 100kHz 试试如果稳定了就是上拉或走线问题。另外电源纹波也会影响示波器看 VCC 是否有毛刺。6.4 ESP32 休眠后 I2C 复位问题热搜里提到“esp32 休眠 i2c复位”这个在 OpenHarmony 上也有类似场景。系统休眠时 I2C 控制器可能掉电唤醒后需要重新初始化。如果驱动没做恢复处理唤醒后第一次读就会失败。解决办法是在驱动里监听电源状态变化唤醒后重新配置 I2C 控制器寄存器。7. 几个容易被忽略的细节和我的实操心得7.1 地址左移问题Linux 的i2c_msg里addr是 7 位地址不需要左移。但有些从机手册给的是 8 位地址含读写位比如写地址 0x78、读地址 0x79实际 7 位地址是 0x3C。搞错了就永远通信不上。我一般拿到手册先确认地址是 7 位还是 8 位8 位就右移一位。7.2 寄存器地址宽度有些传感器寄存器地址是 8 位有些是 16 位。AS5600 是 8 位但像某些 EEPROM 是 16 位。发寄存器地址时len要对应16 位地址要发两个字节高字节在前。这个在msgs[0].len和buf里体现写错了读出来的数据就是错的。7.3 连续读的地址自增大部分 I2C 从机支持连续读时寄存器地址自增但有些低端芯片不支持每次读都要重新发地址。如果发现连续读第二个字节开始就不对查手册确认是否支持自增。不支持的话就拆成多次单字节读。7.4 逻辑分析仪比示波器更好用排 I2C 问题逻辑分析仪能直接解码出地址、数据、ACK比示波器看模拟波形直观得多。几十块钱的 USB 逻辑分析仪配合开源软件就能用强烈建议入手一个。7.5 OpenHarmony 权限配置OpenHarmony 默认对/dev/i2c-*的权限控制比较严普通应用可能打不开。可以在init.cfg或者ueventd规则里加权限比如chmod 0666 /dev/i2c-3。但生产环境不建议这么干最好通过 HDF 服务接口做权限隔离。8. 从 I2C 扩展到整个 OpenHarmony 外设开发I2C 只是 OpenHarmony 外设开发的一个切面。把这套流程走通之后SPI、UART、GPIO 的接入思路基本一致设备树描述硬件、HDF 注册驱动、用户态通过标准接口访问。区别只在于协议细节和接口函数。RK3568 这块板子外设资源丰富I2C 控制器有好几路挂 EEPROM、OLED、传感器、编码器都够用。调试时养成习惯先确认硬件、再确认设备树、再确认驱动、最后查应用代码。这个顺序能帮你省掉大量来回折腾的时间。我在实际项目里遇到最多次的问题归根结底都是设备树引脚复用配错或者上拉不够。代码本身反而很少出问题。所以每次新板子到手第一件事就是量 I2C 静态电平第二件事就是跑i2cdetect。这两步过了后面基本就是顺水推舟。
