| Robert Hak | 40bafc5 | 2002-08-21 10:19:23 +0000 | [diff] [blame] | 1 | __________ __ ___. |
| 2 | Open \______ \ ____ ____ | | _\_ |__ _______ ___ |
| 3 | Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ / |
| 4 | Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < < |
| 5 | Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \ |
| 6 | \/ \/ \/ \/ \/ |
| 7 | |
| Daniel Stenberg | e083a1d | 2003-02-20 21:01:57 +0000 | [diff] [blame^] | 8 | Build Your Own Rockbox |
| Robert Hak | 40bafc5 | 2002-08-21 10:19:23 +0000 | [diff] [blame] | 9 | |
| Daniel Stenberg | e083a1d | 2003-02-20 21:01:57 +0000 | [diff] [blame^] | 10 | 1. Check out 'rockbox' from CVS (or possibly from a downloaded archive). You |
| 11 | may possibly want to check out 'rockbox-devel' instead, since that includes |
| 12 | the simulator code (for trying out things on host before making target |
| 13 | tests). |
| Robert Hak | 40bafc5 | 2002-08-21 10:19:23 +0000 | [diff] [blame] | 14 | |
| Robert Hak | 5f84df9 | 2002-08-21 10:22:49 +0000 | [diff] [blame] | 15 | If you do want to play with the simulator, read UISIMULATOR. |
| 16 | |
| Robert Hak | 40bafc5 | 2002-08-21 10:19:23 +0000 | [diff] [blame] | 17 | 2. Build the tools by running 'make' in the tools/ directory. |
| 18 | |
| 19 | 3. Create your own build directory, preferably in the same directory as the |
| 20 | firmware/ and apps/ directories. This is where all generated files will be |
| 21 | put. |
| 22 | |
| 23 | 4. In your build directory, run the 'tools/configure' script and enter what |
| Daniel Stenberg | e083a1d | 2003-02-20 21:01:57 +0000 | [diff] [blame^] | 24 | target you want to build for and if you want a debug version or not (and a |
| 25 | few more questions). It'll prompt you. The debug version is for making a |
| 26 | gdb version out of it. It is only useful if you run gdb towards your target |
| 27 | Archos. |
| Robert Hak | 40bafc5 | 2002-08-21 10:19:23 +0000 | [diff] [blame] | 28 | |
| Daniel Stenberg | e083a1d | 2003-02-20 21:01:57 +0000 | [diff] [blame^] | 29 | 5. *ploink*. Now you have got a Makefile generated for you. |
| Robert Hak | 40bafc5 | 2002-08-21 10:19:23 +0000 | [diff] [blame] | 30 | |
| Daniel Stenberg | 5059ce5 | 2002-11-29 10:21:55 +0000 | [diff] [blame] | 31 | 6. Make sure you have sh-elf-gcc and siblings in the PATH. Make sure that you |
| 32 | have 'perl' in your PATH too. |
| Robert Hak | 40bafc5 | 2002-08-21 10:19:23 +0000 | [diff] [blame] | 33 | |
| Daniel Stenberg | 5059ce5 | 2002-11-29 10:21:55 +0000 | [diff] [blame] | 34 | 7. Run 'make' and soon the necessary pieces from the firmware and the apps |
| 35 | directories have been compiled, linked and scrambled for you. |
| 36 | |
| Daniel Stenberg | e083a1d | 2003-02-20 21:01:57 +0000 | [diff] [blame^] | 37 | 8. Copy the archos.mod or ajbrec.ajz file to your archos, reboot it and |
| 38 | *smile*. Recent Rockbox versions need no reboots, just PLAY a new rockbox |
| 39 | version and that'll be loaded and replace the currently running version. |
| Robert Hak | 40bafc5 | 2002-08-21 10:19:23 +0000 | [diff] [blame] | 40 | |
| 41 | Whenever the tools/configure script gets updated, you can make your makefile |
| 42 | updated too by running 'tools/configure update' |
| 43 | |
| 44 | If you want to build for more than one target, just create a new build |
| 45 | directory and create a setup for another target combination in there. |
| 46 | |
| 47 | Questions anyone? Take them to the mailing list. We'll be happy to help you |
| 48 | out! |