Gitiles
Code Review Sign In
gerrit.rockbox.org / rockbox / 4b3501f2f6ad19b6422561f94926cc90fecfa0bd / . / uisimulator / HACKING
blob: ae5fd61275e351bb3a4b70ff4a9cfbbae1c88584 [file] [log] [blame]
Daniel Stenberg62204372002-05-06 07:10:57 +0000[diff] [blame]1 __________ __ ___.
2 Open \______ \ ____ ____ | | _\_ |__ _______ ___
3 Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
4 Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
5 Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
6 \/ \/ \/ \/ \/
7
8 HACKING ROCKBOX
9
10Terminology
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
191. Get Sources
20
Daniel Stenberga8956262002-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 Stenberg62204372002-05-06 07:10:57 +0000[diff] [blame]25
Daniel Stenberg829a6e22004-09-15 08:47:11 +0000[diff] [blame]26 All CVS details can be found here:
27 http://rockbox.haxx.se/twiki/bin/view/Main/UsingCVS
Daniel Stenberg62204372002-05-06 07:10:57 +0000[diff] [blame]28
292. Build Uisimulator
30
Daniel Stenberga8956262002-05-31 07:48:30 +0000[diff] [blame]31 For the X11 simulator:
Daniel Stenberg62204372002-05-06 07:10:57 +0000[diff] [blame]32
Daniel Stenberga8956262002-05-31 07:48:30 +0000[diff] [blame]33 (This has been compiled and run on at least Solaris and Linux. It should
34 work on other unixes too but we haven't tried any other yet.)
35
Daniel Stenberge2f91962002-06-04 20:06:40 +0000[diff] [blame]36 Create a new directory and run the 'tools/configure' script in
37 there. Select target to simulate and select simulation. The script will
38 then generate a Makefile for you:
Daniel Stenberga8956262002-05-31 07:48:30 +0000[diff] [blame]39
Daniel Stenberge2f91962002-06-04 20:06:40 +0000[diff] [blame]40 $ mkdir build-dir
41 $ cd build-dir
42 $ ../tools/configure
43
44 [ answer to questions ]
45
46 [ Makefile created, archos subdirectory created ]
47
48 $ make
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
Daniel Stenberga8956262002-05-31 07:48:30 +0000[diff] [blame]56
57 For the Win32 simulator:
58
59 No info yet.
Daniel Stenberg62204372002-05-06 07:10:57 +0000[diff] [blame]60
613. 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
694. 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 -------- --------------
Daniel Stenbergdd078522002-05-30 06:40:57 +0000[diff] [blame]91 Enter MENU
92 6 PLAY (there's no separation between PLAY and RIGHT)