How to use the I2C ports

This article illustrates how to use the I2C ports on Acme Systems Road Runner SOM based on Microchip SAMA5D27 MPU

The I2C bus lines are located on the following pins:

Signal		Per A	Per B	Per C	Per D	Per E	Per F
TWD0	SDA		PD21		PB31	PC27	PC29
TWCK0	SCL		PD22		PC0	PC28	PC30
TWD1	SDA	PD4	PD19	PC6
TWCK1	SCL	PD5	PD20	PC7

Roadrunner pinout

Kernel configuration

Device Drivers  --->
  I2C support  ---> 
    <*>   I2C device interface
          I2C Hardware Bus support  ---> 
          <*> Atmel AT91 I2C Two-Wire interface (TWI)

Device tree

i2c0: i2c@f8028000 {
    dmas = <0>, <0>;
    pinctrl-names = "default";
    pinctrl-0 = <&pinctrl_i2c0_default>;
    i2c-sda-hold-time-ns = <350>;
    status = "okay";
};

i2c1: i2c@fc028000 {
    dmas = <0>, <0>;
    pinctrl-names = "default";
    pinctrl-0 = <&pinctrl_i2c1_default>;
    status = "okay";
};

pinctrl_i2c0_default: i2c0_default {
    pinmux = <PIN_PD21__TWD0>,
         <PIN_PD22__TWCK0>;
    bias-disable;
};

pinctrl_i2c1_default: i2c1_default {
    pinmux = <PIN_PD4__TWD1>,
         <PIN_PD5__TWCK1>;
    bias-disable;
};

Using I2C from user space

i2c-tools

The faster way to do the first experiments with this board is by installing and using the i2c-tools.

i2c-tools is a package contains a heterogeneous set of I2C tools for Linux such as:

a bus probing tool
a chip dumper
a register-level access helpers
an EEPROM decoding scripts
...and more

To install i2c-tools on the FOX Board just type:

apt-get update
apt-get install i2c-tools

Using i2cdetect

i2cdetect is an userspace program to scan an I2C bus for devices. It outputs a table with the list of detected devices on the specified bus.

i2cdetect man page

Example of use:

i2cdetect -y 0

     0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f                             
00:          -- -- -- -- -- -- -- -- -- -- -- -- --                             
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --                             
20: 20 -- -- -- -- -- -- -- -- -- -- -- -- -- -- --                             
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --                             
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --                             
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --                             
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --                             
70: -- -- -- -- -- -- -- --

In this case a device has been detected on address 20 hex.