Realtime Linux

Author(s): Jeroen de Best, Koen Meessen
Source: Techunited: How to turn Hardware into Football

This document describes how to get the robots of Tech United to play football. It begins with installing a development PC, devpc.

How to install a devpc

This chapter describes in detail all the consecutive steps needed in order to get a fully operational development PC called devpc.

Install Ubuntu 8.10

Get a Ubuntu 8.10 live CD put it in your CD tray, boot your system from CD and select Install Ubuntu 8.10 to your hard disk. At the first step choose your language (English) and select 'Forward'. At the second step choose your time-zone. The time-zones are sorted by continent. Choose Europe, Amsterdam and select 'Forward'. At the third step choose your keyboard settings. You can try the settings in the lower area of the setup screen. The default is U.S. English, U.S. English. Select 'Forward'. At the fourth step you are asked to prepare the disks. Choose for the manual option here and select 'Forward'. Now watchout, because in the following steps you are going to erase your entire harddisk! Consecutively, select each partition and delete those partitions by clicking 'Delete partition'. After deleting all partitions select 'free space' and click 'New partition'. First make a primary partition of 4096 megabytes which is located at the beginning. Use this partition as a swap partition. This can be chosen in the 'Use as' drop down menu. Select 'Ok'. Secondly, make a primary partition of the remaining size which is located also at the beginning. Use this partition as an ext3 partition. This can be chosen in the 'Use as' drop down menu. The mount point should be '/'. Now, all disk space is partitioned. Turn on the 'Format?' option for the ext3 partition and select 'Forward'. At step number five, do not Migrate Documents and Settings and select 'Forward'. At the sixth step you should fill in the form about who you are. In our case the login name and username are robocup. The password for robocup is Robocup. Make sure that the name of your computer is devpcX, where X stand for the number of the devpc. Tick the Login Automatically option. The installation will take approximately 15 minutes. After installation, reboot the system.

Wireless internet at the TU/e

If you have a wireless ethernet adapter, you will be asked to give a default keyring password after rebooting. Just apply it without giving any password and accept the warning about the weak password. You can get wireless connection to the internet by clicking the network applet in the top right corner of the screen. Choose tue-wpa2. A screen with settings appears. Set the following settings:

Wireless Security: WPA & WPA 2 Enterprise
Authentication: Protected EAP (PEAP)
Anonymous Identity:
Ca- Certificate: /usr/share/ca-certificates/mozilla/GTE_CyberTrust_Global.crt
PEAP Version: Version 0
Inner Authentication: MSCHAPv2
Username: <your TU/e user name>
Password: <your TU/e password>

Accept the settings and you will be connected to the wireless TU/e network.

Switch to basic appearance

At this moment we shutdown the fancy graphics environment. Therefore, go to System, Preferences, Appearance, Visual Effects and set these to none. This turns of all the fancy desktop features, which are unneccesary.

Change root password

Now we should change the superuser/root password by typing. This can be done using a so-called terminal, which can be started from Applications, Accessories, Terminal. A white screen will appear with a command line prompt. To change the root password type the following.

robocup@devpcX:~$ sudo passwd root

Type your own password when asked as follows

[sudo] password for robocup:

and enter the new root password ****** twice when asked as follows

Enter new UNIX password:
Retype new UNIX password:

Now your root password is updated.

passwd: password updated successfully

Install additional packages

At this point, be sure to have a working internet connection. If so, open Synaptic Package Manager from System, Administration, Synaptic Package Manager. Type the password Robocup to enter the package manager. Click the top right 'Reload' button to update the package list. Now double-click or right-click and select 'Mark for Installation' for the following packages. You can find these packages fast by selecting one of the packages (single-click) in the top right package list and type the first letters of the package you are searching for.

csh (needed for matlab engine)
g++
g++-4.1
gcc-4.1 (needed for compatibility with mex)
glade-3 (needed for GUIs)
kernel-package (needed for kernel compilation)
libgd2-noxpm-dev (needed for gd functionalities)
libstdc++5
mc (file browser midnight commander)
nfs-common (needed to mount wtbfiler)
ntp (needed for synchronizing clocks)
ntpdate (needed for synchronizing clocks)
openssh-server (to access from a remote computer)
sun-java6-bin (needed for java)
subversion (needed for svn version)
bison (needed for comm)
ccache

