Palm OS Emulator

 
 
The Palm OS Emulator (POSE) emulates various models of Palm handhelds. (e.g., Pilot, PalmPilot, PalmIII, Palm V, Palm VII, etc.). The Emulator runs on most standard desktop computers, includes those running Windows 95, Windows 98, Windows NT 4.0, Windows 2000, Mac OS 8.6, Mac OS 9.x, Mac OS X, and several flavors of Unix.
To test your Java midlets on the Palm OS Emulator you will need to download the following:
  • Emulator Application
    Emulates the hardware of the various models of Palm Powered handhelds.
  • ROM Image file
    The Emulator does not include ROM images. When you pick a ROM image, the Emulator will give you the option to pick the device you want to emulate from the devices that could use that ROM. There are also two types of ROM image files: debug and non-debug versions. Use the debug ROMs to develop trouble-free software. To download the ROM images you must be a member of the Palm OS Developer Program and sign an agreement with Palm Inc.
  • Emulator Skins (optional)
    The Emulator Application comes with a built-in Generic skin. But if you want to make the Emulator cosmetically look like the device you are emulating you can download the emulator skins file.
The above mentioned files can be downloaded from: http://www.palmos.com/dev/tools/emulator/index.html







Installing Palm OS Emulator.



Information
none

Operating system used
Windows 2000

Software prerequisites
Java 2 Standard Edition (J2SE) SDK, version 1.1 or higher.

Procedure
  1. Unpack the Emulator Application, Emulator Skins and ROM Image file in one directory.

  2. Create a "Palm Emulator/Skins" directory.
    Copy all *.skin AND *.jpg files from the Skins_v1.9 sub-directories in the created Skins directory.

  3. Start the Palm Emulator (Emulator.exe)



  4. Start a new emulator session by pressing the New button.



  5. Select: ROM file Palm OS 3.5-xxxx. Java midlets requires Palm OS version 3.5 or above to run.

    ROM file the ROM file to use for the emulation.
    Device the handheld type to emulate.
    Skin skin that you want displayed on the emulation screen. You can select between Generic, Standard-English or Standard-Japanse.
    The Japanese skin, are only available for certain handheld types. The Generic choice is always available.
    RAM size the amount of RAM to emulate

    ROM file Device
    Palm III Palm IIIe Palm IIIc Palm IIIx Palm V Palm Vx
    3.0 en x          
    3.1 IIIx   x   x x  
    3.1 IIIx dbg   x   x x  
    3.1 V   x   x x  
    3.3-en-iii x          
    3.3-en-iii-dbg x          
    3.3-en-v       x x x
    3.3-en-v-dbg       x x x
    3.5-en-color     x      
    3.5-en-colordbg     x      
    3.5-en-ez       x x x
    3.5-en-ezdbg       x x x
    3.5-en-nonez x          
    3.5-en-nonezdbg x          


    Note: The rom files name ending with dbg are debug versions.



  6. Press OK button.



  7. The size of the emulator can be changed: right click on the emulator.
    Select: Settings | Skins | disable option "Double scale"

  8. Follow the instructions displayed on the screen (setup 1, 2, 3 and 4):



  9. After the instructions has been followed you will see the following:



  10. Exit the emulator: right click on the emulator.
    Select: Exit

  11. Start Sun J2ME Wireless Toolkit and select Edit | Preferences
    Select folder PalmOSEmulator, enter the POSE location and press OK button



  12. Open a project and select device PalmOS_Device.



  13. Press Build and Run button.
    When the Run button is pressed, the status window shows the following:

    Wrote: ..WTK104\wtklib\devices\PalmOS_Device\<midlet_name>.prc

    Note: MIDlets are composed of two parts: a .jad and .jar file. The Palm OS cannot read these files, it needs to be converted into one .prc file. The toolkit does this automatically for you.

  14. The Java Virtual Machine is started on the Palm emulator and the midlet started.



    For a more detailed information on how to use the Palm OS Emulator read the UsingPalmOSEmulator.pdf file that comes with the Emulator.