1.1. POSE
POSE emulates the hardware of number of different Palm OS devices: Pilot 1000, Pilot 5000, Palm III, Palm IIIx, Palm V, Palm Vx, Palm VII, Palm VIIx, Palm IIIc, Palm m500, Palm m505, Symbol 1700, Handspring Visor, Handspring Prism, HandEra TRGPro, and HandEra 330.
Everybody should read and follow the instructions for POSE. First, we will show you how to install it, then how to run it. We'll be discussing POSE version 3.2 (note that there is a 3.5 version available which is very similar to 3.2).
1.1.1. Getting and Installing POSE
The first thing to do is to download and install POSE. The instructions are slightly different for Unix, because you need to build it from the sources.
1.1.1.1. Windows and Mac OS
You can download the latest version of POSE from:
1.1.1.2. Unix
On Unix, things are a bit more complicated. You'll need to build POSE from the source code. Before, you can do this you need to get the FLTK toolkit.
FLTK Toolkit—Get the FLTK toolkit by:
Downloading fltk-1.0.11-source.tar.gz from www.fltk.org.
Uncompress it with:
tar -zxf fltk-1.0.11-source.tar.gz
Build FLTK with:
cd fltk-1.0.11 ./configure make make install
Get POSE
You can download POSE at:
www.palmos.com/dev/tech/tools/emulator/emulator-src-32.tar.gz
Next, extract the sources with:
tar -zxf emulator-src-32.tar.gz
Build and Install POSE—Configure and build the POSE sources (instructions are in file, Docs/_Building.txt)
Build POSE with:
cd Emulator_Src_3.2/BuildUnix ./configure make
Install POSE into /usr/local/bin/pose with:
make install
1.1.1.3. Emulator Skins
You'll also want to install Emulator Skins for your platform. Skins are pictures of actual devices used to provide a more faithful representation of the device. Here are the steps:
Download the latest Emulator Skins file and uncompress it. It'll create a directory named something like Skins 1.7.
Move that Skins 1.7 directory into the proper place to ensure that POSE finds the skins when it needs them:
Windows and Mac OS—Make a directory within the POSE directory called Skins. Move the Skins 1.7 directory into this newly-created Skins directory. Pose looks for its skins recursively within the Skins directory.
Unix—You need to create a Skins directory in your home directory, and place the Skins 1.7 directory within that newly-created directory.
1.1.2. POSE and ROM Images
You can get ROM images for POSE from the internet or from an actual device. If you get one from a device, make sure that the ROM image is one that POSE can use.
1.1.2.1. From the Internet
Palm-branded product ROMs require registration and a signed license agreement. You can register at: ww.palmos.com/dev
Handspring ROMs require registration and a faxed license agreement. You can get further innformation from: www.handspring.com/developers
1.1.3. Retrieving A ROM from a handheld
Before you get a copy of your particular handheld's ROM, make sure that POSE can use that type. If the handheld from which you are obtaining the ROM isn't in the list of hardware devices described earlier, POSE will refuse to use the resulting ROM image.
To retrieve a ROM image you need to do a couple of things. First, you'll need to install the ROM Transfer application (part of the POSE distribution) onto your handheld using the standard desktop installation procedure. You will then see the form shown in Figure 1-1 when you run the application on your device.
Follow the instructions on the device and tap the “Begin Transfer” button. Now, you'll need to start the process going on the desktop as well.
See the following instructions for the platform you are interested in.
1.1.3.1. Windows
Windows—Run Palm OS Emulator. You'll see the initial dialog (as shown in Figure 1-2).
Click on the “Download” button to display the ROM Transfer dialog shown in Figure 1-3.
Follow the directions in this dialog (see Figure 1-3):
1.1.3.2. Mac OS
POSE transfers ROMs using a serial connection. Since modern Mac OS computers don't have serial ports, you'll need either:
a serial PC card (like those available from www.socketcom.com)
or a USB-serial adapter (like the Keyspan USB PDA Adapter from www.keyspan.com). The PalmConnect® USB-serial adapter works only with the HotSync application, and can't be used by POSE.
Run Palm OS Emulator on your Macintosh. You'll see the new session dialog (see Figure 1-4). Press Cancel.
Choose “Transfer ROM” from the File menu. The Transfer ROM dialog (shown in Figure 1-5) will describe all the steps needed to transfer the ROM. Follow them.
1.1.3.3. Unix
Run the Emulator and you'll see the initial POSE window.
Right-click on the window to display a menu. From that menu, choose “Transfer ROM”. Follow the instructions shown in the resulting Transfer ROM dialog.
1.1.4. Creating a new POSE session
Now that you've downloaded a ROM image you can use it.
First, you have to exit Palm OS Emulator, and rerun it.
Create a New Session. Windows and Mac OS: click the New button. Unix: right-click and choose New.
You'll see the New Session dialog (for example, see Figure 1-6). From this dialog, you'll need to change the ROM file (change to the one you just downloaded). The Device popup should morph automatically, to reflect the devices for which this ROM is valid. The Skin is a picture of the actual device (though all that it affects is the visual look of the emulator).
Finally, choose a RAM Size of 2048K (you don't want the size larger than actual devices you'll be targetting).
At this point, tap OK, and the Emulator will display a picture of a Palm device, it'll show it booting. Then it will show the main screen (see Figure 1-7). You can tap on the screen with your cursor just as you would with a stylus. Tap on the hardware buttons, as well. You can enter characters with both the Graffiti system, and with the desktop's keyboard.
1.1.4.1. Windows and Unix
The menu for POSE is available by right-clicking on the POSE window.
1.1.4.2. Macintosh
The menus are in the menubar.
Now it is time to choose which tutorial you wish to read through. This first one is for CodeWarrior (Windows, Mac OS). If you'll be using PRC-Tools, skip to “PRC-Tools” on page 111.