rockbox

Rockbox

Find a file

Paul Louden ad97b0437f Allow use of either A or Select to pause in mpegplayer. This means you can pause it the same way you pause music, but I've not removed the old button since mpegplayer currently has plenty of buttons, and not many functions. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@15734 a1c6a512-1295-4272-9138-f99709370657		2007-11-21 05:49:00 +00:00
apps	Allow use of either A or Select to pause in mpegplayer. This means you	2007-11-21 05:49:00 +00:00
bootloader	* dont compile audio codec drivers for bootloader, as we dont need them -> saves time	2007-11-20 12:09:59 +00:00
docs	Fix for Nano timing issues, should resolve crashes, data aborts, and	2007-11-20 01:46:18 +00:00
firmware	make private functions static	2007-11-20 23:11:12 +00:00
flash	Include some more stuff in the tarballs.	2007-09-04 21:53:33 +00:00
fonts	improve spacing for some glyphs	2007-11-19 13:18:19 +00:00
gdb	Include some more stuff in the tarballs.	2007-09-04 21:53:33 +00:00
manual	Manual typo fix	2007-11-20 07:38:16 +00:00
rbutil	Bump version for release.	2007-11-20 23:37:22 +00:00
tools	Make voice.pl gentalkclips() work for SAPI.	2007-11-19 23:24:27 +00:00
uisimulator	fix fs#8131 - if --debugwps is used with the sim, the mouse coordinates will be displayed in the console when it is clicked	2007-11-11 01:50:18 +00:00
utils	Document how to use tcctool in Windows, and include the appropriate .inf file for use with the libusb-win32 device driver	2007-11-10 20:26:54 +00:00
wps	Add greyscales to Rockboxed theme and mimic the color variant a bit more.	2007-09-29 19:05:30 +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*.

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!