Robert Hak | 4c53939 | 2002-08-21 10:23:10 +0000 | [diff] [blame] | 1 | __________ __ ___. |
| 2 | Open \______ \ ____ ____ | | _\_ |__ _______ ___ |
| 3 | Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ / |
| 4 | Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < < |
| 5 | Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \ |
| 6 | \/ \/ \/ \/ \/ |
Robert Hak | af25093 | 2002-08-21 10:31:10 +0000 | [diff] [blame] | 7 | |
| 8 | How to build the UISimulators |
Robert Hak | 4c53939 | 2002-08-21 10:23:10 +0000 | [diff] [blame] | 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 | |
| 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). |
| 25 | |
Björn Stenberg | ef8217d | 2003-07-10 14:05:59 +0000 | [diff] [blame] | 26 | All CVS details can be found here: http://rockbox.haxx.se/cvs.html |
Robert Hak | 4c53939 | 2002-08-21 10:23:10 +0000 | [diff] [blame] | 27 | |
| 28 | 2. Build Uisimulator |
| 29 | |
| 30 | For the X11 simulator: |
| 31 | |
| 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' script in |
| 36 | there. Select target to simulate and select simulation. The script will |
| 37 | then generate a Makefile for you: |
| 38 | |
| 39 | $ mkdir build-dir |
| 40 | $ cd build-dir |
| 41 | $ ../tools/configure |
| 42 | |
| 43 | [ answer to questions ] |
| 44 | |
| 45 | [ Makefile created, archos subdirectory created ] |
| 46 | |
| 47 | $ make |
Jonas Häggqvist | 80324d1 | 2005-06-26 22:47:19 +0000 | [diff] [blame] | 48 | $ make install |
Robert Hak | 4c53939 | 2002-08-21 10:23:10 +0000 | [diff] [blame] | 49 | $ ./rockboxui |
| 50 | |
| 51 | Note that the simulator uses a local subdirectory named 'archos' as "root |
| 52 | directory" for the simulated box. Copy a bunch of mp3 files into that |
| 53 | directory, create subdirectories and do all sorts of things you want to be |
| 54 | able to browse when you fire up the simulator. |
| 55 | |
| 56 | |
| 57 | For the Win32 simulator: |
| 58 | |
| 59 | No info yet. |
| 60 | |
| 61 | 3. Run Uisimulator |
| 62 | |
| 63 | To create a simulated disk drive for the simulator to see, create a |
| 64 | subdirectory named 'archos' and populate it with a bunch of test |
| 65 | files/directories. |
| 66 | |
| 67 | Run 'rockboxui'. |
| 68 | |
| 69 | 4. Target Keypad Equivalents |
| 70 | |
| 71 | The keyboard's numerical keypad is used to simulate the Archos keypads: |
| 72 | |
| 73 | Keyboard Generic Archos |
| 74 | -------- -------------- |
| 75 | + ON |
| 76 | 8 UP |
| 77 | 2 DOWN |
| 78 | 4 LEFT |
| 79 | 6 RIGHT |
| 80 | |
| 81 | Keyboard Recorder-only |
| 82 | -------- -------------- |
| 83 | Enter OFF |
| 84 | 5 PLAY |
| 85 | / F1 |
| 86 | * F2 |
| 87 | - F3 |
| 88 | |
| 89 | Keyboard Player-only |
| 90 | -------- -------------- |
| 91 | Enter MENU |
| 92 | 6 PLAY (there's no separation between PLAY and RIGHT) |