跳到主要内容

I2C 通信

本章示例使用I2C设备:1.54inch Touch LCD Module

1. I2C 子系统​

Linux I2C 子系统用于管理 I2C 控制器及挂载在总线上的外部设备,常用接口如下:

  1. /sys/bus/i2c/devices/:查看系统中的 I2C 适配器及设备信息。
  2. /dev/i2c-*:用户空间访问 I2C 总线的设备节点。
  3. i2cdetect、i2cget、i2cset、i2cdump:用于扫描、读取和写入 I2C 设备。

2. I2C 测试(Shell)​

2.1 引脚分布​

Luckfox Aura 的 40Pin 接口提供以下 I2C 引脚:

物理引脚复用功能GPIO说明
3I2C2_SDA_M0GPIO0_D1I2C2 数据线
5I2C2_SCL_M0GPIO0_D0I2C2 时钟线
27I2C5_SDA_M2GPIO5_A7I2C5 数据线
28I2C5_SCL_M2GPIO5_A1I2C5 时钟线

2.2 设备树配置​

  1. 板级设备树路径:

    <Luckfox Aura SDK>/sysdrv/source/kernel/arch/arm64/boot/dts/rockchip/rv1126b-luckfox-aura.dtsi
  2. 启用I2C2:

    &i2c2 {
    pinctrl-names = "default";
    pinctrl-0 = <&i2c2m0_pins>;
    clock-frequency = <100000>;
    status = "okay";
    };
  3. 编译内核:

    sudo ./build.sh kernel

2.3 查看设备​

在 Linux 系统下,/sys/bus/i2c/devices/ 目录用于存放所有 I2C 总线适配器以及挂载的 I2C 从设备节点。

  1. 查看系统已注册的 I2C 总线:

    root@aura:~# ls /sys/bus/i2c/devices/
    0-0027 3-0038 3-0045 3-005d 4-0060 i2c-2 i2c-4
    3-0014 3-0041 3-004e 4-0037 i2c-0 i2c-3
  2. 查看 I2C 设备节点及总线名称:

    root@aura:~# ls /dev/i2c-*
    /dev/i2c-0 /dev/i2c-2 /dev/i2c-3 /dev/i2c-4 /dev/i2c-5
    root@aura:~# i2cdetect -l
    i2c-0 i2c rk3x-i2c I2C adapter
    i2c-2 i2c rk3x-i2c I2C adapter
    i2c-3 i2c rk3x-i2c I2C adapter
    i2c-4 i2c rk3x-i2c I2C adapter

    目录下的文件夹命名分为两种类型:

    • I2C 总线适配器(控制器):命名格式为 i2c‑X,X 代表 I2C 总线编号;例如 i2c‑1 即编号为 1 的 I2C 总线。
    • I2C 从机外设:命名格式为 X‑YYYY;X 为所属总线编号,YYYY 为从设备十六进制地址。

2.4 I2C 测试​

  1. 查看 i2c-2 接口上的设备:

    i2cdetect -a -y 2

    扫描结果中的十六进制数值为从设备地址;-- 表示未检测到设备,UU 表示该地址已被内核驱动占用。

  2. 读取地址为 0x15 的设备全部寄存器:

    i2cdump -f -y 2 0x15
  3. 读取指定IIC设备的某个寄存器的值,如读取 0x15 器件中0xA7 寄存器值:

    i2cget -f -y 2 0x15 0xA7
  4. 向 0xA7 寄存器写入 0x6f:

    i2cset -f -y 2 0x15 0xA7 0x6f

扫描或写寄存器前,应确认设备手册中的地址和寄存器定义,避免改变设备状态。

3. I2C 通信(Python 程序)​

以下示例通过 I2C2 读取从设备寄存器,默认读取触摸控制器地址 0x15 的 0xA7 寄存器。

  1. 安装依赖:

    apt install -y python3-pip
    pip3 install smbus2
  2. 完整代码:

    #!/usr/bin/env python3
    from smbus2 import SMBus, i2c_msg

    I2C_BUS = 2
    I2C_ADDR = 0x15
    REG_ADDR = 0xA7

    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]

    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}")
  3. 配置 I2C 设备参数:设置 I2C 总线编号、从机地址和需要读取的寄存器地址。

    I2C_BUS = 2
    I2C_ADDR = 0x15
    REG_ADDR = 0xA7

    当前使用 I2C2,0x15 为触摸控制器地址,0xA7 为需要读取的寄存器地址。

  4. 打开 I2C 设备:通过 SMBus() 打开 I2C2 设备。

    with SMBus(I2C_BUS) as bus:

    I2C_BUS 为 2 时,对应设备节点 /dev/i2c-2。

  5. 读取寄存器:先发送寄存器地址,再读取 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 传输。

  6. 输出结果和异常处理:通信成功时输出寄存器值;通信失败时输出错误信息。

    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。

  7. 运行测试:

    python3 IIC.py

    执行显示:

4. I2C 通信(C 程序)​

以下程序使用 I2C_RDWR 完成相同的组合读测试。

  1. 完整代码:

    #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 0xA7

    static 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 = &reg },
    { .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;
    }
  2. 配置 I2C 设备参数:设置 I2C2 设备节点、从机地址和寄存器地址。

    #define I2C_DEVICE "/dev/i2c-2"
    #define I2C_ADDRESS 0x15
    #define REG_ADDRESS 0xA7

    连接其他 I2C 设备时,应根据实际总线和器件手册修改这些参数。

  3. 打开 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;
    }

    打开失败时,程序输出错误信息并结束运行。

  4. 配置 I2C 读写消息:使用两个 i2c_msg:第一个发送寄存器地址,第二个读取寄存器数据。

    struct i2c_msg messages[2] = {
    { .addr = addr, .flags = 0, .len = 1, .buf = &reg },
    { .addr = addr, .flags = I2C_M_RD, .len = 1, .buf = value },
    };
    struct i2c_rdwr_ioctl_data transfer = {
    .msgs = messages,
    .nmsgs = 2,
    };

    I2C_M_RD 表示读取消息;未设置该标志的消息为写入消息。

  5. 执行组合读操作:通过 I2C_RDWR 将两个消息作为一次组合传输执行。

    return ioctl(fd, I2C_RDWR, &transfer);

    该操作先写入寄存器地址,再读取 1 字节寄存器数据。

  6. 输出结果并关闭设备:读取成功后输出寄存器值,最后关闭 I2C 设备节点。

    printf("I2C device 0x%02X, register 0x%02X = 0x%02X\n",
    I2C_ADDRESS, REG_ADDRESS, value);
    close(fd);
  7. 编译程序:使用 SDK 的 AArch64 交叉编译器。

    <SDK目录>/tools/linux/toolchain/aarch64-rockchip1240-linux-gnu/bin/aarch64-rockchip1240-linux-gnu-gcc IIC.c -o IIC
  8. 运行程序