Documentation  |   Table of Contents   |  < Previous   |  Next >   |  Index

Table of Contents

Using Palm OS® Emulator

Palm OS Developer Suite

About This Document

Who Should Read This Book

What This Book Contains

Palm OS SDK Documentation

Additional Resources

What's New for Palm OS Emulator 3.5

What's New for Palm OS Emulator 3.4

1 Understanding Palm OS Emulator Concepts

About Palm OS Emulator

Feature Overview

Standard Handheld Features

Extended Emulation Features

Debugging Features

Getting Help with Palm OS Emulator

2 Installing Palm OS Emulator

Prerequisites

Palm OS Emulator Runtime Requirements

Using ROM Images

Downloading Palm OS Emulator

Versions of Palm OS Emulator

Profile Versions

Loading ROM Images

Downloading a ROM Image Obtained from PalmSource

Transferring a ROM Image from a Handheld

Transferring a ROM File in Windows

Transferring a ROM File on a Macintosh

Transferring a ROM File on a Unix System

Transferring a ROM Image over a USB Connection

Using a ROM Image in Palm OS Emulator

Dragging and Dropping a ROM Image

3 Running Palm OS Emulator

Starting Palm OS Emulator

Command Line Options

Palm OS Emulator Start Up

Using Emulation Sessions

Configuring a New Session

The Difference between the New Menu Item and the Open Menu Item

Dragging and Dropping Files

Saving and Restoring Session State

Saving the Screen

Changing Emulator's Appearance

Other Options on the Skins Dialog Box

Modifying the Runtime Environment

Palm OS Emulator Properties

Preferences Files

Installing Applications

Using the Install Menu

Using the Autoload Facility

Using the Autorun Facility

Using Serial Communication

Using the HotSync Application

Performing a Network Hotsync Operation with Palm OS Emulator on Windows

Performing a HotSync Operation with a Null Modem Cable

Emulating Expansion Memory

Emulating a Handheld Reset

4 Palm OS Emulator User Interface Summary

Palm OS Emulator Display

Using the Menus

Using the Hardware Buttons

Entering Data

Using Control Keys

5 Testing Applications Using Palm OS Emulator

Testing Software

Debug Options

Logging Options

Using Gremlins to Automate Testing

Gremlin Characteristics

Gremlin Horde Settings

Running a Gremlin Horde

Stepping and Stopping Gremlins

Gremlin Snapshots

Logging while Gremlins Are Running

Using Gremlin Events

Setting Breakpoints

Setting the Data Breakpoint

Setting Conditional Breakpoints

Debugging with External Debug Tools

Connecting Emulator with Palm Debugger

Connecting Emulator with the GDB Debugger

Connecting the Emulator with External Debuggers

Tracing Your Code

Using Reporter to View Realtime Traces

Profiling Your Code

6 Palm OS Emulator Error Handling

About Errors and Warnings

Detecting an Error Condition

Error Condition Types

Error Messages

7 Palm OS Emulator Advanced Topics

Using Emulator Skin Files

How Skin Files Work

Installing Additional Skin Files

Modifying or Creating Skin Files

Creating Demonstration Versions of Palm OS Emulator

Bound Emulation Session Limitations

Sending Commands to Palm OS Emulator

RPC2 Packet Format

8 Host Control API Reference

About the Host Control API

Constants

Host Error Constants

Host Function Selector Constants

Host ID Constants

Host Platform Constants

Host Signal Constants

Data Types

HostBoolType

HostClockType

HostDirEntType

HostDIRType

HostFILEType

HostGremlinInfoType

HostIDType

HostPlatformType

HostSignalType

HostSizeType

HostStatType

HostTimeType

HostTmType

HostUTimeType

Functions

HostAscTime

HostClock

HostCloseDir

HostCTime

HostErrNo

HostExportFile

HostFClose

HostFEOF

HostFError

HostFFlush

HostFGetC

HostFGetPos

HostFGetS

HostFOpen

HostFPrintF

HostFPutC

HostFPutS

HostFRead

HostFree

HostFReopen

HostFScanF

HostFSeek

HostFSetPos

HostFTell

HostFWrite

HostGestalt

HostGetDirectory

HostGetEnv

HostGetFile

HostGetFileAttr

HostGetHostID

HostGetHostPlatform

HostGetHostVersion

HostGetPreference

HostGMTime

HostGremlinCounter

HostGremlinIsRunning

HostGremlinLimit

HostGremlinNew

HostGremlinNumber

HostImportFile

HostIsCallingTrap

HostIsSelectorImplemented

HostLocalTime

HostLogFile

HostMalloc

HostMkDir

HostMkTime

HostOpenDir

HostProfileCleanup

HostProfileDetailFn

HostProfileDump

HostProfileGetCycles

HostProfileInit

HostProfileStart

HostProfileStop

HostPutFile

HostReadDir

HostRealloc

HostRemove

HostRename

HostRmDir

HostSaveScreen

HostSessionClose

HostSessionCreate

HostSessionOpen

HostSessionQuit

HostSetFileAttr

HostSetLogFileSize

HostSetPreference

HostSignalResume

HostSignalSend

HostSignalWait

HostSlotHasCard

HostSlotMax

HostSlotRoot

HostStat

HostStrFTime

HostTime

HostTmpFile

HostTmpNam

HostTraceClose

HostTraceInit

HostTraceOutputB

HostTraceOutputT

HostTraceOutputTL

HostTraceOutputVT

HostTraceOutputVTL

HostTruncate

HostUTime

Reference Summary

Host Control Database Functions

Host Control Directory Handler Functions

Host Control Environment Functions

Host Control File Chooser Support Functions

Host Control Gremlin Functions

Host Control Debugging Functions

Host Control Logging Functions

Host Control Preference Functions

Host Control Profiling Functions

Host Control RPC Functions

Host Control Standard C Library Functions

Host Control Time Functions

Host Control Tracing Functions

9 Debugger Protocol Reference

About the Palm OS Debugger Protocol

Packets

Packet Structure

Packet Communications

Constants

Packet Constants

State Constants

Breakpoint Constants

Command Constants

Data Structures

_SysPktBodyCommon

SysPktBodyType

SysPktRPCParamType

BreakpointType

Debugger Protocol Commands

Continue

Find

Get Breakpoints

Get Routine Name

Get Trap Breaks

Get Trap Conditionals

Message

Read Memory

Read Registers

RPC

Set Breakpoints

Set Trap Breaks

Set Trap Conditionals

State

Toggle Debugger Breaks

Write Memory

Write Registers

Summary of Debugger Protocol Packets

A Structure Access Notifications

B Unsupported Traps

System Use Only Traps

Internal Use Only Traps

Kernel Traps

Obsolete Traps

Unimplemented Traps

Unimplemented NOP Traps

Unimplemented Rare Traps