This guide describes how to install FroboMind based on ROS Fuerte and Ubuntu Desktop 12.04 LTS. 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 Linux on your computer.
The following information is for PC systems only. If you want to install FroboMind on another platform please see Overo.
The current development of the FroboMind implementation in ROS is based on Ubuntu Desktop 12.04 LTS (Precise Pangolin).
You can find an ISO image for USB drive or CD installation at: http://www.ubuntu.com/download/ubuntu/download
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/fuerte/Installation/Ubuntu
3. Installing Git
Run this command to install git which is used to clone the FroboMind repository to your computer:
sudo apt-get install git-core git-gui gitk
Make sure your name and email address is registered correctly in the repository (replace using your own name and email address):
git config --global user.name "Firstname Lastname" git config --global user.email "email@example.com"
4. Setting up a GitHub account
The FroboMind software repository is located at http://github.com/FroboLab/FroboMind To install FroboMind you must therefore:
- Create an account at GitHub
- Follow this guide to set up SSH keys for establishing a secure connection between your computer and GitHub
5. Installing dependencies
Now you need to install packages and other software required by FroboMind. The commands listed here assumes that you are using Ubuntu or Debian.
Run this command to install Python ROS support which is used in the decision making layer:
sudo apt-get install python-rosinstall
Run this command to install Bluetooth support which is used in fmCSP for serial communication via bluetooth:
sudo apt-get install libbluetooth-dev
Run this command to install an open source Kalman Filter library used by some modules in fmProcessors:
mkdir -p ~/frobomind-temp/kfilter cd ~/frobomind-temp/kfilter wget http://sourceforge.net/projects/kalman/files/kalman/1.3/kalman-1.3.zip/download -O kfilter.zip unzip kfilter.zip cd kalman make sudo make install cd .. rm -rf ~/frobomind-temp
Run this command to install joystick drivers which are used for Wiimote control:
sudo apt-get install ros-fuerte-joystick-drivers
Run these commands to install the SICK LMS lidar kernel module:
mkdir -p ~/frobomind-temp/ros-deps cd ~/frobomind-temp/ros-deps git clone http://github.com/konradb3/libLMS1xx.git cd libLMS1xx mkdir build cd build cmake .. -DCMAKE_INSTALL_PREFIX=/usr make sudo make install cd ~/ rm -rf ~/frobomind-temp
6. Prepare your local repository
Create a new ROS workspace and enter the workspace directory:
rosws init ~/fuerte /opt/ros/fuerte cd ~/fuerte
Source ~/fuerte/setup.bash every time a terminal is started in the future.
echo source ~/fuerte/setup.bash >> ~/.bashrc
Install the Wiimote package in the ROS workspace:
roslocate info wiimote | rosws merge - rosws update wiimote
7. Installing FroboMind
The rest of this guide assumes that you would like to install a copy of FroboMind on your computer for your own use only. If you wish to use Git and GitHub for version control among a group of developers (or robots) or you would like to contribute software back to the FroboMind repository, you must switch to the FroboMind contribution repository guide at this point. If you are new to Git and GitHub you might want to look at our How to use Git and GitHub page.
If you have read the above paragraph and want to continue with this guide, go to your ROS workspace:
git clone firstname.lastname@example.org:FroboLab/FroboMind.git
Add FroboMind to your ROS workspace (answer y when you are asked to add the new FroboMind element):
rosws set FroboMind
Read the configuration into your current shell:
Enter the directory of your FroboMind repository:
Run this command to build FroboMind. Please verify that ROS expands FroboMind into individual packages:
7. Updating FroboMind
If you after the installation of FroboMind would like to update your version with all changes made at the FroboMind repository at GitHub please run the following commands.
Go to the FroboMind repository directory:
Fetch updates from the FroboMind repository at GitHub:
git rebase origin/master
You can visualize and browse the version history by running:
If you see this error when trying to clone the FroboMind repository:
$ git clone email@example.com:FroboLab/FroboMind.git Cloning into FroboMind... Permission denied (publickey).
It means you need to Follow this guide to set up SSH keys before successfully cloning the repository.