I2C Read

Read data from I2C slave device or I2C slave device register

• Library:

• Simulink Support Package for Arduino Hardware / Common

• 

Description

Read serial data from an I2C slave. Using this block, you can also read data from a specific register on the I2C slave device.

For more information on I2C Communication, refer to I2C Read/Write.

Click View pin map to open the Arduino Pin Mapping table .

To know how to assign pins for the block, see Pin Mapping for Arduino Timer Independent Blocks.

Ports

Output

Data — Output port to read data from the I2C slave device

[Nx1] array

Output port to read data from an I2C slave device. The size of the data that the port emits is based on the Data size (N) parameter.

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

Status — Status of the read operation

scalar

Output port to display error status. For more information, see Output error status.

Dependencies

This port appears only when you select the Output error status parameter.

Data Types: uint8

Parameters

I2C Module — Specific module used for I2C communication

0 (default) | 1

Select the specific module on the board that you are using.

Slave address — I2C slave device address

10 (default) | scalar

Enter the I2C slave device address from which you want to read data. You can specify this address in hexadecimal format hex2dec(), for example, hex2dec(‘10').

Slave byte order — Byte order supported by the I2C slave device

BigEndian (default) | LittleEndian

Select the byte ordering that your I2C slave supports.

The two byte ordering options are:

• BigEndian — The most significant byte is read first over the I2C bus. This option is the default option.

• LittleEndian — The least significant byte is read first over the I2C bus.

Enable register address — Option to enable reading from the register on I2C slave register

on (default) | off

Select this check box to enable reading data from a specific register on the I2C slave device.

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 read operation according to your requirements.

Slave register address — I2C slave device register address to read data

0 (default) | scalar

Enter the slave device register address from which you want to read the data.

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

Dependencies

This parameter is enabled only when you select the Enable register access parameter.

Data type — Data type to read from I2C slave device

uint8 (default) | int8 | int16 | uint16 | int32 | uint32 | single | double

Select the data type to read from I2C slave device.

Data size (N) — Data size to read from the I2C slave device

1 (default) | scalar

Enter the data size that you want to read from the I2C slave device for the selected data type.

Output error status — Option to display the error status during data transmission

off (default) | on

Select this option to display the error status during data transmission.

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 read operation at the output port.

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

Status Value	Status Description
0	SUCCESS
1	BUSY
2	ARBITRATION_LOST
4	NO_ACKNOWLEDGE
8	BUS_ERROR
16	BUS_NOT_IN_USE

Sample time — Frequency at which block reads data

0.1 (default) | scalar

Specify how often this block reads the data from the I2C slave. Enter a value greater than zero.

Version History

Introduced in R2015a