(!) Please ask about problems and questions regarding this tutorial on answers.ros.org. Don't forget to include in your question the link to this page, the versions of your OS & ROS, and also add appropriate tags.

Installation

Description: Installation instructions from iso, deb or sources.

Keywords: turtlebot installation

Tutorial Level: BEGINNER

Next Tutorial: Post-Installation Setup

Choose the installation process you'd like to follow from the options below.

Install from Live Usb

Install from Debs

Install from Source

USB Installation

This is pending information/testing of the live usb release.


Debs Installation

Pre-Requisites

These instructions are intended for users with a netbook pre-installed with Ubuntu Precise or Quantal.

Instructions

Follow the generic ubuntu instructions for a ros-groovy-desktop-full installation.

In addition, you will need to install the following debs for turtlebot (please update this if you find any errors):

> sudo apt-get install ros-groovy-turtlebot ros-groovy-turtlebot-apps ros-groovy-turtlebot-viz 

One last step if you have a kobuki base, you'll need to add kobuki's udev rules (you'll need your sudo password):

> . /opt/ros/groovy/setup.bash
> rosrun kobuki_ftdi create_udev_rules

Convenience

For convenience, you may wish to source your setup.sh script from your .bashrc so that your environment is ready as soon as you log in. e.g.

> echo "source /opt/ros/groovy/setup.bash" >> ~/.bashrc

If you have overlaid your own development environment on top of the installed debs, point to that setup script instead.

Notes

ros-groovy-turtlebot-simulator will be official as soon as the gazebo plugin is upgraded and functional

Gazebo has gone through a fairly large upgrade, even to the extent of using a new format for its engine. We are in the middle of reviewing and upgrading this - please bear with us.


Source Installation

Overview

This guide is for people who'd like to hack on the turtlebot sources and contribute. It is not intended as a full blown set of source installation instructions. For that, please ask us for more information at <ros-sig-turtlelbot AT googlegroups DOT com>.

For groovy, the source installation is a little complicated as we are transitioning from rosbuild to catkin, and as a result, there will always be two separate source installs until all the stacks have moved to catkin. Some of these are out of our control and pending catkin releases of other stacks.

Preparation

Follow the generic ubuntu instructions for a ros-groovy-desktop-full installation.

In addition, you will need to install the following pre-requisites for building the create, kobuki and turtlebot stacks:

# Kobuki
> sudo apt-get install ros-groovy-ecl-tools ros-groovy-ecl-lite ros-groovy-ecl-core ros-groovy-ecl-navigation ros-groovy-rqt-robot-plugins ros-groovy-simulator-gazebo
ros-groovy-python-orocos-kdl
# Turtlebot
> sudo apt-get install ros-groovy-zeroconf-avahi ros-groovy-multimaster-experimental ros-groovy-depthimage-to-laserscan ros-groovy-openni-camera
# Turtlebot Apps
> sudo apt-get install ros-groovy-joystick-drivers ros-groovy-map-store
# Workspace Tool
> sudo apt-get install python-wstool

/!\ Please update this list if you find installs missing for either compile or run time.

Catkin Stacks

> mkdir ~/turtlebot-catkin
> cd ~/turtlebot-catkin
> wstool init src https://raw.github.com/turtlebot/turtlebot/master/turtlebot_catkin.rosinstall
> source /opt/ros/groovy/setup.bash
> catkin_make -DCMAKE_INSTALL_PREFIX=/opt/turtlebot/groovy
> cd build; sudo make install

If you have a kobuki base, don't forget to create the udev rule so that it always appears on /dev/kobuki (you'll need your sudo password):

> . /opt/turtlebot/groovy/setup.bash
> rosrun kobuki_ftdi create_udev_rules

If you ever need to uninstall, simple rm -rf /opt/turtlebot will do the trick.

Rosbuild Stacks

> rosws init ~/turtlebot-rosbuild /opt/turtlebot/groovy
> cd ~/turtlebot-rosbuild
> rosws merge https://raw.github.com/turtlebot/turtlebot/master/turtlebot.rosinstall
> rosws update
> source setup.bash
> rosmake kobuki_desktop turtlebot turtlebot_apps turtlebot_viz

Convenience

For convenience, you may wish to source your setup.sh script from your .bashrc so that your environment is ready as soon as you log in. e.g.

> echo "source ~/turtlebot-rosbuild/setup.bash" >> ~/.bashrc

If you have overlaid your own development environment on top of the installed debs, point to that setup script instead.


What Next?

Wiki: turtlebot/Tutorials/groovy/Installation (last edited 2013-04-23 13:33:15 by DanielStonier)