| 1 | .TH I2CDETECT 8 "April 2006" |
|---|
| 2 | .SH NAME |
|---|
| 3 | i2cdetect \- detect I2C chips |
|---|
| 4 | |
|---|
| 5 | .SH SYNOPSIS |
|---|
| 6 | .B i2cdetect |
|---|
| 7 | .RI [ -y ] |
|---|
| 8 | .RI [ -a ] |
|---|
| 9 | .RI [ -q | -r ] |
|---|
| 10 | .I i2cbus |
|---|
| 11 | .br |
|---|
| 12 | .B i2cdetect |
|---|
| 13 | .I -F |
|---|
| 14 | .I i2cbus |
|---|
| 15 | .br |
|---|
| 16 | .B i2cdetect |
|---|
| 17 | .I -V |
|---|
| 18 | .br |
|---|
| 19 | .B i2cdetect |
|---|
| 20 | .I -l |
|---|
| 21 | |
|---|
| 22 | .SH DESCRIPTION |
|---|
| 23 | i2cdetect is a userspace program to scan an I2C bus for devices. It |
|---|
| 24 | outputs a table with the list of detected devices on the specified bus. |
|---|
| 25 | \fIi2cbus\fR indicates the number of the I2C bus to be scanned, and |
|---|
| 26 | should correspond to one of the busses listed by \fIi2cdetect -l\fR. |
|---|
| 27 | .PP |
|---|
| 28 | i2cdetect can also be used to query the functionalities of an I2C bus |
|---|
| 29 | (see option \fB-F\fP.) |
|---|
| 30 | |
|---|
| 31 | .SH WARNING |
|---|
| 32 | This program can confuse your I2C bus, cause data loss and worse! |
|---|
| 33 | |
|---|
| 34 | .SH OPTIONS |
|---|
| 35 | .TP |
|---|
| 36 | .B "\-y" |
|---|
| 37 | Disable interactive mode. By default, i2cdetect will wait for a confirmation |
|---|
| 38 | from the user before messing with the I2C bus. When this flag is used, it |
|---|
| 39 | will perform the operation directly. This is mainly meant to be used in |
|---|
| 40 | scripts. |
|---|
| 41 | .TP |
|---|
| 42 | .B "\-a" |
|---|
| 43 | Force scanning of non-regular addresses. Not recommended. |
|---|
| 44 | .TP |
|---|
| 45 | .B "\-q" |
|---|
| 46 | Use SMBus "quick write" commands for probing (by default, the command |
|---|
| 47 | used is the one believed to be the safest for each address). |
|---|
| 48 | Not recommended. This is known to corrupt the Atmel AT24RF08 EEPROM |
|---|
| 49 | found on many IBM Thinkpad laptops. |
|---|
| 50 | .TP |
|---|
| 51 | .B "\-r" |
|---|
| 52 | Use SMBus "read byte" commands for probing (by default, the command |
|---|
| 53 | used is the one believed to be the safest for each address). |
|---|
| 54 | Not recommended. This is known to lock SMBus on various write-only |
|---|
| 55 | chips (most notably clock chips at address 0x69). |
|---|
| 56 | .TP |
|---|
| 57 | .B "\-F" |
|---|
| 58 | Display the list of functionalities implemented by the adapter and exit. |
|---|
| 59 | .TP |
|---|
| 60 | .B "\-V" |
|---|
| 61 | Display the version and exit. |
|---|
| 62 | .TP |
|---|
| 63 | .B "\-l" |
|---|
| 64 | Output a list of installed busses. |
|---|
| 65 | |
|---|
| 66 | .SH CONFORMING TO |
|---|
| 67 | lm_sensors-2.x |
|---|
| 68 | |
|---|
| 69 | .SH SEE ALSO |
|---|
| 70 | i2cdump(8), sensors-detect(8) |
|---|
| 71 | |
|---|
| 72 | .SH AUTHOR |
|---|
| 73 | Frodo Looijaard, Mark D. Studebaker, and the lm_sensors group |
|---|
| 74 | http://www.lm-sensors.org/ |
|---|
| 75 | This manual page was written by Aurelien Jarno <aurel32@debian.org>, for |
|---|
| 76 | the Debian GNU/Linux system. It was then reviewed by the lm_sensors team and |
|---|
| 77 | is now part of the lm_sensors source distribution. |
|---|
