1. 项目缘起为什么要在Linux上折腾i2c-tool如果你在嵌入式Linux开发或者玩树莓派、香橙派这类单板计算机大概率会接触到I2C总线。这玩意儿在板子上连接着各种传感器、EEPROM、RTC时钟芯片是嵌入式世界里的“血管”。但很多时候你拿到一块新板子或者自己编译了一个内核发现i2cdetect、i2cget这些命令死活用不了提示“找不到设备”或者“没有那个文件或目录”。这时候你就需要自己动手把i2c-tool这个“瑞士军刀”给移植到你的Linux系统里。我最近就在一块国产主控的板子上遇到了这个问题。板子跑的是厂商提供的定制Linux内核倒是开启了I2C驱动但根文件系统里空空如也常用的调试工具一概没有。没有i2c-tool你连总线上挂了几个设备、地址是什么都搞不清楚更别提读写寄存器了。难道要自己写个应用程序去ioctl太麻烦了。所以移植i2c-tool就成了点亮外设、调试硬件的第一步。这个过程说简单也简单就是编译一套工具说复杂也复杂涉及到交叉编译环境、库依赖、内核头文件匹配等一系列细节。下面我就把这次完整的移植过程、踩过的坑以及背后的原理掰开揉碎了讲清楚。2. i2c-tool工具链的构成与工作原理在动手编译之前我们得先搞清楚i2c-tool到底是什么以及它凭什么能操作I2C硬件。i2c-tool不是一个单一的程序而是一个工具集主要包含以下几个我们最常用的命令i2cdetect用于扫描I2C总线列出所有应答的设备地址。这是你拿到一块新板子要做的第一件事。i2cget从I2C设备的某个寄存器读取一个字节byte或一个字word。i2cset向I2C设备的某个寄存器写入一个字节或一个字。i2cdump连续读取I2C设备的一段寄存器区域并以十六进制形式打印出来非常适合快速查看配置。i2ctransfer执行一次或多次复杂的I2C消息传输组合读写功能更强大。这些命令行工具的本质都是对Linux内核提供的I2C设备接口进行封装的上层应用。在Linux中一旦I2C总线驱动和设备驱动加载成功内核就会在/dev目录下创建对应的设备节点例如/dev/i2c-0、/dev/i2c-1等。i2c-tool通过标准的文件IO操作open,read,write结合IO控制命令ioctl来与这些设备节点通信。这里的关键是ioctl。i2c-tool调用ioctl时会传入一个名为struct i2c_msg的数据结构这个结构体完整描述了一次I2C传输从设备地址、读写标志、数据缓冲区到数据长度。内核的I2C子系统收到这个请求后会通过平台相关的I2C控制器驱动如i2c-imx,i2c-rk3x最终操控硬件上的SCL时钟线和SDA数据线波形完成物理层的通信。所以i2c-tool能工作的前提是内核正确配置并编译了I2C子系统驱动包括总线驱动和设备驱动。系统中存在/dev/i2c-*设备节点。i2c-tool在编译时能找到与当前运行内核版本匹配的内核头文件特别是其中定义struct i2c_msg等数据结构和ioctl命令号的头文件。很多移植失败的问题都出在第三点上——编译环境和运行环境的内核版本不匹配。3. 移植前的准备工作环境与源码移植工作通常在x86的PC上进行称为宿主机为目标板可能是ARM、RISC-V等架构称为目标机生成可执行文件。这就需要搭建交叉编译环境。3.1 获取i2c-tool源代码i2c-tool是Linux内核源码的一部分但为了方便它也维护了独立的发布版本。推荐从官方镜像站获取这样版本比较清晰。# 在宿主机上操作 wget https://mirrors.edge.kernel.org/pub/software/utils/i2c-tools/i2c-tools-4.3.tar.gz tar -xzvf i2c-tools-4.3.tar.gz cd i2c-tools-4.3独立发布的i2c-tool代码更干净编译脚本也针对用户态工具做了优化比直接去内核源码drivers/i2c/tools目录下编译要省事得多。3.2 确认目标板内核版本与获取头文件这是最关键的一步。你必须知道目标板正在运行的内核精确版本。# 在目标板Linux系统上执行 uname -r假设输出是5.10.60-v8l。那么你需要在宿主机上准备完全相同版本的内核源代码。因为i2c-tool在编译过程中会包含内核头文件linux/i2c-dev.h和linux/i2c.h里面定义了关键的ioctl命令如I2C_SLAVE和数据结构。如果版本不一致即使编译成功在目标板上运行时也可能因为数据结构内存布局不同或ioctl命令号不同而导致段错误Segmentation fault或功能异常。如何获取内核源码最佳情况你的目标板供应商提供了完整的Linux SDK其中就包含内核源码包。直接使用这个。次选从内核官网www.kernel.org下载对应版本的内核源码。备选如果实在找不到精确版本可以尝试目标板/lib/modules/$(uname -r)/build目录。这个软链接通常指向内核构建目录但嵌入式系统里这个目录经常不存在或不完整。将内核源码解压到宿主机某个路径例如/home/user/linux-5.10.60。我们后续需要将其路径告诉i2c-tool的编译系统。3.3 安装交叉编译工具链你需要目标板CPU架构对应的交叉编译工具链。比如对于ARM Cortex-A53工具链前缀可能是aarch64-linux-gnu-。对于RISC-V可能是riscv64-unknown-linux-gnu-。在Ubuntu宿主机上通常可以用apt安装# 对于64位ARM sudo apt install gcc-aarch64-linux-gnu g-aarch64-linux-gnu # 对于32位ARM sudo apt install gcc-arm-linux-gnueabihf g-arm-linux-gnueabihf # 对于RISC-V sudo apt install gcc-riscv64-linux-gnu g-riscv64-linux-gnu安装后用aarch64-linux-gnu-gcc --version验证是否安装成功。4. 交叉编译i2c-tool的详细步骤与参数解析进入i2c-tools-4.3目录我们开始编译。i2c-tool使用经典的make系统我们需要通过修改Makefile或直接传递参数来指导交叉编译。4.1 直接命令行指定参数推荐这是最清晰的方式不需要永久修改文件。# 在i2c-tools-4.3目录下执行 make clean # 先清理 make CCaarch64-linux-gnu-gcc ARaarch64-linux-gnu-ar STRIPaarch64-linux-gnu-strip \ CFLAGS-I/home/user/linux-5.10.60/include -O2 \ BUILD_STATIC_LIB1 \ USE_STATIC_LIB1我们来拆解这些参数CCaarch64-linux-gnu-gcc指定交叉编译器。AR和STRIP同样指定交叉编译工具链中的归档和剥离工具。CFLAGS这是核心。-I/home/user/linux-5.10.60/include最重要指定内核头文件路径。必须指向你准备好的、与目标板内核版本一致的内核源码的include目录。这确保了i2c-tool使用正确的数据结构定义。-O2优化等级一般用-O2平衡性能与大小。BUILD_STATIC_LIB1和USE_STATIC_LIB1强烈建议在嵌入式移植中开启。这会让i2c-tool静态链接它自己的库函数生成的可执行文件几乎不依赖目标板上的动态库glibc等除外。可以避免因目标板C库版本过低而导致的“/lib/libc.so.6: version GLIBC_2.33 not found”这类令人头疼的运行时错误。注意静态编译虽然解决了库依赖但会显著增大二进制文件体积。如果目标板存储空间紧张且你确认其C库版本兼容可以尝试去掉这两个参数进行动态编译。4.2 处理常见的编译错误错误1linux/i2c-dev.h: No such file or directory这明确说明CFLAGS中的-I路径设置错了或者该路径下确实没有这个头文件。检查路径是否正确并确认内核源码是否完整解压ls /home/user/linux-5.10.60/include/linux/i2c-dev.h。错误2implicit declaration of function ‘...’通常是缺少其他内核头文件。可以尝试将CFLAGS中的路径指向内核源码的根目录因为i2c-tool可能还会包含其他位于include/uapi或include/linux下的头文件。更稳妥的做法是使用内核的make headers_install生成的用户态头文件但对于快速移植直接引用源码include目录在大多数情况下可行。错误3对__sync_fetch_and_add等函数的未定义引用这发生在为不支持原子操作的旧架构如某些老的ARMv5编译时。你需要在CFLAGS中为GCC指定正确的-march和-mcpu参数例如-marcharmv5te。4.3 编译成功后的产出物编译成功后在tools/目录下你会找到我们需要的可执行文件i2cdetect,i2cget,i2cset,i2cdump,i2ctransfer。用file命令检查一下file tools/i2cdetect输出应为tools/i2cdetect: ELF 64-bit LSB executable, ARM aarch64, version 1 (GNU/Linux), statically linked, for GNU/Linux 5.10.60, with debug_info, not stripped。注意“statically linked”和“for GNU/Linux 5.10.60”字样这和我们预期一致。5. 在目标板上的部署、测试与排坑编译出的二进制文件需要拷贝到目标板上运行。5.1 部署与权限设置可以通过SD卡、U盘、scp、nfs等方式将tools/下的文件拷贝到目标板例如放到/usr/local/bin。# 在目标板上操作 cp i2cdetect i2cget i2cset i2cdump i2ctransfer /usr/local/bin/非常重要的一步设置权限。/dev/i2c-*设备节点默认通常只有root用户或i2c用户组有读写权限。# 方法一使用sudo运行每次都要输密码 sudo i2cdetect -l # 方法二将当前用户加入i2c组推荐一劳永逸 sudo usermod -aG i2c $(whoami) # 然后需要注销并重新登录或者使用newgrp i2c命令在当前shell生效。 # 方法三直接修改设备节点权限安全性较低仅用于调试 sudo chmod 666 /dev/i2c-05.2 基础功能测试首先列出系统可用的I2C总线i2cdetect -l你会看到类似输出i2c-0 i2c mv64xxx_i2c adapter I2C adapter i2c-1 i2c DesignWare HDMI I2C adapter这表示系统有两组I2C总线i2c-0是主控的I2C控制器i2c-1可能是HDMI接口上的DDC通道。然后扫描某条总线例如i2c-0上的设备i2cdetect -y 0 # 或使用更详细的扫描 i2cdetect -y -r 0-y选项取消交互确认-r使用SMBus的receive byte命令进行探测比默认的quick write更可靠尤其对一些不标准的设备。输出是一个地址矩阵UU表示该地址被驱动占用通常由内核驱动声明xx数字如0x50表示有设备应答。5.3 高级操作与实战示例假设我们扫描到i2c-0总线上0x50地址有一个EEPROM设备如AT24C02。读取一个字节从芯片地址0x50的寄存器0x00读取一个字节。i2cget -y 0 0x50 0x00写入一个字节向芯片地址0x50的寄存器0x10写入值0xAB。i2cset -y 0 0x50 0x10 0xAB连续读取读取从寄存器0x00开始的16个字节。i2cdump -y 0 0x50 b 16 # 或者用i2ctransfer更灵活 i2ctransfer -y 0 w10x50 0x00 r165.4 常见运行时问题排查问题1Error: Could not open file /dev/i2c-0’: No such file or directory这说明内核没有成功创建I2C设备节点。可能的原因内核配置中未启用I2C_CHARDEV位于Device Drivers - I2C support - I2C device interface这个选项负责创建/dev/i2c-*。对应的I2C总线驱动未成功加载或探测失败。检查内核启动信息dmesg | grep i2c看是否有错误。问题2Error: Read failed或Error: Write failed读写失败的原因非常复杂。电气问题首先怀疑硬件。SCL/SDA上拉电阻是否合适线路是否过长用示波器或逻辑分析仪抓取波形看是否有ACK信号。时序问题某些低速设备如某些传感器可能无法适应内核驱动默认的高速模式。可以尝试在设备树Device Tree中降低该I2C总线的时钟频率clock-frequency 100000;表示100kHz。设备忙/锁死某些I2C设备如PMIC在异常操作后可能进入锁死状态需要断电复位。驱动冲突如果这个I2C地址已经被一个内核驱动占用i2cdetect显示为UU那么用户态的i2c-tool是无法直接访问的。你需要先卸载或屏蔽那个内核驱动。问题3扫描不到已知存在的设备使用i2cdetect -y -r bus尝试不同的探测模式。确认设备地址是否正确。I2C地址通常是7位i2c-tool命令中需要输入完整的8位地址左移一位但很多芯片手册给的是7位地址。例如手册说地址是0x507位那么i2c-tool命令中使用的地址就是0x50。但有些工具或文档会使用8位地址包含读写位即0xA0或0xA1要注意区分。i2c-tool期望的是7位地址。检查设备是否需要特殊的初始化序列才能进入通信状态。6. 超越基础i2c-tool的进阶用法与脚本化当基础读写调试通过后i2c-tool可以成为自动化测试和监控的强大工具。6.1 使用i2ctransfer进行复杂操作i2ctransfer的语法更接近底层I2C消息功能最强。它的基本格式是i2ctransfer -f -y bus [direction]data[address] ...-f强制访问即使设备被驱动占用也尝试访问。w表示写r表示读后面跟7位设备地址。示例1组合写入后读取常见于先写寄存器地址再读数据。# 向0x50设备写入一个字节0x10寄存器地址然后连续读取4个字节 i2ctransfer -y 0 w10x50 0x10 r4示例2发送重复起始条件Repeat Start。标准I2C协议中在一次传输中不释放总线的情况下主机可以发送重复起始条件后跟新的设备地址和读写方向。这在访问许多传感器时是标准操作。i2ctransfer的一个传输序列中的多条消息默认就会产生重复起始条件。# 这条命令会产生起始 0x50写 0x00 重复起始 0x50读 读4字节数据 停止 i2ctransfer -y 0 w10x50 0x00 r46.2 编写Shell脚本进行自动化测试你可以将一系列i2c-tool命令写入Shell脚本实现自动化配置、读取或监控。#!/bin/bash # monitor_sensor.sh BUS0 DEV_ADDR0x48 REG_TEMP0x00 while true; do # 读取温度寄存器2字节 VAL$(i2cget -y $BUS $DEV_ADDR $REG_TEMP w | sed s/0x//) # 将十六进制转换为十进制假设精度为0.0625°C/LSB TEMP$(( (0x$VAL 4) * 625 / 1000 )) echo Temperature: ${TEMP}.$(( (0x$VAL 0xF) * 625 )) C sleep 1 done6.3 与Python等高级语言结合虽然i2c-tool是命令行工具但你可以通过Python的subprocess模块调用它解析其输出从而在更复杂的应用逻辑中集成I2C操作。import subprocess import re def i2c_scan(bus): 扫描指定I2C总线上的设备地址 try: output subprocess.check_output([i2cdetect, -y, -r, str(bus)], textTrue) addresses [] for line in output.splitlines()[1:]: # 跳过第一行表头 parts line.split(:) if len(parts) 1: hex_str parts[1] # 匹配十六进制数字忽略--和UU matches re.findall(r([0-9a-f]{2}), hex_str, re.IGNORECASE) addresses.extend([int(m, 16) for m in matches]) return addresses except subprocess.CalledProcessError as e: print(fScan failed: {e}) return [] if __name__ __main__: dev_list i2c_scan(0) print(fFound devices at addresses: {[hex(addr) for addr in dev_list]})7. 从工具到理解透过i2c-tool看Linux I2C子系统通过移植和使用i2c-tool我们实际上已经触摸到了Linux I2C子系统的几个关键层面。用户态与内核态的桥梁i2c-tool是用户态便捷性的体现它将复杂的ioctl调用封装成简单的命令。当你用strace跟踪i2cdetect命令时能看到它最终调用了open(“/dev/i2c-0”, O_RDWR)和一系列的ioctl。驱动与设备的分离/dev/i2c-0这个节点是由I2C总线驱动如i2c-imx创建的。而挂在这条总线上的具体设备如0x50的EEPROM可能有独立的内核设备驱动如at24。如果这个设备驱动被加载并绑定成功它就会“认领”这个I2C地址i2cdetect就会显示为UU防止用户态程序误操作。这种设计保证了系统的稳定性和安全性。设备树Device Tree的作用在嵌入式Linux中I2C总线上的设备通常不是在代码中写死的而是通过设备树描述的。内核在启动时解析设备树中i2c0节点下的子节点然后自动实例化对应的平台设备并尝试匹配驱动。i2c-tool能直接访问的设备往往是那些没有对应内核驱动或者驱动被手动卸载的设备。所以下次当你轻松地用i2cget读出一个传感器的数据时可以想到这条命令背后是一条从用户空间到I2C控制器硬件的完整通路而i2c-tool是这个通路上一个设计精巧的“开关”。自己动手移植它不仅是获得一个工具更是对这套通信机制的一次深度实践。
1. 项目缘起为什么要在Linux上折腾i2c-tool如果你在嵌入式Linux开发或者玩树莓派、香橙派这类单板计算机大概率会接触到I2C总线。这玩意儿在板子上连接着各种传感器、EEPROM、RTC时钟芯片是嵌入式世界里的“血管”。但很多时候你拿到一块新板子或者自己编译了一个内核发现i2cdetect、i2cget这些命令死活用不了提示“找不到设备”或者“没有那个文件或目录”。这时候你就需要自己动手把i2c-tool这个“瑞士军刀”给移植到你的Linux系统里。我最近就在一块国产主控的板子上遇到了这个问题。板子跑的是厂商提供的定制Linux内核倒是开启了I2C驱动但根文件系统里空空如也常用的调试工具一概没有。没有i2c-tool你连总线上挂了几个设备、地址是什么都搞不清楚更别提读写寄存器了。难道要自己写个应用程序去ioctl太麻烦了。所以移植i2c-tool就成了点亮外设、调试硬件的第一步。这个过程说简单也简单就是编译一套工具说复杂也复杂涉及到交叉编译环境、库依赖、内核头文件匹配等一系列细节。下面我就把这次完整的移植过程、踩过的坑以及背后的原理掰开揉碎了讲清楚。2. i2c-tool工具链的构成与工作原理在动手编译之前我们得先搞清楚i2c-tool到底是什么以及它凭什么能操作I2C硬件。i2c-tool不是一个单一的程序而是一个工具集主要包含以下几个我们最常用的命令i2cdetect用于扫描I2C总线列出所有应答的设备地址。这是你拿到一块新板子要做的第一件事。i2cget从I2C设备的某个寄存器读取一个字节byte或一个字word。i2cset向I2C设备的某个寄存器写入一个字节或一个字。i2cdump连续读取I2C设备的一段寄存器区域并以十六进制形式打印出来非常适合快速查看配置。i2ctransfer执行一次或多次复杂的I2C消息传输组合读写功能更强大。这些命令行工具的本质都是对Linux内核提供的I2C设备接口进行封装的上层应用。在Linux中一旦I2C总线驱动和设备驱动加载成功内核就会在/dev目录下创建对应的设备节点例如/dev/i2c-0、/dev/i2c-1等。i2c-tool通过标准的文件IO操作open,read,write结合IO控制命令ioctl来与这些设备节点通信。这里的关键是ioctl。i2c-tool调用ioctl时会传入一个名为struct i2c_msg的数据结构这个结构体完整描述了一次I2C传输从设备地址、读写标志、数据缓冲区到数据长度。内核的I2C子系统收到这个请求后会通过平台相关的I2C控制器驱动如i2c-imx,i2c-rk3x最终操控硬件上的SCL时钟线和SDA数据线波形完成物理层的通信。所以i2c-tool能工作的前提是内核正确配置并编译了I2C子系统驱动包括总线驱动和设备驱动。系统中存在/dev/i2c-*设备节点。i2c-tool在编译时能找到与当前运行内核版本匹配的内核头文件特别是其中定义struct i2c_msg等数据结构和ioctl命令号的头文件。很多移植失败的问题都出在第三点上——编译环境和运行环境的内核版本不匹配。3. 移植前的准备工作环境与源码移植工作通常在x86的PC上进行称为宿主机为目标板可能是ARM、RISC-V等架构称为目标机生成可执行文件。这就需要搭建交叉编译环境。3.1 获取i2c-tool源代码i2c-tool是Linux内核源码的一部分但为了方便它也维护了独立的发布版本。推荐从官方镜像站获取这样版本比较清晰。# 在宿主机上操作 wget https://mirrors.edge.kernel.org/pub/software/utils/i2c-tools/i2c-tools-4.3.tar.gz tar -xzvf i2c-tools-4.3.tar.gz cd i2c-tools-4.3独立发布的i2c-tool代码更干净编译脚本也针对用户态工具做了优化比直接去内核源码drivers/i2c/tools目录下编译要省事得多。3.2 确认目标板内核版本与获取头文件这是最关键的一步。你必须知道目标板正在运行的内核精确版本。# 在目标板Linux系统上执行 uname -r假设输出是5.10.60-v8l。那么你需要在宿主机上准备完全相同版本的内核源代码。因为i2c-tool在编译过程中会包含内核头文件linux/i2c-dev.h和linux/i2c.h里面定义了关键的ioctl命令如I2C_SLAVE和数据结构。如果版本不一致即使编译成功在目标板上运行时也可能因为数据结构内存布局不同或ioctl命令号不同而导致段错误Segmentation fault或功能异常。如何获取内核源码最佳情况你的目标板供应商提供了完整的Linux SDK其中就包含内核源码包。直接使用这个。次选从内核官网www.kernel.org下载对应版本的内核源码。备选如果实在找不到精确版本可以尝试目标板/lib/modules/$(uname -r)/build目录。这个软链接通常指向内核构建目录但嵌入式系统里这个目录经常不存在或不完整。将内核源码解压到宿主机某个路径例如/home/user/linux-5.10.60。我们后续需要将其路径告诉i2c-tool的编译系统。3.3 安装交叉编译工具链你需要目标板CPU架构对应的交叉编译工具链。比如对于ARM Cortex-A53工具链前缀可能是aarch64-linux-gnu-。对于RISC-V可能是riscv64-unknown-linux-gnu-。在Ubuntu宿主机上通常可以用apt安装# 对于64位ARM sudo apt install gcc-aarch64-linux-gnu g-aarch64-linux-gnu # 对于32位ARM sudo apt install gcc-arm-linux-gnueabihf g-arm-linux-gnueabihf # 对于RISC-V sudo apt install gcc-riscv64-linux-gnu g-riscv64-linux-gnu安装后用aarch64-linux-gnu-gcc --version验证是否安装成功。4. 交叉编译i2c-tool的详细步骤与参数解析进入i2c-tools-4.3目录我们开始编译。i2c-tool使用经典的make系统我们需要通过修改Makefile或直接传递参数来指导交叉编译。4.1 直接命令行指定参数推荐这是最清晰的方式不需要永久修改文件。# 在i2c-tools-4.3目录下执行 make clean # 先清理 make CCaarch64-linux-gnu-gcc ARaarch64-linux-gnu-ar STRIPaarch64-linux-gnu-strip \ CFLAGS-I/home/user/linux-5.10.60/include -O2 \ BUILD_STATIC_LIB1 \ USE_STATIC_LIB1我们来拆解这些参数CCaarch64-linux-gnu-gcc指定交叉编译器。AR和STRIP同样指定交叉编译工具链中的归档和剥离工具。CFLAGS这是核心。-I/home/user/linux-5.10.60/include最重要指定内核头文件路径。必须指向你准备好的、与目标板内核版本一致的内核源码的include目录。这确保了i2c-tool使用正确的数据结构定义。-O2优化等级一般用-O2平衡性能与大小。BUILD_STATIC_LIB1和USE_STATIC_LIB1强烈建议在嵌入式移植中开启。这会让i2c-tool静态链接它自己的库函数生成的可执行文件几乎不依赖目标板上的动态库glibc等除外。可以避免因目标板C库版本过低而导致的“/lib/libc.so.6: version GLIBC_2.33 not found”这类令人头疼的运行时错误。注意静态编译虽然解决了库依赖但会显著增大二进制文件体积。如果目标板存储空间紧张且你确认其C库版本兼容可以尝试去掉这两个参数进行动态编译。4.2 处理常见的编译错误错误1linux/i2c-dev.h: No such file or directory这明确说明CFLAGS中的-I路径设置错了或者该路径下确实没有这个头文件。检查路径是否正确并确认内核源码是否完整解压ls /home/user/linux-5.10.60/include/linux/i2c-dev.h。错误2implicit declaration of function ‘...’通常是缺少其他内核头文件。可以尝试将CFLAGS中的路径指向内核源码的根目录因为i2c-tool可能还会包含其他位于include/uapi或include/linux下的头文件。更稳妥的做法是使用内核的make headers_install生成的用户态头文件但对于快速移植直接引用源码include目录在大多数情况下可行。错误3对__sync_fetch_and_add等函数的未定义引用这发生在为不支持原子操作的旧架构如某些老的ARMv5编译时。你需要在CFLAGS中为GCC指定正确的-march和-mcpu参数例如-marcharmv5te。4.3 编译成功后的产出物编译成功后在tools/目录下你会找到我们需要的可执行文件i2cdetect,i2cget,i2cset,i2cdump,i2ctransfer。用file命令检查一下file tools/i2cdetect输出应为tools/i2cdetect: ELF 64-bit LSB executable, ARM aarch64, version 1 (GNU/Linux), statically linked, for GNU/Linux 5.10.60, with debug_info, not stripped。注意“statically linked”和“for GNU/Linux 5.10.60”字样这和我们预期一致。5. 在目标板上的部署、测试与排坑编译出的二进制文件需要拷贝到目标板上运行。5.1 部署与权限设置可以通过SD卡、U盘、scp、nfs等方式将tools/下的文件拷贝到目标板例如放到/usr/local/bin。# 在目标板上操作 cp i2cdetect i2cget i2cset i2cdump i2ctransfer /usr/local/bin/非常重要的一步设置权限。/dev/i2c-*设备节点默认通常只有root用户或i2c用户组有读写权限。# 方法一使用sudo运行每次都要输密码 sudo i2cdetect -l # 方法二将当前用户加入i2c组推荐一劳永逸 sudo usermod -aG i2c $(whoami) # 然后需要注销并重新登录或者使用newgrp i2c命令在当前shell生效。 # 方法三直接修改设备节点权限安全性较低仅用于调试 sudo chmod 666 /dev/i2c-05.2 基础功能测试首先列出系统可用的I2C总线i2cdetect -l你会看到类似输出i2c-0 i2c mv64xxx_i2c adapter I2C adapter i2c-1 i2c DesignWare HDMI I2C adapter这表示系统有两组I2C总线i2c-0是主控的I2C控制器i2c-1可能是HDMI接口上的DDC通道。然后扫描某条总线例如i2c-0上的设备i2cdetect -y 0 # 或使用更详细的扫描 i2cdetect -y -r 0-y选项取消交互确认-r使用SMBus的receive byte命令进行探测比默认的quick write更可靠尤其对一些不标准的设备。输出是一个地址矩阵UU表示该地址被驱动占用通常由内核驱动声明xx数字如0x50表示有设备应答。5.3 高级操作与实战示例假设我们扫描到i2c-0总线上0x50地址有一个EEPROM设备如AT24C02。读取一个字节从芯片地址0x50的寄存器0x00读取一个字节。i2cget -y 0 0x50 0x00写入一个字节向芯片地址0x50的寄存器0x10写入值0xAB。i2cset -y 0 0x50 0x10 0xAB连续读取读取从寄存器0x00开始的16个字节。i2cdump -y 0 0x50 b 16 # 或者用i2ctransfer更灵活 i2ctransfer -y 0 w10x50 0x00 r165.4 常见运行时问题排查问题1Error: Could not open file /dev/i2c-0’: No such file or directory这说明内核没有成功创建I2C设备节点。可能的原因内核配置中未启用I2C_CHARDEV位于Device Drivers - I2C support - I2C device interface这个选项负责创建/dev/i2c-*。对应的I2C总线驱动未成功加载或探测失败。检查内核启动信息dmesg | grep i2c看是否有错误。问题2Error: Read failed或Error: Write failed读写失败的原因非常复杂。电气问题首先怀疑硬件。SCL/SDA上拉电阻是否合适线路是否过长用示波器或逻辑分析仪抓取波形看是否有ACK信号。时序问题某些低速设备如某些传感器可能无法适应内核驱动默认的高速模式。可以尝试在设备树Device Tree中降低该I2C总线的时钟频率clock-frequency 100000;表示100kHz。设备忙/锁死某些I2C设备如PMIC在异常操作后可能进入锁死状态需要断电复位。驱动冲突如果这个I2C地址已经被一个内核驱动占用i2cdetect显示为UU那么用户态的i2c-tool是无法直接访问的。你需要先卸载或屏蔽那个内核驱动。问题3扫描不到已知存在的设备使用i2cdetect -y -r bus尝试不同的探测模式。确认设备地址是否正确。I2C地址通常是7位i2c-tool命令中需要输入完整的8位地址左移一位但很多芯片手册给的是7位地址。例如手册说地址是0x507位那么i2c-tool命令中使用的地址就是0x50。但有些工具或文档会使用8位地址包含读写位即0xA0或0xA1要注意区分。i2c-tool期望的是7位地址。检查设备是否需要特殊的初始化序列才能进入通信状态。6. 超越基础i2c-tool的进阶用法与脚本化当基础读写调试通过后i2c-tool可以成为自动化测试和监控的强大工具。6.1 使用i2ctransfer进行复杂操作i2ctransfer的语法更接近底层I2C消息功能最强。它的基本格式是i2ctransfer -f -y bus [direction]data[address] ...-f强制访问即使设备被驱动占用也尝试访问。w表示写r表示读后面跟7位设备地址。示例1组合写入后读取常见于先写寄存器地址再读数据。# 向0x50设备写入一个字节0x10寄存器地址然后连续读取4个字节 i2ctransfer -y 0 w10x50 0x10 r4示例2发送重复起始条件Repeat Start。标准I2C协议中在一次传输中不释放总线的情况下主机可以发送重复起始条件后跟新的设备地址和读写方向。这在访问许多传感器时是标准操作。i2ctransfer的一个传输序列中的多条消息默认就会产生重复起始条件。# 这条命令会产生起始 0x50写 0x00 重复起始 0x50读 读4字节数据 停止 i2ctransfer -y 0 w10x50 0x00 r46.2 编写Shell脚本进行自动化测试你可以将一系列i2c-tool命令写入Shell脚本实现自动化配置、读取或监控。#!/bin/bash # monitor_sensor.sh BUS0 DEV_ADDR0x48 REG_TEMP0x00 while true; do # 读取温度寄存器2字节 VAL$(i2cget -y $BUS $DEV_ADDR $REG_TEMP w | sed s/0x//) # 将十六进制转换为十进制假设精度为0.0625°C/LSB TEMP$(( (0x$VAL 4) * 625 / 1000 )) echo Temperature: ${TEMP}.$(( (0x$VAL 0xF) * 625 )) C sleep 1 done6.3 与Python等高级语言结合虽然i2c-tool是命令行工具但你可以通过Python的subprocess模块调用它解析其输出从而在更复杂的应用逻辑中集成I2C操作。import subprocess import re def i2c_scan(bus): 扫描指定I2C总线上的设备地址 try: output subprocess.check_output([i2cdetect, -y, -r, str(bus)], textTrue) addresses [] for line in output.splitlines()[1:]: # 跳过第一行表头 parts line.split(:) if len(parts) 1: hex_str parts[1] # 匹配十六进制数字忽略--和UU matches re.findall(r([0-9a-f]{2}), hex_str, re.IGNORECASE) addresses.extend([int(m, 16) for m in matches]) return addresses except subprocess.CalledProcessError as e: print(fScan failed: {e}) return [] if __name__ __main__: dev_list i2c_scan(0) print(fFound devices at addresses: {[hex(addr) for addr in dev_list]})7. 从工具到理解透过i2c-tool看Linux I2C子系统通过移植和使用i2c-tool我们实际上已经触摸到了Linux I2C子系统的几个关键层面。用户态与内核态的桥梁i2c-tool是用户态便捷性的体现它将复杂的ioctl调用封装成简单的命令。当你用strace跟踪i2cdetect命令时能看到它最终调用了open(“/dev/i2c-0”, O_RDWR)和一系列的ioctl。驱动与设备的分离/dev/i2c-0这个节点是由I2C总线驱动如i2c-imx创建的。而挂在这条总线上的具体设备如0x50的EEPROM可能有独立的内核设备驱动如at24。如果这个设备驱动被加载并绑定成功它就会“认领”这个I2C地址i2cdetect就会显示为UU防止用户态程序误操作。这种设计保证了系统的稳定性和安全性。设备树Device Tree的作用在嵌入式Linux中I2C总线上的设备通常不是在代码中写死的而是通过设备树描述的。内核在启动时解析设备树中i2c0节点下的子节点然后自动实例化对应的平台设备并尝试匹配驱动。i2c-tool能直接访问的设备往往是那些没有对应内核驱动或者驱动被手动卸载的设备。所以下次当你轻松地用i2cget读出一个传感器的数据时可以想到这条命令背后是一条从用户空间到I2C控制器硬件的完整通路而i2c-tool是这个通路上一个设计精巧的“开关”。自己动手移植它不仅是获得一个工具更是对这套通信机制的一次深度实践。
)
