PHEM Quick Start
This page covers the basics of how to get PHEM up and running. If you ever used the original Palm OS Emulator that PHEM is derived from, it'll be dead simple. But even if you never heard of POSE, PHEM is very easy to set up. If you prefer, the key information is covered in this video:
The Bare Bones
Here's the basic steps. If you're familiar with Palm PDAs and general emulator concepts, this list may be all you need:
- Install PHEM, run it once. It will create the directories it needs, then complain that it can't find any ROM files and quit.
- Place at least one Palm ROM file in PHEM's "roms" directory. Typically this will be in a place like "/mnt/sdcard/phem/roms".
- Fire up PHEM again. It will start up with the "Create Session" screen. From here, you can pick ROMs, specific Palm models to emulate, and how much onboard RAM should be emulated.
- Hit the "Done" button. PHEM will boot up the virtual Palm, and once it finishes booting up, you can start partying like it's 1997 to 2003!
If any of that isn't clear, don't worry. Just keep reading for the details.
PHEM needs to read and store files on the Android device's storage. It uses the default location for storage - typically this is "/mnt/sdcard". Any Android file manager can be used to organize and manage these files. PHEM stores everything under its own directory - so again typically this will be "/mnt/sdcard/phem". Within that directory there are a few sub-directories:
- roms: Where Palm ROM images are kept. (See below for details on these.)
- card: If the emulated Palm PDA supports memory cards, this directory is used to emulate that storage. Files placed here will appear to the emulated Palm PDA as if they were on an expansion card. (See here for more details on emulating memory cards.)
- skins: Where Palm "Skin" files are kept. Skin files allow PHEM to show a particular model of Palm PDA just as it appeared. They are not at all necessary to run PHEM - in fact, on smaller devices they take up more screen space than they are probably worth. But on a tablet-sized device they might be fun to use. (See here for all the details about using skins with PHEM.)
You don't have to create these directories - PHEM creates them for you the first time it's run. The only directory that you are required to deal with is the "roms" directory - that is where PHEM looks for ROM images to boot from.
PHEM emulates the hardware of a Palm PDA (the hardware of many different models of Palm PDA, actually). But in order to run Palm apps, you also need the Palm OS, the operating system software that runs on the hardware. These typically are named something like "palmos40-en-m505.rom" or "palmos353-en-handera330.rom".
The main (legal) way to acquire Palm OS ROM images is by downloading them off an actual Palm device. Tools like ROMeo, Pilot-link, or the original Palm OS Emulator can be used to pull the ROM off of a Palm device. Once upon a time, you could register as a developer with Palm and then download their ROM images, but Palm's developer program shut down (ahem) a while ago.
In any case, once you have at least one Palm ROM image, you're ready to use PHEM. Use whatever Android file manager you like to place the ROM image(s) into the "phem/roms" directory, then fire up PHEM again.
Setting Up An Emulation Session
PHEM organizes the Palms it emulates into "sessions". You can have multiple versions of a particular Palm model - say, several different Palm m515s with different software installed on them - or multiple different Palm models. You can save a session and reload it later, and switch between them at will, though PHEM only runs one session at a time. You might switch between emulating a Palm m505 (with a color screen, but 160x160 pixels) and a Handera 330 (with a grayscale screen, but higher resolution at 240x320).
To create a session, pick the "Manage Session" option from the menu or taskbar (icon: ), then hit the "New Session" button.
There are three options to pick. At the top, there's a drop-down list of all the ROMs that PHEM could find.
Below that, there's a drop-down list of all the models of Palm PDA that the selected ROM can support. Many ROMs only work with one specific model.
Finally, you pick how much RAM to emulate. By default, PHEM selects the maximum RAM the selected ROM and device will support. Usually this is around 8MB. In these days of multi-Gigabyte devices, that may sound limiting, but Palms were very memory-efficient and Palm apps are typically no more than a few hundred KB at most. 8MB is a lot of memory for a Palm.
Once you've chosen the options you like, hit the "Done" button, and PHEM will start up a new emulation session with those parameters.
Congratulations! You're up and running!
At this point, you've got the equivalent of a shiny new Palm PDA to play with. But you probably want to do more than just look at it. Here's some information to get you started:
- Using PHEM - What all the buttons and menus do.
- Palm Basics - A quick and dirty introduction to Palms. Covers things like Graffiti, menus, settings, navigation, and such.
- Loading Data From An Older Palm - How to load your old Datebook, Memo, ToDo, and other Palm data into PHEM.
- Palm Software - Some resources for getting software to run on your emulated Palm.
- Card Storage Emulation - Some Palms supported expansion in the form of memory cards. PHEM can emulate this, giving your Palm effectively unlimited storage. Here's how!
- Skins - Using skin files to change the appearance of the emulated Palm.
Copyright © 2013 Perpendox Software LLC