blob: 822a872bdef07cfc9aa9163670b39adf3a030a19 [file] [log] [blame]
Robert Hak4c539392002-08-21 10:23:10 +00001 __________ __ ___.
2 Open \______ \ ____ ____ | | _\_ |__ _______ ___
3 Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
4 Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
5 Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
6 \/ \/ \/ \/ \/
Robert Hakaf250932002-08-21 10:31:10 +00007
8 How to build the UISimulators
Robert Hak4c539392002-08-21 10:23:10 +00009
Robert Hak4c539392002-08-21 10:23:10 +0000101. Get Sources
11
Daniel Stenbergd49cf312007-06-06 20:31:36 +000012 Get the very latest sources off the SVN server (or possibly get a recent
Daniel Stenberg7c385642007-04-09 21:07:12 +000013 source code tarball).
Robert Hak4c539392002-08-21 10:23:10 +000014
Daniel Stenberg7c385642007-04-09 21:07:12 +000015 All SVN details can be found here:
16 http://www.rockbox.org/twiki/bin/view/Main/UsingSVN
Robert Hak4c539392002-08-21 10:23:10 +000017
182. Build Uisimulator
19
Robert Hak4c539392002-08-21 10:23:10 +000020 Create a new directory and run the 'tools/configure' script in
21 there. Select target to simulate and select simulation. The script will
22 then generate a Makefile for you:
23
24 $ mkdir build-dir
25 $ cd build-dir
26 $ ../tools/configure
27
28 [ answer to questions ]
29
30 [ Makefile created, archos subdirectory created ]
31
32 $ make
Jonas Häggqvist80324d12005-06-26 22:47:19 +000033 $ make install
Robert Hak4c539392002-08-21 10:23:10 +000034 $ ./rockboxui
35
36 Note that the simulator uses a local subdirectory named 'archos' as "root
37 directory" for the simulated box. Copy a bunch of mp3 files into that
38 directory, create subdirectories and do all sorts of things you want to be
39 able to browse when you fire up the simulator.
40
Robert Hak4c539392002-08-21 10:23:10 +0000413. Run Uisimulator
42
43 To create a simulated disk drive for the simulator to see, create a
44 subdirectory named 'archos' and populate it with a bunch of test
45 files/directories.
46
47 Run 'rockboxui'.
48
494. Target Keypad Equivalents
50
Daniel Stenberg7c385642007-04-09 21:07:12 +000051 The keyboard's numerical keypad is used to simulate the target keypad. See
52 the output rockboxui displays on start for details.