I2C 通信
本章示例使用I2C设备:
1.54inch Touch LCD Module
1. I2C 子系统
Linux I2C 子系统用于管理 I2C 控制器及挂载在总线上的外部设备,常用接口如下:
/sys/bus/i2c/devices/:查看系统中的 I2C 适配器及设备信息。/dev/i2c-*:用户空间访问 I2C 总线的设备节点。i2cdetect、i2cget、i2cset、i2cdump:用于扫描、读取和写入 I2C 设备。
2. I2C 测试(Shell)
2.1 引脚分布
Luckfox Aura 的 40Pin 接口提供以下 I2C 引脚:
| 物理引脚 | 复用功能 | GPIO | 说明 |
|---|---|---|---|
| 3 | I2C2_SDA_M0 | GPIO0_D1 | I2C2 数据线 |
| 5 | I2C2_SCL_M0 | GPIO0_D0 | I2C2 时钟线 |
| 27 | I2C5_SDA_M2 | GPIO5_A7 | I2C5 数据线 |
| 28 | I2C5_SCL_M2 | GPIO5_A1 | I2C5 时钟线 |

2.2 设备树配置
-
板级设备树路径:
<Luckfox Aura SDK>/sysdrv/source/kernel/arch/arm64/boot/dts/rockchip/rv1126b-luckfox-aura.dtsi -
启用I2C2:
&i2c2 {pinctrl-names = "default";pinctrl-0 = <&i2c2m0_pins>;clock-frequency = <100000>;status = "okay";}; -
编译内核:
sudo ./build.sh kernel
2.3 查看设备
在 Linux 系统下,/sys/bus/i2c/devices/ 目录用于存放所有 I2C 总线适配器以及挂载的 I2C 从设备节点。
-
查看系统已注册的 I2C 总线:
root@aura:~# ls /sys/bus/i2c/devices/0-0027 3-0038 3-0045 3-005d 4-0060 i2c-2 i2c-43-0014 3-0041 3-004e 4-0037 i2c-0 i2c-3 -
查看 I2C 设备节点及总线名称:
root@aura:~# ls /dev/i2c-*/dev/i2c-0 /dev/i2c-2 /dev/i2c-3 /dev/i2c-4 /dev/i2c-5root@aura:~# i2cdetect -li2c-0 i2c rk3x-i2c I2C adapteri2c-2 i2c rk3x-i2c I2C adapteri2c-3 i2c rk3x-i2c I2C adapteri2c-4 i2c rk3x-i2c I2C adapter目录下的文件夹命名分为两种类型:
- I2C 总线适配器(控制器):命名格式为
i2c‑X,X代表 I2C 总线编号;例如i2c‑1即编号为 1 的 I2C 总线。 - I2C 从机外设:命名格式为
X‑YYYY;X为所属总线编号,YYYY为从设备十六进制地址。
- I2C 总线适配器(控制器):命名格式为
2.4 I2C 测试
-
查看 i2c-2 接口上的设备:
i2cdetect -a -y 2扫描结果中的十六进制数值为从设备地址;
--表示未检测到设备,UU表示该地址已被内核驱动占用。 -
读取地址为
0x15的设备全部寄存器:i2cdump -f -y 2 0x15 -
读取指定IIC设备的某个寄存器的值,如读取
0x15器件中0xA7寄存器值:i2cget -f -y 2 0x15 0xA7 -
向
0xA7寄存器写入0x6f:i2cset -f -y 2 0x15 0xA7 0x6f
扫描或写寄存器前,应确认设备手册中的地址和寄存器定义,避免改变设备状态。
3. I2C 通信(Python 程序)
以下示例通过 I2C2 读取从设备寄存器,默认读取触摸控制器地址 0x15 的 0xA7 寄存器。
-
安装依赖:
apt install -y python3-pippip3 install smbus2 -
完整代码:
#!/usr/bin/env python3from smbus2 import SMBus, i2c_msgI2C_BUS = 2I2C_ADDR = 0x15REG_ADDR = 0xA7def read_register(bus, device_addr, register_addr):write_msg = i2c_msg.write(device_addr, [register_addr])read_msg = i2c_msg.read(device_addr, 1)bus.i2c_rdwr(write_msg, read_msg)return list(read_msg)[0]try:with SMBus(I2C_BUS) as bus:value = read_register(bus, I2C_ADDR, REG_ADDR)print(f"I2C device 0x{I2C_ADDR:02X}, "f"register 0x{REG_ADDR:02X} = 0x{value:02X}")except PermissionError:print("Permission denied: run the program as root")except OSError as error:print(f"I2C communication failed: {error}") -
配置 I2C 设备参数:设置 I2C 总线编号、从机地址和需要读取的寄存器地址。
I2C_BUS = 2I2C_ADDR = 0x15REG_ADDR = 0xA7当前使用 I2C2,
0x15为触摸控制器地址,0xA7为需要读取的寄存器地址。 -
打开 I2C 设备:通过
SMBus()打开 I2C2 设备。with SMBus(I2C_BUS) as bus:I2C_BUS为 2 时,对应设备节点/dev/i2c-2。 -
读取寄存器:先发送寄存器地址,再读取 1 字节寄存器数据。
def read_register(bus, device_addr, register_addr):write_msg = i2c_msg.write(device_addr, [register_addr])read_msg = i2c_msg.read(device_addr, 1)bus.i2c_rdwr(write_msg, read_msg)return list(read_msg)[0]i2c_rdwr()将写入和读取操作组合为一次 I2C 传输。 -
输出结果和异常处理:通信成功时输出寄存器值;通信失败时输出错误信息。
try:with SMBus(I2C_BUS) as bus:value = read_register(bus, I2C_ADDR, REG_ADDR)print(f"I2C device 0x{I2C_ADDR:02X}, "f"register 0x{REG_ADDR:02X} = 0x{value:02X}")except PermissionError:print("Permission denied: run the program as root")except OSError as error:print(f"I2C communication failed: {error}")使用其他 I2C 设备时,应根据器件手册修改
I2C_ADDR和REG_ADDR。 -
运行测试:
python3 IIC.py执行显示:
4. I2C 通信(C 程序)
以下程序使用 I2C_RDWR 完成相同的组合读测试。
-
完整代码:
#include <errno.h>#include <fcntl.h>#include <linux/i2c-dev.h>#include <linux/i2c.h>#include <stdint.h>#include <stdio.h>#include <stdlib.h>#include <string.h>#include <sys/ioctl.h>#include <unistd.h>#define I2C_DEVICE "/dev/i2c-2"#define I2C_ADDRESS 0x15#define REG_ADDRESS 0xA7static int read_register(int fd, uint8_t addr, uint8_t reg, uint8_t *value){struct i2c_msg messages[2] = {{ .addr = addr, .flags = 0, .len = 1, .buf = ® },{ .addr = addr, .flags = I2C_M_RD, .len = 1, .buf = value },};struct i2c_rdwr_ioctl_data transfer = {.msgs = messages,.nmsgs = 2,};return ioctl(fd, I2C_RDWR, &transfer);}int main(void){uint8_t value = 0;int fd = open(I2C_DEVICE, O_RDWR);if (fd < 0) {fprintf(stderr, "Failed to open %s: %s\n",I2C_DEVICE, strerror(errno));return EXIT_FAILURE;}if (read_register(fd, I2C_ADDRESS, REG_ADDRESS, &value) < 0) {fprintf(stderr, "I2C communication failed: %s\n",strerror(errno));close(fd);return EXIT_FAILURE;}printf("I2C device 0x%02X, register 0x%02X = 0x%02X\n",I2C_ADDRESS, REG_ADDRESS, value);close(fd);return EXIT_SUCCESS;} -
配置 I2C 设备参数:设置 I2C2 设备节点、从机地址和寄存器地址。
#define I2C_DEVICE "/dev/i2c-2"#define I2C_ADDRESS 0x15#define REG_ADDRESS 0xA7连接其他 I2C 设备时,应根据实际总线和器件手册修改这些参数。
-
打开 I2C 设备:用以读写方式打开 I2C2 设备节点。
int fd = open(I2C_DEVICE, O_RDWR);if (fd < 0) {fprintf(stderr, "Failed to open %s: %s\n",I2C_DEVICE, strerror(errno));return EXIT_FAILURE;}打开失败时,程序输出错误信息并结束运行。
-
配置 I2C 读写消息:使用两个
i2c_msg:第一个发送寄存器地址,第二个读取寄存器数据。struct i2c_msg messages[2] = {{ .addr = addr, .flags = 0, .len = 1, .buf = ® },{ .addr = addr, .flags = I2C_M_RD, .len = 1, .buf = value },};struct i2c_rdwr_ioctl_data transfer = {.msgs = messages,.nmsgs = 2,};I2C_M_RD表示读取消息;未设置该标志的消息为写入消息。 -
执行组合读操作:通过
I2C_RDWR将两个消息作为一次组合传输执行。return ioctl(fd, I2C_RDWR, &transfer);该操作先写入寄存器地址,再读取 1 字节寄存器数据。
-
输出结果并关闭设备:读取成功后输出寄存器值,最后关闭 I2C 设备节点。
printf("I2C device 0x%02X, register 0x%02X = 0x%02X\n",I2C_ADDRESS, REG_ADDRESS, value);close(fd); -
编译程序:使用 SDK 的 AArch64 交叉编译器。
<SDK目录>/tools/linux/toolchain/aarch64-rockchip1240-linux-gnu/bin/aarch64-rockchip1240-linux-gnu-gcc IIC.c -o IIC -
运行程序