Code Mappings Editor

R2026b

Configure DDS inports and outports as DataReaders and DataWriters

Description

The Code Mappings Editor lets you configure model inports and outports as DDS DataReaders and DataWriters, select Topics, and specify QoS to connect your application to a DDS network.

Use the Inports and Outports sections in the Code Mappings editor to configure the inports and outports respectively.

Open the Code Mappings Editor

• MATLAB^® Toolstrip: In a DDS Blockset model, on the DDS tab, click Code Interface and select Individual Element Code Mappings.

• The Code Mappings editor appears as a minimized tab directly below the model canvas in a DDS Blockset model. Click the tab to expand the editor.

Examples

Configure DataReaders and DataWriters by Using Default Behavior

This example uses the Shapes Demo example model to show how to configure the DataReaders and DataWriters for a DDS application by using default behavior.

Create a DDS application

1. Open the Shapes Demo example model, shapesdemo.

   openExample('shapesdemo');

2. Create DDS definitions. In the DDS Application Quick Start, on the second page, select Create and use default dictionary.

Configure the DDS Interface

1. Open the Code Mappings editor. On the DDS tab, click Code Interface and select Individual Element Code Mappings.

   

2. Configure the inports. The inports represent DataReaders in a DDS application.

   • Select the Topic. Set the Topic to the Square Topic specified in the drop-down options by its path (ShapesDomainLibrary/ShapesDomain/Square).

   • Select the DataReader. Set the Reader XML Path to Auto to have DDS Blockset automatically generate a reader for the application.

   • Select the Quality of Service (QoS). Set the Reader QoS to Default to have the reader use the vendor provided QoS.

3. Configure the outports. The outports represent DataWriters in a DDS application.

   • Select the Topic. Set the Topic to the Circle Topic specified in the drop-down options by its path (ShapesDomainLibrary/ShapesDomain/Circle).

   • Select the DataWriter. Set the Writer XML Path to Auto to have DDS Blockset automatically generate a writer for the application.

   • Select the Quality of Service (QoS). Set the Writer QoS to Default to have the writer use the vendor provided QoS.

Deploy the DDS application

1. Set up the build environment for your target vendor.

2. On the DDS tab, click Build.

3. Deploy the application executable on DDS.

Configure DataReaders and DataWriters by Using XML Definitions

This example uses the Shapes Demo example model to show how to configure the DataReaders and DataWriters for a DDS application by using definitions previously specified in imported XML definitions.

Create a DDS application

1. Open the Shapes Demo example model, shapesdemo.

   openExample('shapesdemo');

2. Create DDS definitions. In the DDS Application Quick Start, select Import from XML, and select the shapesexample_qos XML file. When you close the Quick Start, the DDS DataReader and DataWriter definitions from the shapesexample_qos XML file become available in the DDS Dictionary for the example application.

Configure the DDS Interface

1. Open the Code Mappings editor. On the DDS tab, click Code Interface and select Individual Element Code Mappings.

   

2. Configure the inports. The inports represent DataReaders in a DDS application. The Topic, DataReader, and QoS for each inport appears in the editor based on the imported XML definitions.

   • Verify the Topic. For the Topic, verify that the Square Topic specified in the drop-down options by its path (ShapesDomainLibrary/ShapesDomain/Square) is shown in the editor.

   • Verify the DataReader. For the Reader XML Path, verify that the DataReader, MySquareRdr, specified by its path (myParticipant/MySubscriber/MySquareRdr), is shown in the editor.

   • Configure the Quality of Service (QoS). Set the Reader QoS to Default to have the reader use the vendor provided QoS.

3. Configure the outports. The outports represent DataWriters in a DDS application. The Topic, DataWriter, and QoS for each outport appears in the editor based on the imported XML definitions.

   • Verify the Topic. For the Topic, verify that the Circle Topic is specified in the drop-down options by its path (ShapesDomainLibrary/ShapesDomain/Circle).

   • Verify the DataWriter. For the Writer XML Path, verify that the DataWriter, MyCircleWtr, specified by its path (myParticipant/MyPublisher/MyCircleWtr), is shown in the editor.

   • Configure the Quality of Service (QoS). Set the Writer QoS to Default to have the writer use the vendor provided QoS.

Deploy the DDS application

1. Set up the build environment for your target vendor.

2. On the DDS tab, click Build.

3. Deploy the application executable on DDS.

Related Examples

• DDS Blockset Shapes Demo

Properties

Inports

Source — Root-level Inport block or bus element

character vector

Identifies a root-level Inport block or an element of an In Bus Element block in the model. Inports map to DataReaders in DDS applications.

Topic — Specifies the Topic that a DDS application subscribes to

character vector

Select a Topic for each DataReader.

Reader XML Path — Specifies the DataReader

character vector

Select or generate a DataReader for each inport.

Reader QoS — Specifies the QoS for the DataReader

character vector

Select the QoS for the DataReader for each inport.

Outports

Source — Name of root Outport block or bus element

character vector

Identifies a root-level DDS Outport block or an element of an Out Bus Element block in the model. Outports map to DataWriters in DDS applications.

Topic — Specifies the Topic that a DDS application publishes

character vector

Select a Topic for each DataWriter.

Writer XML Path — Specifies the DataWriter

character vector

Select or generate a DataWriter for each outport. Multiple outports of same Topic type can be mapped to a single DataWriter.

Writer QoS — Specifies the QoS for the DataWriter

character vector

Select the QoS for the DataWriter for each outport.

Version History

Introduced in R2021a