FroboMind:Installation:Kinetic

From FroboMind [www.frobomind.org]
Jump to: navigation, search

This guide describes how to install FroboMind based on ROS Kinetic and Ubuntu 16.04 LTS on either a standard PC or a Raspberry Pi 3 model B.

Please notice that this version is considered the FroboMind current stable version. If you want to install another version please visit the FroboMind installation page.


1. Installing Linux

The first step of installing FroboMind is to install Ubuntu 16.04.

PC

For PC please click the link Ubuntu Desktop 16.04 LTS (Xenial Xerus) to download an installation image.

Raspberry Pi

For Raspberry Pi please click the link Ubuntu Mate 16.04 LTS to download an installation image.


2. Installing ROS

The next step is to install ROS on top of your Linux installation.

ROS is an abbreviation for Robot Operating System which provides libraries and tools to help software developers create robot applications. It provides hardware abstraction, device drivers, libraries, visualizers, message-passing, package management, and more.

For information about how to install ROS on Ubuntu please go to this page: http://www.ros.org/wiki/kinetic/Installation/Ubuntu

PC

For PC we recommend that you install the ROS-Desktop-Full configuration.

Raspberry Pi

For Raspberry Pi we recommend that you install the ROS-Base configuration to minimize the installation.


3. Installing dependencies

If you have installed the ROS-Desktop-Full configuration, there are currently no required dependencies.

If you have installed the ROS-Base configuration you will need to install the software packages listed below:

sudo apt install git
sudo apt install catkin
sudo apt install python-matplotlib
sudo apt install ros-kinetic-tf ros-kinetic-stage ros-kinetic-stage-ros

If you wish to run the MarkerLocator software, you will also need to install the software packages listed below:

sudo apt install python-opencv
sudo apt install ros-kinetic-cv-bridge


4. Installing FroboMind

Run these commands to create a ROS workspace directory under your user home dir. If you are new to the linux, please notice that the shortcut to paste in the terminal is CTRL-SHIFT-V.

mkdir -p ~/roswork/src

Clone the FroboMind repository and the Frobit demo application to the ROS source directory:

cd ~/roswork/src
git clone http://github.com/frobolab/frobomind.git
git clone http://github.com/frobolab/frobit_demo.git


5. Compiling your first FroboMind application

ROS Groovy is compiled using catkin, however in FroboMind a script in the ~/roswork/src/frobomind directory handles compilation of the components you need for a particular application, so you don't have to deal with catkin directly. Run these commands to compile and run the Frobit demo application:

cd ~/roswork/src
frobomind/frobomind_make /frobit_demo

During the compilation process catkin has created two new directories, so now your roswork directory contains:

~/roswork/src
~/roswork/devel
~/roswork/build

To configure ROS for this workspace run:

echo "source ~/roswork/devel/setup.bash" >> ~/.bashrc
source ~/.bashrc

The first line above configures your current shell, the second line configures all new shells that you open.

To be able to run the frobomind_make script from everywhere run:

echo 'PATH="$PATH:~/roswork/src"' >> ~/.bashrc


6. Where to go from here

When you have completed the installation above you are ready to begin using FroboMind. This is where it gets really exiting. We recommend that you...

Personal tools