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.
For PC please click the link Ubuntu Desktop 16.04 LTS (Xenial Xerus) to download an installation image.
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
For PC we recommend that you install the ROS-Desktop-Full configuration.
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...