Main Content

Interprocess Data Read

Receive messages from another processor using interprocess communication channel

Since R2020b

  • Block icon of interprocess data read.

Libraries:
SoC Blockset / Processor Interconnect
C2000 Microcontroller Blockset / Target Communication

Description

The Interprocess Data Read block asynchronously receives messages from another processor in an SoC using an interprocess data channel. The Interprocess Data Read block connects to an Interprocess Data Channel block that similarly connects to an Interprocess Data Write block contained in a separate processor reference model. In simulation, data from another processor is asynchronously received and processed in the processor containing the Interprocess Data Read block and associated asynchronous task. This diagram shows a generalized view of the interprocessor data channel connection.

Note

  • Ensure that the number of buffers specified must same at both the Tx and Rx side.

  • If you are using multiprocessor modeling approach with single model triggering multiple cores using Task manager, use the Interprocess Data Read and Interprocess Data Write blocks to send and receive data between cores.

    Use IPC Receive and IPC Transmit blocks to receive or sent data to either core for multi-core processors. Use these blocks for flat model approach where you are using separate models for each core.

    To help you choose the right solution for your application, see Communication Between Cores Using IPC Blocks for the detailed comparison between the IPC Transmit/Receive blocks and Interprocess Data Read/Write blocks

Interprocess data channel diagram.

Ports

Input

expand all

This message port receives data messages from the connected Interprocess Data Channel (SoC Blockset) block. The messages process when the Task Manager (SoC Blockset) block triggers the task containing the this block. For more information on messages, see Messages.

Dependencies

This port appears only when Enable simulation port parameter is enabled.

Data Types: SoCData

Output

expand all

This port emits a data frame read from another processor connected via the Interprocess Data Channel (SoC Blockset) block.

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

The status port outputs one of these values:

  • 0—No errors

  • 1—Data not available

  • 2—Data type mismatch

  • 4—Data length mismatch

  • 6—Data type and Data length mismatch

Dependencies

This port appears when you disable the Enable simulation port parameter.

Parameters

expand all

Select this parameter to configure the msg output port to enable peripheral simulation capability.

Enter the data type used by the interprocess data channel.

You can selectively show or hide the Data Type Assistant options by clicking >> button or << button. For more information, refer to Specify Data Types Using Data Type Assistant.

Buffers are circular buffers created in shared message RAM. Number of buffer is the number of elements stored at a time in the shared message RAM. These are not FIFO but will be overwritten at next instance.

Ensure that the number of buffers specified must same at both the Tx and Rx side.

Dependencies

This parameter is visible only when you disable the Enable simulation port parameter.

Enter the circular FIFO element size of the data vector read from the interprocess data channel.

Select the channel where you want to send the data.

Dependencies

This parameter is visible only when you disable the Enable simulation port parameter.

Select this parameter to acknowledge IPC interrupt at the receiving core to receive more.

Dependencies

This parameter is visible only when you disable the Enable simulation port parameter.

Select the participating cores as per the Hardware board you select in the Configuration Parameters window.

Dependencies

This parameter is visible only when you disable the Enable simulation port parameter.

Note

Ensure that Channel number, Number of buffers and Participating cores parameters match for the corresponding Interprocess Data Read and Interprocess Data Write (SoC Blockset) blocks of the model.

Enter the sample time of the block to apply to the timer-driven task subsystem.

Version History

Introduced in R2020b