View source for HOWTO Setup GumStix Buildroot on an existing (X)Ubuntu System

=The Easy Route=

If you want to get things going as fast as possible, the best way to do this is to use the <code>build_myphone.sh</code> script from the downloads section of the web site. You can always find the latest version of the build_myphone.sh script for (X)Ubuntu systems at:

http://hbmobile.org/downloads/XU_CURRENT/build_myphone.sh

This script downloads all the packages required to build the GumStix Linux system, then adds support for DirectFB, libpng, libjpeg, freetype, sftp and ppp over <code>/dev/ttyS0</code> (the middle serial port on the ConsoleLCD.) Then in an orgastic explosion of compilation, it builds everything. If everything goes well, you're left with three files in the <code>~/Projects</code> directory:

* u-boot.bin
* rootfs.arm_nofpu.jffs2
* uImage

These are the files you'll need to reflash your myPhone. More information about reflashing can be found at the [[HOWTO Reflash the GumStix Verdex]] page.

Note that the current version of (X)Ubuntu we support is 7.10, and the script in the XU_CURRENT directory has been tested with this Linux distro. Users of other Linux distros may have some success with it, but your mileage may definitely vary.

==Check your /etc/apt/sources.list before running the script==

As a test, I installed Xubuntu 7.10 on a very old laptop that did not have a built in WiFi chipset (remember the days before WiFi?) I'm happy to say the install went well, but it took me a few minutes to realize... if you install on a machine that does not have a working network adapter ''when you do the install'', it will disable network software updates by commenting out various lines in the <code>/etc/apt/sources.list</code> file.

If you have reason  to believe your network adapter was deactivated when you installed, you may want to check this file out. This file is supposed to look something like this:<blockquote><code><pre>####################################
### Official Ubuntu Repositories ###
####################################

# Gutsy Final Release Repository
deb http://archive.ubuntu.com/ubuntu gutsy main restricted universe multiverse
#deb-src http://archive.ubuntu.com/ubuntu gutsy main restricted universe multiverse

# Gutsy Security Updates
deb http://security.ubuntu.com/ubuntu gutsy-security main restricted universe multiverse
#deb-src http://security.ubuntu.com/ubuntu gutsy-security main restricted universe multiverse

# Gutsy Bugfix Updates
deb http://archive.ubuntu.com/ubuntu gutsy-updates main restricted universe multiverse
#deb-src http://archive.ubuntu.com/ubuntu gutsy-updates main restricted universe multiverse

# Gutsy Backports (new software versions, provided by the Ubuntu Backports Project)
deb http://archive.ubuntu.com/ubuntu gutsy-backports main restricted universe multiverse
#deb-src http://archive.ubuntu.com/ubuntu gutsy-backports main restricted universe multiverse

# Ubuntu Commercial
deb http://archive.canonical.com/ubuntu gutsy partner
#deb-src http://archive.canonical.com/ubuntu gutsy partner</pre></code></blockquote>

If the lines that start with "deb" are commented out... well... that's bad. To fix the situation, use <code>vi</code> or your favorite editor to remove the comments from the front of the "deb" lines and run the command:<blockquote><code>sudo apt-get update</code></blockquote>

The disk will spin, the lights will blink and you should see the <code>apt-get</code> tool updating its database of software packages.

==Okay, Run the Script Already==

To run the script, you can use the following shell commands:<blockquote><code>wget http://hbmobile.org/downloads/XU_CURRENT/build_myphone.sh<br/>chmod 755 build_myphone.sh<br/>./build_myphone.sh</code></blockquote>

=The Less Easy Route=

<blockquote><em>"Two roads diverged in a wood<br/>
And I took the one less traveled by<br/>
And that has made all the difference"<br/></em>
-- Robert Frost, <em>Road Less Travelled</em></blockquote>

So if you're reading this far, it likely means there was a problem with the <code>build_myphone.sh</code> script; or maybe you're just the kind of person who likes to know what scripts executing on your machine (sometimes with root permissions) are doing. Here's what's going on:

==Use apt-get to Install Required Packages==

The command<blockquote><code>sudo apt-get install build-essential libncurses5-dev bison flex texinfo zlib1g-dev gettext libssl-dev libc6-dev make g++ gcc automake1.9 subversion libpng12-dev libjpeg62-dev libfreetype6-dev pkg-config fbset libdbus-1-dev libdbus-glib-1-2 libdbus-glib-1-dev libglib-2.0-dev lrzsz mtd-tools</code></blockquote>downloads the packages required on (X)Ubuntu to make sure things build right.

==Add Soft Links for bash and zcat==

For reasons unknown to mortals, the ascended (X)Ubuntu masters chose to make <code>/bin/sh</code> a soft link to <code>/bin/dash</code>. As we all know, this is an affront to the great work of the secret cabal of bash shell programmers. Or something. But seriously, some of the packages referenced in the GumStix buildroot fail in mysterious ways if <code>/bin/sh</code> is soft linked to <code>/bin/bash</code>. The fix is to make <code>/bin/sh</code> a link to <code>/bin/bash</code>.

Also, it seems that some of the packages assume that the command <code>gzcat</code> will be found somewhere on the system. But... the (X)Ubuntu default is to leave <code>gzcat</code> fans wanting.

The following commands change things around so this isn't an issue:<blockquote><code>cd /bin<br/>sudo rm sh<br/>sudo ln -s bash sh<br/>sudo ln -s zcat gzcat<br/></code></blockquote>