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-02-20 21:01:57 +00:00
|
|
|
1. Check out 'rockbox' from CVS (or possibly from a downloaded archive). You
|
|
|
|
|
may possibly want to check out 'rockbox-devel' instead, since that includes
|
|
|
|
|
the simulator code (for trying out things on host before making target
|
|
|
|
|
tests).
|
2002-08-21 10:19:23 +00:00
|
|
|
|
2002-08-21 10:22:49 +00:00
|
|
|
If you do want to play with the simulator, read UISIMULATOR.
|
|
|
|
|
|
2002-08-21 10:19:23 +00:00
|
|
|
2. Build the tools by running 'make' in the tools/ directory.
|
|
|
|
|
|
|
|
|
|
3. Create your own build directory, preferably in the same directory as the
|
|
|
|
|
firmware/ and apps/ directories. This is where all generated files will be
|
|
|
|
|
put.
|
|
|
|
|
|
|
|
|
|
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-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
|
|
|
|
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-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
|
|
|
|
|
|
|
|
Whenever the tools/configure script gets updated, you can make your makefile
|
|
|
|
|
updated too by running 'tools/configure update'
|
|
|
|
|
|
|
|
|
|
If you want to build for more than one target, just create a new build
|
|
|
|
|
directory and create a setup for another target combination in there.
|
|
|
|
|
|
|
|
|
|
Questions anyone? Take them to the mailing list. We'll be happy to help you
|
|
|
|
|
out!
|
