Create/ASUS install instructions

From Tekkotsu Wiki

Revision as of 19:49, 15 August 2010 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 Easy Peasy (a netbook remix of Ubuntu Linux) by following the instructions on the Easy Peasy download page. The current stable version is 1.6. 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. Once Easy Peasy boots, click on the Administration tab on the left, and run the Install application.

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.

3. If you've installed the older Easy Peasy 1.5, you will need to fix the broken archive information. (You don't have to do this for Easy Peasy 1.6 or higher.)

sudo -s
cd /var/lib/apt
apt-get clean
mv lists lists.old
mkdir -p lists/partial
apt-get clean
apt-get update

4. Once Easy Peasy is installed and booted:

  • Find the Preferences tab in the menu at left. Go to Preferences > Startup Applications (in Easy Peasy 1.1 this was called Preferences > Settings) and uncheck the Maximus box. This keeps the system from maximizing windows, which would interfere with your use of the ControllerGUI.
  • Go to Preferences > Power Management and 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.
  • Go to Accessories > Terminal to get a shell window. Select Edit > Profile Preferences > Colors, and choose white on black; this is the most readable option for Tekkotsu error messages. Also click on the Scrolling tab and select 5000 lines of scrollback.

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

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

6. Reboot the machine. Hold down the F2 key during boot to enter the Setup dialog in the BIOS. Move to the Advanced tab, select Onboard Devices Configuration, then select Onboard Camera and set it to Enabled. Press F10 to save and exit.

7. Connect to your wireless network, or plug the ASUS into an Ethernet port and establish network access.

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

sudo -s
apt-get update
apt-get remove ubiquity
apt-get install libpng12-dev libjpeg-dev libreadline-dev libxml2-dev
apt-get install sox libasound2-dev
apt-get install cvs g++ gdb sun-java6-jdk openssh-server
apt-get clean
apt-get autoremove
perl -MCPAN -e "install Parse::RecDescent"   (Hit Enter repeatedly to accept all offered defaults)

9. Now install and build Tekkotsu:

cd /usr/local
cvs -d checkout -P Tekkotsu
cd /usr/local/Tekkotsu/project
su user
cp -rp /usr/local/Tekkotsu/project /home/user

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