Apply to install the packages. Agree the license agreement of Java, select 'Forward'. These packages will be needed during the following steps or will be needed in combination with the Tech United software.

Change gcc and g++ version

On your system there are now two versions of gcc, namely 4.1 and 4.3. Since the mex command of Matlab cannot cope with the 4.3 version we have to use the 4.1 version. The current version will probably be 4.3. To check this type the following

robocup@devpcX:~$ su
Password:
root@devpcX:/home/robocup# gcc --version
root@devpcX:/home/robocup# g++ --version

Now we alter the link gcc and g++ to point to the 4.1 versions. This is done as follows

robocup@devpcX:~$ su
Password:
root@devpcX:/home/robocup# cd /usr/bin
root@devpcX:/usr/bin# ln -sf gcc-4.1 gcc
root@devpcX:/usr/bin# ln -sf g++-4.1 g++

Check the versions again to make sure that the correct version 4.1 is now used.

Install Matlab 2007b

Now we will install Matlab 2007b. Therefore we will access to the wtbfiler of the TU/e. Note that this is only possible if you are at the TU/e or having a VPN connection with the TU/e. Make sure you have a working internet connection, preferably wired to speed up the installation process. Open a Terminal and proceed as follows

robocup@devpcX:~$ su
Password:
root@devpcX:/home/robocup# mkdir /mnt/temp
root@devpcX:/home/robocup# mount wtbfiler.wtb.tue.nl:/software /mnt/temp
root@devpcX:/home/robocup# mkdir /usr/local/matlab75
root@devpcX:/home/robocup# cd /mnt/temp/Unix-Software/matlab2007b/license
root@devpcX:/mnt/temp/Unix-Software/matlab2007b/license# cp license.dat /usr/local/matlab75
root@devpcX:/mnt/temp/Unix-Software/matlab2007b/license# cd ../DVD1
root@devpcX:/mnt/temp/Unix-Software/matlab2007b/DVD1# ./install

Choose the matlab root directory as /usr/local/matlab75. During installation cut the license at the begin and at the end where it is indicated (cut including the begin and end comments). Select the option Create symbolic links to MATLAB scripts in: /usr/local/bin. The installation will approximately take 30 minutes. Now we change the matlab command to work with the installed java package. Therefore edit the file /usr/local/bin/matlab. Open a Terminal and open the file as follows

robocup@devpcX:~$ su
Password:
root@devpcX:/home/robocup# cd /usr/local/bin
root@devpcX:/usr/local/bin# gedit matlab

Add the following at line 183 just after all the comments

export MATLAB_JAVA=/usr/lib/jvm/java-6-sun-1.6.0.14/jre

Save and close the file. Now you can start matlab. Always start matlab as a superuser/root so

robocup@devpcX:~$ su
Password:
root@devpcX:/home/robocup# matlab

Change mex options

In this section we change the options for the matlab function mex in order to be able to build the Tech United software lateron. If matlab is started type the following

>> mex -setup

Choose for option 2, Template Options file for building gcc MEX-files. Matlab reports that a file mexopts.sh is created in the folder /root/.matlab/R2007b. Check if it is placed in the prementioned folder. If this is not the case, you probably did not start matlab as a superuser and therefore the file mexopts.sh is placed in /home/robocup/.matlab/R2007b, which is incorrect. If this is the case restart matlab as a superuser and do the same again. Open the file /root/.matlab/R2007b/mexopts.sh with the editor of matlab and remove the -ansi option from the CFLAGS options on line 57 and 65. Add the option -W on line 57 and 65 to show warnings during compilation. Save and close the file.

Install linux kernel 2.6.28.3

Since the Tech United software is based on the linux kernel 2.6.28.3 we need to install this kernel. Therefore, make sure to have a working internet connection. Open the webbrowser Mozilla and go to the FTP site ftp://ftp.kernel.org/pub/linux/kernel/v2.6 and download the file linux-2.6.28.3.tar.bz2 to your desktop. Extract the file by right-clicking and chosing extract here. To move the folder linux-2.6.28.3 from your desktop to /usr/src open a Terminal and type

