The installation of the Edufill software components required installation of following:

• Operating System : Ubuntu 12.04
• Software Framework : ROS Fuerte
• Version Control: Git

The distribution can be download via link below:

http://www.ubuntu.com/download/desktop

The installation tutorial can be found here:

http://www.ubuntu.com/download/desktop/install-desktop-long-term-support

In order to operate a robot the software framework ROS has to be installed. Version which was verified with our components is "fuerte".

Installation instructions for "ros-fuerte-desktop-full" is on:

http://wiki.ros.org/fuerte/Installation/Ubuntu

Follow the step by step instruction for installation. For thought user who never work with ROS before, we recommend to start with beginner level of ROS tutorials:

http://wiki.ros.org/ROS/Tutorials

If git was not installed automatically with Ubuntu installation:

sudo apt-get install

The git core components and git GUI can be installed via command:

sudo apt-get install gitk gitg git-core

Git can be configuration by user name and email which will be associated with your commits

git config --global user.name "YOUR NAME"
git config --global user.email "YOUR@EMAIL.COM"

Users who does not want investigate in installation of EduFIll software components can download shell script for automatic installation from:

www.edufill.org

This script has to be executed in terminal in directory where you what to store the EduFill components:

./EduFill.sh

This process takes time bacause it is installing all possible dependences for the EduFill components. Within the process, user will be asked permission several time for executing commands that require different privilege. If there is no error occur, the user will be notified upon completion: Instlation finish . Additionally, within the directory where the EduFill.sh script was executed, two additional directory will be created, components and external_software.

The manual installation requires more advance knowledge and give more flexibility.

sudo apt-get install python-rosinstall python-setuptools

We recommend create new directory for EduFill components. In new terminal window:

mkdir ~/ros
cd ~/ros

Then the git repository can be clone there:

git clone https://github.com/EduFill/components

The further dependences need to be installed:

edufill components

 cd ~/ros
./components/edufill_sw/repository.debs
mkdir external_software
cd components/edufill_sw/
rosinstall ../../external_software /opt/ros/fuerte ./repository.rosinstall

hbrs-ros-package

cd ~/ros
./external_software/hbrs-ros-pkg/repository.debs
cd external_software/hbrs-ros-pkg/ rosinstall ../../external_software
/opt/ros/fuerte ./repository.rosinstall

Use your favorite text editor (vim, nano, gedit) to modify your .bashrc file. In most cases, .bashrc file is located in the user directory (for example /home/<user_name>) and it is a hidden file. Add the following lines to the .bashrc file.

  vim ~/.bashrc

Define which robot to be used within ROS. The EduFill software toolbox accommodate three different robot which are youbot-edufill, nxt-arm and nxt-base

export ROBOT=youbot-edufill

The variable ROBOT_ENV define which robot environment to be used within ROS (i.e. for the navigation component). There are five different environment are available for simulation (brsu-home, edufill_domestic, edufill_maze, edufill_maze_big, and edufill_maze_island)

export ROBOT_ENV=brsu-home

The variable ROS_PACKAGE_PATH is to include the directory where you install EduFill components in the ROS package directory.

export ROS_PACKAGE_PATH=/home/user/...../ros:$ROS_PACKAGE_PATH

To set the variable you need to perform :

source ~/.bashrc

in each terminal that is opened or close all of them.

EduFill software component can be build using the following commands:

rosmake edufill_blockly