Pendragon Software Corporation
Home News Products Order Support Company

Case Studies

 

 

Pendragon Forms

Details

FAQ
Quick Guide
Pricing
Download
Case Studies
Order
Upgrade

Support

Knowledgebase

Using the Palm OS Emulator (POSE) for Pendragon Forms Demonstrations, Training and Development

 

If you are demonstrating Pendragon Forms handheld databases to more than one or two users, and would like to show live data collection, the Palm OS Emulator (POSE) may be an ideal tool.  

The Emulator can also be useful for testing new form designs and is available for free from PalmSource.

 

 

Contents:

What is POSE?

Using the Emulator for Forms Development

Training and Presentations

Starting a New Session

Setting Up Network HotSync

Setting Up the Emulator for Network HotSync

Your First Synchronization

What is the Palm OS Emulator?

The Palm OS Emulator (POSE) is a software program that runs on your PC, and acts in almost every way just like your Palm OS hardware device.  It consists of two components:

  1. The emulator program simulates the hardware.

  2. A ROM image file contains the Palm Operating System that you will need to use the emulator. 

The emulator software program and installation instructions are available from the PalmSource Web site at http://www.palmos.com/dev/tools/emulator/.  

PalmSource does not distribute the ROM file from its Web site without a written agreement unless you sign up as a developer, though it does provide a tool for copying the ROM file from your physical Palm handheld into your PC via the serial port.  For more information on transferring the ROM file, see the documentation accompanying the emulator files.

In the past, PalmSource has made several ROM image files available to users signed up in the Palm Solution Provider program, including image files for new or soon-to-be-released devices. 

The Palm OS 5 Simulator

If you will need high resolution screens (320x320 pixels) or need to test Palm OS 5 devices, the Palm OS 5 Simulator is also available from Palm Source at  http://www.palmos.com/dev/tools/simulator/.  Although these are two very different programs, using them with Pendragon Forms is quite similar.

 

Using the Emulator for Development
Because the emulator can synchronize so quickly, you may find it very useful for testing your Pendragon Forms applications.   You can quickly distribute form designs and data to the emulator, test data collection on your forms, and make modifications. 

To use the Emulator with Pendragon Forms, add the emulator HotSync user name to your Pendragon Forms Manager, select the Active checkbox, and assign the new user to a UserGroup.

It may be helpful to use the Default UserGroup for testing and to create a second UserGroup for forms in production.

 

Training and Presentations

The emulator  is an excellent tool for doing presentations that demonstrate Pendragon Forms data collection.  Just setup the emulator on your laptop computer and connect your laptop to a projection device or VGA->TV converter.  On of the options on the POSE Properties dialog allows you to increase the screen size, making the Palm screen easier to see on projection displays.

You can also use the emulator to capture screen shots, even with grayscale images such as those found in Pendragon Browser Web sites.  To capture a screen as a bitmap file, right-click on the emulator and choose Save Screen.

 

Starting a New Session
 
After unzipping the files into a directory on your PC's hard disk, you can launch the emulator by double-clicking on the EMULATOR.EXE program.  When the program is launched, you will be prompted with the screen at the right.

 

Click the New button to create a new emulator session.  Each session can represent a different named device.  When it synchronizes, you will be able to give the simulated device a different HotSync user name to distinguish it from your physical handheld device and from other sessions you may create.

 

When creating a new session, you will be prompted for the type of hardware to simulate, and the path to the ROM file you want to use.

You will then see the emulator reset on your screen, just a real device would do when powered up for the first time.

 

 

Setting Up Network HotSync

POSE can synchronize via the serial port just like a normal Palm handheld, but synchronizing via Network HotSync is much faster and more reliable.

Network HotSync works just like your normal cradle HotSync, but instead of wires and serial ports, Network HotSync uses a network connection to transfer Palm data during synchronization.  When you synchronize POSE via Network HotSync, it establishes a TCP/IP network connection between the HotSync Manager and POSE on the same machine, even if you don't have a modem or network card.  Since no ethernet or modem connection is actually needed, the synchronization can be extremely fast.

To synchronize with Network HotSync, you will need to download either the latest Palm Desktop software or the Network HotSync update from the Palm Computing Support home page at http://www.palmone.com/us/support/hotsync.html.  

To see if you already have the required software, click on the HotSync icon in your Task Tray at the bottom right of your PC screen.  If the popup menu has a Network option, you already have the required software.

You will also need to have TCP/IP networking installed on your PC.  In general, if you have Internet access on your PC, you already have TCP/IP installed.

The first step is to setup your HotSync Manager for network synchronization.  To do this, click on the HotSync icon in your Task Tray at the bottom right of your PC screen.  A popup menu will appear.   Choose Setup.  Go to the Network tab and click on the TCP/IP Settings... button. Make a note of your PC's machine name and IP address.

 

After closing the Setup dialog, click on the HotSync icon in the Task Tray again, and choose Network to enable network synchronization.

 

Setting Up the Emulator for Network Sync
 
You will need to tell the Emulator to use the TCP/IP networking feature.  To do this, right-click on the emulator screen and choose Settings...Properties...

Check the box marked Redirect NetLib calls to host TCP/IP.  Then click OK.

Click on the applications button on the emulator to see the list of applications (just like you would on the real device).

 

The Palm OS 5 Simulator

If you are using the Palm OS 5 Simulator,  right click on the simulator screen and choose Settings ... Communication ... Redirect NetLib calls to host TCP/IP.

 

 

Tap the HotSync icon to open the HotSync application. 

 

 

 

Tap the menu button.  You will see menu options for several option screens.  You will need to edit the Modem Sync Prefs, Primary PC Setup and Connection Setup.

First, tap Modem Sync Prefs...  

 

From the Modem Sync Preferences screen, select Network.

Then click OK. 

 

 

Return to the HotSync Options menu by tapping the menu button.  Next, tap Primary PC Setup...

Enter the Primary PC name and address as was shown on the TCP/IP Settings dialog in your HotSync Manager.

Click OK. 

 

Finally, you will need to select a service profile. 

On the HotSync main screen, tap the Select Service selector under the HotSync icon.

 

Tap on the word Service and choose Aimnet or Earthlink (you may have to type the service name into the Palm OS 5 Simulator).

 

Set the username to 0 (zero).

 

 

Save Your Session

Don't forget to save your emulator session after you have set it up.  To do this, right-click on the emulator and choose Save on the menu. You will be prompted to save the session each time you close the Emulator. 

 

Saving Palm OS 5 Simulator Sessions

If you are using the Palm OS Simulator, remember to save each session before closing the Simulator.  You will not be prompted to save otherwise.

 

Your first Synchronization
 
Now you are ready to synchronize your POSE session.  To do this, simply click on the Modem Sync icon.  Though the first synchronization session may not run at full speed, you will probably find subsequent sessions synchronize at least 10 times faster than serial port HotSync sessions.

On your first synchronization, the HotSync software will prompt you for the HotSync username for the session:

We recommend that you click the New... button and enter a new name for your emulator session.  You can then treat your emulator just like a normal Palm handheld device.

 

 

© 2001-2004 Pendragon Software Corporation.  All rights reserved. Copyright and trademark information.