要想用Linux i2c-tools必须安装如下套件,安装后就可以使用i2cdetect、i2cdump、i2cset、i2cget、i2ctransfer了。
sudo apt install i2c-tools -y
该命令用于扫描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”
实例
i2cdetect的其他命令
i2cdetect -V:打印软件的版本
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块。
实例
其中: 1是总线号,0x1a是设备地址,0x0是寄存器地址。
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块
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块
i2ctransfer:可以读写多字节寄存器地址。i2ctransfer可以替代i2cset和i2cget。(i2ctransfer becomes available starting with I2C tools revision v4.0 included into OpenEmbedded Thud (2.6.x))
语法
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个字节
实例
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。
i2ctransfer -y -f 1 w2@0x1a 0x0 0xf r16
其中:1是总线号,0x1a是设备地址,0x0 0xf是16-bit寄存器地址,r16是读16个字节。也就是从0x0 0xf寄存器开始,向后读16个字节。w2表示要写2个字节,即寄存器地址0x0 0xf。