Release Name: v0.5.0

Notes:
pspkvm v0.5.0
11 Jan. 2009
Author: Sleepper, M@x
Email: pspkvm@gmail.com
Project website:
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.

Changes:
- 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



2008-09-20 23:38 v0.4.2
FreeType2 fonts support. (Please see "Running tips: Use FreeType2 font files" of Release Notes)
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.


2008-06-29 02:50 v0.4.1
Bug fixes:
1) HTTPS connection always fail
2) On Screen Keyboard fail to open
3) Virtual Keyboard cannot input 4 and 6
Input symbols and numbers while Chinese Input is open
Improve performance of FileConnection InputStream.skip()


2008-06-22 10:32 v0.4.0

Change package name and purpose of release bundles.
1) pspkvm-bin-x.x.x-150-upgrade: Use this package if your PSP is 1.50 kernel and have installed pspkvm 0.3.2
2) pspkvm-bin-x.x.x-OE-upgrade: Use this package if your PSP is 3.xx OE kernel and have installed pspkvm 0.3.2
3) pspkvm-bin-x.x.x-150-allinone: Use this package if your PSP is 1.50 kernel and havn´t installed pspkvm 0.3.2
4) pspkvm-bin-x.x.x-OE-allinone: Use this package if your PSP is 3.xx OE kernel and havn´t installed pspkvm 0.3.2
*) Source code package is no longer provided in release; Instead, you can grab source code from svn, tags are created for each release.
JSR179 support (OE Version only). Currently support GPS290(Sony´s USB GPS receiver) only, serial GPS will be supported in future
Chinese Input Method. Please see "Virtual Keyboard and Chinese Input tips" in "Running tips" section of Release Note. Special thanks to Culiu for his contribution of Chinese Pinyin engine.
Use Sony´s On screen Keyboard as alternate input method. Default is off, turn it on in pspkvm.ini
X/O swap in native dialog, configurable by pspkvm.ini
Get device specific properties from pspkvm.ini. User can set properties (e.g "microedition.platform", or User-Agent value) for specific device
Use HTTP proxy setting in network profile
Add SonyEricsson Generic device profile in Device Selection
Virtual Keyboard improvement:
1) Change key layout to be "QWERTY"
2) Add some short-cut keys
3) "Auto-open" property can be configured by pspkvm.ini
Resolve some MIDlets not run problems:
1) Super Action Hero
2) Gmail 1.5.0
3) Yahoo! GO



2008-04-27 23:57 v0.3.2

Virtual Keyboard support
Use "L+R+Square" to call up network connection dialog at any time (slim version only)
Add pspkvm.ini confituation file
JSR75 root directories configurable by pspkvm.ini
Strech small device screen to fit PSP screen
Support CW90
Resolve bug: can not enter jad/jar file selector form, if the original jar file direcory is deleted
Implement microedition.platform property. Now can run Cangshenlu.
Don´t show mess icon in AMS
Resolve the bug that can´t output voice in jstardict



2008-04-08 0:38 v0.3.1

Add JSR75(File Connection) support (Please read "JSR75 Tips" in Release Note)
Minor optimization of draw_rgb
Enlarge Java Heap to avoid OutOfMemoryError for some games



2008-03-31 22:59 v0.3.0

Merge the source codes from 2 original project: pspkvm 0.1.0a and pspME 0.2.1 . Please see the Features for details.



2008-02-18 18:11 v0.1.0a
Limited the heap size used by sound font to fix a crash bug.



2008-02-16 18:33 v0.1.0
Add audio support, it can play MIDI and WAVE now.
Add the homebrew icon, thanks to Datadayne and vivid for making it.
Add the function to select the last selected file when restart, thanks to Kevin Borchert´s suggestion.
The fixedsys font was back, thanks to vivid for making font of the special characters.
Fix a crash bug caused by a corrupted jar file in the folder, thanks to Kevin Borchert for the reporting.
Fix the bug that it don´t display file name include ´.´, thanks to Anton Buckov for reporting it.



2008-02-09 20:19 v0.0.9
Support 3.XX kernel now, tested on my PSP-1000 3.71m33 & 3.90m33 .
Add fake functions for WMA2.0/1.1, many games that need WMA API will can be run now.
Add functions to "String Midlet.getAppProperty(String key)", can run "Cang Shen Lu(苍神录)" now.
Add functions for command bar.
Add a function to load the last selected device when restart, thanks to Shawn Winnie for suggesting it.
Add a new key "L+Cross -> CLEAR", thanks to Jörg Westphal for suggesting it.
Disable some unnecessary exceptions.
Fix a OutOfMemory bug.
Fix a bug when decode some images with transparent color, thanks to asenchai for reporting this.
Fix the bug when display some specific letters, thanks to SOUDAN Gael for reporting it.
Fix the bug that "SELECT" key don´t respond sometimes, thanks to Anton Buckov for reporting it.



2008-01-07 00:37 v0.0.8 fix some bugs that may cause some games can not be played. Please check the gameloft games compatible list.

2008-01-04 20:04 v0.0.7 fix the blank screen bug; add a new key "SELECT".
2008-01-03 01:04 v0.0.6 user can select device by press Triangle now.

2008-01-02 00:20 v0.0.5 fix some bugs.
2007-12-31 23:50 v0.0.4 fix 2 crash bugs.
2007-12-31 00:14 v0.0.3 fix a crash bug and optimized.
2007-12-23 01:48 v0.0.2 fix some bugs.
2007-12-10 00:42 v0.0.1 the first release.