POSE emulates the hardware of a 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.
On Windows and Mac OS you can download the latest version of POSE from http://www.palmos.com/dev/tech/tools/emulator/.
Download the FLTK toolkit ( fltk-1.0.11-source.tar.gz) from http://www.fltk.org.
tar -zxf fltk-1.0.11-source.tar.gz
cd fltk-1.0.11 ./configure make make install
Download POSE at http://www.palmos.com/dev/tech/tools/emulator/emulator-src-32.tar.gz.
Extract the sources:
tar -zxf emulator-src-32.tar.gz
Configure and build the POSE sources (instructions are in the file, Docs/_Building.txt):
cd Emulator_Src_3.2/BuildUnix ./configure make
Install POSE into /usr/local/bin/pose:
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:
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.
Create a Skins directory in your home directory, and place the Skins 1.7 directory within that newly created directory.
Palm-branded product ROMs require registration and signed license agreements. You can register at http://www.palmos.com/dev/.
Handspring ROMs require registration and faxed license agreements. You can get further information from http://www.handspring.com/developers/.
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 earlier list, 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 4-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 initiate the process on the desktop as well. (See the following instructions for the appropriate platform.)
Now do the following:
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 box.
Close Palm OS Emulator, and reopen 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 box (see Figure 4-6). From this dialog box, you’ll need to change the ROM file (change to the one you just downloaded). The Device pop up will change 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).
Tap OK, and the Emulator will display a picture of a Palm device that is booting up. Then it will show the main screen (see Figure 4-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.
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 Section 4.3.