C28x I2C Receive

Configure inter-integrated circuit (I2C) module to receive data from I2C bus

• Library:

• Embedded Coder Support Package for Texas Instruments C2000 Processors / C2802x

  Embedded Coder Support Package for Texas Instruments C2000 Processors / C2803x

  Embedded Coder Support Package for Texas Instruments C2000 Processors / C2805x

  Embedded Coder Support Package for Texas Instruments C2000 Processors / C2806x

  Embedded Coder Support Package for Texas Instruments C2000 Processors / C280x

  Embedded Coder Support Package for Texas Instruments C2000 Processors / C2833x

  Embedded Coder Support Package for Texas Instruments C2000 Processors / C2834x

  Embedded Coder Support Package for Texas Instruments C2000 Processors / F2807x

  Embedded Coder Support Package for Texas Instruments C2000 Processors / F2837xD

  Embedded Coder Support Package for Texas Instruments C2000 Processors / F2837xS

  Embedded Coder Support Package for Texas Instruments C2000 Processors / F2838x/ C28x

  Embedded Coder Support Package for Texas Instruments C2000 Processors / F28004x

  Embedded Coder Support Package for Texas Instruments C2000 Processors / F28002x

  Embedded Coder Support Package for Texas Instruments C2000 Processors / F28003x

  Embedded Coder Support Package for Texas Instruments C2000 Processors / F28M35x / C28x

  Embedded Coder Support Package for Texas Instruments C2000 Processors / F28M36x / C28x

• 

Description

The I2C Receive block configures the inter-integrated circuit (I2C) module to receive data from the two-wire I2C serial bus. The I2C Receive block supports I2C bus communication between the processor and external peripherals or other controllers. The block can run in either slave or master mode.

When the I2C module is configured as master, the module receives data from a slave. When the I2C module is configured as a slave, the module receives data from the master. Configure the I2C module by navigating to Configuration Parameters > Hardware Implementation > Target hardware resources.

To read data from a slave, send the address of the register to be read using the I2C Transmit block to the slave. Ensure that the data is sent from the Tx FIFO to the slave before the data is read from the slave using the I2C Receive block. For more information, see Using the I2C Bus to Access Sensors.

Ports

Input

SAR — Slave address register value

scalar

The slave address register value.

Dependencies

This port appears only when Slave address source is set to Input port.

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

Output

RD — Received data from I2C bus

scalar | vector

The data read from the I2C bus.

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

status — I2C communication status

scalar

Status values from the I2C status register (I2CSTR).

Dependencies

This port appears only when Output receiving status is selected.

Data Types: uint16

Parameters

Module — Module for communication

I2C_A (default) | I2C_B

The I2C module to be used for communication. The number of I2C modules supported varies across different C2000™ processors.

Addressing format — Address format for communication

7–Bit addressing (default) | 10–Bit addressing | Free data format

The address format for communication. The diagram shows the format for each option. The I2C Receive block sets the R/W bit to 0.

S — Start bit

R/W — Read/Write

ACK — Acknowledge

P — Stop bit

MSB — Most significant bit

LSB — Least significant bit

Slave address source — Slave address source of I2C slave

Specify via dialog (default) | Input port

The method for setting the slave address register of the I2C slave.

Slave address register — Slave address register value

80 (default) | scalar

Enter a 7- or 10-bit slave address according to the addressing format selected.

Dependencies

This parameter appears only when Slave address source is set to Specify via dialog.

Bit count — Bit count for communication

8 (default) | integer in [1 8]

The number of bits in the data byte received by the I2C module.

Read data length — Length of received data

1 (default) | scalar

The number of Data type the block receives (not bytes). If this parameter is set to more than 1, the output will be a vector.

Initial output — Value of I2C node output to model

0 (default) | scalar | vector

The value the I2C node outputs to the model before it has received data. By default, the block outputs 0 if the I2C value is not received.

Set NACK bit — NACK bit during I2C acknowledge cycle

off (default) | on

Generates a no-acknowledge bit (NACK) during the I2C acknowledge cycle and ignores new bits from the transmitting I2C node.

Enable stop condition — Stop message to I2C Transmit block

off (default) | on

Enables the I2C Receive block (master) to send a stop message to the I2C Transmit block (slave).

Output receiving status — Indicates when I2C Receive block receives message

off (default) | on

Enables the status output port, which indicates when the I2C Receive block receives a message.

Sample time — Frequency at which data is read from I2C device

0.001 (default) | –1 | scalar

Sample time for the block in seconds. To execute this block asynchronously, set this parameter to -1.

Data type — Type of data in data vector

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

Sets the data type of the data received. If the size of the received data is less than 8 bits, then the data is right-justified.

Model Examples

Using the I2C Bus to Access Sensors

Use the I2C blocks to communicate with I2C based devices.

Open Example