Message Communication Interfaces

Within a platform environment, code generated from a Simulink^® model can communicate with platform software or with other code generated from Simulink models by using message-based communication. Generate C++ component code for message-based communication with platform software. Generate C++ or C component code for message-based communication with other models.

Note

C code generation is not supported for models that connect the message port of a Simulink block or Stateflow chart to a top model root-level Inport or Outport block. For those modeling patterns, only C++ code generation is supported.

Generate C++ Messages to Communicate Data Between Simulink Components

To generate C++ code that supports message-based communication between model components in the Simulink environment, use the Simulink Messages & Events Library blocks Send and Receive. To customize the communication, use the Queue block (from the same library) to set parameters for capacity, sorting policy (LIFO, FIFO, and priority), and overwriting policy (behavior when the queue exceeds capacity). You can generate C++ code for GRT-based system target files by using Simulink Coder or for ERT-based system target files by using Embedded Coder.

Messages are an effective communication technique for distributed and complex systems that you can model within Simulink.

How to Prepare Models in Simulink for Message-Based Communication

In Simulink, model message-based communication between model components:

1. Create a model that contains a Send block (referenced model).

2. Create a model that contains a Receive block (referenced model).

3. Create a model that has two Model blocks (top model).

   • Set the first Model block to the model that contains the Send block (model from step 1).

   • Set the second Model block to the model that contains the Receive block (model from step 2).

4. When you run the model, a queue generates in the top model above the message line. A queue, explicit or implicit, controls the message communication. You can use the generated queue or you can add a Queue block in the top model to explicitly specify communication parameters.

How Model Components Pass Messages and How the Code Implements the Behavior

Referenced models pass messages:

1. In the model that contains the Send block, the Send block converts signals into messages.

2. The top model that contains the queue manages messages according to parameters that define capacity, order of delivery, and other quality of service (QoS) metrics.

3. In the model that contains the Receive block, the Receive block converts messages back to signals.

In the generated C++ code, the top model facilitates the connection between the send and receive referenced models by establishing a set interface that the referenced models can access independently of one another.

The generated C++ code implements message behavior:

1. A service is created at each model boundary. A service contains a reference to the top model and an entry point function, referred to as a service function, for referenced models to use to pass messages to the top model.

2. The top model initializes each service to create a connection to each referenced model.

3. The referenced models invoke service functions to pass messages to the top model.

C++ Code Generation Example

This example generates and examines C++ code from the model provided in Establish Message Send and Receive Interfaces Between Software Components.

Generate C++ Code:

1. Open the model.

2. In the Apps gallery, click Embedded Coder.

3. For each model (top and both referenced models), in the Configuration Parameters dialog box, set these parameters:

   • In the Code Generation pane, set Language to C++.

   • In the Interface pane, set Code interface packaging to C++ class.

   Save the model.

4. Generate code. On the C++ Code tab, click Build.

5. View the generated code. On the C++ Code tab, click View Code.

Examine C++ Code:

1. A service is created at each model boundary. In C++, services are represented as objects that hold an instance of the top model and a service function that referenced models invoke to pass messages.

   1. To view the creation of the services, open the top model C++ file MessageSendReceiveDefaultBufferModel.cpp. View the constructor method.

      

      The constructor methods, ReceiveComponentRecvData(*this) and SendComponentSendData(*this), create the receive and send service objects respectively by taking as an argument a reference to the instance of the top model. Each service object saves a reference to the top model and defines the message interface (the service functions RecvData and SendData).

   2. To view the receive and send service classes, open the top model header file MessageSendReceiveDefaultBufferModel.h, and view the following section.

      

2. The top model initializes each service to create a connection to each referenced model. To view the initialization, open the top model C++ file MessageSendReceiveDefaultBufferModel.cpp. View the constructor method.

   

   The constructor method Receive_ComponentMDLOBJ0(get_ReceiveComponentRecvData()), passes a reference to the receive service to the receive referenced model. The constructor method, Send_ComponentMDLOBJ1(get_SendComponentSendData()), passes a reference to the send service to the send referenced model.

3. The referenced models invoke service functions to pass messages to the top model. In C++, referenced models invoke the top model (common ancestor, if in a hierarchy) service functions to send or receive messages (specifically, a referenced model invokes the abstract service method (RecvData or SendData) from the interface created in step 2).The abstract interface classes are emitted to a shared folder. The implementation of the service functions in each service is defined in the top model C++ file.

   1. To view the abstract interface class to send messages, open from the shared folder the header file SendData_real_T.h.

      

   2. To view the implementation of the service function to send messages, open the top model C++ file MessageSendReceiveDefaultBufferModel.cpp.

      

   3. To view how the send referenced model invokes the service function, open its C++ file mSend.cpp. In the step function, the model invokes the service function to send messages to the top model and receives back a return status.

      

   4. To view the abstract interface class to receive messages, open from the shared folder the header file RecvData_real_T.h.

      

   5. To view the implementation of the service function to receive messages, open top model C++ file MessageSendReceiveDefaultBufferModel.cpp.

      

   6. To view how the receive referenced model invokes the service function, open its C++ file mRecieve.cpp. In the step function, the model invokes the service function to receive messages and a status from the top model.

      

Considerations and Limitations

• C++ code support is available for GRT-based system target files by using the Simulink Coder app.

• C++ code support is available for ERT-based system target files by using the Embedded Coder app.

• To generate code, for top and referenced models, select the same language (C++) and the same system target file.

