foxbox

Fork of rockbox tailored for ipod classic

Find a file

Dominik Riebeling 48832cd20a Change font encoding to T1. Some characters used by the manual can't be represented by the default font encoding OT1 used by LaTeX. Switching the font encoding to T1 fixes this, and makes the manuals build again. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@26578 a1c6a512-1295-4272-9138-f99709370657		2010-06-05 13:55:36 +00:00
apps	remove old text viewer plugin (viewer.rock).	2010-06-05 12:09:10 +00:00
backdrops	Remove svn:executable	2009-12-11 14:50:57 +00:00
bootloader	Update Samsung YP-S3 bootloader demo	2010-05-30 21:43:14 +00:00
docs	FS#11353 - Fix all errors in islenska.lang by Hinrik Örn Sigurðsson	2010-06-04 20:39:00 +00:00
firmware	Implement backlight brightness for iPod G4 greyscale and iPod Color/Photo.	2010-06-05 11:48:12 +00:00
flash	Generate C file / header for svn version string	2010-05-27 09:41:46 +00:00
fonts	Make the 8 in 35-Nimbus slightly more balanced	2010-06-04 19:45:14 +00:00
gdb	Generate C file / header for svn version string	2010-05-27 09:41:46 +00:00
icons	Revert hotkey bitmaps	2010-05-07 14:46:42 +00:00
manual	Change font encoding to T1.	2010-06-05 13:55:36 +00:00
rbutil	rbutil: add mpio hd200 as disabled target (all untested)	2010-06-04 21:43:15 +00:00
tools	Improve error handling.	2010-06-05 08:58:30 +00:00
uisimulator	Generate C file / header for svn version string	2010-05-27 09:41:46 +00:00
utils	Theme Editor: Basic save-as functionality working, but only invoked when a tab is closed	2010-06-05 08:40:27 +00:00
wps	cabbiev2 128x64x1 wps (iriver remote wps): add more info to the screen	2010-06-03 09:22:00 +00:00

docs/README

               __________               __   ___.
     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!