———
Changelog
———

Additional documentation
————————

* See Readme.txt for user tips and general project information.
* See BUILDING.TXT for notes on building this software.

———————————————————————–
Change log for release version 0.5.5 (relative to 0.5.4 final release)
———————————————————————–
- MP3 support.
- AMS UI enhancement.
- Improved i18n support.
- Truetype font bug fixes.
- Network optimization. Resolve the randomly network drop issue.
- Fix platformRequest and HttpInstaller problem, now can handle HTTP 302 response.
- Enlarge HTTP buffer for better downloading speed.
- Graphics optimization.
- Some minor bug fixes (Please refer to SVN log)

———————————————
Changes for 0.5.5 Test 3 (relative to Test 2)
———————————————

* MP3 support adds seeking support, time display, wider
compatibility with varied stream formats, support for ID3 V2 tags.
* Made forms (including AMS) ‘loop’ top to bottom/bottom to top when
scrolling past the end; merged MR4 code.
* Made lists (including wifi selector) ‘loop’ top to bottom/bottom to
top when scrolling past the end; merged MR4 code.
* Redrew Unicode page 03 (Greek) for the built-in font entirely by
hand–glyphs now match general pitch and appearance of Latin, Cyrillic.
Added accented vowels, terminal sigma; completes modern Greek support
in built-in font.
* Added Unicode pages 21-26, 30-33, f9-fa, fe-ff to built-in
font from old CJK-ordered tables–lost in previous builds due to
various changes.
* Made system folder closed at startup.
* Made all menus and submenus ‘loop’ top to bottom/bottom to top when
scrolling past the end.

———————————————
Changes for 0.5.5 Test 2 (relative to Test 1)
———————————————

* Initial MP3 (JSR 135 Multimedia API) implementation added. This is a
MediaEngine (hardware-based) implementation–very fast, and easy on your
processor. It is for file-based playback only as of this release (no
streaming from the net as yet), and has the following known limitations:
there are no shuttle controls or volume control, metadata reading is not
yet supported, and backgrounded playback, while functional, will break
your network connection.

* Added a ‘mark all contents’ command to AMS folders

—————————————————-
Changes for 0.5.5 Test 1 (relative to 0.5.4 release)
—————————————————-

* Fix for disappearing built-in font on sleep/wake

* Accelerations to built-in font handling–eliminated uni2cjk run-time
mapping and much iterative hunting in lookup code

Sorry for delay of 0.5.1. I know there was couple of serious bugs in 0.5.0, it should have come earlier. But anyway, finally it’s here. No exciting new features, but some important bug fixes, some of them had already existed in 0.4.x:

- Enable input symbol in password textfield
- Fix OSK bug
- Fix drawRGB alpha blending bug
- Fix a couple of bug inside VM interpreter

Thanks for your constantly support, enjoy ^_^

Download from SF.net:

https://sourceforge.net/project/showfiles.php?group_id=217400&package_id=262057&release_id=664748

M@x

http://www.pspkvm.com

http://www.pspkvm.cn

Project home on SF:

https://sourceforge.net/projects/pspkvm

——————————–
Change log
——————————–
- Completely new designed Virtual Keyboard (Great thanks to Anweifeng, who is the designer and coder of new Virtual Keyboard)
- Support JSR226(SVG) and JSR172(Web Service)
- Optimized interpreter loop of VM, JB2 score improves 25%
- Bug fix and improvement in networking
- Support user defined Truetype font size by pspkvm.ini
- Add CPU speed setting in “Select device” menu

——————————–
General information
——————————–
This software is a PSP porting of SUN open-source JavaME implementation: phoneMEFeature. The words below is copied from phoneME’s website to describe the project:

The objective of the phoneME project is to further expand the usage of Java? Platform, Micro Edition (Java ME platform) technology in the mobile handset market. The project scope includes a focus on the mainstream feature phone segment with phoneME Feature software, and the emerging advanced phone segment with phoneME Advanced software. Our goal in making these technologies available to the Mobile & Embedded Community is to reduce implementation variation, increase the rate of innovation and enable new devices to leverage the power of the Java ME platform.

You can also refer to the original website from here: https://phoneme.dev.java.net/

The goal of pspkvm is porting phoneMEFeature to Sony PSP game console. If you’re seeking for phoneMEAdvanced porting on PSP, please take a look at the other project here: https://sourceforge.net/projects/pspme

