Administrator Guide

present. The i2ctool does not automatically traverse MUXes along the i2c bus. Other tools use this tool to read i2c device
information and pass the results back through a named pipe.
Tests
To test, the i2ctool has a configuration file that lists all the devices on the busses. The tool runs through the list and tries to
reach the devices. The
i2ctool reports when a device is not returning data.
CLI Options
Dell Diag - I2C Tool
version 1.5, 1.10
build, 2014/11/10,
Syntax: ./i2ctool <option>
--h := show this help
--scan [--bus=buspath] := scan the I2C devices. Optional: --bus=/dev/i2c-<bus number>
--test [--config=config_file] := test using the pre-programmed configuration or use supplied
config
--read --bus=buspath --addr=address --reg=reg --count=count --width=#8,16 --
display_size=#1,2,4 of bytes
--read --bus=buspath --addr=address --reg16=register --count=count --display_size=#1,2,4 of
bytes: For 16bit addressing
--write --bus=buspath --addr=address --reg=register --width=#8,16 --val=value
--write --bus=buspath --addr=address --reg16=register --val=value.For 16bit addressing
• scan — Scans all the i2c busses and reports all the devices found in an 8x16 array.
• test — Uses the devices the configuration file lists and verifies that they are readable on the busses.
• read — Reads a register offset, or count of bytes starting at a register offset, and return the values. The register width is
either 8-bit or 16-bit.
• write — Writes a single value at the specified register offset. The register width is either 8-bit or 16-bit.
Output
NOTE: The i2ctool does not automatically scan multiple MUXed segments. Prior to scanning, you MUST set the MUXes to
select the devices you want to see on the busses. By default, the i2ctool scans the i2c devices from the root MUX where
it sees the list of devices directly connected to the CPU MUX. The default scan function scans all connected busses. By
specifying a bus, you can limit the scan to one bus. In the scan data,
RR indicates a reserved address which is not used for
any devices and UU indicates that the device is busy or mapped to the OS.
scan Output
root@dell-diag-os:/opt/ngos/bin# ./i2ctool --scan
0 1 2 3 4 5 6 7 8 9 a b c d e f
00: RR RR RR RR RR RR RR RR -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
70: -- -- -- -- -- -- -- -- RR RR RR RR RR RR RR RR
0 1 2 3 4 5 6 7 8 9 a b c d e f
00: RR RR RR RR RR RR RR RR -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- 18 -- -- -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- 2e --
30: 30 -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
Dell DiagOS Tools 40