| 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 | |
| Robert Hak | 4c53939 | 2002-08-21 10:23:10 +0000 | [diff] [blame] | 10 | 1. Get Sources |
| 11 | |
| Daniel Stenberg | d49cf31 | 2007-06-06 20:31:36 +0000 | [diff] [blame] | 12 | Get the very latest sources off the SVN server (or possibly get a recent |
| Daniel Stenberg | 7c38564 | 2007-04-09 21:07:12 +0000 | [diff] [blame] | 13 | source code tarball). |
| Robert Hak | 4c53939 | 2002-08-21 10:23:10 +0000 | [diff] [blame] | 14 | |
| Daniel Stenberg | 7c38564 | 2007-04-09 21:07:12 +0000 | [diff] [blame] | 15 | All SVN details can be found here: |
| 16 | http://www.rockbox.org/twiki/bin/view/Main/UsingSVN |
| Robert Hak | 4c53939 | 2002-08-21 10:23:10 +0000 | [diff] [blame] | 17 | |
| 18 | 2. Build Uisimulator |
| 19 | |
| Robert Hak | 4c53939 | 2002-08-21 10:23:10 +0000 | [diff] [blame] | 20 | 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 | |
| Bertrik Sikken | c9d000d | 2009-01-18 19:30:28 +0000 | [diff] [blame] | 30 | [ Makefile created, simdisk subdirectory created ] |
| Robert Hak | 4c53939 | 2002-08-21 10:23:10 +0000 | [diff] [blame] | 31 | |
| 32 | $ make |
| Jonas Häggqvist | 80324d1 | 2005-06-26 22:47:19 +0000 | [diff] [blame] | 33 | $ make install |
| Robert Hak | 4c53939 | 2002-08-21 10:23:10 +0000 | [diff] [blame] | 34 | $ ./rockboxui |
| 35 | |
| Bertrik Sikken | c9d000d | 2009-01-18 19:30:28 +0000 | [diff] [blame] | 36 | Note that the simulator uses a local subdirectory named 'simdisk' as "root |
| Robert Hak | 4c53939 | 2002-08-21 10:23:10 +0000 | [diff] [blame] | 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 Hak | 4c53939 | 2002-08-21 10:23:10 +0000 | [diff] [blame] | 41 | 3. Run Uisimulator |
| 42 | |
| 43 | To create a simulated disk drive for the simulator to see, create a |
| Bertrik Sikken | c9d000d | 2009-01-18 19:30:28 +0000 | [diff] [blame] | 44 | subdirectory named 'simdisk' and populate it with a bunch of test |
| Robert Hak | 4c53939 | 2002-08-21 10:23:10 +0000 | [diff] [blame] | 45 | files/directories. |
| 46 | |
| 47 | Run 'rockboxui'. |
| 48 | |
| 49 | 4. Target Keypad Equivalents |
| 50 | |
| Daniel Stenberg | 7c38564 | 2007-04-09 21:07:12 +0000 | [diff] [blame] | 51 | The keyboard's numerical keypad is used to simulate the target keypad. See |
| 52 | the output rockboxui displays on start for details. |
| Frank Gevaerts | f615fb4 | 2010-02-16 17:34:48 +0000 | [diff] [blame] | 53 | |
| 54 | 5. Mouse Input |
| 55 | |
| 56 | Clicking on the button images on the background will simulate pressing the |
| 57 | appropriate buttons. On scroll wheel targts the mouse wheel will simulate |
| 58 | scroll wheel motion. |
| 59 | |