Rockbox
Find a file
Dave Chapman 45895df35d Initial CVS commit ofipodpatcher - v0.2 release from 16 Jan 2006
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@11744 a1c6a512-1295-4272-9138-f99709370657
2006-12-13 08:57:06 +00:00
apps Free more plugin memory 2006-12-13 06:52:10 +00:00
bootloader Remove unused code in (and hence simplify) the ipod bootloader - the image header parsing and memmove isn't used in Rockbox, it was just leftover from the original ipodlinux loader. Note that we still need the empty space in the bootloader (400 bytes starting at 0x100 - the 'boot_table' definition in firmware/target/arm/crt0-pp.S) to maintain compatibility with ipod_fw/make_fw (which will write information there that we have always ignored). 2006-12-10 13:33:12 +00:00
CVSROOT rbutil 2006-12-11 22:37:04 +00:00
docs Add Chinese Simplified Language by Ye Wei 2006-12-11 13:13:07 +00:00
firmware Some fixes and additions to sscanf - Still has bugs but it works for doom currently. As a note: this function is only used by doom to my knowledge. 2006-12-13 04:55:48 +00:00
flash Bootbox now needs target includes. 2006-11-27 02:34:22 +00:00
fonts some minor changes and add support for greek 2006-09-01 13:50:13 +00:00
gdb Adapted more Makefiles to the more efficient info printing. 2006-10-30 01:40:20 +00:00
manual Add the GPL to the manual. Some changes to the license section and also to the GFDL to better fit in our manual (in style, not content) 2006-12-07 20:47:39 +00:00
rbutil Unix targets require a second (mode) parameter to wxMkdir. rbutil now compiles cleanly for me on Linux with the just-released wxWidgets 2.8.0 2006-12-12 16:01:27 +00:00
songdbj javazoom converter, not the tritonus one.. 2005-07-11 15:43:44 +00:00
tools Initial CVS commit ofipodpatcher - v0.2 release from 16 Jan 2006 2006-12-13 08:57:06 +00:00
uisimulator Removed the Gmini 120 and Gmini SP code. These ports are dead, unfortunately. 2006-11-10 20:26:01 +00:00
wps Last part of iCatcher and UniCatcher updates... add Sansa versions 2006-12-08 17:55:56 +00:00
www the showlog script 2006-10-29 09:28:51 +00:00

               __________               __   ___.
     Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
     Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
     Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
     Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
                       \/            \/     \/    \/            \/

Build Your Own Rockbox

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).

   (For more information about the simulator, read UISIMULATOR.)

   $ cvs -d:pserver:anonymous@www.rockbox.org:/cvsroot/rockbox login 
   $ cvs -z3 -d:pserver:anonymous@www.rockbox.org:/cvsroot/rockbox co rockbox

     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

4. In your build directory, run the 'tools/configure' script and enter what
   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.

   $ ../tools/configure

5. *ploink*. Now you have got a Makefile generated for you.

6. Make sure you have sh-elf-gcc and siblings in the PATH. Make sure that you
   have 'perl' in your PATH too.

   $ which sh-elf-gcc
   $ which perl

7. Run 'make' and soon the necessary pieces from the firmware and the apps
   directories have been compiled, linked and scrambled for you.

   $ make

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.

   $ mount /dev/sda1 /mnt/archos
   $ cp ajbrec.ajz /mnt/archos
   $ umount /mnt/archos

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 several build
directories and create a setup for each target:

   $ mkdir build-fmrecorder
   $ cd build-fmrecorder
   $ ../tools/configure

   $ mkdir build-player
   $ cd build-player
   $ ../tools/configure

Questions anyone? Ask on the mailing list. We'll be happy to help you!