This content relates to a deprecated version of Mbed

Mbed 2 is now deprecated. For the latest version please see the Mbed OS documentation.

For the latest I2C API, please see I2C.

The I2C interface provides I2C Master functionality.

This interface can be used for communication with a I2C devices, such as serial memories, sensors and other modules or integrated circuits.

Hello World!

Import program

00001 #include "mbed.h"
00003 // Read temperature from LM75BD
00005 I2C i2c(p28, p27);
00007 const int addr = 0x90;
00009 int main() {
00010     char cmd[2];
00011     while (1) {
00012         cmd[0] = 0x01;
00013         cmd[1] = 0x00;
00014         i2c.write(addr, cmd, 2);
00016         wait(0.5);
00018         cmd[0] = 0x00;
00019         i2c.write(addr, cmd, 1);
00020         i2c.read(addr, cmd, 2);
00022         float tmp = (float((cmd[0]<<8)|cmd[1]) / 256.0);
00023         printf("Temp = %.2f\n", tmp);
00024     }
00025 }


Remember, you will need a pull-up resistor on sda and scl.

All drivers on the I2C bus are required to be open collector, and so it is necessary for pull up resistors to be used on the two signals. A typical value for the pullup resistors is around 2.2k ohms, connected between the pin and 3v3.



The mbed API uses 8 bit addresses, so make sure to take that 7 bit address and left shift it by 1 before passing it.

Import librarymbed

No documentation found.


See the Pinout page for more details

The default frequency of the I2C interface is 100KHz.

I2C is a two wire serial protocol that allows an I2C Master exchange data with an I2C Slave. The I2C protocol support upto 127 devices per bus. The I2C interface can be used for writing data words out of the I2C port, returning the data recieved back from I2C slave. The I2C clock frequency can be configured.


All wikipages