Android I2C Tool Manual

This tool is to

• detect Android I2C devices,
• dump and set the values of I2C device registers periodically or just one time.
• log device registers values.

The core part is running linux commannd line tool through Runtime.getRuntime().exec(), then read and parse the stand out/error and then write to log.

Setup

1. Build the i2c linux command line tool in target Android BSP to generate binary files: i2cdump, i2cset.

2. Root Android device.

3. Upload these two files to target device path /system/xbin, and modify the permission as 755;

   adb-platform-tools>adb remount
   adb-platform-tools>adb push i2cdump /system/xbin
   adb-platform-tools>adb push i2cset /system/xbin
   adb-platform-tools>adb shell chmod 755 /system/xbin/i2c*

4. If encounter the following error:

   Error: Could not open file `/dev/i2c-2': Permission denied, Run as root?

then need to modify the permission of Android I2C device file：root@android:/ # chmod 666 /dev/i2c*

Detect I2C bus and chips on target Android device

Dump all registers of specific I2C chip

1. click right button to popup a I2C device selector dialog, then set bus number, device addres, read mode;
2. enable read periodically;
3. enable Log,

log path :/mnt/sdcard/i2clog/i2c_log_parsed.txt and i2c_log_raw.txt

    14:54:59 - 
    24 02 00 00 64 00 12 0c 3f 10 88 02 8c 0b 8c 0b
    c9 0c c9 0c 08 00 ff ff c9 0c fa ff 27 0b 5b fd
    27 0b c9 0c 21 00 00 00 12 0c 02 00 64 00 60 00 
    68 10 fa 05 ff ff 5e 00 53 00 76 11 f4 0b 00 00
    00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
    00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
    00 00 0a 42 51 32 37 35 34 58 2d 47 31 ff 00 00
    00 00 00 00 00 00 00 00 XX XX 95 ff 3f 10 12 0c
    24 02 00 00 64 00 12 0c 3f 10 88 02 8c 0b 8c 0b
    c9 0c c9 0c 08 00 ff ff c9 0c fa ff 27 0b 5b fd
    27 0b c9 0c 21 00 00 00 12 0c 02 00 64 00 60 00
    68 10 fa 05 ff ff 5e 00 53 00 76 11 f4 0b 00 00
    00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
    00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
    00 00 0a 42 51 32 37 35 34 58 2d 47 31 ff 00 00
    00 00 00 00 00 00 00 00 XX XX 95 ff 3f 10 12 0c
14:55:00 - 

Set value to specific I2C device register

About

App可以用于探测Android设备I2C总线、读取/设置I2C设备寄存器值，并写入log，硬件工程师可以直接把log导入excel，就可以进一步分析数据。 方便不熟悉命令行和ADB的硬件工程师测试。

核心是通过Runtime.getRuntime().exec()调用命令行工具，然后读取进程的标准输出/标准错误。核心代码在I2cToolHelper.java和I2cParserHelper.java

之所以开发这个App，是因为我负责的驱动模块出现了问题，需要和硬件工程师排一起查软、硬问题。因为硬件工程师不熟悉命令行、ADB，并且使用ADB打印的log不便于处理。

第一版于2013.08开发完成，这是第一次开发Android，所有细节都得搜索，很琐碎很差劲，至于有多差劲，可以看代码：branch-v1， 第二版于2015.10开发完成，重构了之前的代码。

之所以开源这个App，是因为没有上述提到的开源的命令行工具，这个App没有任何作用。 希望对别人有所帮助。

weiyi.just2@gmail.com li2.me