Using I2C

Initialization

The first step in using I2C is to configure and bring up the interface. The k_i2c_default_dev_init() function will initialize a connection with the specified I2C bus using the default configuration values.

KI2CStatus status;

status = k_i2c_default_dev_init(K_I2C1);
if (status != I2C_OK)
{
    fprintf(stderr, "Failed to initialize I2C bus connection: %d\n", status);
    return -1;
}

Writing

The k_i2c_write() function should be used to write to an I2C device. The function takes four arguments:

  • The I2C bus to use for communication
  • The I2C address of the slave device
  • A pointer to the data to be written
  • The number of bytes to be written

The function returns a KI2CStatus value. I2C_OK indicates that the function completed successfully.

KI2CStatus status;
char cmd = 0x40;
int slave_addr = 0x80;

status = k_i2c_write(K_I2C1, slave_addr, &cmd, 1);
if (status != I2C_OK)
{
    fprintf(stderr, "Failed to write to I2C device: %d\n", status);
    return -1;
}

Reading

The k_i2c_read() function should be used to read data from an I2C device. The function takes four arguments:

  • The I2C bus to use for communication
  • The I2C address of the slave device
  • A pointer to the read buffer
  • The number of bytes to be read

The function returns a KI2CStatus value. I2C_OK indicates that the function completed successfully.

KI2CStatus status;
char buffer[100];
int slave_addr = 0x80;

status = k_i2c_read(K_I2C1, slave_addr, buffer, 10);
if (status != I2C_OK)
{
    fprintf(stderr, "Failed to read from I2C device: %d\n", status);
    return -1;
}

Termination

Once all I2C work has been completed, the k_i2c_terminate() function should be used to close the connection with the I2C bus and perform system cleanup.

k_i2c_terminate(K_I2C1);