——————————–
Fetures
——————————–
- Nokia UI APIs (partial)
- WMA1.1(JSR120) stub
- Networking (By PSP’s WIFI)
- Java AMS with MVM supporting
- Several input methods: QWERTY/Abc/Symbol/…
- Directly browse and run from local jad/jar file, and auto-install without interrupting
- Jpeg support
- MIDI & Wave audio playback support
- Device emulation. You can choose device type to emulate for different screen sizes and key codes, either at installation time or from “Select device” menu
- Change default key assignment for specific application.
- JSR75(File Connection)
- Virtual Keyboard Input
- Chinese Input
- JSR179(GPS)
- FreeType2 font support
- JSR 226(SVG)
- JSR 172(Web Service)

——————————–
TODO
——————————–
- Graphic optimization (High)
- JSR184 (Low)
- MIPS JIT compiler and Interpreter generator (Low)

——————————–
Bugs and known issues
——————————–
Known issues:
- Not running on 5.02 Gen-A firmware
- javacall_file_truncate doesn’t ported, so some file truncating operation, such as some RMS operations, may not work as expected
- Multimedia temporary files may leave on your memory stick sometimes, especially after VM crash. They’re usually not big, but if you wanna delete the by hands, just goto your PSP’s /PSP/GAME/pspkvm/ directory, find the file whose name likes xxxxxxxx_tmp_mus.mid, delete them.
- Fileconnection rmdir operation may fail for unknown reasons
- LocationProvider.getState() will always returns AVAILABLE once after GPS initialized, so LocationListener.providerStateChanged() doesn’t work as expected.

——————————–
Run from binary bundle
——————————–
1. Download correct binary bundle:
- If you have a 1.50 kernel PSP and have installed pspkvm 0.4.2:
Download pspkvm-bin-x.x.x-150-upgrade.zip
- If you want to run pspkvm on 3.xx OE and have installed pspkvm 0.4.2:
Download pspkvm-bin-x.x.x-OE-upgrade.zip
- If you have a 1.50 kernel PSP and haven’t installed pspkvm 0.4.2:
Download pspkvm-bin-x.x.x-150-allinone.zip
- If you want to run pspkvm on 3.xx OE and haven’t installed pspkvm 0.4.2:
Download pspkvm-bin-x.x.x-OE-allinone.zip
2. Extract the zip to PSP’s /PSP/GAME/ or /PSP/GAME150
3. Here we go!

——————————–
Building instructions
——————————–
For the ones who are interested in our source code:
0. You have to prepare the building enviroment for phoneME at first. Please refer the document from here: https://phoneme.dev.java.net/content/mr2/buildenv_feature.html#win_setup

Now assume you have installed the building environment by following the above instruction. In Cygwin:
1. Grab the source code from svn to a local directory
2. cd ${your_source_dir}
3. export JDK_DIR=${your_jdk_dir} (example: export JDK_DIR=c:/j2sdk1.4.2_16)
4. ./build-psp-cldc.sh
5. cd psp
Now you should see the success message of phoneME libs building.
6. Make the executable:
- If build on 1.50 kernel:
make kxploit
You should get pspkvm and pspkvm% directories in this directory, just copy them to your PSP’s /PSP/GAME or /PSP/GAME150 directory.
- If build on 3.xx OE:
make BUILD_SLIM=true
You should get EBOOT.PBP in this directory, copy it to your PSP’s /PSP/GAME/pspkvm directory
7. Copy “lib” and “appdb” directory from ${your_source_dir}/midp/build/javacall_psp/output/ into PSP’s /PSP/GAME/pspkvm
8. unzip midi_res.zip to PSP’s /PSP/GAME/pspkvm (If you need MIDI support)

Requirement:
SDL_mixer
libvorbis
libogg
freetype2

——————————–
Running tips
——————————–
- Run MIDlet from memory stick:
1) Select “Find Application” item in AMS (the item on the top)
2) Select “Install from memory stick (ms0:/)”
3) Browse the file system of your memory stick now, and select jad or jar to run
4) After selected, the jad/jar will be automatically installed and run. You can choose the installed application from AMS next time you want to run.

- Input text:
You can’t use Qwerty input method on PSP since it’s lack of standard keyboard, but there’s still other input methods available. In any text input sence, you can popup the menu by Right Soft-button, and change to another input method. I’d suggest to use “abc” to input alphabetics, just like you’ve done on your phone, input english characters by 0~9,#,* keypad.

- Key map:
By default, the key assignment is blow:
NUM0: Cross
NUM1: Square
NUM2: UP
NUM3: Triangle
NUM4: LEFT
NUM5: Shift+Circle
NUM6: RIGHT
NUM7: Shift+Square
NUM8: DOWN
NUM9: Shift+Triangle
*:    Shift+SELECT
#:    Shift+START
CLEAR: Shift+Cross
SELECT: Circle
Left Soft: SELECT
Right Soft: START
UP/DOWN/LEFT/RIGHT: Analog joy stick
(* “Shift” = holding Left Trigger or Right Trigger)

