===============================================================================
 phoneME-GP2X-SDL version 1.0.0 - 15/07/2008 by -zaxxon-
===============================================================================

Questo porting è basato sul rilascio ufficiale di phoneME Feature della Sun:
https://phoneme.dev.java.net/

Rispetto ai sorgenti ufficiali, il porting per GP2X (linux-arm) utilizza le 
librerie SDL per implementare grafica, audio e input.

Per la configurazione dei tasti e del orientamento del display vengono 
utilizzate le seguenti variabili d'ambiente della shell:

J2ME_GP2X_JOYU   - Joystick UP
J2ME_GP2X_JOYUL  - Joystick UP-LEFT
J2ME_GP2X_JOYL   - Joystick LEFT
J2ME_GP2X_JOYDL  - Joystick DOWN-LEFT
J2ME_GP2X_JOYD   - Joystick DOWN
J2ME_GP2X_JOYDR  - Joystick DOWN-RIGHT
J2ME_GP2X_JOYR   - Joystick RIGHT
J2ME_GP2X_JOYUR  - Joystick UP-RIGHT
J2ME_GP2X_JOYC   - Joystick CENTER (PRESS)
J2ME_GP2X_START  - Button START
J2ME_GP2X_SELECT - Button SELECT
J2ME_GP2X_LEFT   - Button LEFT
J2ME_GP2X_RIGHT  - Button RIGHT
J2ME_GP2X_BUTA   - Button A
J2ME_GP2X_BUTB   - Button B
J2ME_GP2X_BUTX   - Button X
J2ME_GP2X_BUTY   - Button Y
J2ME_GP2X_VOLU   - Button VOLUME+
J2ME_GP2X_VOLD   - Button VOLUME-

J2ME_GP2X_REVERSE - Reverse Display Orientation (Any Value).

