Palm OS programming development tools guide

Palm OS Programming Development Tools Guide......Page 1
Table of Contents......Page 3
What This Volume Contains......Page 19
Additional Resources......Page 21
Part I: Testing Your Application......Page 23
Using Palm OS Emulator......Page 25
Feature Overview......Page 26
Debugging Features......Page 28
Using ROM Images......Page 29
Downloading Palm OS Emulator......Page 30
Versions of Palm OS Emulator......Page 31
Transferring a ROM File in Windows......Page 33
Transferring a ROM File On a Macintosh......Page 34
Transferring a ROM File On a Unix System......Page 35
Using a ROM Image in Palm OS Emulator......Page 36
Command Line Options......Page 38
Starting Palm OS Emulator......Page 42
Configuring a New Session......Page 45
Dragging and Dropping Files......Page 47
Changing the Emulator’s Appearance......Page 48
Palm OS Emulator Properties......Page 50
Installing Applications......Page 51
Serial Communications and Palm OS Emulator......Page 52
Using the HotSync Application With Palm OS Emulator......Page 53
Emulating Expansion Cards......Page 56
Debug Options......Page 58
Logging Options......Page 61
Using Gremlins to Automate Testing......Page 65
Setting Breakpoints......Page 70
Source Level Debugging......Page 72
Connecting Emulator with the GDB Debugger......Page 73
Connecting the Emulator With External Debuggers......Page 74
Profiling Your Code......Page 75
Error Handling Concepts......Page 76
Error Condition Types......Page 77
Error Messages......Page 78
Sending Commands to Palm OS Emulator......Page 84
Using the Menus......Page 86
Using the Hardware Buttons......Page 91
Control Keys......Page 92
Getting Help With Palm OS Emulator......Page 93
About the Host Control API......Page 95
Host Error Constants......Page 96
Host Platform Constants......Page 100
Data Types......Page 101
New HostDIRType......Page 102
HostGremlinInfoType......Page 103
New HostSizeType......Page 104
New HostStatType......Page 105
New HostTmType......Page 106
New HostUTimeType......Page 107
New HostClock......Page 108
HostErrNo......Page 109
HostFClose......Page 110
HostFFlush......Page 111
HostFGetS......Page 112
HostFPutC......Page 113
HostFree......Page 114
HostFScanF......Page 115
HostFSetPos......Page 116
HostGestalt......Page 117
New HostGetFile......Page 118
New HostGetFileAttr......Page 119
HostGetHostVersion......Page 120
HostGetPreference......Page 121
HostGremlinIsRunning......Page 122
HostGremlinNumber......Page 123
HostIsCallingTrap......Page 124
New HostLocalTime......Page 125
New HostMkDir......Page 126
HostProfileCleanup......Page 127
HostProfileDetailFn......Page 128
New HostProfileGetCycles......Page 129
HostProfileInit......Page 130
HostProfileStop......Page 131
New HostReadDir......Page 132
HostRename......Page 133
New HostSaveScreen......Page 134
HostSessionCreate......Page 135
HostSessionQuit......Page 136
New HostSetFileAttr......Page 137
HostSetPreference......Page 138
HostSignalSend......Page 139
HostSignalWait......Page 140
New HostSlotHasCard......Page 141
New HostSlotRoot......Page 142
New HostStrFTime......Page 143
HostTmpNam......Page 144
HostTraceInit......Page 145
HostTraceOutputT......Page 146
HostTraceOutputTL......Page 148
HostTraceOutputVT......Page 149
New HostTruncate......Page 150
Host Control Database Functions......Page 151
Host Control Environment Functions......Page 152
Host Control Gremlin Functions......Page 153
Host Control Profiling Functions......Page 154
Host Control Standard C Library Functions......Page 155
New Host Control Time Functions......Page 157
Host Control Tracing Functions......Page 158
About Palm Simulator......Page 161
Feature Overview......Page 162
Palm Simulator Compared to Palm OS Emulator......Page 163
Differences Between Palm Simulator and Actual Hardware......Page 164
Building a Project for Use with Simulator......Page 166
Tracing Events......Page 168
Scripting Pen and Key Events......Page 169
Saving Memory Information to File......Page 170
File Menu......Page 171
Replay Menu......Page 172
Gremlin Menu......Page 173
Panel Menu......Page 174
Part II: Debugging Your Application......Page 177
Using Palm Debugger......Page 179
About Palm Debugger......Page 180
Connecting to The Handheld Device......Page 182
Using the Console and Debugging Windows Together......Page 186
Entering Palm Debugger Commands......Page 187
Palm Debugger Menus......Page 188
Palm Debugger Command Syntax......Page 190
Using the Debugging Window......Page 192
Using Debugger Expressions......Page 194
Performing Basic Debugging Tasks......Page 200
Advanced Debugging Features......Page 207
Using the Source Window......Page 209
Debugging With the Source Window......Page 210
Using Symbol Files......Page 211
Using the Source Menu......Page 212
Palm Debugger Error Messages......Page 214
Performing Calculations......Page 215
Finding a Specific Function......Page 216
Finding Memory Corruption Problems......Page 220
Displaying Local Variables and Function Parameters......Page 222
Changing the Baud Rate Used by Palm Debugger......Page 225
Importing System Extensions and Libraries......Page 226
Determining the Current Location Within an Application......Page 227
Command Syntax......Page 229
Debugging Window Commands......Page 231
>......Page 232
aliases......Page 233
atd......Page 234
bootstrap......Page 235
brc......Page 236
cardInfo......Page 237
db......Page 238
dir......Page 239
dm......Page 241
dx......Page 242
fill......Page 243
ft......Page 244
fw......Page 245
hChk......Page 246
hd......Page 247
hl......Page 249
ht......Page 250
il......Page 251
keywords......Page 252
opened......Page 253
penv......Page 254
reset......Page 255
save......Page 256
sc......Page 257
sc7......Page 258
sl......Page 259
storeInfo......Page 260
sw......Page 261
templates......Page 262
typeend......Page 263
variables......Page 264
Flow Control Commands......Page 265
Memory Commands......Page 266
Utility Commands......Page 267
Console Commands......Page 268
Predefined Constants......Page 269
About the Palm Debugger Protocol......Page 271
Packet Structure......Page 272
Packet Constants......Page 274
Command Constants......Page 275
_SysPktBodyCommon......Page 276
SysPktRPCParamType......Page 277
Continue......Page 278
Find......Page 280
Get Breakpoints......Page 281
Get Routine Name......Page 282
Get Trap Breaks......Page 284
Get Trap Conditionals......Page 285
Message......Page 286
Read Memory......Page 287
Read Registers......Page 288
RPC......Page 289
Set Breakpoints......Page 290
Set Trap Breaks......Page 291
Set Trap Conditionals......Page 292
State......Page 294
Toggle Debugger Breaks......Page 296
Write Memory......Page 297
Write Registers......Page 298
Summary of Debugger Protocol Packets......Page 299
About the Console Window......Page 301
Activating Console Input......Page 302
Using Shortcut Numbers to Activate the Windows......Page 303
Entering Console Window Commands......Page 305
Command Syntax......Page 308
Console Window Commands......Page 310
AddResource......Page 311
AttachResource......Page 312
CardFormat......Page 313
ChangeRecord......Page 314
ColdBoot......Page 315
Del......Page 316
DelResource......Page 317
DetachResource......Page 318
Dir......Page 319
DM......Page 320
Exit......Page 321
Export......Page 322
Feature......Page 323
GDB......Page 324
GremlinOff......Page 325
HChk......Page 326
HD......Page 327
Help......Page 328
HL......Page 329
HT......Page 330
HTorture......Page 331
Import......Page 332
Info......Page 333
KInfo......Page 334
Launch......Page 335
Lock......Page 336
MDebug......Page 337
New......Page 339
Opened......Page 340
PowerOn......Page 341
Resize......Page 342
SetInfo......Page 343
SetRecordInfo......Page 344
Sleep......Page 345
StoreInfo......Page 346
SysAlarmDump......Page 347
Chunk Utility Commands......Page 348
Heap Utility Commands......Page 349
Record Utility Commands......Page 350
System Commands......Page 351
Part III: Tracing Your Application......Page 353
Palm Reporter Features......Page 355
Installing Palm Reporter......Page 356
Adding Trace Calls to Your Application......Page 357
Specifying Trace Strings......Page 358
Trace Functions in a Code Sample......Page 359
Starting a Palm Reporter Session......Page 360
Filtering Information in a Palm Reporter Session......Page 361
Using the Palm Reporter Toolbar......Page 362
Troubleshooting Palm Reporter......Page 363
Part IV: Creating National Language Versions of Your Application......Page 367
Using Overlays to Localize Resources......Page 369
Overlay Specification Resources......Page 370
Choosing a Locale......Page 371
Modifying the Filter Set......Page 372
PRC2OVL Example......Page 373
Using the Patch Overlay Function......Page 374
PRC2OVL Options Summary......Page 375
Selecting Resources......Page 377
Part V: Appendixes......Page 379
Resource Tools......Page 381
Simple Data Types......Page 383
Glossary......Page 385
Index......Page 387