Left Trigger + Right Trigger + Triangle: Multi-tasking key (Click to return AMS and put MIDlet to background)
Left Trigger + Right Trigger + Cross:    Exit current running MIDlet

- Multi tasking
In and application, press Left Trigger+Right Trigger+Triangle will put current running MIDlet to background, and AMS screen will be shown. The background running MIDlet is shown in high-lighted, and you can choose another MIDlet to run without stop the previous MIDlet. To bring a background running MIDlet to foreground, just click the MIDlet item from AMS is ok.
Note that currently we only enable run 2 MIDlet to run at same time, will allow more in future.

- Connect to network
Before a Java MIDlet wants to use network, you need to connect your PSP to network at first. To setup this connection, please select “Network Setup” in AMS(the 2nd item in AMS MIDlets list), then all the wifi connections you’ve setup in PSP will be listed. Select one and until an alert popup to tell you if it’s succeeded. Once it says “Successfully connected by profile xxx”, that means your network is setup, and back to AMS and run you MIDlet which uses network.
*Tips for 3.xx OE users: you don’t have to setup network in “Network Setup” menu. When the first your MIDlet want to access wifi network, a PSP network setup dialog will popup and prompt you connecting. And also, you can press “L+R+Square” at any time to call up network setup dialog.

- Select device to emulate
When user select a jad/jar file from memory stick to run, a “Device Select” menu will appear. Choose you preffered device size and model here, and press CIRCLE key to decide. If want to change the preffered device setting, go back to AMS and move the highlight onto the MIDlet whose setting you want to change, then select “Select Device” from menu.

- Change default key assignment for specified game
Default key assignment may not fit your game, you can go to AMS and move the highlight onto the MIDlet whose key assignment you want to change, then select “Select Device” from menu. Change the key setting as what you want. REMEBER:”Shift” means Left Trigger or Right Tirgger.

- Change defualt JSR75 Fileconnection root directories mapping in pspkvm.ini.
The default root directories mapping is as following:
/root -> ms0:/pspkvm/
/music -> ms0:/PSP/MUSIC/
/photo -> ms0:/PSP/PHOTO/
/video -> ms0:/PSP/VIDEO/
/recordings -> ms0:/pspkvm/
/tones -> ms0:/pspkvm/
/graphics -> ms0:/pspkvm/
/private -> ms0:/pspkvm_pri/
However, you can change the default mapping in pspkvm.ini. Please open pspkvm.ini in PSPKVM’s install directory, change the values in [jsr75] section. If the value is left blank, default value is applied.

- Virtual Keyboard and Chinese Input tips:
Confirm key (SHIFT+CIRCLE by default)   -> Switch input methods
“*” (SHIFT+SELECT by default)           -> Switch input methods (same as above)
2/4/6/8 (UP/LEFT/RIGHT/DOWN by default) -> Move focus on Virtual Keyboard
Direction Keys (Analog stick by default)-> Move cursor
CLEAR (SHIFT+CROSS by default)          -> Backspace
0 (CROSS by default)                    -> Delete Pinyin (in Chinese input method)

- Use FreeType2 font files
You can have 3 type of fonts: System, Proportional and Monospace. Copy your .ttf files into ms0:/PSP/GAME/PSPKVM and rename them as below:
System font: sys.ttf
Proportional font: pro.ttf
Monospace font: mono.ttf
If pro.ttf or mono.ttf is not found, sys.ttf will be used automatically; If no any of three font files are found, internal built-in font will be used.

http://www.pspkvm.com

http://www.pspkvm.cn

Project home on SF:

https://sourceforge.net/projects/pspkvm

——————————–
Change log
——————————–
- FreeType2 fonts support. (Please see “Running tips: Use FreeType2 font files”)
- Bug fixes:
1) Mess display bug of NokiaUI for some games, e.g American Army.
2) Fix PlatformRequest() issue of not launching Installer for Jad/Jar files.
- Add missing character in Chinese Input Method. Now full GB2312 charset is supported.
- Optimize alpha-blending of drawRGB() with VFPU instructions.

——————————–
General information
——————————–
This software is a PSP porting of SUN open-source JavaME implementation: phoneMEFeature. The words below is copied from phoneME’s website to describe the project:

