I2C Master Write

Write data to I2C slave device or I2C slave device register

  • Library:
  • Simulink Coder Support Package for NXP FRDM-K64F Board

Description

The I2C Master Write block writes data to an I2C slave device that is connected to the board. Using this block, you can write data to a specific register on the I2C slave device.

For more information on I2C communication, see Support I2C Communication.

Ports

Input

expand all

Data Types: int8 | uint8 | int16 | uint16 | int32 | uint32 | single | double

Output

expand all

When you select the Output error status parameter, the block configures an output port. The port on the block is labeled as Status, indicating that the block outputs the status of the write operation at the output port.

The block outputs the status as a uint8 value. Each value corresponds to a data transfer status.

Status valueStatus description
0SUCCESS
1BUSY
4NO_ACKNOWLEDGE

Data Types: uint8

Parameters

expand all

Specify the I2C module on the board from which you want to write data to the I2C slave device.

Specify the I2C slave address to which you want to write the data. The I2C slave device address is a 7-bit address.

Specify this address as an integer or in hexadecimal format by using hex2dec(), for example, ‘hex2dec(‘61’)’.

The 2-byte ordering options are:

  • BigEndian - The most significant byte is sent first over the I2C bus.

  • LittleEndian - The least significant byte is sent first over the I2C bus.

When you select this parameter, the block writes data to the I2C slave register that you specify in the Slave register address parameter.

When you clear this parameter, the Send NACK at the end of data transfer and Remove stop bit at the end of data transfer parameters are displayed. Using these parameters, you can modify the write operation according to your requirements.

Specify the I2C slave register address to which you want to write the data.

Specify this address as an integer or in hexadecimal format by using hex2dec(), for example, ‘hex2dec(‘20’)’.

For more information on register read/write, see I2C Register Read/Write.

Dependencies

This parameter appears only when you select Enable register access parameter.

When you select this parameter, the I2C Master Write block sends a NACK (Not Acknowledge) bit to the slave device with the final byte.

When the slave device receives the NACK, it waits for a STOP condition from the I2C master block. The master block generates either a STOP condition to abort the transfer or a repeated START condition to start a new transfer.

When you clear this parameter, the I2C Master Write block sends an ACK (Acknowledge) bit to the slave device at the end of every byte. The ACK indicates that the I2C Master Write block is ready to read the next byte from the slave device.

Dependencies

This parameter appears only when you clear Enable register access parameter.

When you clear this parameter, the block sends a STOP condition. This condition indicates that the block has terminated the data transmission and the I2C bus is free for any other I2C master block to initiate the read/write operation.

When you select this parameter, the block sends another START condition followed by an address and read/write bit. The block sends any number of start conditions recursively. Such a repeated START condition allows write operations to the slave devices without releasing the bus. No other master block interrupts the operation.

Dependencies

This parameter appears only when you clear Enable register access parameter.

When you select this parameter, the block configures an output port. The port on the block is labeled as Status, indicating that the block outputs the status of the write operation at the output port.

The block outputs the status as a uint8 value. Each value corresponds to a data transfer status.

Status valueStatus description
0SUCCESS
1BUSY
4NO_ACKNOWLEDGE

Introduced in R2016b