rockbox/docs
Daniel Stenberg d3f4c362b3 "Rockbox From A Technical Angle", take 1
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@2457 a1c6a512-1295-4272-9138-f99709370657
2002-10-01 08:20:33 +00:00
..
API initial move from other directories 2002-08-21 10:19:23 +00:00
BATTERY-FAQ official answer from tech support for battery replacing & warranty question. 2002-09-06 05:42:23 +00:00
CONTRIBUTING header added 2002-08-21 10:29:58 +00:00
COPYING initial move from other directories 2002-08-21 10:19:23 +00:00
CREDITS *friends* 2002-09-30 19:10:40 +00:00
CUSTOM_EQ_FORMAT Added documentation for Custom EQ 2002-09-06 06:20:15 +00:00
CUSTOM_WPS_FORMAT Philip Pertermanns peak meter 2002-09-27 09:31:31 +00:00
FAQ Added question about shuffle 2002-09-18 09:25:55 +00:00
FILES Update for the custom eq doc 2002-09-06 06:19:31 +00:00
README added reference to UISIMULATOR 2002-08-21 10:22:49 +00:00
TECH "Rockbox From A Technical Angle", take 1 2002-10-01 08:20:33 +00:00
UISIMULATOR *** empty log message *** 2002-08-21 10:31:10 +00:00

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

Build your own archos.mod.

1. Check out 'firmware', 'apps' and 'tools' from CVS (or possibly from a
   downloaded archive). You may possibly want 'uisimulator' too (for trying
   out things on host before making target tests).  If you haven't already
   done so, we advise you pull down the 'docs' directory as well.

   If you do want to play with the simulator, read UISIMULATOR.

2. Build the tools by running 'make' in the tools/ directory.

3. Create your own build directory, preferably in the same directory as the
   firmware/ and apps/ directories. This is where all generated files will be
   put.

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. 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.

5. Make sure you have sh-elf-gcc and siblings in the PATH.

6. *ploink*. Now you have got a Makefile generated for you. Run 'make' and
   soon the necessary pieces from the firmware and the apps directories have
   been compiled and linked.

7. Copy the archos.mod file to your archos, 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 a new build
directory and create a setup for another target combination in there.

Questions anyone? Take them to the mailing list. We'll be happy to help you
out!