The objective of the phoneME project is to further expand the usage of Java? Platform, Micro Edition (Java ME platform) technology in the mobile handset market. The project scope includes a focus on the mainstream feature phone segment with phoneME Feature software, and the emerging advanced phone segment with phoneME Advanced software. Our goal in making these technologies available to the Mobile & Embedded Community is to reduce implementation variation, increase the rate of innovation and enable new devices to leverage the power of the Java ME platform.

You can also refer to the original website from here: https://phoneme.dev.java.net/

The goal of pspkvm is porting phoneMEFeature to Sony PSP game console. If you’re seeking for phoneMEAdvanced porting on PSP, please take a look at the other project here: https://sourceforge.net/projects/pspme

——————————–
Fetures
——————————–
- Nokia UI APIs (partial)
- WMA1.1(JSR120) stub
- Networking (By PSP’s WIFI)
- Java AMS with MVM supporting
- Several input methods: QWERTY/Abc/Symbol/…
- Directly browse and run from local jad/jar file, and auto-install without interrupting
- Jpeg support
- MIDI & Wave audio playback support
- Device emulation. You can choose device type to emulate for different screen sizes and key codes, either at installation time or from “Select device” menu
- Change default key assignment for specific application.
- JSR75(File Connection)
- Virtual Keyboard Input
- Chinese Input
- JSR179
- FreeType2 font support

——————————–
TODO
——————————–
- Graphic optimization (High)
- JSR184 (Low)
- MIPS JIT compiler and Interpreter generator (Low)

——————————–
Bugs and known issues
——————————–
Known issues:
- javacall_file_truncate doesn’t ported, so some file truncating operation, such as some RMS operations, may not work as expected
- Multimedia temporary files may leave on your memory stick sometimes, especially after VM crash. They’re usually not big, but if you wanna delete the by hands, just goto your PSP’s /PSP/GAME/pspkvm/ directory, find the file whose name likes xxxxxxxx_tmp_mus.mid, delete them.
- Fileconnection rmdir operation may fail for unknown reasons
- LocationProvider.getState() will always returns AVAILABLE once after GPS initialized, so LocationListener.providerStateChanged() doesn’t work as expected.
- gmail 1.5.0 cannot login. Always get “Username and password do not match. You provided ()”

——————————–
Run from binary bundle
——————————–
1. Download correct binary bundle:
- If you have a 1.50 kernel PSP and have installed pspkvm 0.3.2:
Download pspkvm-bin-x.x.x-150-upgrade.zip
- If you want to run pspkvm on 3.xx OE and have installed pspkvm 0.3.2:
Download pspkvm-bin-x.x.x-OE-upgrade.zip
- If you have a 1.50 kernel PSP and haven’t installed pspkvm 0.3.2:
Download pspkvm-bin-x.x.x-150-allinone.zip
- If you want to run pspkvm on 3.xx OE and haven’t installed pspkvm 0.3.2:
Download pspkvm-bin-x.x.x-OE-allinone.zip
2. Extract the zip to PSP’s /PSP/GAME/ or /PSP/GAME150
3. Here we go!

——————————–
Building instructions
——————————–
For the ones who are interested in our source code:
0. You have to prepare the building enviroment for phoneME at first. Please refer the document from here: https://phoneme.dev.java.net/content/mr2/buildenv_feature.html#win_setup

Now assume you have installed the building environment by following the above instruction. In Cygwin:
1. Grab the source code from svn to a local directory
2. cd ${your_source_dir}
3. export JDK_DIR=${your_jdk_dir} (example: export JDK_DIR=c:/j2sdk1.4.2_16)
4. ./build-psp-cldc.sh
5. cd psp
Now you should see the success message of phoneME libs building.
6. Make the executable:
- If build on 1.50 kernel:
make kxploit
You should get pspkvm and pspkvm% directories in this directory, just copy them to your PSP’s /PSP/GAME or /PSP/GAME150 directory.
- If build on 3.xx OE:
make BUILD_SLIM=true
You should get EBOOT.PBP in this directory, copy it to your PSP’s /PSP/GAME/pspkvm directory
7. Copy “lib” and “appdb” directory from ${your_source_dir}/midp/build/javacall_psp/output/ into PSP’s /PSP/GAME/pspkvm
8. unzip midi_res.zip to PSP’s /PSP/GAME/pspkvm (If you need MIDI support)

Requirement:
SDL_mixer
libvorbis
libogg
freetype2

——————————–
Running tips
——————————–
- Run MIDlet from memory stick:
1) Select “Find Application” item in AMS (the item on the top)
2) Select “Install from memory stick (ms0:/)”
3) Browse the file system of your memory stick now, and select jad or jar to run
4) After selected, the jad/jar will be automatically installed and run. You can choose the installed application from AMS next time you want to run.

