rockbox/docs/UISIMULATOR
Solomon Peachy 2434b6ca25 misc: Remove all 'twiki' references in favor of up-to-date 'wiki' links.
(This migration happened over a decade ago!)

Change-Id: Ib396414a16f2d763e549af49e3f3b03047dab49c
2020-06-07 01:38:55 +00:00

59 lines
1.9 KiB
Text

__________ __ ___.
Open \______ \ ____ ____ | | _\_ |__ _______ ___
Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
\/ \/ \/ \/ \/
How to build the UISimulators
1. Get Sources
Get the very latest sources off the SVN server (or possibly get a recent
source code tarball).
All SVN details can be found here:
http://www.rockbox.org/wiki/UsingSVN
2. Build Uisimulator
Create a new directory and run the 'tools/configure' script in
there. Select target to simulate and select simulation. The script will
then generate a Makefile for you:
$ mkdir build-dir
$ cd build-dir
$ ../tools/configure
[ answer to questions ]
[ Makefile created, simdisk subdirectory created ]
$ make
$ make install
$ ./rockboxui
Note that the simulator uses a local subdirectory named 'simdisk' as "root
directory" for the simulated box. Copy a bunch of mp3 files into that
directory, create subdirectories and do all sorts of things you want to be
able to browse when you fire up the simulator.
3. Run Uisimulator
To create a simulated disk drive for the simulator to see, create a
subdirectory named 'simdisk' and populate it with a bunch of test
files/directories.
Run 'rockboxui'.
4. Target Keypad Equivalents
The keyboard's numerical keypad is used to simulate the target keypad. See
the output rockboxui displays on start for details.
5. Mouse Input
Clicking on the button images on the background will simulate pressing the
appropriate buttons. On scroll wheel targts the mouse wheel will simulate
scroll wheel motion.