Embedded Motion Control 2012: Difference between revisions

From Control Systems Technology Group
Jump to navigation Jump to search
No edit summary
Line 12: Line 12:
This manual describes how to the install the necessary and sufficient software to start programming the Jazz robot.
This manual describes how to the install the necessary and sufficient software to start programming the Jazz robot.


= Ubuntu =
== Ubuntu ==


Go to [http://ubuntu.com The official Ubuntu site] and download and install '''Ubuntu 10.04''', which is the latest '''Long Term Support''' release. Make sure that you download the appropriate architecture i.e., 32- or 64-bit
Go to [http://ubuntu.com The official Ubuntu site] and download and install '''Ubuntu 10.04''', which is the latest '''Long Term Support''' release. Make sure that you download the appropriate architecture i.e., 32- or 64-bit


= ROS =
== ROS ==


In the this project, we will use the '''Robotic Operating System''' (ROS) which aids the testing and development of robot software. ROS provides a nice open-source framework for dealing with the communication between and management of different modules, and comes with a large amount of software that can be used out of the box, including device drivers, libraries, low- and high-level software, visualizers and more. More information about ROS and its goals can be found [http://www.ros.org/wiki/ROS/Introduction here]. To install ROS under Ubuntu 10.04, do the following:
In the this project, we will use the '''Robotic Operating System''' (ROS) which aids the testing and development of robot software. ROS provides a nice open-source framework for dealing with the communication between and management of different modules, and comes with a large amount of software that can be used out of the box, including device drivers, libraries, low- and high-level software, visualizers and more. More information about ROS and its goals can be found [http://www.ros.org/wiki/ROS/Introduction here]. To install ROS under Ubuntu 10.04, do the following:
Line 28: Line 28:
If you ran into problems, be sure to check the [http://www.ros.org/wiki/electric/Installation/Ubuntu installation guide on the ROS website].
If you ran into problems, be sure to check the [http://www.ros.org/wiki/electric/Installation/Ubuntu installation guide on the ROS website].


= SVN =
== SVN ==
In this project, an [http://svnbook.red-bean.com/en/1.7/svn.intro.whatis.html SVN] will be used for sharing and versioning the software. Every group has its own space on the SVN, and an account which has only permissions for that particular part. To set up the directory to where the code is checked out from the SVN, open a terminal and do the following:
In this project, an [http://svnbook.red-bean.com/en/1.7/svn.intro.whatis.html SVN] will be used for sharing and versioning the software. Every group has its own space on the SVN, and an account which has only permissions for that particular part. To set up the directory to where the code is checked out from the SVN, open a terminal and do the following:


Line 35: Line 35:
# Furthermore, check out the general folder, which contains the robot simulator:<pre>svn co https://amigo.wtb.tue.nl/svn/amigo/education/emc/2012/groups/general ~/ros</pre>
# Furthermore, check out the general folder, which contains the robot simulator:<pre>svn co https://amigo.wtb.tue.nl/svn/amigo/education/emc/2012/groups/general ~/ros</pre>


= Environment Set-up =
== Environment Set-up ==


So far we've installed ROS and created a local copy of the SVN. However, before you can start working, you need to do some additional set-ups to make sure Ubuntu knows where to find all ROS-related packages, scripts, etc. More specifically, every time you start up a terminal, the correct ''environment variables'' need to be set. The file '''.bashrc''' in your home directory is your friend: it's a script which runs every time a a new terminal is opened. We basically need to add some lines to this file, so open it with a text editor:
So far we've installed ROS and created a local copy of the SVN. However, before you can start working, you need to do some additional set-ups to make sure Ubuntu knows where to find all ROS-related packages, scripts, etc. More specifically, every time you start up a terminal, the correct ''environment variables'' need to be set. The file '''.bashrc''' in your home directory is your friend: it's a script which runs every time a a new terminal is opened. We basically need to add some lines to this file, so open it with a text editor:
Line 59: Line 59:
If everything is correct, you should have changed directory to this package.
If everything is correct, you should have changed directory to this package.


= Getting Started =
== Installing Eclipse ==


Now everything is set-up correctly, you can start using Ubuntu and ROS to develop some great new features for AMIGO! But before you run off and start to do some serious coding, be sure to check out the following pages:


* [[Using the Terminal in Ubuntu | How to use the Ubuntu terminal]]
* [[Using Subversion | SVN usage and policy]]
* [[Programming in ROS | Getting started with coding and ROS: tutorials, guidelines and conventions]]
<!--
==== Getting started with ROS ====
Once everything is set up it is time for the coding. The [http://www.ros.org/wiki/ROS/Tutorials ROS tutorials] provide a step-by-step introduction to ROS, whereas both the [http://www.ros.org/wiki/ROS ROS website] and [http://en.wikipedia.org/wiki/ROS_%28Robot_Operating_System%29 wikipedia]  briefly explain what ROS actually is. Our own wiki page on [[coding guidelines]] explains some important coding aspects, such as code documentation and naming conventions.
-->
=Introduction=
=Goal=
=Hardware=
=Installation=
== Installing Ubuntu 10.04 LTS ==
Ubuntu can be installed according 2 methods
# Using an USB stick.
# Using the hard drive.
For both methods the most recent installation instructions can be found on http://www.ubuntu.com/desktop/get-ubuntu/download. Make sure that you download the appropriate architecture ie. 32 or 64-bit.
Creating a dual-boot system, ie. installing Ubuntu on the hard drive is the most convenient.
When installing Ubuntu on an USB stick make sure to use some persistence/extra space during the install such that information is still there after a reboot.
If you installed Ubuntu on an USB stick you have to make sure that your notebook will boot from the USB stick. This can be edited in the BIOS or for most notebooks during the booting process, <code>F9</code> can be pressed to select the USB drive.


=Group Wiki Pages=
=Group Wiki Pages=

Revision as of 12:55, 18 April 2012

Guide towards the assignment

Gostai-Jazz-500x500.jpg

Author(s): Sjoerd van den Dries

Installation

This manual describes how to the install the necessary and sufficient software to start programming the Jazz robot.

Ubuntu

Go to The official Ubuntu site and download and install Ubuntu 10.04, which is the latest Long Term Support release. Make sure that you download the appropriate architecture i.e., 32- or 64-bit

ROS

In the this project, we will use the Robotic Operating System (ROS) which aids the testing and development of robot software. ROS provides a nice open-source framework for dealing with the communication between and management of different modules, and comes with a large amount of software that can be used out of the box, including device drivers, libraries, low- and high-level software, visualizers and more. More information about ROS and its goals can be found here. To install ROS under Ubuntu 10.04, do the following:

  1. Add the ROS Debian source to your sources.list such that Ubuntu knows where to download ROS from. Open a terminal (Applications -> Accessories -> Terminal) and enter:
    sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu lucid main" > /etc/apt/sources.list.d/ros-latest.list'
  2. To be able to connect with the server, add its public key to your keys:
    wget http://packages.ros.org/ros.key -O - | sudo apt-key add -
  3. Make sure you have re-indexed the ROS.org server:
    sudo apt-get update
  4. Then, install ROS. To make sure you don't miss out on any packages, install all packages available in the ROS Electric release:
    sudo apt-get install ros-electric-*

If you ran into problems, be sure to check the installation guide on the ROS website.

SVN

In this project, an SVN will be used for sharing and versioning the software. Every group has its own space on the SVN, and an account which has only permissions for that particular part. To set up the directory to where the code is checked out from the SVN, open a terminal and do the following:

  1. First, create a directory in your home directory in which we'll put all ROS-related code, files and data:
    mkdir ~/ros
  2. Then, check out your group folder from the SVN:
    svn co https://amigo.wtb.tue.nl/svn/amigo/education/emc/2012/groups/group_01 ~/ros
  3. Furthermore, check out the general folder, which contains the robot simulator:
    svn co https://amigo.wtb.tue.nl/svn/amigo/education/emc/2012/groups/general ~/ros

Environment Set-up

So far we've installed ROS and created a local copy of the SVN. However, before you can start working, you need to do some additional set-ups to make sure Ubuntu knows where to find all ROS-related packages, scripts, etc. More specifically, every time you start up a terminal, the correct environment variables need to be set. The file .bashrc in your home directory is your friend: it's a script which runs every time a a new terminal is opened. We basically need to add some lines to this file, so open it with a text editor:

gedit ~/.bashrc

Append the following text to the end of the file:

source /opt/ros/electric/setup.bash

This will set-up all ROS-related scripts etc. every time you open a terminal. Furthermore, ROS needs to known where your software is located. Therefore, also add the following command to ~/.bashrc:

export ROS_PACKAGE_PATH=~/ros:$ROS_PACKAGE_PATH

That's it. Next time you open a terminal, .bashrc is executed, which will in turn execute the script and set the path specified above. To directly see it working without starting a new terminal, explicitly source .bashrc from the terminal:

source ~/.bashrc

To see whether it worked, try one of commands that are now at your disposal. For example, change your directory to the jazz_simulator package:

roscd jazz_simulator

If everything is correct, you should have changed directory to this package.

Installing Eclipse

Group Wiki Pages

Group 01 - Visit Wiki - <NAMES>

Group 02 - Visit Wiki - <NAMES>

Group 03 - Visit Wiki - <NAMES>

Group 04 - Visit Wiki - <NAMES>

Group 05 - Visit Wiki - <NAMES>

Group 06 - Visit Wiki - <NAMES>

Group 07 - Visit Wiki - <NAMES>

Group 08 - Visit Wiki - <NAMES>

Group 09 - Visit Wiki - <NAMES>

Group 10 - Visit Wiki - <NAMES>

References