• You cannot configure function prototype control (FPC) for a top model that has root message ports.

• External models and variant models are not supported.

• Software-in-the-loop (SIL) and processor-in-the-loop (PIL) simulations are not supported.

Generate C Messages to Communicate Data Between Simulink Components

To generate C code that supports message-based communication between model components in the Simulink environment, use the Simulink Messages & Events Library blocks Send and Receive. To customize the communication, use the Queue block (from the same library) to set parameters for capacity, sorting policy (LIFO, FIFO, and priority), and overwriting policy (behavior when the queue exceeds capacity). You can generate C code for GRT-based system target files by using Simulink Coder or for ERT-based system target files by using Embedded Coder.

Messages are an effective communication technique for distributed and complex systems that you can model within Simulink.

How to Prepare Models in Simulink for Message-Based Communication

In Simulink, you can model message-based communication between model components:

1. Create a model that contains a Send block (referenced model).

2. Create a model that contains a Receive block (referenced model).

3. Create a model that has two Model blocks (top model).

   • Set the first Model block to the model that contains the Send block (model from step 1).

   • Set the second Model block to the model that contains the Receive block (model from step 2).

4. When you run the model, a queue generates in the top model above the message line. A queue, explicit or implicit, controls the message communication. You can use the generated queue or you can add a Queue block in the top model to explicitly specify communication parameters.

How Model Components Pass Messages and How the Code Implements the Behavior

Referenced models pass messages:

1. In the model that contains the Send block, the Send block converts signals into messages.

2. The top model that contains the queue manages messages according to parameters that define capacity, order of delivery, and other quality of service (QoS) metrics.

3. In the model that contains the Receive block, the Receive block converts messages back to signals.

In the generated C code, the top model facilitates the connection between the send and receive referenced models by establishing a set interface that the referenced models can access independently of one another.

The generated C code implements message behavior:

1. A service is created at each model boundary. A service contains a reference to the top model and an entry point function, referred to as a service function, for referenced models to use to pass messages to the top model.

2. The top model initializes each service to create a connection to each referenced model.

3. The referenced models invoke service functions to pass messages to the top model.

C Code Generation Example

This example generates and examines C code from the model provided in Establish Message Send and Receive Interfaces Between Software Components.

Generate C Code:

1. Open the model.

2. In the Apps gallery, click Embedded Coder.

3. For each model (top and both referenced models), in the Configuration Parameters dialog box, in the Code Generation pane, set Language to C and save the model.

4. Generate code. On the C Code tab, click Build.

5. View the generated code. On the C Code tab, click View Code.

Examine C Code:

1. A service is created at each model boundary. In C, referenced models represent services as DWork. The service provides a pointer to an instance of the top model and a service function that referenced models invoke to pass messages.

   1. To view the service to send messages, open the send referenced model header file mSend.h. View the DWork allocation.

      

   2. To view the send message data type, if the data type is shareable (for example, built-in data types, imported bus types, or exported bus types that have a specified data type) the information is located in a shared header file. If the data type is not shareable, the information is located the model header file mSend.h. For this example, view the shareable data type by opening the shared header file SendData_real_T.h.

      

   3. To view the service to receive messages, open the receive referenced model header file, mReceive.h. View the DWork allocation.

      

   4. To view the received messages data type, if the data type is shareable (for example,built-in data types, imported bus types, or exported bus types that have a specified data type) the information is located in a shared header file. If the data type is not shareable the information is located the model header file, mReceive.h. For this example, view the shareable data type by opening the shared header file RecvData_real_T.h.

      

2. The top model initializes each service to create a connection to each referenced model. In C, the top model initializes each referenced model DWork. To view the initialization, open the top model C file MessageSendReceiveDefaultBufferModel.c.

   

3. The referenced models invoke service functions to pass messages to the top model. In C, a referenced model invokes a service function by dereferencing the service function pointer and passing a pointer to the instance of the top model. You can view the prototypes of the service functions in the top model header file. You can view the referenced model invocations of those service functions in the referenced model C files.

   1. To view the prototype of the service function to send messages, open the top model header file, MessageSendReceiveDefaultBufferModel.h.

      

   2. To view the implementation of the service function to send messages, open the top model C file, MessageSendReceiveDefaultBufferModel.c.

      

      

   3. To view how the send referenced model invokes the service function, open the C file for the model mSend.c. In the step function, the model invokes the service to send instance data and a message to the top model and receives back a return status.

      

   4. To view the prototype of the service function to receive messages, open the top model header file MessageSendReceiveDefaultBufferModel.h.

      

   5. To view the implementation of the service function to receive messages, open the top model C file MessageSendReceiveDefaultBufferModel.c.

      

      

   6. To view how the receive referenced model invokes the service function, open the C file for the model mReceive.c. In the step function, the model invokes the service to receive a message payload and a return status.

      

Considerations and Limitations

• C code support is available for GRT-based system target files by using the Simulink Coder app.

• C code support is available for ERT-based system target files by using the Embedded Coder app.

• To generate code, for top and referenced models, select the same language (C) and the same system target file.

• You cannot configure function prototype control (FPC) for a top model that has root message ports.

• External models and variant models are not supported.

• Software-in-the-loop (SIL) and processor-in-the-loop (PIL) simulations are not supported.

• C code generation is not supported for models that connect a message port of a Simulink block or a Stateflow chart to a top model root-level Inport or Outport block. For those modeling patterns, only C++ code generation is supported.