2002-08-21 10:19:23 +00:00
|
|
|
__________ __ ___.
|
|
|
|
Open \______ \ ____ ____ | | _\_ |__ _______ ___
|
|
|
|
Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
|
|
|
|
Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
|
|
|
|
Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
|
|
|
|
\/ \/ \/ \/ \/
|
|
|
|
|
2003-02-20 21:01:57 +00:00
|
|
|
Build Your Own Rockbox
|
2002-08-21 10:19:23 +00:00
|
|
|
|
2003-07-10 11:52:42 +00:00
|
|
|
1. Check out 'rockbox' from CVS (or extract a downloaded archive). You
|
|
|
|
want to check out 'rockbox-devel' instead if you want the simulator
|
|
|
|
code too (for trying out things on host before making target tests).
|
2002-08-21 10:19:23 +00:00
|
|
|
|
2003-07-10 11:52:42 +00:00
|
|
|
(For more information about the simulator, read UISIMULATOR.)
|
2002-08-21 10:22:49 +00:00
|
|
|
|
2003-07-10 11:52:42 +00:00
|
|
|
$ cvs -d:pserver:anonymous@cvs.rockbox.sourceforge.net:/cvsroot/rockbox login
|
|
|
|
$ cvs -z3 -d:pserver:anonymous@cvs.rockbox.sourceforge.net:/cvsroot/rockbox co rockbox
|
2002-08-21 10:19:23 +00:00
|
|
|
|
2003-07-10 11:52:42 +00:00
|
|
|
or
|
|
|
|
|
|
|
|
$ tar xzf rockbox.tar.gz
|
|
|
|
|
|
|
|
2. Create a build directory, preferably in the same directory as the firmware/
|
|
|
|
and apps/ directories. This is where all generated files will be written.
|
|
|
|
|
|
|
|
$ cd rockbox
|
|
|
|
$ mkdir build
|
|
|
|
$ cd build
|
2002-08-21 10:19:23 +00:00
|
|
|
|
|
|
|
4. In your build directory, run the 'tools/configure' script and enter what
|
2003-02-20 21:01:57 +00:00
|
|
|
target you want to build for and if you want a debug version or not (and a
|
|
|
|
few more questions). It'll prompt you. The debug version is for making a
|
|
|
|
gdb version out of it. It is only useful if you run gdb towards your target
|
|
|
|
Archos.
|
2002-08-21 10:19:23 +00:00
|
|
|
|
2003-07-10 11:52:42 +00:00
|
|
|
$ ../tools/configure
|
|
|
|
|
2003-02-20 21:01:57 +00:00
|
|
|
5. *ploink*. Now you have got a Makefile generated for you.
|
2002-08-21 10:19:23 +00:00
|
|
|
|
2002-11-29 10:21:55 +00:00
|
|
|
6. Make sure you have sh-elf-gcc and siblings in the PATH. Make sure that you
|
|
|
|
have 'perl' in your PATH too.
|
2002-08-21 10:19:23 +00:00
|
|
|
|
2003-07-10 11:52:42 +00:00
|
|
|
$ which sh-elf-gcc
|
|
|
|
$ which perl
|
|
|
|
|
2002-11-29 10:21:55 +00:00
|
|
|
7. Run 'make' and soon the necessary pieces from the firmware and the apps
|
|
|
|
directories have been compiled, linked and scrambled for you.
|
|
|
|
|
2003-07-10 11:52:42 +00:00
|
|
|
$ make
|
|
|
|
|
2003-02-20 21:01:57 +00:00
|
|
|
8. Copy the archos.mod or ajbrec.ajz file to your archos, reboot it and
|
|
|
|
*smile*. Recent Rockbox versions need no reboots, just PLAY a new rockbox
|
|
|
|
version and that'll be loaded and replace the currently running version.
|
2002-08-21 10:19:23 +00:00
|
|
|
|
2003-07-10 11:52:42 +00:00
|
|
|
$ mount /dev/sda1 /mnt/archos
|
|
|
|
$ cp ajbrec.ajz /mnt/archos
|
|
|
|
$ umount /mnt/archos
|
|
|
|
|
2002-08-21 10:19:23 +00:00
|
|
|
Whenever the tools/configure script gets updated, you can make your makefile
|
2003-07-10 11:52:42 +00:00
|
|
|
updated too by running 'tools/configure update'.
|
|
|
|
|
|
|
|
If you want to build for more than one target, just create several build
|
|
|
|
directories and create a setup for each target:
|
|
|
|
|
|
|
|
$ mkdir build-fmrecorder
|
|
|
|
$ cd build-fmrecorder
|
|
|
|
$ ../tools/configure
|
2002-08-21 10:19:23 +00:00
|
|
|
|
2003-07-10 11:52:42 +00:00
|
|
|
$ mkdir build-player
|
|
|
|
$ cd build-player
|
|
|
|
$ ../tools/configure
|
2002-08-21 10:19:23 +00:00
|
|
|
|
2003-07-10 11:52:42 +00:00
|
|
|
Questions anyone? Ask on the mailing list. We'll be happy to help you!
|