Palm OS Platform Developer Guide, Hardware and Software, Rev. D
Total Page:16
File Type:pdf, Size:1020Kb
Palm OS® Platform Developer Guide Software and Hardware Rev. E November 22, 2006 Usage Restrictions You are being provided these materials solely as a member of Palm's PluggedIn Program (the "PIP"). Your right to access and use these "PluggedIn Materials" is subject to and governed by the terms and conditions of the PluggedIn Program License Agreement which you agreed to at the time you became a member of PIP. Disclaimer and Limitation of Liability Palm, Inc. (“Palm”) provides this guide as a courtesy to members of its PluggedIn Program. Palm provides this guide on an “AS IS” basis and does not guarantee nor assume any liability for the accuracy or completeness of this guide, nor does Palm guarantee that the guide will be without errors. Members assume the entire risk of using this guide, including any damage or loss resulting from Member’s use of this guide or any loss or claims by third parties which may arise from the member’s use of this guide. Copyright and Trademark © 2004-2006 Palm, Inc. All rights reserved. Palm, LifeDrive, Zire, Tungsten, Treo, Blazer, Handspring, Graffiti, HotSync, VersaMail, Palm Powered, and Palm OS are among the trademarks or registered trademarks owned by or licensed to Palm, Inc. MPEG Layer-3 audio decoding technology is licensed from Fraunhofer IIS and Thomson. Adobe and Acrobat are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. All other brand and product names are or may be trademarks of, and are used to identify products or services of, their respective owners. IMPORTANT: Please read the End User Software License Agreement with this product before using the accompanying software program(s). Using any part of the software indicates that you accept the terms of the End User Software License Agreement. Date Revision Description of Changes 2004 - 2005 A Documents prior to document revisioning. May 15, 2006 B Revisions for Treo™ 700p smartphone. June 29, 2006 C Revisions for Multimedia features. November 20, 2006 D Revisions for Treo™ 700p smartphone Rest of World carrier release. November 22, 2006 E Revisions for Treo™ 680 smartphone. Contents What’s New . xi What’s new in Treo™ 680 smartphones . .xi What’s new in Treo™ 700p ROW smartphones . xii What’s new in Treo™ 700p smartphones . xii Chapter 1: Overview . 13 How this guide is organized . 13 Getting started . 13 Join the PalmSource® developer program . 13 Download the PalmSource® Palm OS SDK . 14 Acquire a development environment . 14 Join the Palm® Developer program . 14 Download the Palm OS Platform SDK . 15 Additional documentation and resources . 16 Chapter 2: Product Line Overview . 17 Treo™ smartphone product line . 17 What’s not supported by Treo™ smartphones . 18 Tungsten™ handheld product line . 19 What’s not supported by Tungsten™ handhelds . 19 Zire™ handheld product line . 19 What’s not supported by Zire™ handhelds . 19 LifeDrive™ mobile manager . 20 What’s not supported by LifeDrive™ mobile managers . 20 Hardware feature matrix . 21 Treo™smartphone hardware features . 21 Palm® handheld and LifeDrive™ mobile manager hardware features . 23 Palm® Z22 organizer and Zire™ handhelds hardware features . 25 SDIO support . 26 Software compatibility specifications (Palm libraries) . 27 sysExternalConnectorAttachEvent and sysExternalConnectorDetachEvent notifications . 29 kPmConnectorClass Notifications . 29 Optimizing your application for Palm® NVFS devices . 30 Speeding up actual performance . 30 Speeding up perceived performance . 31 Palm OS Developer Guide, Rev. E iii Contents PART I: Features and Libraries Chapter 3: PIM Database Structures . 35 The PIM SDK . 35 Overview . 35 PIM database structures . 36 Contacts . 37 Calendar . 43 Tasks . 52 Memos . 60 Known issues . 60 Chapter 4: Multimedia . 61 Codec Plug-in Manager . 62 Codec Plug-in Manager Overview . 62 Codec Wrapping . 65 Codec Plug-in Manager process . 66 Media codec formats supported by device . 68 For more information . 69 Imaging . 69 Photo Library . 69 LCD Overlay . 71 Camera Manager . 73 Audio . 76 Voice recording and sound libraries . 76 Tones library . 78 Video playback . 82 Streaming . 83 Known issue . 83 Chapter 5: Data Communications . 85 NetPref Library API . 85 Loading the library . 85 NetPref Library information . 87 NetPref panel . 87 NetMaster library API . 90 Usage model . 91 Loading the library . 92 Library information . 93 HTTP library . 94 Architecture . 94 Functional highlights . 95 iv Palm OS Developer Guide, Rev. E Contents httpErrorLibraryAlreadyOpen error message for Treo™ 680 smartphones . 96 HTTP library interface to SSL . ..