robocup@devpcX:~$ su
Password:
root@devpcX:/home/robocup# cd Desktop
root@devpcX:/home/robocup/Desktop# mv linux-2.6.28.3 /usr/src

Now obtain the .config file needed for the compilation of the kernel from another devpc and put it into the folder /usr/src/linux-2.6.28.3. Now your are ready to compile the 2.6.28.3 linux kernel. Here we will make debian packages of the kernel, *.deb files, such that they can be easily installed and uninstalled from your current installation. Open a Terminal and proceed as follows

robocup@devpcX:~$ su
Password:
root@devpcX:/home/robocup# cd /usr/src/linux-2.6.28.3
root@devpcX:/usr/src/linux-2.6.28.3# make-kpkg --initrd binary-arch

The compilation will approximately take one hour. After that, two debian packages are created in /usr/src, namely linux-image-2.6.28.3_2.6.28.3-10.00.Custom_i386.deb and linux-headers-2.6.28.3_2.6.28.3-10.00.Custom_i386.deb. Open the file browser Nautilus from Places, Computer and go to /usr/src/ and double-click the first one. Enter the password and install the package. Do the same for the second one. Finally, restart your PC. During rebooting you will see that there are now two more GRUB options from which the default is now the new linux kernel 2.6.28.3. Once booted, you can check the kernel version in a Terminal

robocup@devpcX:~$ uname -r

It should be 2.6.28.3.

Linux

In the startup script set the maximum transfer unit of the GigE ethernet card to 9200 kilobytes. This can be done as

robocup@devpcX:~$ su
root@devpcX:/home/robocup# ifconfig eth0 mtu 9200

where eth0 is the GigE ethernet port. Furthermore, add a directory /dev/usb and run the executable makenodes. This is necessary to make the compass function properly. The prementioned steps can be done as follows

robocup@devpcX:~$ su
root@devpcX:/home/robocup# mkdir /dev/usb
root@devpcX:/home/robocup# cd svn/trunk/src/Turtle2/Libs/TUeDACS-2.0/UgcDriver
root@devpcX:/home/robocup/svn/trunk/src/Turtle2/Libs/TUeDACS-2.0/UgcDriver# ./makenodes

With the linux dmesg we can check if the compass is detected correctly. If necessary remove and again insert the compass in the usb port of the PC. You should get messages concerning Range Bearing Devices.

Install SmartSVN

Before we can actually build the Tech United Robocup software we have to obtain the Robocup svn software tree using SmartSVN. To install SmartSVN open the webbrowser Mozilla and go to http://www.syntevo.com. Choose for SmartSVN. On the left hand side choose for Download, followed by Generic (Linux, Unix, OS/2) Download. Tick the I have read, understand and agree to all terms of the license agreement and download SmartSVN. Save the smartsvn-generic-5_0_4.tar.gz to your Desktop. Extract the tar.gz file to your Desktop by right-clicking the tar file and chosing for Extract here. Move the created directory smartsvn-5_0_4 to /usr/local, by typing the following in a Terminal

robocup@devpcX:~$ su
root@devpcX:/home/robocup# cd /home/robocup/Desktop
root@devpcX:/home/robocup/Desktop# mv smartsvn-5_0_4 /usr/local

We should edit the file smartsvn.sh in /usr/local/smartsvn-5_0_4/bin. This can be done for example using gedit, see below.

robocup@devpcX:~$ su
root@devpcX:/home/robocup# gedit /usr/local/smartsvn-5_0_4/bin/smartsvn.sh

Uncomment and edit the JAVA_HOME as follows

JAVA_HOME=/usr

Save and close the file. It is nice to have a symbolic link to SmartSVN such that you can start it from anywhere on your PC. To make a link to SmartSVN type the following in a shell

robocup@devpcX:~$ su
root@devpcX:/home/robocup# cd /usr/local/bin
root@devpcX:/usr/local/bin# ln -sf /usr/local/smartsvn-5_0_4/bin/smartsvn.sh smartsvn

Always start SmartSVN as a normal user by typing

robocup@devpcX:~$ smartsvn

