Linux 下i2c-tool的常用命令

Linux的i2c命令是用于与I2C（Inter-Integrated Circuit）总线设备进行通信的命令。I2C总线是一种串行通信协议，常用于连接各种外设，如传感器、显示器、存储器等。在Linux系统中，可以使用i2c-tools软件包提供的工具来操作I2C总线设备。

下面是一些常用的i2c命令：

i2cdetect命令

该命令用于扫描I2C总线上的设备。

语法：
​
i2cdetect [-y] [-a] [-q|-r] i2cbus [first last]：
​
参数说明：
​
参数y：关闭交互模式，使用该参数时，不会提示警告信息。
​
参数a：扫描总线上的所有设备。
​
参数q：使用SMBus的“quick write”命令进行检测，不建议使用该参数。
​
参数r：使用SMBus的“receive byte”命令进行检测，不建议使用该参数。
​
参数i2cbus：指定i2c总线的编号
​
参数first、last：扫描的地址范围
​
返回值说明：
​
‘–’：表示该地址被检测，但没有芯片应答；
​
‘UU’：表示该地址当前由内核驱动程序使用。
​
‘**’：**表示以十六进制表示的设备地址编号，如 “18”
​
例：扫描i2cbus0上的设备
  i2cdetect -y  0
​

i2cdetect的其他命令

i2cdetect -V：打印软件的版本
i2cdetect -l：检测当前系统有几组i2c总线

i2cget命令

i2cget：读某个寄存器的值，寄存器地址只能是8-bit

语法：
​
i2cget [-f] [-y] i2cbus chip-address [data-address [mode]]
​
参数说明：
​
参数f：强制访问设备。
​
参数y：关闭交互模式，使用该参数时，不会提示警告信息。
​
参数i2cbus：指定i2c总线的编号
​
参数chip-address：i2c设备地址
​
参数data-address：设备的寄存器的地址
​
参数mode：指定读取的大小， 可以是b, w, s或i，分别对应了字节，字，SMBus块, I2C块。
​
例：按字节读取i2cbus2上 0x1a设备的 0x0寄存器的值
i2cget -f -y 2 0x1a 0x0 b
​

i2cset命令

i2cset：写某个寄存器的值，寄存器地址只能是8-bit。

语法：
​
i2cset [-f] [-y] [-m mask] [-r] i2cbus chip-address data-address [value] … [mode]
​
参数说明：
​
参数f：强制访问设备。
​
参数y：关闭交互模式，使用该参数时，不会提示警告信息。
​
参数m：
​
参数r：写入后立即回读寄存器值，并将结果与写入的值进行比较。
​
参数i2cbus：指定i2c总线的编号
​
参数chip-address：i2c设备地址
​
参数data-address：设备的寄存器的地址
​
参数value：要写入寄存器的值
​
参数mode：指定读取的大小， 可以是b, w, s或i，分别对应了字节，字，SMBus块, I2C块
​
例：按字节写i2cbus2上 0x1a设备的 0x0寄存器的值为0xff
i2cset -f -y 2 0x1a 0x0 0xff b

i2cdump命令

i2cdump：读取指定设备的全部寄存器的值。

语法：
​
i2cdump [-f] [-r first-last] [-y] i2cbus chip-address [mode [bank [bankreg]]]
​
参数说明：
​
参数r：指定寄存器范围，只扫描从first到last区域；
​
参数f：强制访问设备。
​
参数y：关闭人机交互模式；
​
参数i2cbus：指定i2c总线的编号
​
参数address：指定设备的地址
​
参数mode：指定读取的大小， 可以是b, w, s或i，分别对应了字节，字，SMBus块, I2C块
​
​
例：按字节读取i2cbus2上 0x1a设备的 所有寄存器的值
i2cget -f -y 2 0x1a  b

i2ctransfer命令

i2ctransfer：可以读写多字节寄存器地址。i2ctransfer可以替代i2cset和i2cget。

语法
i2ctransfer [-f] [-y] [-v] [-a] i2cbus w-n@chip-address data-0 data-1 ... data-n r-num
i2ctransfer [-f] [-y] [-v] [-a] i2cbus w-n@chip-address data-0 data-1 ... data-n    
​
参数说明：
​
参数f：强制访问设备。
参数y：关闭人机交互模式；
参数v：
参数a：允许用0x00-0x07和0x78-0x7f地址
参数i2cbus：指定i2c总线的编号
参数w-n：写n个字节
参数chip-address：器件地址
参数data-0 data-1 ... data-n：寄存器地址（读） / 寄存器地址和写的数据（写）
参数r-num：读num个字节
​
例1：i2ctransfer -y -f 1 w4@0x1a 0x0 0x0 0xfe 0xf2
   1是总线号，0x1a是设备地址，0x0 0x0是16-bit寄存器地址，0xfe和0xf2是写入的数据。也就是把0xfe和0xf2写入到0x1a芯片的0x0 0x0寄存器中。w4表示要写4个字节，即寄存器地址0x0 0x0和数据0xfe 0xf2。
​
例2：i2ctransfer -y -f 1 w2@0x1a 0x0 0xf r16
   1是总线号，0x1a是设备地址，0x0 0xf是16-bit寄存器地址，r16是读16个字节。也就是从0x0 0xf寄存器开始，向后读16个字节。w2表示要写2个字节，即寄存器地址0x0 0xf。