Create Architecture Model with Interfaces and Requirement Links
Create an architecture model of a robot arm using System Composer™. Define interfaces on ports and link requirements on components. When you
complete these steps, you will have created a completed
A Requirements Toolbox™ license is required to link, trace, and manage requirements in System Composer.
For more information about the model-based systems engineering workflow within System Composer, see Compose and Analyze Systems Using Architecture Models.
Visually Represent System
Implementing an architectural design starts with visually representing the system using components and their connections. Create an architecture model, represent the system components, and draw the connections between them.
Create Architecture Model
Enter this command in the MATLAB® Command Window.
The Simulink® Start Page opens to System Composer.
Click Architecture Model.
Use a System Composer Architecture Model to describe systems as a combination of structural elements with underlying behavioral descriptions. Use a Software Architecture Model to easily define the execution order of your functions from your components, simulate your design in the architecture level, and generate code by linking your Simulink export-function, rate-based, or JMAAB models to components.
For more information about software architecture models, see Author Software Architectures.
A new, blank architecture model canvas opens. You can identify an architecture model by the badge in the lower left corner and the component palette on the left side.
Double-click the architecture model header and change
untitledto a descriptive model name, for example,
RobotDesign. The name of the model generally reflects the system whose architecture you are building.
Save the model.
Design a mobile robotic arm where a sensor senses position and trajectory planning
computes a path to a location that the robot needs to reach using motion. An architecture
model of such a system could consist of three primary components:
Trajectory Planning, and
Motion. You can represent these components in System Composer using three Component blocks.
Click and drag a Component block from the left-side palette.
Rename the component as
Follow these steps to create
Create Ports and Connections
You can begin to create connectivity between components by describing the flow of power, energy, data, or any other representative information. Create ports on the components that provide or consume information and connectors that bind two component ports to represent the flow of the information.
You can add a port to a component on any side, and the port can have either an input
or output direction. To create a port, pause your cursor over a component side. Click and
release to view port options. Select either
Physical to create a port. Rename the
port using a name that represents the information that flows through that port.
Create an output port on the bottom side of the Sensors component. Rename it SensorData.
Click and drag a line from the SensorData output port to the
Motioncomponent. When you see an input port created at the component side, release the pointer. By default, this new port has the same name as the source port.
Pause on the corner of the SensorData line until you see the branch icon . Right-click and drag a branch line to the
Complete the connections as shown in this figure.
The root level of the architecture model can also have ports that describe the interaction of the system with its environment. In this example, the target position for the robot is provided by a computer external to the robot itself. Represent this relationship with an input port.
Click the left edge of the architecture model and enter the port name TargetPosition.
Connect an architecture port to a component by dragging a line from the TargetPosition input port to the
Trajectory Planningcomponent. Connections to or from an architecture port appear as tags.
Edit Data Interfaces
You can define a data interface to fully specify a connection and its associated ports. A data interface can consist of multiple data elements with various dimensions, units, and data types. To check for consistency when connecting a port, you can also associate interfaces with unconnected ports during component design.
Specify the information flow through a port between components by configuring the data interface with attributes. A data interface can be as simple as sending an integer value, but it can also be a set of numbers, an enumeration, a combination of numbers and strings, or a bundle of other predefined interfaces.
Consider the data interface between the
Sensors and the
Motion components. The sensor data consists of:
Position data from two motors
Obstacle proximity data from two sensors
A time stamp to capture the freshness of the data
To open the Interface Editor, navigate to Modeling > Interface Editor.
Click the button to add a data interface. Name the interface
The data interface is named and defined separately from a component port and then assigned to a port.
Click the SensorData output port on the
Sensorscomponent. In the Interface Editor, right-click
sensordataand select Assign to Selected Port(s).
If you click
sensordataagain, the three SensorData ports are highlighted, indicating the ports are associated with that interface.
Add a data element to the selected data interface. Click the button to add a data element and name it
Continue adding data elements to the data interface as specified by clicking the add data element button.
Name Type Units
position1for motor 1
position2for motor 2
distance1for sensor 1
direction1for sensor 1
distance2for sensor 2
direction2for sensor 2
Edit the properties of a data element in the Interface Editor. Click on the cell corresponding to the data element in the table and add units as shown in the specification.
Click the drop-down list next to the button to save the data interface to a data dictionary. A data dictionary allows you to collectively manage and share a set of interfaces among models. For instance, later in the design, if you choose to model the external computer as a separate architecture model, then this model and the
Robotmodel can share the same data dictionary. Here, the dictionary is saved as
Each component can have its own architecture. Double-click a component to decompose it into its subcomponents.
Trajectory Planningcomponent. The Explorer Bar and Model Browser indicates the position of the component in the model hierarchy.
This component first uses the motor position data that is part of the
sensordatainterface to compute the ideal position and velocity command. It then processes the obstacle distance information in the same interface to condition this motion command according to some safety rules.
Safety Rulescomponents as part of the
Drag the TargetPosition port to the
Motion Controlcomponent. Add a Command output port to
Motion Control, then drag a line to the
Safety Rulescomponent. Drag lines from the SensorData port to the
Robot Arm Architecture Model
Open the architecture model of a robot arm that consists of sensors, motion actuators, and a planning algorithm. You can use System Composer to view the interfaces and manage the requirements for this model.
Manage Requirement Links
Requirements are integral to the systems engineering process. Some requirements relate to the functionality of the overall system, and some relate to aspects of performance such as power, size, and weight. Decomposing high-level requirements into low-level requirements and deriving additional requirements is crucial to defining the architecture of the overall system. For instance, the overall power consumption of the robot determines the requirement for the power consumption of the robot controller.
To allocate and trace requirements with system elements, System Composer fully integrates with Requirements Toolbox. To derive appropriate requirements, you must sometimes analyze and specify
properties (such as power) for elements of the system including components, ports, or
connectors. For example, if the total cost of the system is a concern, a
unitPrice property is necessary.
Manage requirements from the Requirements Perspective in System Composer using Requirements Toolbox. Navigate to Apps > Requirements Manager. For more information, see View and Link Requirements in Simulink (Requirements Toolbox).
To enhance the traceability of requirements, link requirements to architectural components and ports. When you click a component in the Requirements Perspective, linked requirements are highlighted. Conversely, when you click a requirement, the linked components are shown. To directly create a link, drag a requirement onto a component or a port.