···11+ __________ __ ___.
22+ Open \______ \ ____ ____ | | _\_ |__ _______ ___
33+ Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
44+ Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
55+ Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
66+ \/ \/ \/ \/ \/
77+88+ HACKING ROCKBOX
99+1010+Terminology
1111+1212+ The hardware is mainly separated in two different versions. The "Player" is
1313+ the Archos Jukebox Player 6000 and Archos Studio 20, while the "Recorder" is
1414+ the Archos Recorder 20. The "Player" has a character-based LCD screen with 2
1515+ lines of 11 letters and a big round thing on the keypad (featuring 6
1616+ different keys), while the "Recorder" has a graphical LCD and has all its 10
1717+ keys separate.
1818+1919+1. Get Sources
2020+2121+ The the very latest sources off the CVS server. Get the 'tools' dir,
2222+ 'firmware' dir, the 'apps' dir and the 'uisimulator' dir on the same dir
2323+ level, to make it easier to build things (some of the files assume this
2424+ hierarchy).
2525+2626+ All CVS details can be found here: http://bjorn.haxx.se/rockbox/cvs.html
2727+2828+2. Build Uisimulator
2929+3030+ For the X11 simulator:
3131+3232+ (This has been compiled and run on at least Solaris and Linux. It should
3333+ work on other unixes too but we haven't tried any other yet.)
3434+3535+ Create a new directory and run the 'tools/configure' script in
3636+ there. Select target to simulate and select simulation. The script will
3737+ then generate a Makefile for you:
3838+3939+ $ mkdir build-dir
4040+ $ cd build-dir
4141+ $ ../tools/configure
4242+4343+ [ answer to questions ]
4444+4545+ [ Makefile created, archos subdirectory created ]
4646+4747+ $ make
4848+ $ ./rockboxui
4949+5050+ Note that the simulator uses a local subdirectory named 'archos' as "root
5151+ directory" for the simulated box. Copy a bunch of mp3 files into that
5252+ directory, create subdirectories and do all sorts of things you want to be
5353+ able to browse when you fire up the simulator.
5454+5555+5656+ For the Win32 simulator:
5757+5858+ No info yet.
5959+6060+3. Run Uisimulator
6161+6262+ To create a simulated disk drive for the simulator to see, create a
6363+ subdirectory named 'archos' and populate it with a bunch of test
6464+ files/directories.
6565+6666+ Run 'rockboxui'.
6767+6868+4. Target Keypad Equivalents
6969+7070+ The keyboard's numerical keypad is used to simulate the Archos keypads:
7171+7272+ Keyboard Generic Archos
7373+ -------- --------------
7474+ + ON
7575+ 8 UP
7676+ 2 DOWN
7777+ 4 LEFT
7878+ 6 RIGHT
7979+8080+ Keyboard Recorder-only
8181+ -------- --------------
8282+ Enter OFF
8383+ 5 PLAY
8484+ / F1
8585+ * F2
8686+ - F3
8787+8888+ Keyboard Player-only
8989+ -------- --------------
9090+ Enter MENU
9191+ 6 PLAY (there's no separation between PLAY and RIGHT)