- Input text:
You can’t use Qwerty input method on PSP since it’s lack of standard keyboard, but there’s still other input methods available. In any text input sence, you can popup the menu by Right Soft-button, and change to another input method. I’d suggest to use “abc” to input alphabetics, just like you’ve done on your phone, input english characters by 0~9,#,* keypad.

- Key map:
By default, the key assignment is blow:
NUM0: Cross
NUM1: Square
NUM2: UP
NUM3: Triangle
NUM4: LEFT
NUM5: Shift+Circle
NUM6: RIGHT
NUM7: Shift+Square
NUM8: DOWN
NUM9: Shift+Triangle
*:    Shift+SELECT
#:    Shift+START
CLEAR: Shift+Cross
SELECT: Circle
Left Soft: SELECT
Right Soft: START
UP/DOWN/LEFT/RIGHT: Analog joy stick
(* “Shift” = holding Left Trigger or Right Trigger)

Left Trigger + Right Trigger + Triangle: Multi-tasking key (Click to return AMS and put MIDlet to background)
Left Trigger + Right Trigger + Cross:    Exit current running MIDlet

- Multi tasking
In and application, press Left Trigger+Right Trigger+Triangle will put current running MIDlet to background, and AMS screen will be shown. The background running MIDlet is shown in high-lighted, and you can choose another MIDlet to run without stop the previous MIDlet. To bring a background running MIDlet to foreground, just click the MIDlet item from AMS is ok.
Note that currently we only enable run 2 MIDlet to run at same time, will allow more in future.

- Connect to network
Before a Java MIDlet wants to use network, you need to connect your PSP to network at first. To setup this connection, please select “Network Setup” in AMS(the 2nd item in AMS MIDlets list), then all the wifi connections you’ve setup in PSP will be listed. Select one and until an alert popup to tell you if it’s succeeded. Once it says “Successfully connected by profile xxx”, that means your network is setup, and back to AMS and run you MIDlet which uses network.
*Tips for 3.xx OE users: you don’t have to setup network in “Network Setup” menu. When the first your MIDlet want to access wifi network, a PSP network setup dialog will popup and prompt you connecting. And also, you can press “L+R+Square” at any time to call up network setup dialog.

- Select device to emulate
When user select a jad/jar file from memory stick to run, a “Device Select” menu will appear. Choose you preffered device size and model here, and press CIRCLE key to decide. If want to change the preffered device setting, go back to AMS and move the highlight onto the MIDlet whose setting you want to change, then select “Select Device” from menu.

- Change default key assignment for specified game
Default key assignment may not fit your game, you can go to AMS and move the highlight onto the MIDlet whose key assignment you want to change, then select “Select Device” from menu. Change the key setting as what you want. REMEBER:”Shift” means Left Trigger or Right Tirgger.

- Change defualt JSR75 Fileconnection root directories mapping in pspkvm.ini.
The default root directories mapping is as following:
/root -> ms0:/pspkvm/
/music -> ms0:/PSP/MUSIC/
/photo -> ms0:/PSP/PHOTO/
/video -> ms0:/PSP/VIDEO/
/recordings -> ms0:/pspkvm/
/tones -> ms0:/pspkvm/
/graphics -> ms0:/pspkvm/
/private -> ms0:/pspkvm_pri/
However, you can change the default mapping in pspkvm.ini. Please open pspkvm.ini in PSPKVM’s install directory, change the values in [jsr75] section. If the value is left blank, default value is applied.

- Virtual Keyboard and Chinese Input tips:
“#” (SHIFT+START by default)            -> Open/Close Chinese Input
“*” (SHIFT+SELECT by default)           -> Switch input methods
4/6 (LEFT/RIGHT by default)             -> Select candidate chinese chars / Move cursor
2/8 (UP/DOWN by default)                -> Prev/Next page of candidate chinese chars
5 (SHIFT+CIRCLE by default)             -> Confirm selected chinese char
CLEAR (SHIFT+CROSS by default)          -> Backspace

- Use FreeType2 font files
You can have 3 type of fonts: System, Proportional and Monospace. Copy your .ttf files into ms0:/PSP/GAME/PSPKVM and rename them as below:
System font: sys.ttf
Proportional font: pro.ttf
Monospace font: mono.ttf
If pro.ttf or mono.ttf is not found, sys.ttf will be used automatically; If no any of three font files are found, internal built-in font will be used.

Enjoy! ^_^