Find a file
Thomas Martitz 6e882b43b6 put_line(): Do not lock up if the scroll engine runs out of lines.
Allocate MAX_LINES+1 because at the time get_line_desc() is called
the scroll engine did not yet determine that it ran out of lines
(because puts_scroll_func() wasn't called yet. Therefore we can
run out of lines before setting the used field. By allocating
one item more we can survive that point and set used to false
if the scroll engine runs out of lines.

Change-Id: I7a9af1bce256c6e07d254f096bd5865fa7cf2cee
2014-01-12 12:12:13 +01:00
android android: Rewrite PCM playback without OnPlaybackPositionUpdateListener. 2013-04-01 11:26:12 +02:00
apps put_line(): Do not lock up if the scroll engine runs out of lines. 2014-01-12 12:12:13 +01:00
backdrops cabbiev2 for rk27xx generic design target 2012-07-09 20:30:43 +02:00
bootloader Add missing kernel.h includes (hopefully all of them). 2014-01-05 20:32:09 +01:00
debian Prepare new maemo release 2013-03-10 12:12:38 +01:00
docs lcd-common/scroll_engine: Remove unused functions lcd_puts_scroll_style(). 2014-01-07 14:13:48 +01:00
firmware Fix remote warnings and charcell reds, and remove minor left-over tuff. 2014-01-12 01:50:21 +01:00
flash Make fixepoint.c as a shared library (libfixedpoint.a). 2013-04-26 00:11:04 +02: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 Proposed fix for FS#12878: Zero-length embedded album art prevents mp3 playback 2013-12-23 17:55:15 +01:00
manual DSP Compressor: Sidechain, Exponential Atk/Rls 2013-12-15 22:24:08 +01:00
packaging Prepare unofficial pandora release 2013-03-10 14:09:30 +01:00
rbutil Bump Rockbox Utility version to 1.4.0. 2014-01-05 21:44:28 +01:00
tools creativezenv: change target_id & MODEL_NUMBER. 2014-01-02 13:35:05 +01:00
uisimulator zenmozaic: add keymap and bitmap for simulator 2013-11-08 13:57:21 +00:00
utils adfuload: add atj213x timer0 test program 2014-01-08 08:56:09 +01:00
wps Fix cabbie WPS for black&white targets (m:robe 100) 2013-12-17 21:35:05 +01: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. Clone 'rockbox' from git (or extract a downloaded archive).

   $ git clone git://git.rockbox.org/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!