Android i2cdetect i2cdump i2cget i2cset调试工具使用_i2cget命令详解

本文介绍Android/Linux (反正是ARM) 的I2C调试工具用法 , 包括i2cdetect、i2cdump、i2cget和i2cset，可实现I2C设备的识别、监控和配置。i2cdetect用于扫描所有设备地址，i2cdump读取寄存器的值，而i2cget和i2cset分别实现读取和写入寄存器的功能。这些工具提供了便捷的方式与I2C设备进行交互，深入了解设备状态与配置。

1. i2c工具和命令

1.1 i2c工具概述

I2C（Inter-Integrated Circuit）是一种串行总线协议，用于连接多个低速设备，如传感器，EEPROM，LCD等。I2C总线由两根信号线组成：SCL（时钟线）和SDA（数据线）。I2C总线上有一个主设备（master）和多个从设备（slave），主设备负责产生时钟信号和控制数据传输，从设备负责响应主设备的命令和发送或接收数据。

I2C工具是一组Linux命令行工具，用于操作I2C总线上的设备。I2C工具包括以下四个工具：

• i2cdetect：用于扫描I2C总线上的所有设备，并显示它们的地址。
• i2cdump：用于读取I2C设备的所有寄存器，并显示它们的值。
• i2cget：用于读取I2C设备的某个寄存器，并显示它的值。
• i2cset：用于向I2C设备的某个寄存器写入一个值。

1.2 i2c命令和参数

i2c命令的通用格式如下：

i2c<tool> [-options] BUS CHIP [ADDRESS] [VALUE] [MODE]
1

其中：

• <tool>表示要使用的I2C工具，如detect, dump, get, set等。
• [-options]表示可选的参数，不同的工具有不同的参数，具体可以使用--help选项查看。
• BUS表示要操作的I2C总线编号，如0, 1, 2等。
• CHIP表示要操作的I2C设备地址，如0x20, 0x3c等。
• [ADDRESS]表示要操作的I2C设备寄存器地址，如0x00, 0x01等。这个参数只在i2cget和i2cset工具中使用。
• [VALUE]表示要写入的值，如0x00, 0xff等。这个参数只在i2cset工具中使用。
• [MODE]表示要使用的数据模式，如b（字节），w（16位字），i（I2C块）。这个参数只在i2cset工具中使用。

2. i2cdetect工具的使用

2.1 i2cdetect工具介绍

i2cdetect工具是用于扫描I2C总线上的所有设备，并显示它们的地址。这个工具可以帮助我们确定哪些设备已经连接到了I2C总线上，以及它们各自的地址是多少。

2.2 i2cdetect命令和参数

i2cdetect命令的格式如下：

i2cdetect [-ary] BUS [FIRST LAST]
1

其中：

• [-ary]表示可选的参数，具体含义如下：
  • -a表示扫描所有地址（0x00-0x7f），而不是默认的范围（0x03-0x77）。
  • -r表示使用SMBus Read Byte命令进行探测，而不是默认的Write Byte命令。这个选项可以避免一些设备的写保护问题，但是也可能导致一些设备的错误操作。
  • -y表示在执行探测之前不进行确认提示，这个选项适合脚本使用。
• BUS表示要扫描的I2C总线编号，如0, 1, 2等。
• [FIRST LAST]表示要扫描的地址范围，如0x20 0x30。这个参数是可选的，如果不指定，则默认扫描所有地址或者由-a选项指定的范围。

2.3 i2cdetect使用示例

假设我们有一个Android设备，它有两个I2C总线，分别编号为0和1。我们想要知道这两个总线上都连接了哪些设备，以及它们的地址是多少。我们可以使用以下命令：

130|rk3568_r:/data # i2cdetect -l 
i2c-1   i2c             rk3x-i2c                                I2C Adapter
i2c-6   i2c             DesignWare HDMI                         I2C Adapter
i2c-0   i2c             rk3x-i2c                                I2C Adapter
i2c-5   i2c             rk3x-i2c                                I2C Adapter
# 因为我只打开了0,1,5 i2c

1
2
3
4
5
6
7

输出结果可能类似于以下内容：

rk3568_r:/data # i2cdetect -y 0
     0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
