Rockbox
Find a file
Dominik Riebeling 45cda1fdcc Fix version handling for patchers.
The working directory will usually be different than the one libtools.make is
located in, so make sure to use the correct starting folder for the relative
path.

Change-Id: I9a84a0573c9f1f32601f31587425689dcf8fb81f
2013-01-01 15:06:40 +01:00
android Fix .apk signs when using OpenJDK7 (Android builds) 2012-11-30 11:39:35 +01:00
apps Revert 64d048be. It breaks h300. 2012-12-26 18:01:19 +01:00
backdrops cabbiev2 for rk27xx generic design target 2012-07-09 20:30:43 +02:00
bootloader Another optimization for the OF in the mi4 format. 2012-11-24 22:33:09 +01:00
debian Prepare new, unofficial maemo release 2012-12-26 19:59:29 +01:00
docs Add Richard Quirk to credits. 2012-10-03 17:34:23 +02:00
firmware iPod6G (Classic) - enable HAVE_DISK_STORAGE 2012-12-29 21:25:57 +01:00
flash Add KEEP() around vectors in linker scripts. 2011-12-18 06:43:08 +00:00
fonts Remove superfluous executable bits on a bunch of files. 2011-06-08 14:22:03 +00:00
gdb Generate C file / header for svn version string 2010-05-27 09:41:46 +00:00
icons wpsbuild: Rewrite to fix various issues and support .fms 2012-06-10 21:20:36 +02:00
lib Fix FS#12794 - new EQ code does not compile for the Nokia N8x0 2012-12-28 14:12:18 -05:00
manual [Fuze+] imageviewer: update/complete keymaps 2012-12-26 17:30:54 +01:00
packaging Pandora port: Prepare unofficial release 2012-12-26 01:00:29 +01:00
rbutil Fix version handling for patchers. 2013-01-01 15:06:40 +01:00
tools android: Undo accidental switch to asm threads. 2012-11-07 23:32:58 +01:00
uisimulator Fix building the iPod 6G UI sim by reusing the iPod Video bitmap. 2012-11-25 22:54:06 +01:00
utils imxtools/sbtools: improve sb1 key handling 2012-12-26 01:17:28 +01:00
wps fix typo 2012-12-04 18:49:29 +11:00
.gitattributes Add a gitattributes file for the migration. 2011-12-01 14:14:59 +00:00
.gitignore Add *.o and *.a to .gitignore 2012-05-16 11:26:22 +02:00

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

Build Your Own Rockbox

1. Check out 'rockbox' from SVN (or extract a downloaded archive).

   $ svn co svn://svn.rockbox.org/rockbox/trunk rockbox

     or

   $ tar xjf rockbox.tar.bz2

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

3. Make sure you have sh/arm/m68k-elf-gcc and siblings in the PATH. Make sure
   that you have 'perl' in your PATH too. Your gcc cross compiler needs to be
   a particular version depending on what player you are compiling for. These
   can be acquired with the rockboxdev.sh script in the /tools/ folder of the
   source, or will have been included if you've installed one of the
   toolchains or development environments provided at http://www.rockbox.org/

   $ which sh-elf-gcc
   $ which perl

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. Run 'make' and soon the necessary pieces from the firmware and the apps
   directories have been compiled, linked and scrambled for you.

   $ make
   $ make zip

7. unzip the rockbox.zip on your music player, reboot it and
   *smile*.

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!