--------------------------------
General information
--------------------------------
This software is a PSP porting of SUN open-source JavaME implementation: phoneME. 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 pspME is porting phoneME to Sony PSP game console. As the first step, my goal is a phoneMEFeature PSP implementation, which can enable user to run JavaME application on CLDC. In future, if time permit, I'll try to porting phoneMEAdvanced as well.
--------------------------------
What's new
--------------------------------
- An intiative porting of MIDP and CLDC
- Java AMS with MVM supporting
- Several input methods: QWERTY/Abc/Symbol/...
- Install application from local JAR file
--------------------------------
TODO
--------------------------------
- Enable sounds and music (High)
- User configurable key map (High)
- Networking (Medium)
- Graphic optimization (Medium)
- JSR184 (Low)
- MIPS JIT compiler and Interpreter generator (Low)
--------------------------------
Bugs and known issues
--------------------------------
- sceIoRename, which is used in javacall_file_rename(), doesn't work properly somehow
- javacall_file_truncate doesn't ported, so some file truncating operation, such as some RMS operations, may not work as expected
- javacall_dir_get_next doens't work for sceIoDread() somehow trash the stack, still under investigation. This bug may cause fail to remove RMS or MIDlet suite. Once this bug resolved, a graphic installer with JAR file selector could be implemented. Now user has to input the full path name of JAR file in the installer to install MIDlet.
--------------------------------
Building instructions
--------------------------------
0. You have to prepare the building enviroment for phoneME at first. Please refer the document from here:
https://phoneme.dev.java.net/content...html#win_setup
Now assume you have installed the building environment by following the above instruction. In Cygwin:
1. unzip the source bundle to a 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 kxploit
You should get PSPME and PSPME% directories in this directory, just copy them to your PSP's /PSP/GAME or /PSP/GAME150 directory.
7. Finally, unzip resouces.zip to extract "appdb" and "lib" directories PSP's /PSP/GAME/PSPME or /PSP/GAME150/PSPME
--------------------------------
Running tips
--------------------------------
- Install MIDlet from JAR file:
1) Copy the JAR file to memory stick
2) In AMS, select the first item "Install Application"
3) Input the full path name of the JAR file. For example: ms0:/abc.jar, means to install MIDlet from abc.jar which is copied to root directory of memory stick
4) Click Right Soft-button and select "2 Go to" from the popup menu, then follow the steps on screen
- 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:
Currently, key map is hardcoded and you've to change source code to alter it. By default, the key assignment is blow:
Left Trigger : Left Soft-button
Right Trigger: Right Soft-button
Up/Down/Left/Right: Up/Down/Left/Right
Select: *
Start : #
Triangle: CLEAR
Circle : SELECT
Analog Joy Stick:
UP-LEFT 1
UP 2
UP-RIGHT 3
LEFT 4
RIGHT 6
DOWN-LEFT 7
DOWN 8
DOWN-RIGHT 9
CROSS : 5
SQUARE : 0
Left Trigger + Right Trigger: Multi-tasking key (Click to return AMS and put MIDlet to background)
- Multi tasking
In any application, press Left Trigger + Right Trigger 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.
