nordic,nrf-twim

Vendor: Nordic Semiconductor

Description

These nodes are “i2c” bus nodes.

Nordic nRF family TWIM (TWI master with EasyDMA).

This binding can be used for nodes which can represent TWIM
peripherals. A single SoC peripheral ID is often associated with
multiple I2C peripherals, like a TWIM and a TWIS. You can choose
TWIM by setting the node's "compatible" to "nordic,nrf-twim"
and "status" to "okay", e.g. using an overlay file like this one:

    /* This is for TWIM0 -- change to "i2c1" for TWIM1, etc. */
    &i2c0 {
            compatible = "nordic,nrf-twim";
            status = "okay";
            /* other property settings can go here */
    };

This works on any supported SoC, for all TWIM instances.

Note: on nRF51 SoCs, use the "nordic,nrf-twi" binding instead.

Properties

Properties not inherited from the base binding file.

Name

Type

Details

zephyr,concat-buf-size

int

If concatenation buffer size is set, then multiple messages in the same direction will be concatenated into single transfers as long as there is space in buffer and no restart or stop flag is set.
This property must be provided when interacting with devices like the SSD1306 display that cannot tolerate a repeated start and address appearing on the bus between message fragments.  For many devices a concatenation buffer is not necessary.

sda-pin

int

The SDA pin to use.

For pins P0.0 through P0.31, use the pin number. For example,
to use P0.16 for SDA, set:

    sda-pin = <16>;

For pins P1.0 through P1.31, add 32 to the pin number. For
example, to use P1.2 for SDA, set:

    sda-pin = <34>;  /* 32 + 2 */

This property is required.

scl-pin

int

The SCL pin to use. The pin numbering scheme is the same as
the sda-pin property's.

This property is required.

clock-frequency

int

Initial clock frequency in Hz