Automatic installation for ubuntu using the tinyprod repository

From TinyOS Wiki
Jump to: navigation, search

With Debian based systems (like Ubuntu) you have the possibility for a relative hassle-free installation by using the repository from the tinyprod project for the toolchain installation. The TinyOS code ifself is obtained from the official github.

You can also use this guide to install TinyOS on a virtual machine of your choice, as long as the installed system is compatible with the packages.

Installation

1) Follow the guide by Eric Decker to install the toolchain from the tinyprod repository. You will need to have gpg installed (which is quite likely already included in your distribution).

2) Get the code from the main branch (git is required):

 git clone https://github.com/tinyos/tinyos-main.git

This will check out the actual TinyOS code in a folder named tinyos-main inside the directory the command was iussed.

3) You will need to add some enviroment variables to your shell. The following file includes the necessary ones.The placeholder <local-tinyos-path> has to be replaced with the path where you chose to place the code in the last section.

# Here we setup the environment
# variables needed by the tinyos 
# make system

export TOSROOT="<local-tinyos-path>"
export TOSDIR="$TOSROOT/tos"
export CLASSPATH=$CLASSPATH:$TOSROOT/support/sdk/java
export MAKERULES="$TOSROOT/support/make/Makerules"
export PYTHONPATH=$PYTHONPATH:$TOSROOT/support/sdk/python

echo "setting up TinyOS on source path $TOSROOT"

Suppose you named this file tinyos.env. There are now at least two possibilites to have these variables accessible in your shell:
a) Place it as root user in /etc/profile.d/
b) Place it in <local-tinyos-path> and add the following line to your .bashrc

 source <local-tinyos-path>/tinyos.env

You can also directly add the contents of the file directly to the .bashrc.
To make the changes work, the easiest way is to open a new terminal window.

4) In order to program motes you will need to access the serial ports. This can be done by joining the group that grants this privilege.

 sudo gpasswd -a <your-user> dialout

This change only takes effect when log out and log in again.

Now you should have everything needed to get started. This guide should work on all Ubuntu and Debian based on Squeeze. It has only been tested on Ubuntu though.