Service Robotics Research Center
at Ulm University of Applied Sciences

User Tools

Site Tools

This version is outdated by a newer approved version.DiffThis version (2021/02/24 19:07) is a draft.
Approvals: 0/1
The Previously approved version (2021/02/24 15:53) is available.Diff

This is an old revision of the document!

Getting Started with the SmartMDSD Toolchain

This is the first tutorial of lesson one. It shows where to look around in the SmartMDSD Toolchain and it gives you basic information of how to update from the repositories

This is the first tutorial of lesson one. It shows where you find the SmartMDSD-Toolchain on your desktop and how to start it.

This tutorial also already gives you basic information of how to update from the repositories for the latest versions and how to import / export already existing projects. That part of this tutorial is not needed in the beginning and you scan skip that part in the first round.

Basic Information

Level Beginner
Role System builder, but also other roles while browsing through the system's building blocks
Assumptions Basic understanding of Virtual Machines is a plus, but not required
System Requirements None. Instructions to install virtual box and download the virtual machine are provided.
You will learn Basic usage functionalities of the SmartMDSD Toolchain


In this lesson one, we guide you through first examples running a Pioneer 3DX robot in simulation. Later tutorials will show how to run the examples in real-world with a real robot. You will get an immediate impression of the power of the SmartMDSD Toolchain and its development tools. We provide all the hints of where to find more information, documentation, reusable components etc. We will accomplish all the tasks of this tutorial and the next tutorials by using a Virtual Machine.

What is SmartSoft?

SmartSoft is an umbrella term for structures, tooling, infrastructure, and software components to build robotics systems: a systematic software development methodology, best practices, implementations, and software components.

The SmartMDSD Toolchain is based on the Eclipse Modeling Project. It assists the component developer in building software components that adhere to a software component model for robotics. It assists the application builder in composing complex robotics applications out of off-the-shelf robotics software components.

Read more

Download the Virtual Appliance

Download the virtual appliance to a directory in your home folder (SeRoNet users find the VM which bundles packages with a dedicated focus on the “SeRoNet Tooling Collection” at

Virtual Machine image System Information:

  • Virtual Machine image based on Ubuntu LTS 64bit
  • user name / password: smartsoft / smartsoft
  • sudo password if needed: smartsoft

See additional information for working with the virtual machine: Welcome to the Virtual Machine.

How to start and stop the Virtual Machine

You have two ways to Start the Virtual Machine:

  1. Start “VirtualBox”, import the just downloaded ova-File, and then start this Virtual Machine.
  2. Double-click the just downloaded ova-File and all gets started within “VirtualBox”. As “VirtualBox” starts the prepared Virtual Machine appears as a virtual computer inside your computer. In our case, this virtual computer is run by Ubuntu LTS.

We provide a “ready-to-use” installation of the SmartMDSD Toolchain in this virtual computer. It comes with all necessary examples to follow the tutorials. If you are new to virtual machines: Please always shutdown your virtual machine as you do with regular computers. We recommend to learn more about advanced methods to save the machine state and snapshots, see Welcome to the Virtual Machine.

You can shut down the VM from the guest operating system as illustrated below:

You can also shut down the VM from the virtual box management GUI. This will issue an ACPI command. It simulates pressing the “power button”.

How to update the Virtual Machine Image

It is recommended to update your svn repository and the installed SmartMDSD toolchain. Double-click the “Update Virtual Machine” icon on the Ubuntu Linux desktop in the Virtual Machine.

Updating the VM will update all repositories and re-compile the development environment. Depending on your host and guest configuration, it may take about 20-30 minutes.

The SmartSoft MDSD Toolchain

To start the SmartMDSD Toolchain, click on the icon “SmartMDSD Toolchain”.

Importing import existing projects

By default, the toolchain in the virtual machine will have all necessary projects imported and set up. To import additional projects, follow these steps:

  • (if not all are already visible within the toolchain)
  • in the SmartMDSD toolchain menu, please click the following:
    • File → Import → Existing Project into Workspace
  • and then import the projects by selecting the following directories (one by one):
    • /home/smartsoft/SOFTWARE/smartsoft_dev_ace_v3/repos/DomainModelsRepositories/
    • /home/smartsoft/SOFTWARE/smartsoft_dev_ace_v3/repos/ComponentRepository/
    • /home/smartsoft/SOFTWARE/smartsoft_dev_ace_v3/repos/DomainModelsRepositories/

Please do not modify settings in the import-dialog: keep the defaults. It is recommended to “link projects” and not to copy them to the current workspace.

  • You might need to wait some time until the Virtual Machine has processed everything and is again idle.
  • This can take some time when you import a bunch of components.
  • Please proceed only after the Virtual Machine is idle again.

The following screenshots shows the dialog settings for components:

Look Around: An Example System Project

We now briefly look around in the SmartMDSD Toolchain. The next tutorial will more deeply address all aspects of the SmartMDSD Toolchain.

Let's look at one easy example of a system project SystemLaserObstacleAvoidTiagoGazeboSimulator. To open the project, locate it in the project explorer and double click it. There are multiple views which include component architecture, target platform and deployment. The system component architecture composes software components to systems. Double click System Architecture Viewpoint and explore it:

It contains two software components which implement a simple reactive obstacle avoidance scenario. To see more, continue with the next tutorials.

Further Information

Additional information for working with the virtual machine: Welcome to the Virtual Machine

What to do next?


tutorials/launching-vm-and-toolchain/start.1614190025.txt.gz · Last modified: 2021/02/24 19:07 by Christian Schlegel