Differences

This shows you the differences between two versions of the page.

--- documentation:protocols:i2c:i2c-tools_shell [2026/10/09 10:30] – [i2cdetect] chris
+++ documentation:protocols:i2c:i2c-tools_shell [2026/10/09 11:11] (current) – [i2cdump] chris
@@ Line 16: / Line 16: @@
 ===== i2cdetect =====
-Detects I2C chips
+Detects I2C chips. Use: ''i2cdetect [options] i2cbus [first_addr last_addr]''. Special flags that don't require a given i2cbus are ''-V'' that prints the current version and ''-l''.
+  * ''i2cdetect -l'' to list busses. To access each buss you have to used it's number (''i2c-{NUM}'') or the full string name.
+  * ''-q'' and ''-r'' options are to use quick write and receive byte commands for probing. They can corrupt certain IC chips.
+  * ''-F'' displays the list of functionalities available on the bus.
 ===== i2cdump =====
+Examines registers on the I2C bus. Use: ''i2cdump [options] i2cbus address [mode [bank [bankreg]]]''
+  * ''i2cbus'': One of the buses represented by the number or string name from ''i2cdetect -l''.
+  * ''-r first-last'': Limit the range of registers being accessed. Incompatible with ''s''.
+  * ''address'': The address of the IC chip on the bus.
+  * ''mode'': Chooses the mode to access the register as a single byte, a double byte word or a block. If not provided, defaults to single byte without PEC. Options are listed below:
+    * ''b'': Single byte (default).
+    * ''w'': Word.
+    * ''i'': I2C block.
+    * ''c'': Consecutive block. Useful for ICs with automatic increment, like EEPROMs.
+    * ''W'': Word, but the command will only be issued on even addresses. Also useful for EEPROMs.
+    * ''s'': SMBus block. Avoid it, it's deprecated.
+    * ''p'': Can be appended on the mode parameter (not on ''i'' and ''W'') to enable Packet Error Checking (PEC).
+  * ''bank''/''bankreg'': Used on Winbond and Asus chips. ''bank'' is an integer from 0 to 7, and ''bankreg'' an integer from 0x00 to 0xff with a default of 0x4e.
+Use of ''i2cdump'' is not advised unless you have intimate knowledge of the IC you're accessing. It's very easy to corrupt stuff.
 ===== i2cget =====

Personal Wiki

User Tools

Site Tools

Differences

Page Tools