rockbox/docs
Björn Stenberg 7347025780 The examples should not be wrong :-)
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@3281 a1c6a512-1295-4272-9138-f99709370657
2003-02-17 09:57:00 +00:00
..
API initial move from other directories 2002-08-21 10:19:23 +00:00
BATTERY-FAQ added 'battery level flickers\!' question 2003-01-15 14:53:15 +00:00
CHARGING_ALGORITHM LiIon Link 2003-01-26 17:19:31 +00:00
CONTRIBUTING corrected patch info 2002-10-12 08:37:54 +00:00
COPYING initial move from other directories 2002-08-21 10:19:23 +00:00
CREDITS Matthew P. OReilly added for his GREAT donatation: an FM Recorder 20 given 2003-02-15 17:26:46 +00:00
CUSTOM_CFG_FORMAT The examples should not be wrong :-) 2003-02-17 09:57:00 +00:00
CUSTOM_WPS_FORMAT Added info about /.rockbox filename length limit. 2003-02-09 11:19:07 +00:00
FAQ set contrast on recorder blindly 2003-01-27 08:19:40 +00:00
FILES added the NODO document 2003-01-16 16:06:31 +00:00
NODO fix language 2003-01-16 16:29:29 +00:00
README mention perl, the recorder image name and that you can ROLO the new version 2002-11-29 10:21:55 +00:00
TECH Some more tech info 2002-10-30 23:39:37 +00:00
UISIMULATOR *** empty log message *** 2002-08-21 10:31:10 +00:00

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

Build your own archos.mod (or ajbrec.ajz)

1. Check out 'firmware', 'apps', 'docs' 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 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. *ploink*. Now you have got a Makefile generated for you. 

6. Make sure you have sh-elf-gcc and siblings in the PATH. Make sure that you
   have 'perl' in your PATH too.

7. Run 'make' and soon the necessary pieces from the firmware and the apps
   directories have been compiled, linked and scrambled for you.

8. Copy the archos.mod/ajbrec.ajz file to your archos, reboot it and *smile*.
   Recent Rockbox versions need no reboots, just PLAY a new rockbox version
   and that'll be loaded and replace the currently running version.

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!