blob: b0f4cef599e49077147d76dfdca1f04d4c2f8c72 [file] [log] [blame]
Robert Hak40bafc52002-08-21 10:19:23 +00001 __________ __ ___.
2 Open \______ \ ____ ____ | | _\_ |__ _______ ___
3 Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
4 Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
5 Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
6 \/ \/ \/ \/ \/
7
Daniel Stenberg5059ce52002-11-29 10:21:55 +00008Build your own archos.mod (or ajbrec.ajz)
Robert Hak40bafc52002-08-21 10:19:23 +00009
Linus Nielsen Feltzing7912a6d2002-11-11 10:09:26 +0000101. Check out 'firmware', 'apps', 'docs' and 'tools' from CVS (or possibly from
11 a downloaded archive). You may possibly want 'uisimulator' too (for trying
12 out things on host before making target tests).
Robert Hak40bafc52002-08-21 10:19:23 +000013
Robert Hak5f84df92002-08-21 10:22:49 +000014 If you do want to play with the simulator, read UISIMULATOR.
15
Robert Hak40bafc52002-08-21 10:19:23 +0000162. Build the tools by running 'make' in the tools/ directory.
17
183. Create your own build directory, preferably in the same directory as the
19 firmware/ and apps/ directories. This is where all generated files will be
20 put.
21
224. In your build directory, run the 'tools/configure' script and enter what
23 target you want to build for and if you want a debug version or not. It'll
24 prompt you. The debug version is for making a gdb version out of it. It is
25 only useful if you run gdb towards your target Archos.
26
Daniel Stenberg5059ce52002-11-29 10:21:55 +0000275. *ploink*. Now you have got a Makefile generated for you.
Robert Hak40bafc52002-08-21 10:19:23 +000028
Daniel Stenberg5059ce52002-11-29 10:21:55 +0000296. Make sure you have sh-elf-gcc and siblings in the PATH. Make sure that you
30 have 'perl' in your PATH too.
Robert Hak40bafc52002-08-21 10:19:23 +000031
Daniel Stenberg5059ce52002-11-29 10:21:55 +0000327. Run 'make' and soon the necessary pieces from the firmware and the apps
33 directories have been compiled, linked and scrambled for you.
34
358. Copy the archos.mod/ajbrec.ajz file to your archos, reboot it and *smile*.
36 Recent Rockbox versions need no reboots, just PLAY a new rockbox version
37 and that'll be loaded and replace the currently running version.
Robert Hak40bafc52002-08-21 10:19:23 +000038
39Whenever the tools/configure script gets updated, you can make your makefile
40updated too by running 'tools/configure update'
41
42If you want to build for more than one target, just create a new build
43directory and create a setup for another target combination in there.
44
45Questions anyone? Take them to the mailing list. We'll be happy to help you
46out!
47
48
49
50