SRRC Wiki

Service Robotics Research Center
at Ulm University of Applied Sciences

User Tools

Site Tools


tutorials:launching-vm-and-toolchain:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
tutorials:launching-vm-and-toolchain:start [2021/02/24 18:35]
Christian Schlegel [Getting Started with the Virtual Machine and the SmartMDSD Toolchain]
tutorials:launching-vm-and-toolchain:start [2021/02/24 20:23] (current)
Christian Schlegel [How to update the Virtual Machine Image]
Line 1: Line 1:
 ====== Getting Started with the SmartMDSD Toolchain ====== ====== Getting Started with the SmartMDSD Toolchain ======
  
-This is the introductory ​tutorial ​for lesson one. It shows where to look around in the SmartMDSD Toolchain.+This is the first tutorial ​of lesson one. It shows where you find the SmartMDSD-Toolchain on your desktop and where to look around in the SmartMDSD-Toolchain
 + 
 +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.
  
  
Line 13: Line 15:
  
  
-===== Introduction of Lesson 1 and this Tutorial ===== 
  
-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. 
  
-This lesson features two systems/​applications:​ 
  
-  * Simple Laser Obstacle Avoid: +===== What is SmartSoft? ​=====
-    * A simple reactive and collision-free motion of a robot with a laser ranger +
-    * A simple example to get hands-on experience with the toolchain +
- +
-  * A full Navigation Stack (Mapping, Path Planning, Collission Avoidance, etc.) +
-    * Complex set of off-the-shelf software components for navigation as it is used in real service robots +
-    * Example to illustrate how a complex system is composed from previously developed software components +
- +
-==== 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. 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.
Line 38: Line 29:
  
  
-===== Download ​the Virtual Appliance ===== +===== Basics on the Virtual Appliance =====
- +
- +
-Download the [[:​virtual-machine|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 [[http://​robot.one/​tooling|robot.one]]) +
- +
-{{ :​tutorials:​launching-vm-and-toolchain:​installvm.png?​600 |}} +
- +
-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: [[tutorials:​vm-welcome]]. +
- +
- +
-==== How to start and stop the Virtual Machine ==== +
- +
-You have two ways to Start the Virtual Machine:  +
- +
-  - Start “VirtualBox”,​ import the just downloaded ova-File, and then start this Virtual Machine. +
-  - 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 [[tutorials:​vm-welcome]]. +
- +
-You can shut down the VM from the guest operating system as illustrated below:+
  
-{{ :tutorials:launching-vm-and-toolchain:​shuttingdownlikeanormalpc.png?300 |}}+In case you are using a virtual appliance, please see [[tutorials:​vm-welcome]] for additional information on working with virtual machines.
  
-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"​. 
  
-{{ :​tutorials:​launching-vm-and-toolchain:​shuttingdownthevirtualmachine.png |}} 
  
-==== How to update the Virtual Machine Image ====+===== How to do updates =====
 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. 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.
  
Line 96: Line 60:
 {{ :​tutorials:​launching-vm-and-toolchain:​screenshot_from_2018-08-06_16-13-48.png?​600 |}} {{ :​tutorials:​launching-vm-and-toolchain:​screenshot_from_2018-08-06_16-13-48.png?​600 |}}
  
-==== Importing import ​existing projects ====+==== 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:+By default, the toolchain in the virtual machine will have all necessary projects imported and set up. In case you did a direct installation,​ the you first might need to import projects. This also applies in case you want to import projects not yet imported so far. For this, follow these steps:
  
   * //(if not all are already visible within the toolchain)//​   * //(if not all are already visible within the toolchain)//​
Line 125: Line 89:
 We now briefly look around in the SmartMDSD Toolchain. The next tutorial will more deeply address all aspects of the SmartMDSD Toolchain. 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:+Let's look at one simple ​example of a system project ''​SystemLaserObstacleAvoidRobotinoWebotsSimulator''​. 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:
  
 {{ :​tutorials:​launching-vm-and-toolchain:​openingsystemprojectanddifferentviewpoints.png?​400 |}} {{ :​tutorials:​launching-vm-and-toolchain:​openingsystemprojectanddifferentviewpoints.png?​400 |}}
tutorials/launching-vm-and-toolchain/start.1614188128.txt.gz · Last modified: 2021/02/24 18:35 by Christian Schlegel