00:          -- -- -- -- -- -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: UU -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
40: 40 -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
70: -- -- -- -- -- -- -- --
rk3568_r:/data # i2cdetect -y 1
     0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
00:          -- -- -- -- -- -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
70: -- -- -- -- -- -- -- --
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

从输出结果中，我们可以看到：

• 在I2C总线0上，有很多设备连接了，它们的地址分别是：0x20，0x40。其中，0x20地址后面有UU标记，表示这些地址已经被内核驱动占用了，不能直接访问。
• 在I2C总线1上，没有任何设备连接了，所有的地址都显示为–。

3. i2cdump工具的使用

3.1 i2cdump工具介绍

i2cdump工具是用于读取I2C设备的所有寄存器，并显示它们的值。这个工具可以帮助我们了解I2C设备的内部状态和配置，以及检查是否有错误或异常发生。

3.2 i2cdump命令和参数

i2cdump命令的格式如下：

i2cdump [-fy] BUS CHIP
1

其中：

• [-fy]表示可选的参数，具体含义如下：
  • -f表示强制访问忙碌的设备，即使它们已经被内核驱动占用了。这个选项可能会导致一些设备的错误操作，所以要谨慎使用。
  • -y表示在执行读取之前不进行确认提示，这个选项适合脚本使用。
• BUS表示要读取的I2C总线编号，如0, 1, 2等。
• CHIP表示要读取的I2C设备地址，如0x20, 0x3c等。

3.3 i2cdump使用示例

假设我们有一个Android设备，它有一个I2C总线0，上面连接了一个地址为0x20的I/O扩展器（PCA9555）。我们想要读取这个设备的所有寄存器，并显示它们的值。我们可以使用以下命令：

rk3568_r:/data # i2cdump -fy 0 0x20
1

输出结果可能类似于以下内容：

rk3568_r:/data # i2cdump -fy 0 0x20
     0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f    0123456789abcdef
