Software Updates

From Tekkotsu Wiki

Jump to: navigation, search


General Update Procedure

This page contains tips for updating the Tekkotsu software on your workstation or robot. Make sure you have the necessary dot files installed (see below); these eliminate the need to pass a complex set of switches to cvs. The basic instructions for doing an update are:

sudo -s
cd /usr/local/Tekkotsu
cvs update
cd project
make -j4

Note: the "-j4" above tells make to run 4 simultaneous processes. This is perfect for a dual-core machine with 2GB of RAM. If you have an older machine with 1GB of RAM then you may experience thrashing, so use "-j2" or leave the switch off entirely. You can tell if your machine is thrashing, or paging heavily, by listening to the hard drive, or by running "top" and looking at the amount of swap space used.

If you have the Mirage simulator installed, you should update that as well:

sudo -s
cd /usr/local/Tekkotsu/tools/mirage
make -j4

Occasionally there are updates made to the Tekkotsu system files in the project directory, so it's a good idea to update the user project directory as well. Don't do this as root! Do it as "user". The steps are similar to the ones above:

cd ~/project
cvs update

If you mess up and do the update of ~/project as root instead of as user, you will need to go back and fix the file ownership information or you won't be able to compile anything as user. Click here for an explanation of how to fix the ownership information.

Recent Changes to the Software Configuration

4/16/2015: Upgrade to openjdk-7-jdk

Tekkotsu now includes support for the Xbox 360 gamepad, which can be read by the ControllerGUI. This requires upgrading to version 7 of openjdk. To upgrade your system, do:

sudo apt-get remove openjdk-6-jdk
sudo apt-get install openjdk-7-jdk

7/31/2014: Upgrade 12.04 to the 3.5.0 Kernel

If you are still running Ubuntu 12.04 (which is fine), you should upgrade to the 3.5.0 kernel for better device driver support, in particular fixing a critical bug in the Sony Eye webcam driver used on the Calliope2SP robot.

To check your Ubuntu version, do:

cat /etc/lsb-release

To check your kernel version, do:

uname -a

To upgrade to the 3.5.0 kernel, do:

sudo apt-get install linux-headers-3.5.0-54-generic 
sudo apt-get install linux-image-3.5.0-54-generic

After these commands complete you should reboot the machine.

Warning: do not upgrade to the even newer 3.8.0 kernel because some WiFi drivers are non-functional in that version. This problem has been fixed in Ubuntu 14.04 LTS.

6/20/2013: Upgrade to Ubuntu 12.04 LTS

Support for Ubuntu 10.04 LTS has ended, so no more security updates will be released. And newer computers are using graphics chips and displays that 10.04 does not support. So it's time for Tekkotsu users to upgrade to Ubuntu 12.04 LTS (Long Term Stable). Fortunately, this is easy. See our Upgrading to Ubuntu 12.04 LTS page for instructions.

3/9/2012: Java3D now required

The latest release of the SketchGUI, available via cvs update, includes a 3D viewer which requires the Java3D package. To install Java3D on Ubuntu systems:

cd /tmp
if [ `uname -m` == "x86_64" ]; then
unzip j3d*zip
rm -f j3d*zip
cd j3d*
sudo cp -p lib/*/ /usr/lib

2/14/2012: CVS dotfiles available

Use these dotfiles to make cvs updating go more smoothly.

mv dot-cvsrc .cvsrc
cat /dev/null >.cvspass

7/21/2010: New user dotfiles available

We've added dotfiles (.profile and .bashrc) to the Create/ASUS install instructions that make your Create/ASUS robot easier to use. The .profile puts /usr/local/Tekkotsu/tools/bin and /usr/local/Tekkotsu/tools/sbin on your search path so, for example, you can just type "ControllerGUI <host>" to run a ControllerGUI. The .bashrc file gives the shell a red and blue prompt string so that, when you have a terminal window on a workstation with multiple tabs, some of which are ssh connections to the robot and some of which are shells on the workstation, you can easily tell the difference. To upgrade an already-setup robot, follow these steps:

mv dot-profile .profile
mv dot-bashrc .bashrc

2/2010: Change to Startup and UserBehavior Conventions

As of February 2010 the startup files in the ~/project directory have changed, and when you do a cvs update, you need to take the following steps to make Tekkotsu work again; otherwise you will get compilation errors:

cd ~/project
rm Startup*
cvs update

Then edit UserBehaviors.h and remove all conflict markers ("<<<<<<<<" and "========" and ">>>>>>>>") and any references to HelloWorldBehavior in Part 1 or Part 2.

With this change to Tekkotsu, you no longer need to register behaviors in UserBehaviors.h. Instead of creating, e.g., MyDemo.h.fsm, call the file and on the last line, write: REGISTER_BEHAVIOR(MyDemo);

Besides eliminating the need to edit UserBehaviors.h every time you write a new behavior, this change also makes compilations faster. If you choose to convert your existing behaviors to .cc.fsm files with REGISTER_BEHAVIOR calls then you can delete UserBehaviors.h and entirely.

9/2009: Install libasound-dev Sound Library

As of September 2009 you need to install libasound-dev due to enhancements to Tekkotsu's sound support under Linux. If you don't do this, Tekkotsu will report compilation or linking errors during the make process. To install it, type:

sudo apt-get install libasound2-dev

6/2009: Install Perl package Parse::RecDescent

You need to install the Perl module Parse::RecDescent in order to make use of the new stateparser released in June 2009. Tekkotsu now depends on this module, so installation is not optional. To install it, type:

sudo perl -MCPAN -e "install Parse::RecDescent"

The CPAN program may ask you if you want manual or automatic configuration; select automatic. It may also ask for permission to connect to the Internet; tell it "yes". If you get into any other kind of dialog with CPAN, just keep hitting Enter to accept the defaults and everything will be fine.