Configuring I2C

The I2C bus allows multiple devices to be connected to your Raspberry Pi, each with a unique address, that can often be set by changing jumper settings on the module. It is very useful to be able to see which devices are connected to your Pi as a way of making sure everything is working.

To do this, it is worth running the following commands in the Terminal to install the i2c-tools utility.

sudo apt-get install -y python-smbus
sudo apt-get install -y i2c-tools

Installing Kernel Support (with Raspi-Config)

Run sudo raspi-config and follow the prompts to install i2c support for the ARM core and linux kernel

Go to Interfacing Options

On older versions, look under Advanced

then I2C


Then reboot!

We also recommend going through the steps below to manually check everything was added by raspi-config!

Installing Kernel Support (Manually)

If you're not using a modern Raspbian or you want to do it by hand, you can! Open LXTerminal or console or ssh and enter the following command:

sudo nano /etc/modules

and add these two lines to the end of the file:


like so:

Then save the file with Control-X Y <return>

Depending on your distribution, you may also have a file called /etc/modprobe.d/raspi-blacklist.conf

If you do not have this file then there is nothing to do, however, if you do have this file, you need to edit it and comment out the lines below:

blacklist spi-bcm2708
blacklist i2c-bcm2708
.. by putting a # in front of them.

Open an editor on the file by typing:
sudo nano /etc/modprobe.d/raspi-blacklist.conf
.. then edit the file so that it appears as below, and then save and exit the file using CTRL-x and Y.

If you are running a recent Raspberry Pi (3.18 kernel or higher) you will also need to update the /boot/config.txt file. Edit it with sudo nano /boot/config.txt and add the text


at the bottom. note that the "1" in "i2c1" is a one not an L!

Once this is all done, reboot!

sudo reboot

Testing I2C

Now when you log in you can type the following command to see all the connected devices

sudo i2cdetect -y 1

This shows that two I2C addresses are in use – 0x40 and 0x70.

Note that if you are using one of the very first Raspberry Pis (a 256MB Raspberry Pi Model B) then you will need to change the command to:

sudo i2cdetect -y 0

The Raspberry Pi designers swapped over I2C ports between board releases. Just remember: 512M Pi's use i2c port 1, 256M ones use i2c port 0!

Last updated on Aug 14, 2017 Published on Dec 14, 2012