Per l'orientamento del display si può usare qualsiasi valore, basta che la 
variabile J2ME_GP2X_REVERSE venga definita (usare unset J2ME_GP2X_REVERSE per
essere sicuri che l'orientamento sia quello normale).

Per la definizione dei tasti i valori, definiti nei file include del progetto,
sono i seguenti:

KEYMAP_KEY_BACKSPACE    = 8
KEYMAP_KEY_POUND        = 35
KEYMAP_KEY_ASTERISK     = 42
KEYMAP_KEY_0            = 48
KEYMAP_KEY_1            = 49
KEYMAP_KEY_2            = 50
KEYMAP_KEY_3            = 51
KEYMAP_KEY_4            = 52
KEYMAP_KEY_5            = 53
KEYMAP_KEY_6            = 54
KEYMAP_KEY_7            = 55
KEYMAP_KEY_8            = 56
KEYMAP_KEY_9            = 57
KEYMAP_KEY_SPACE        = 32
KEYMAP_KEY_UP           = -1
KEYMAP_KEY_DOWN         = -2
KEYMAP_KEY_LEFT         = -3
KEYMAP_KEY_RIGHT        = -4
KEYMAP_KEY_SELECT       = -5
KEYMAP_KEY_SOFT1        = -6
KEYMAP_KEY_SOFT2        = -7
KEYMAP_KEY_CLEAR        = -8
KEYMAP_KEY_SEND         = -10
KEYMAP_KEY_END          = -11
KEYMAP_KEY_POWER        = -12 
KEYMAP_KEY_GAMEA        = -13
KEYMAP_KEY_GAMEB        = -14
KEYMAP_KEY_GAMEC        = -15
KEYMAP_KEY_GAMED        = -16
KEYMAP_KEY_GAME_UP      = -17
KEYMAP_KEY_GAME_DOWN    = -18
KEYMAP_KEY_GAME_LEFT    = -19
KEYMAP_KEY_GAME_RIGHT   = -20

Come si può notare i valori negativi hanno significati particolari, mentre 
quelli positivi sono i valori ASCII dei rispettivi tasti, è quindi possibile
usare anche i codici dei caratteri alfabetici, anche se probabilmente nessun
gioco per cellulari li usa (forse per inserire i nomi dei record).

Il programma attualmente implementa i profili CLDC 1.1 e MIDP 2.1 più una
parziale implementazione della Mobile Media API (JSR 135).
In particolare della mmapi sono implementati i player MIDI (con relativo
VolumeControl) e ToneSequence (con il relativo ToneControl) oltre al metodo
Manager.playTone().

Il progetto è nato per portare la suite J2ME su dispositivi mobili, per cui
implementa internamente il database delle MIDlet installate. Di conseguenza
non si può eseguire direttamente una MIDlet partendo dal file .jar, bensì
bisogna prima installarla nella suite.

Per installare una MIDlet bisogna usare il comando:

installMidlet <nome del file .jar>

Se tutto funziona, viene restituito il codice ID numerico da usare poi per
lanciare la MIDlet con il comando:

runMidlet <ID numerico>

Per rimuovere una MIDlet dal database usare il comando:

removeMidlet <ID numerico>

Infine per conoscere i nomi e ID di tutte le MIDlet installate, si usa il
comando

listMidlet

Il programma si aspetta di trovare le cartelle phoneME e midi nella root
della SD. Gli eseguibili si trovano in phoneME/bin/arm.

Il programma, per suonare i file MIDI, utilizza i sorgenti della libreria
Timidity (http://timidity.sourceforge.net/) nella versione inclusa nei 
sorgenti della libreria SDL_sound (http://icculus.org/SDL_sound/) il path
di ricerca del file di configurazione è stato modificato in modo da 
includere la directory /mnt/sd/midi così da poter avere il file sulla SD.

Si ringraziano ovviamente gli autori della libreria! :D

I comandi vanno eseguiti dalla shell, ma ovviamente questo è scomodo sulla
console; conviene quindi costruirsi degli script .gpe per installare ed 
eseguire le varie MIDlet.

Ad esempio per installare la MIDlet contenuta nel file Game.jar possiamo
creare un file Install_Game.gpe con il seguente contenuto:

unset J2ME_GP2X_REVERSE
cd /mnt/sd/phoneME/bin/arm
./installMidlet ../../Game.jar > ../../Game.txt
sync
cd /usr/gp2x
exec ./gp2xmenu

il quale suppone che il file Game.jar si trovi in /mnt/sd/phoneME.
Dopo averlo eseguito, con il lettore di eBook andiamo a leggere il file
di testo /mnt/sd/phoneME/Game.txt e vi troveremo scritto il codice ID
numerico della MIDlet.

Per eseguire la MIDlet faremo uno script Game.gpe di questo tipo:

export J2ME_GP2X_JOYU=50
export J2ME_GP2X_JOYUL=49
export J2ME_GP2X_JOYL=52
export J2ME_GP2X_JOYDL=55
export J2ME_GP2X_JOYD=56
export J2ME_GP2X_JOYDR=57
export J2ME_GP2X_JOYR=54
export J2ME_GP2X_JOYUR=51
export J2ME_GP2X_JOYC=53
export J2ME_GP2X_START=-7
export J2ME_GP2X_SELECT=-6
export J2ME_GP2X_LEFT=42
export J2ME_GP2X_RIGHT=35
export J2ME_GP2X_BUTA=53
export J2ME_GP2X_BUTB=48
export J2ME_GP2X_BUTX=-6
export J2ME_GP2X_BUTY=-7
export J2ME_GP2X_VOLU=-5
export J2ME_GP2X_VOLD=-6
unset J2ME_GP2X_REVERSE
cd /mnt/sd/phoneME/bin/arm
./runMidlet 2
sync
cd /usr/gp2x
exec ./gp2xmenu

Dove il numero 2 indicato dopo ./runMidlet è il numero del ID numerico
letto nel file Game.txt.

Per chi volesse compilare i sorgenti, deve seguire le seguenti istruzioni:

1) Scaricare i sorgenti originali dalla Sun da qui 
   http://download.java.net/mobileembedded/phoneme/feature/phoneme_feature-mr2-rel-src-b23-08_may-2007.zip

2) Creare nella vostra home directory una nuova cartella chiamata "phoneME".

3) Copiare i sorgenti dentro a phoneME e scompattarli, si crea una cartella "phoneme_feature".

4) Copiare la patch phoneME-GP2X-SDL-1.0.0.patch allegata nella cartella phoneME.

5) Entrare in "phoneME" e dare il comando patch -p1 <phoneME-GP2X-SDL-1.0.0.patch

7) Rendere eseguibile lo script "compile.sh" con il comando chmod a+x compile.sh

8) Eseguire lo script con ./compile.sh

9) Attendere fiduciosi con le dita incrociate... ;)

10) Al termine le uniche cartelle che serve copiare sulla console sono
    ~/phoneME/phoneme_feature/build_output/midp/appdb
    ~/phoneME/phoneme_feature/build_output/midp/bin
    ~/phoneME/phoneme_feature/build_output/midp/lib

Per ulteriori info utilizzate il forum http://www.gp2xita.com/community/



                                                                    -zaxxon-

