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