Create/ASUS install instructions

From Tekkotsu Wiki

Revision as of 09:21, 3 October 2011 by Touretzky (Talk | contribs)
Jump to: navigation, search

1. Turn on the wireless and webcam in the BIOS. (Some units are shipped with these already turned on, but we've also seen brand new units where these were turned off.) Power up the ASUS and press the F2 key during boot to enter the BIOS Setup Utility. Hit the right arrow key to select the Advanced tab, and then down arrow and Enter to select Onboard Devices Configuration. Make sure that all devices are enabled, then hit F10 to save and exit.

2. Install Ubuntu Netbook Edition version 10.04 using this ISO file and the instructions on the [Ubuntu Netbook Edition install page]. Warning: do not install Ubuntu 10.10 on ASUS 900 netbooks; the wireless support is defective. Stick with Ubuntu 10.04 for now.

Note that during boot you must press the Escape key, not the F2 key, in order to boot off the memory stick you created for installation.

3. During the install process, you will be asked for a user name ("Tekkotsu User") and a userid/login (set this to "user"). You will also have to specify a password. Check the box for automatic login on power-up.

4. Once Ubuntu is installed and you've rebooted from the hard drive:

  • Find the System tab in the menu at left. Go to System > Preferences > Startup Applications and uncheck the Maximus box. This keeps the system from maximizing windows, which would interfere with your use of the ControllerGUI.
  • Go to System > Preferences > Screensaver and disable keyboard locking and screen dimming. Also disable sleep mode for both the power adapter and battery operating modes. You don't want the robot to go to sleep while it's running, just because you haven't touched the keyboard in a while.

5. Raise the memory lock limit (eliminates an annoying error message when you run Tekkotsu). Type the following in a shell:

sudo -s
echo @user - memlock 1024 >>/etc/security/limits.conf
exit

6. Connect to your wireless network, or plug the ASUS into an Ethernet port and establish network access. Note: the ASUS 1015PX and some other models use an Atheros AR8152 Ethernet card whose drivers are not included in Ubuntu 10.04. To check the type of your networking card, do:

lshw -C network

If you do "ifconfig -a" and do not see device eth0 listed, then there is a driver problem. You can fix the problem by following these instructions.

7. Install dotfiles (do this as "user", not "root"):

cd
cat /dev/null >~/.cvspass
wget http://Chiara-Robot.org/create-setup/dot-profile
mv dot-profile .profile
wget http://Chiara-Robot.org/create-setup/dot-bashrc
mv dot-bashrc .bashrc
source .bashrc

8. Reboot the machine.

9. Install the packages you'll need for Tekkotsu:

sudo -s
apt-get update
apt-get -y install cvs g++ gdb openjdk-6-jdk openssh-server
apt-get -y install libpng12-dev libjpeg-dev libreadline-dev libxml2-dev sox libasound2-dev
apt-get clean
apt-get autoremove

perl -MCPAN -e "install Parse::RecDescent"   # Hit Enter to accept defaults

apt-get -y install ruby rubygems
gem install plist treetop

10. Now install and build Tekkotsu:

cd /usr/local
cvs -d :pserver:anonymous@cvs.tekkotsu.org:/cvs checkout -P Tekkotsu
cd /usr/local/Tekkotsu/project
make
su user
cp -rp /usr/local/Tekkotsu/project /home/user

11. See the section on Editing Code for advice about setting up text editor config files.