| Daniel Stenberg | 6220437 | 2002-05-06 07:10:57 +0000 | [diff] [blame] | 1 | __________ __ ___. |
| 2 | Open \______ \ ____ ____ | | _\_ |__ _______ ___ |
| 3 | Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ / |
| 4 | Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < < |
| 5 | Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \ |
| 6 | \/ \/ \/ \/ \/ |
| 7 | |
| 8 | HACKING ROCKBOX |
| 9 | |
| 10 | Terminology |
| 11 | |
| 12 | The hardware is mainly separated in two different versions. The "Player" is |
| 13 | the Archos Jukebox Player 6000 and Archos Studio 20, while the "Recorder" is |
| 14 | the Archos Recorder 20. The "Player" has a character-based LCD screen with 2 |
| 15 | lines of 11 letters and a big round thing on the keypad (featuring 6 |
| 16 | different keys), while the "Recorder" has a graphical LCD and has all its 10 |
| 17 | keys separate. |
| 18 | |
| 19 | 1. Get Sources |
| 20 | |
| Daniel Stenberg | a895626 | 2002-05-31 07:48:30 +0000 | [diff] [blame^] | 21 | The the very latest sources off the CVS server. Get the 'tools' dir, |
| 22 | 'firmware' dir, the 'apps' dir and the 'uisimulator' dir on the same dir |
| 23 | level, to make it easier to build things (some of the files assume this |
| 24 | hierarchy). |
| Daniel Stenberg | 6220437 | 2002-05-06 07:10:57 +0000 | [diff] [blame] | 25 | |
| 26 | All CVS details can be found here: http://bjorn.haxx.se/rockbox/cvs.html |
| 27 | |
| 28 | 2. Build Uisimulator |
| 29 | |
| Daniel Stenberg | a895626 | 2002-05-31 07:48:30 +0000 | [diff] [blame^] | 30 | For the X11 simulator: |
| Daniel Stenberg | 6220437 | 2002-05-06 07:10:57 +0000 | [diff] [blame] | 31 | |
| Daniel Stenberg | a895626 | 2002-05-31 07:48:30 +0000 | [diff] [blame^] | 32 | (This has been compiled and run on at least Solaris and Linux. It should |
| 33 | work on other unixes too but we haven't tried any other yet.) |
| 34 | |
| 35 | Create a new directory and run the 'tools/configure' |
| 36 | script. Select target to simulate and select simulation. The script will |
| 37 | then generate a Makefile for you. |
| 38 | |
| 39 | Run 'make'. |
| 40 | |
| 41 | For the Win32 simulator: |
| 42 | |
| 43 | No info yet. |
| Daniel Stenberg | 6220437 | 2002-05-06 07:10:57 +0000 | [diff] [blame] | 44 | |
| 45 | 3. Run Uisimulator |
| 46 | |
| 47 | To create a simulated disk drive for the simulator to see, create a |
| 48 | subdirectory named 'archos' and populate it with a bunch of test |
| 49 | files/directories. |
| 50 | |
| 51 | Run 'rockboxui'. |
| 52 | |
| 53 | 4. Target Keypad Equivalents |
| 54 | |
| 55 | The keyboard's numerical keypad is used to simulate the Archos keypads: |
| 56 | |
| 57 | Keyboard Generic Archos |
| 58 | -------- -------------- |
| 59 | + ON |
| 60 | 8 UP |
| 61 | 2 DOWN |
| 62 | 4 LEFT |
| 63 | 6 RIGHT |
| 64 | |
| 65 | Keyboard Recorder-only |
| 66 | -------- -------------- |
| 67 | Enter OFF |
| 68 | 5 PLAY |
| 69 | / F1 |
| 70 | * F2 |
| 71 | - F3 |
| 72 | |
| 73 | Keyboard Player-only |
| 74 | -------- -------------- |
| Daniel Stenberg | dd07852 | 2002-05-30 06:40:57 +0000 | [diff] [blame] | 75 | Enter MENU |
| 76 | 6 PLAY (there's no separation between PLAY and RIGHT) |