Player 2.1.1 / Stage 3.0.1 (official release)

Created: 07.14.2008
Last updated: 08.02.2008
Old version of this document here.

Installation on Fedora 9

First of all

You must have a suitable Linux distribution running into your computer in order to install Player Robotics Interface and Stage 2.5D Mobile Robotics Simulator. The following are the steps you might follow to install Player and Stage on a Fedora 9 machine. It will also work on similar distributions with similar configuration. Follow the first 2 steps in Personal Fedora 9 Installation Guide to install Fedora 9 correctly (in addition, great tips for F9), and add Development Support during installation in order to be able to compile and install Player/Stage and their prerequisites.

Prerequisites

Mandatory prerequisites available at Fedora 9 Package List that are not installed with the above configuration:

libtool-ltdl-devel-1.5.24-6.fc9.i386.rpm - The GNU Portable Library Tool development package
cmake-2.4.8-2.fc9.i386.rpm - CMake is used to control the software compilation process using simple platform and compiler independent configuration files (only for Stage).
fltk-1.1.8-1.fc9.i386.rpm - FLTK is a cross-platform C++ GUI toolkit (only for Stage).
fltk-devel-1.1.8-1.fc9.i386.rpm - Development package of the FLTK (only for Stage).

Install from fedora rpm repository usin Yum:

$ 
yum install libtool-ltdl-devel

$ yum install cmake

$ yum install fltk fltk-devel

Additionaly, Player looks for libboost_thread.so which does not come with boost-devel (that it should be already installed in your system) package, so make a symbolic link as follows:

$ ln -s /usr/lib/libboost_thread-mt.so /usr/lib/libboost_thread.so

Optional prerequisites:

gsl-1.10.tar.gz - GNU Scientific Library for acml driver
opencv-1.0.0.tar.gz - Real time computer vision
libraw1394-1.3.0-7.fc9.i386.rpm - Library providing low-level IEEE-1394 access for camera1394 driver
libraw1394-devel-1.3.0-7.fc9.i386.rpm - Development libs for libraw1394
libavc1394-0.5.3-2.fc9.i386.rpm - Audio/Video Control library for IEEE-1394 devices for camera1394 driver
libavc1394-devel-0.5.3-2.fc9.i386.rpm - Development libs for libavc1394
libdc1394-2.0.2-1.fc9.i386.rpm
libdc1394-devel-2.0.2-1.fc9.i386.rpm
libjpeg-6b-41.fc9.i386* - A library for manipulating JPEG image format files for cameracompress driver
libjpeg-devel-6b-41.fc9.i386* - Development tools for libjpeg
<linux/joystick.h>* - The Linux joystick support for linuxjoystick driver

(*) already installed with the above Fedora 9 configuration

Install from fedora rpm repository usin Yum:

$ yum install gsl gsl-devel
$ yum install opencv opencv-devel
$ yum install libraw1394 libraw1394-devel
$ yum install libavc1394 libavc1394-devel
$ yum install libdc1394 libdc1394-devel

Python bindings for Player/Stage (optional):

$
mkdir -p /usr/local/lib/python2.5/

$ cd
/usr/local/lib/python2.5/

$ ln
-s /usr/lib/python2.5/site-packages

Add to /etc/bashrc :

export
PATH=/usr/local/bin:$PATH

export CPATH=/usr/local/include:$CPATH

export
LIBRARY_PATH=/usr/local/lib:$LIBRARY_PATH

export
LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

export
PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH

And optionally for Python bindings:

export
PYTHONPATH=/usr/local/lib/python2.5/site-packages:$PYTHONPATH

Install Player 2.1.1 as root

Installing:

    $ tar xvzf player-2.1.1.tar.gz
    $ cd player-2.1.1
    $ ./configure
    $ make
    $ make install

Running:

$ player /usr/local/share/player/config/pioneer.cfg

Output:

    [root@localhost ~]# player /usr/local/share/player/config/pioneer.cfg
    Player v.2.1.1

    * Part of the Player/Stage/Gazebo Project [http://playerstage.sourceforge.net].
    * Copyright (C) 2000 - 2006 Brian Gerkey, Richard Vaughan, Andrew Howard,
    * Nate Koenig, and contributors. Released under the GNU General Public License.
    * Player comes with ABSOLUTELY NO WARRANTY. This is free software, and you
    * are welcome to redistribute it under certain conditions; see COPYING
    * for details.
    Listening on ports: 6665

Install Stage 3.0.1 as root

Installing:

    $ tar xvzf Stage-3.0.1-Source.tar.gz
    $ cd Stage-3.0.1-Source
    $ cmake .
    $ make
    $ make install

Running:

$ stage worlds/fasr.world

Stage robot simulator

Stage perspective view

Player & Stage together

TODO

Driver & Interfaces