1I2CDETECT(8)                System Manager's Manual               I2CDETECT(8)
2
3
4

NAME

6       i2cdetect - detect I2C chips
7
8

SYNOPSIS

10       i2cdetect [-y] [-a] [-q|-r] i2cbus [first last]
11       i2cdetect -F i2cbus
12       i2cdetect -V
13       i2cdetect -l
14
15

DESCRIPTION

17       i2cdetect  is  a  userspace  program to scan an I2C bus for devices. It
18       outputs a table with the list of detected devices on the specified bus.
19       i2cbus  indicates  the number or name of the I2C bus to be scanned, and
20       should correspond to one of the busses listed  by  i2cdetect  -l.   The
21       optional   parameters  first  and  last  restrict  the  scanning  range
22       (default: from 0x03 to 0x77).
23
24       i2cdetect can also be used to query the functionalities of an  I2C  bus
25       (see option -F.)
26
27

WARNING

29       This program can confuse your I2C bus, cause data loss and worse!
30
31

INTERPRETING THE OUTPUT

33       Each  cell  in  the output table will contain one of the following sym‐
34       bols:
35
36       · "--". The address was probed but no chip answered.
37
38       · "UU". Probing was skipped, because this address is currently  in  use
39         by  a  driver.  This  strongly  suggests that there is a chip at this
40         address.
41
42       · An address number in hexadecimal, e.g. "2d" or "4e". A chip was found
43         at this address.
44
45

OPTIONS

47       -y     Disable  interactive mode. By default, i2cdetect will wait for a
48              confirmation from the user before messing with the I2C bus. When
49              this  flag is used, it will perform the operation directly. This
50              is mainly meant to be used in scripts.
51
52       -a     Force scanning of non-regular addresses. Not recommended.
53
54       -q     Use SMBus "quick write" commands for probing  (by  default,  the
55              command  used  is  the  one  believed  to be the safest for each
56              address).  Not recommended. This is known to corrupt  the  Atmel
57              AT24RF08 EEPROM found on many IBM Thinkpad laptops.
58
59       -r     Use SMBus "read byte" commands for probing (by default, the com‐
60              mand used is  the  one  believed  to  be  the  safest  for  each
61              address).  Not recommended. This is known to lock SMBus on vari‐
62              ous write-only chips (most notably clock chips at address 0x69).
63
64       -F     Display the list of functionalities implemented by  the  adapter
65              and exit.
66
67       -V     Display the version and exit.
68
69       -l     Output a list of installed busses.
70
71

SEE ALSO

73       i2cdump(8), sensors-detect(8)
74
75

AUTHOR

77       Frodo Looijaard, Mark D. Studebaker and Jean Delvare
78
79       This   manual   page   was   originally   written   by  Aurelien  Jarno
80       <aurel32@debian.org>, for the Debian GNU/Linux system.
81
82
83
84                                  April 2008                      I2CDETECT(8)
Impressum