foxbox

Fork of rockbox tailored for ipod classic

Find a file

Andrew Mahone 23d9812273 loader-initialized global plugin API: struct plugin_api *rb is declared in PLUGIN_HEADER, and pointed to by __header.api the loader uses this pointer to initialize rb before calling entry_point entry_point is no longer passed a pointer to the plugin API all plugins, and pluginlib functions, are modified to refer to the global rb pluginlib functions which only served to copy the API pointer are removed git-svn-id: svn://svn.rockbox.org/rockbox/trunk@19776 a1c6a512-1295-4272-9138-f99709370657		2009-01-16 10:34:40 +00:00
apps	loader-initialized global plugin API:	2009-01-16 10:34:40 +00:00
backdrops	kill the release script and build tarball from everything in SVN...	2008-03-26 13:12:07 +00:00
bootloader	Dual boot for the Philips HDD1630.	2009-01-10 03:21:07 +00:00
docs	remove align_buffer from firmare/general.c, replacing with ALIGN_BUFFER macro, and replace all uses of it (only resize.c in core, and pictureflow and mpegplayer plugins), remove it from plugin_api,	2009-01-13 13:48:26 +00:00
firmware	SD driver cleanup by Thomas Martitz. Removes various magic numbers in favor of defines, increases a timeout in hopes of improving support for various SD cards, adds descriptive panic messages, and adds volatile were needed.	2009-01-16 01:14:58 +00:00
flash	Simplify powermgmt thread loops so it calls functions turn (no more power_thread_sleep). Do other target-friendly simplifications, generic battery switch handling and split sim-specific code. Whoever can, please verify charging on the Archos Recorder (due to change in the charger duty cycle code).	2008-12-24 16:58:41 +00:00
fonts	revert my previous commit since 5.1.20080820 was already committed in r18342 with some useless glyphs removed	2008-10-20 10:39:07 +00:00
gdb	Updated our source code header to explicitly mention that we are GPL v2 or	2008-06-28 18:10:04 +00:00
icons	kill the release script and build tarball from everything in SVN...	2008-03-26 13:12:07 +00:00
manual	More fixes for blind descriptions: fix a small bug in the H10 manuals,	2009-01-14 11:50:45 +00:00
rbutil	Add some more bootloader install progress messages and call processEvents() more often before performing player disk accesses.	2009-01-08 17:16:53 +00:00
tools	Don't rerun configure automatically, just inform that you should do it.	2009-01-10 22:36:41 +00:00
uisimulator	Red build fix.	2009-01-10 21:38:56 +00:00
utils	Remove executable property that somehow got set	2009-01-04 01:39:57 +00:00
wps	Accept FS#9579 by Bartosz Fabianowski, fixing make zip when your build dir is not inside the source tree	2008-11-26 09:36:34 +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!