00: 04 00 09 04 08 17 05 00 00 00 01 01 00 01 80 00    ?.?????...??.??.
10: 00 00 03 00 00 00 00 06 c8 00 00 00 00 00 00 00    ..?....??.......
20: 00 00 00 ff ff 00 00 70 00 66 00 00 00 00 00 0f    ...??..p.f.....?
30: 04 00 00 00 a5 00 00 00 01 ff ff 00 00 e0 0f 09    ?...?...???..???
40: 69 4c 0c 58 2d 0c 95 01 00 00 00 17 00 00 17 00    iL?X-???...?..?.
50: 8c 00 01 00 01 b0 44 10 00 60 00 00 00 00 00 00    ?.?.??D?.`......
60: 00 00 00 00 00 00 00 00 00 00 00 00 54 01 59 00    ............T?Y.
70: 00 00 00 00 ff ff ff f1 00 05 ff fc 00 00 00 00    ....????.???....
80: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
90: 60 81 59 80 04 df d2 81 59 00 00 00 00 00 00 00    `?Y?????Y.......
a0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
b0: 00 0f 0f 0f 0f 04 a4 ff ff 00 64 20 20 64 1a 20    .????????.d  d?
c0: 64 00 00 64 1a 00 6b ff ff ff ff ff 0c 00 0c 0c    d..d?.k??????.??
d0: 0c 0c 6c 00 6c 6c 6c 6c 30 30 30 30 30 00 09 31    ??l.llll00000.?1
e0: 00 00 00 55 a2 c8 c5 40 00 ff 22 03 0a 80 94 0e    ...U???@.?"?????
f0: c2 ac a0 40 18 40 00 86 00 fc 00 ff 00 ff 60 00    ???@?@.?.?.?.?`.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

从输出结果中，我们可以看到：

• 这个设备有16个寄存器，分别是：Input Port 0 (0x00), Input Port 1 (0x01), Output Port 0 (0x02), Output Port 1 (0x03), Polarity Inversion Port 0 (0x04), Polarity Inversion Port 1 (0x05), Configuration Port 0 (0x06), Configuration Port 1 (0x07), and Bank Select (0x10-0x17).
• 所有的寄存器都显示为ff，表示所有的位都是1。这意味着这个设备没有被配置或者控制过，所有的端口都是输入模式，并且没有反向极性。如果我们想要改变这个设备的状态或者功能，我们需要使用i2cset工具向相应的寄存器写入不同的值。

4. i2cget工具的使用

4.1 i2cget工具介绍

i2cget工具是用于读取I2C设备的某个寄存器，并显示它的值。这个工具可以帮助我们了解I2C设备的某个特定状态或配置，以及检查是否有错误或异常发生。

4.2 i2cget命令和参数

i2cget命令的格式如下：

i2cget [-fy] BUS CHIP ADDR
1

其中：

• [-fy]表示可选的参数，具体含义如下：
  • -f表示强制访问忙碌的设备，即使它们已经被内核驱动占用了。这个选项可能会导致一些设备的错误操作，所以要谨慎使用。
  • -y表示在执行读取之前不进行确认提示，这个选项适合脚本使用。
• BUS表示要读取的I2C总线编号，如0, 1, 2等。
• CHIP表示要读取的I2C设备地址，如0x20, 0x3c等。
• ADDR表示要读取的I2C设备寄存器地址，如0x00, 0x01等。

4.3 i2cget使用示例

假设我们有一个Android设备，它有一个I2C总线0，上面连接了一个地址为0x20的I/O扩展器。我们想要读取这个设备的Output Port 0寄存器（0x02），并显示它的值。我们可以使用以下命令：

i2cget -fy 0 0x20 0x02 #一定要f , 不然会提示i2cget: ioctl 703: Device or resource busy
1

输出结果可能类似于以下内容：

1|rk3568_r:/data # i2cget -fy 0 0x20 0x02
0x09
1
2

从输出结果中，我们可以看到：

• 这个设备的Output Port 0寄存器（0x02）的值是0xff，表示所有的位都是1。这意味着这个端口上所有的引脚都输出高电平。如果我们想要改变这个端口上某些引脚的输出状态，我们需要使用i2cset工具向这个寄存器写入不同的值。

5. i2cset工具的使用

5.1 i2cset工具介绍

i2cset工具是用于向I2C设备的某个寄存器写入一个值。这个工具可以帮助我们改变I2C设备的某个特定状态或配置，以及控制它的功能或行为。

5.2 i2cset命令和参数

i2cset命令的格式如下：

i2cset [-fy] BUS CHIP ADDR VALUE [MODE]
1

其中：

• [-fy]表示可选的参数，具体含义如下：
  • -f表示强制访问忙碌的设备，即使它们已经被内核驱动占用了。这个选项可能会导致一些设备的错误操作，所以要谨慎使用。
  • -y表示在执行写入之前不进行确认提示，这个选项适合脚本使用。
• BUS表示要写入的I2C总线编号，如0, 1, 2等。
• CHIP表示要写入的I2C设备地址，如0x20, 0x3c等。
• ADDR表示要写入的I2C设备寄存器地址，如0x00, 0x01等。
• VALUE表示要写入的值，如0x00, 0xff等。
• [MODE]表示要使用的数据模式，如b（字节），w（16位字），i（I2C块）。这个参数是可选的，如果不指定，则默认使用字节模式。

5.3 i2cset使用示例

假设我们有一个Android设备，它有一个I2C总线0，上面连接了一个地址为0x20的I/O扩展器。我们想要向这个设备的Output Port 0寄存器（0x02）写入一个值0xaa，并显示它的值。我们可以使用以下命令：

i2cset -fy 0 0x20 0x02 0xaa b
i2cget -fy 0 0x20 0x02
1
2

输出结果可能类似于以下内容：

rk3568_r:/data # i2cset -fy 0 0x20 0x02 0xaa b
rk3568_r:/data # i2cget -fy 0 0x20 0x02
0xaa
rk3568_r:/data #
1
2
3
4

从输出结果中，我们可以看到：

• 我们成功地向这个设备的Output Port 0寄存器（0x02）写入了一个值0xaa。
• 这个寄存器的值是0xaa，表示其中奇数位都是1，偶数位都是0。这意味着这个端口上奇数引脚都输出高电平，偶数引脚都输出低电平。如果我们想要改变这个端口上某些引脚的输出状态，我们可以使用i2cset工具向这个寄存器写入不同的值。