Tick the I understand and agree to the terms and conditions of this agreement and click Next. Choose for the Free Professional edition and click Next. Choose My repositories are already set up and click Finish. Then Check out project from repository and click Ok. Choose for the Quick Checkout (less configuration) option with URL http://robocup.wtb.tue.nl/svn/techunited and Local directory as /home/robocup/svn and click Next. Accept that you want to create the directory if it does not exist by clicking Create and finally click Finish. In lower status bar you can see that SmartSVN is now checking out. When the checkout is completed, click the Refresh button in the lower left Transitions part. Choose to create cache for the whole repository at http://robocup.wtb.tue.nl/svn/Techunited. To close SmartSVN click the normal close button, but also close it in the upper right toolbar by right-clicking the SmartSVN icon and chosing Exit SmartSVN.

Install the Tech United software

Now startup matlab as superuser and go to the directory /home/robocup/svn/trunk/src/Turtle2. Install the robocup software in matlab by typing the following in the matlab command window

>> make_all_install

To create the motion executable in matlab go to /home/robocup/svn/trunk/src/Turtle2/Motion and type

>> build_turtle_motion turtleX

where X stands for the number of the turtle. Copy the motion executable to the turtle by typing

>> copy_motion turtleX

To build and copy the vision go to /home/robocup/svn/trunk/src/Turtle2/Vision

>> build_turtle_vision turtleX
>> copy_vision turtleX

To start the turtle we need to start the Turtle Remote Control panel. Open a Terminal login as superuser and start the trc as follows

>> export AGENT=#devpcnumber+10
>> trc

How to test the connections of the turtle

This chapter describes how to run test connections osn a turtle. Note that the wheels of the robot have to be released of the ground as the wheels will rotate!!

Preparation

Put the turtle on a plateaux and make sure the wheels can freely rotate. Connect a devpc to the robot using a UTP cable. Plug the cable in the input port (right port) of the IO stack. Next, start matlab as follows

robocup@devpcX:~$ su
Password:
root@devpcX:/home/robocup# matlab

Within the matlab go to /home/Robocup/svn/trunk/src/Turtle2/Motion/Tools/Test_connections and initialize the test_connections scheme by typing the following in the matlab command window

>> cd /home/Robocup/svn/trunk/src/Turtle2/Motion/Tools/Test_connections
>> init_test_connection turtleX

Now open the simulink scheme test_connections.mdl on the devpc. Make sure that the following settings are set

• Power on/off : 1
• Amplifiers on/off : 1

and all other constants are to zero! If the settings are correct build the model by pressing CTRL-B. Next open a Terminal and run the executable test_connections as follows

robocup@devpcX:~$ su
Password:
root@devpcX:/home/robocup# cd svn/trunk/src/Turtle2/Motion/Tools/Test_connections
root@devpcX:/home/robocup/svn/.../Tools/Test_connections# ./test_connections -w

Go back to test_connection.mdl and press "Simulation", "Connect to target" and after a few seconds press "Simulation", "Start real-time code".

Test motors

In the table below, a list is created that shows to which values the inputs (current) have to be set, what the encoder should show, and what the direction of motion should be.

Test motor

System	Motor	Current	Encoder	Direction
Drive	drive motor front left	+0.1	decrement	anti-clockwise
	drive motor rear	+0.1	decrement	anti-clockwise
	drive motor front right	+0.1	decrement	anti-clockwise
Ball handling	Ball motor left	+0.05	0-5	push ball
		-0.05	5-10	pull ball
	Ball motor right	+0.05	0-5	push ball
		-0.05	5-10	pull ball
Shooting device*	kick motor	+0.6	decrement	up
Keeper frame

'*'Note that this motor has a finite stroke, hence, set it to zero when it reaches the end of stroke!

Solenoid

To check the kicker, a very light shot will be produced. First, check the state of the slave of the shooter and the encoder of the kicker

• The output of SHTstatus should be equal to 1.
• Pulling out the kicker should result in an increasing SHTvalue.

Now it is time for a tiny shot. Place a ball in front of the robot and make sure that nothing can be hit by the ball. Set the following values

• SHTdutycycle  : 0.15
• SHTpulselength : 25
• SHTencodermax  : 100

After setting these values, set

• SHTcontrol : 1

Now the kicker should kick.

Stop test connections

In test_connections.mdl, press 'Simulation', 'Stop real-time code' and set all inputs to zero.