[edit] Building from scratch

If you don't understand what the following commands do exactly, don't just blindly follow them. And you should check KnownIssues first to save some time later.

[edit] Installing Scratchbox

wget http://scratchbox.org/download/files/sbox-releases/apophis/tarball/scratchbox-core-1.0.17-i386.tar.gz
tar xzf scratchbox-core-1.0.17-i386.tar.gz
wget http://scratchbox.org/download/files/sbox-releases/apophis/tarball/scratchbox-libs-1.0.17-i386.tar.gz
tar xzf scratchbox-libs-1.0.17-i386.tar.gz
wget http://scratchbox.org/download/files/sbox-releases/apophis/tarball/scratchbox-toolchain-host-gcc-1.0.17-i386.tar.gz
tar xzf scratchbox-toolchain-host-gcc-1.0.17-i386.tar.gz
wget http://scratchbox.org/download/files/sbox-releases/apophis/tarball/scratchbox-devkit-doctools-1.0.13-i386.tar.gz
tar xzf scratchbox-devkit-doctools-1.0.13-i386.tar.gz
wget http://scratchbox.org/download/files/sbox-releases/apophis/tarball/scratchbox-devkit-git-1.0.1-i386.tar.gz
tar xzf scratchbox-devkit-git-1.0.1-i386.tar.gz
wget http://scratchbox.org/download/files/sbox-releases/apophis/tarball/scratchbox-devkit-qemu-0.10.0-0sb10-i386.tar.gz
tar xzf scratchbox-devkit-qemu-0.10.0-0sb10-i386.tar.gz
wget http://scratchbox.org/download/files/sbox-releases/apophis/tarball/scratchbox-devkit-perl-1.0.4-i386.tar.gz
tar xzf scratchbox-devkit-perl-1.0.4-i386.tar.gz
wget http://scratchbox.org/download/files/sbox-releases/apophis/tarball/scratchbox-devkit-mtd-1.0.2-i386.tar.gz
tar xzf scratchbox-devkit-mtd-1.0.2-i386.tar.gz
wget http://scratchbox.org/download/files/sbox-releases/apophis/tarball/scratchbox-toolchain-arm-linux-cs2009q3-67-1.0.14-1-i386.tar.gz
tar xzf scratchbox-toolchain-arm-linux-cs2009q3-67-1.0.14-1-i386.tar.gz

# as root (press "enter" at all questions, replace <user> with your Linux username):
./scratchbox/run_me_first.sh
./scratchbox/sbin/sbox_adduser <user>

[edit] Adding a Scratchbox target

# as normal user (relogin or "newgrp sbox" might be required for getting the right group permissions)
./scratchbox/login

sb-conf setup Matrix_arm \
     --compiler=arm-linux-cs2009q3-67 --devkits=qemu:doctools:git:perl:mtd \
     --cputransp=qemu-arm-sb

sb-conf select Matrix_arm
sb-conf install --devkits --etc --cruntime

[edit] Setting up Matrix for all targets

# Run these inside the Scratchbox (replace the email address and name in the commands with your own ones).

git config --global user.email firstname.lastname@domain.com
git config --global user.name "Firstname Lastname"

wget http://sandbox.movial.com/files/matrix/matrix-1.3.tar.gz
tar xzf matrix-1.3.tar.gz
cd matrix-1.3
python setup.py install --prefix=/host_usr
cd ..

[edit] Building the platform

If you want to add multimedia codecs to the build, check 3rd party codecs page before running the install command.

Run these inside the Scratchbox. The -c<board name> option will build the platform for the specified board listed in the configdirs file. If it is omitted a generic ARMv5 build is made.

git clone git://linux.onarm.com/git/alip-project.git
cd alip-project
matrix install -j2 -J2 -cbeagleboard

fakeroot matrix-rootfs -cbeagleboard

To create a build for a generic board without any board specific components, omit any -c options and select the board in local file before running the install command:

echo 'UseBoard("armvXXXX")' >> local

If something doesn't work, you should check KnownIssues ! You can also build and run the Hello-world project to check Scratchbox and the toolchain were correctly installed on your machine (See the instructions on SB tutorial)