SmartSoft on Robotino for Robot Developers
Contents
Introduction
The term SmartSoft originally stands for the component based robotics framework that was published in 1999. Comparable with other robotic frameworks or middlewares, SmartSoft provides communication mechanisms to exchange information between components and provides a component container.
However, there are clear and explicit communication semantics (communication patterns) and a clear component model.
SmartSoft uses components with services as fundamental building blocks.
In addition, SmartSoft provides implementations and tools such as the Eclipse based integrated model-driven SmartMDSD Toolchain. The SmartMDSD Toolchain supports the complete development process from component developer over system integration up to runtime aspects.
Some Important Hints
Component repositories
One of the principles behind SmartSoft is that robotic systems have to be composed from components, rather than programmed. SmartSoft provides components in repositories ready for reuse and composition of new robotic applications through the SmartSoft MDSD toolchain.
SmartSoft components that are specifically developed for the use with the robotino platform, can be found in the repository:
http://svn.openrobotino.org/smartsoft/trunk/components/
All other SmartSoft components can and are used in combination with those components as well, e.g. laser components, all the navigation, localization and mapping components, etc. .
Link to the components from the main smartsoft repository:
http://servicerobotik-ulm.de/drupal/doxygen/components_commrep/group__componentGroup.html
Use the SmartMDSD Toolchain
We encourage all SmartSoft robotics software developer to use the SmartMDSD Toolchain, although it is possible to develop SmartSoft applications without it. With the SmartSoft toolchain you get support throughout the complete development process.
Already Running SmartSoft component instances?
Depending on the installed robotino debian packages smartsoft is already running on your robotino, providing the infrastructure and skills accessible through the robotino factroy app or robotino view.
If you wan't to run your own smartsoft components or whole deployments on the robotino you should make sure that no other smartsoft components or an other SmartSoft namingservice is running.
To check if the pre-installed robotino smartsoft components are running execute the follwing:
sudo systemctl status smartsoft-slave sudo systemctl status smartsoft-master
To stop those component execute the following:
sudo systemctl stop smartsoft-slave sudo systemctl stop smartsoft-master
Hint: It is also possible to remove those components from robotino (later re-installation is easy). However some functionally of the robotino factroy app will not be available with uninstalled or stopped smartsoft components.
sudo apt-get purge robotino-smartsoft-master robotino-smartsoft-common robotino-smartsoft-slave
Installing SmartSoft from Sources (on Development PC)
SmartSoft and the SmartMDSD Toolchain enable the deployment of robotics applications form an development platform to the target robot, in this case a robotino.
Therefore a typical development setup is to fetch and compile the sources on a development platform, to later deploy the binaries to the robotino.
Important Hint: To make use of this development setup the development platform needs to run the same operation system version as the target platform, the robotino (due to dynamically linked dependencies).
If for some reason this is not your preferred setup, its also equally possible to install SmartSoft and the SmartMDSD Toolchain onto the robotino itself. The later deployment target is in that case localhost, so that all functionality and support offered by the SmartMDSD Toolchain is available as well.
Hint: To develop software on the robotino itself you can use the pre-installed VNC connection.
Installation
The installation of SmartSoft from source is pretty simple and tool supported, see our install script: http://servicerobotik-ulm.de/drupal/?q=node/34
Due to the integration of SmartSoft with the robotino webinterface / robotino factory app and robotino view some parts of the general SmartSoft installation should be modified:
0.) Install robotino debian repo + ace
wget -qO - http://packages.openrobotino.org/keyFile | sudo apt-key add - sudo su echo "deb http://packages.openrobotino.org/precise precise main" > /etc/apt/sources.list.d/openrobotino.list apt-get update apt-get install ace
1.) Get Installation Script
wget http://sourceforge.net/p/smartsoft-ace/code/HEAD/tree/trunk/smartsoft-install-updatescript.sh?format=raw\ -O /tmp/smartsoft-install-updatescript.sh
sudo apt-get install zenity
2.) Execute the Installation Script
chmod +x /tmp/smartsoft-install-updatescript.sh cd /tmp ./smartsoft-install-updatescript.sh
3.) Install ACE/SmartSoft and deps on a clean system
The script is also able to update and compile an existing SmartSoft installation.
For installation select the menu entry:
Install ACE/SmartSoft and deps on a clean system*
From the new shown menu select the entries:
Install ACE/SmartSoft dependent system packages Checkout ACE/SmartSoft SVN repo + set env variables Install robotino packages Checkout robotino ACE/SmartSoft SVN repo
Hint: ACE should be installed as binary package from the robotino debian repo!
The script will update the system and install the necessary system packages to compile all SmartSoft-Components.
SmartSoft will be located in ~/SOFTWARE/smartsoft as a subversion checkout pointing to HEAD of TRUNK of the SourceForge SmartSoft main repository. The necessary environment variables are set in ~/.profile .
The robotino repository checkout will be locate in ~/SOFTWARE/smartsoft_robotino_components .
Important Hint: To apply changed and added environment variables set in the ~/.profile restart the system!
Update and Compile SmartSoft
The script (now also available in $SMART_ROOT_ACE) can also be used to compile (and update) a SmartSoft installation and system.
cd $SMART_ROOT_ACE ./smartsoft-install-updatescript.sh
To update and compile select the menu entries:
Upgrade system packages* Update ACE/SmartSoft SVN Build/Compile ACE/SmartSoft Update Robotino SVN Build/Compile Robotino ACE/SmartSoft Components
The script updates the system packages, the subversion checkouts and finally compiles the SmartSoft installation.
If the installation has been compiled successfully you should get the following message in a terminal:
######################################## ### SmartSoft successfully compiled! ### ########################################
Install SmartMDSD Toolchain
Using the script is an easy way to install the latest version of the SmartMDSD Toolchain, select the menu entry:
Update/Install SmartMDSD Toolchain to recent version
The latest version of the SmartMDSD Toolchain will be installed to ~/SOFTWARE/toolchain-latest . On Linux you can start the toolchain by double clicking the extracted binary "~/SOFTWARE/toolchain-latest/SmartMDSD-toolchain-x.x/eclipse" (prefered/standard method) or by executing in a terminal:
~/SOFTWARE/SmartMDSD-toolchain-x.x/toolchain-latest ./eclipse
Important Hint: Find more tutorials how to use the SmartMDSD Toolchain at the Video Tutorials page.
Developing new Components
Video tutorials how to use the SmartMDSD Toolchain are available at the Video Tutorials page of http://servicerobotik-ulm.de/.
Deploying Components to Robotino
Video tutorials how to use the SmartMDSD Toolchain are available at the Video Tutorials page of http://servicerobotik-ulm.de/.
