Symbian OS Communications (Symbian Books)

Symbian OSCommunicationsProgramming2nd EditionSymbian OSCommunicationsProgramming2nd EditionByIain CampbellWithDale Self, Emlyn Howell, Ian Bunning, Ibrahim Rahman, LucyCaffery, Malcolm Box, Matthew Elliott, Natasha Ho, PierreCochart, Tim Howes, Twm DaviesReviewed byChris Notton, Dan Handley, David Harper, David Singleton,Donald Page, Graeme Duncan, Ian Bunning, John Roe, MalcolmBox, Tim HowesHead of Symbian PressFreddie GjertsenManaging EditorSatu McNabbCopyright ¤ 2007Symbian Software LtdPublished byJohn Wiley & Sons, Ltd The Atrium, Southern Gate, Chichester,West Sussex PO19 8SQ, EnglandTelephone (+44) 1243 779777Email (for orders and customer service enquiries): cs-books@wiley.co.ukVisit our Home Page on www.wileyeurope.com or www.wiley.comAll Rights Reserved.

No part of this publication may be reproduced, stored in a retrieval system ortransmitted in any form or by any means, electronic, mechanical, photocopying, recording, scanning orotherwise, except under the terms of the Copyright, Designs and Patents Act 1988 or under the terms ofa licence issued by the Copyright Licensing Agency Ltd, 90 Tottenham Court Road, London W1T 4LP,UK, without the permission in writing of the Publisher.

Requests to the Publisher should be addressed tothe Permissions Department, John Wiley & Sons Ltd, The Atrium, Southern Gate, Chichester, WestSussex PO19 8SQ, England, or emailed to permreq@wiley.co.uk, or faxed to (+44) 1243 770620.Designations used by companies to distinguish their products are often claimed as trademarks. Allbrand names and product names used in this book are trade names, service marks, trademarks orregistered trademarks of their respective owners.

The Publisher is not associated with any product orvendor mentioned in this book.This publication is designed to provide accurate and authoritative information in regard to the subjectmatter covered. It is sold on the understanding that the Publisher is not engaged in renderingprofessional services.

If professional advice or other expert assistance is required, the services of acompetent professional should be sought.The Bluetooth£ word mark and logos are registered trademarks owned by Bluetooth SIG, Inc. and anyuse of such marks by Symbian Software Ltd is under license.

Other trademarks and trade names arethose of their respective owners.Other Wiley Editorial OfficesJohn Wiley & Sons Inc., 111 River Street, Hoboken, NJ 07030, USAJossey-Bass, 989 Market Street, San Francisco, CA 94103-1741, USAWiley-VCH Verlag GmbH, Boschstr.

12, D-69469 Weinheim, GermanyJohn Wiley & Sons Australia Ltd, 42 McDougall Street, Milton, Queensland 4064, AustraliaJohn Wiley & Sons (Asia) Pte Ltd, 2 Clementi Loop #02-01, Jin Xing Distripark, Singapore 129809John Wiley & Sons Canada Ltd, 6045 Freemont Blvd, Mississauga, Ontario, L5R 4J3, CanadaWiley also publishes its books in a variety of electronic formats. Some content thatappears in print may not be available in electronic books.Library of Congress Cataloging-in-Publication DataCampbell, Iain.Symbian OS communications programming / Iain Campbell, with Dale Self . .

.[et al.]. – 2nd Edition.p. cm.Previously published: Symbian OS communications programming / Michael J.Jipping, 2002.Includes bibliographical references and index.ISBN 978-0-470-51228-9 (pbk. : alk. paper)1. Symbian OS (Computer file) 2. Operating systems (Computers) 3. Datatransmission systems. I. Jipping, Michael J. Symbian OS communicationsprogramming. II.

Title.QA76.76.063J56 2997055.4 482 – dc222007011028British Library Cataloguing in Publication DataA catalogue record for this book is available from the British LibraryISBN: 978-0-470-51228-9Typeset in 10/12pt Optima by Laserwords Private Limited, Chennai, IndiaPrinted and bound in Great Britain by Bell & Bain, GlasgowThis book is printed on acid-free paper responsibly manufactured from sustainableforestry in which at least two trees are planted for each one used for paper production.ContentsContributorsixAbout the AuthorsxiAcknowledgmentsxvSymbian Press AcknowledgementsxviiSection I: Introduction and Overview1Introduction31.11.21.31.41.534671.61.71.81.91.102What is in this BookWhat isn’t in this BookExpected Level of KnowledgeStructure of this BookTo which Versions of Symbian OS does theInformation in this Book Apply?Example ApplicationsReading GuideOther Sources of InformationThe History of Symbian OS CommunicationsSummary89991012Overview132.12.22.3141923Low-level FunctionalityHigh-level FunctionalitySummaryviCONTENTSSection II: Low-level Technologyand Frameworks34An Introduction to ESOCK273.13.23.3275262Bluetooth4.14.24.34.44.55636382112118124125IntroductionInfrared OverviewIrDA in Symbian OSSummary125125129153IP and Related Technologies1556.16.26.36.46.56.66.77Bluetooth Technology OverviewBluetooth in Symbian OSExample Symbian OS Bluetooth ApplicationAV Protocols and ProfilesSummaryInfrared5.15.25.35.46Overview of ESOCKInto PracticeSummaryIP Networks OverviewIP Networks and Symbian OSNetwork Bearer Technologies in Symbian OSUsing the Network ConnectionInformation Gathering and Connection ManagementQuality of ServiceSummaryTelephony in Symbian OS7.17.27.37.4OverviewUsing the ETel ISV APIRestrictions and ConsiderationsSummary156160163175193197203205206207211214Section III: High-level Technologyand Frameworks8Receiving Messages8.18.28.38.4Example Application – Summary ScreenThe Message ServerThe Message StoreMessaging Application Design and Implementation217218220223233CONTENTS8.58.69Receiving Application-specific SMS MessagesSummarySending Messages9.19.29.39.49.59.69.79.89.99.109.119.129.139.149.15Examples Provided in this ChapterSendAs OverviewServices/AccountsTechnical DescriptionUsing the UI Platform Send DialogsA Brief Background to MTMsThe Flickr MTMThe Flickr Data MTMThe Flickr UI MTMFlickr Client MTMThe Flickr Server MTMMTM DLLs and PlatsecFlickrMTM Shared SettingsInstallation of an MTMSummary10 OBEX10.110.210.3OBEX OverviewOBEX in Symbian OSSummary11 HTTP11.111.211.311.411.511.611.711.811.911.1011.1111.1211.1311.14235240241242242246246250255257260262263265268269269271273273289341343HTTP OverviewGetting Started: Creating a SessionCreating and Submitting a TransactionSupplying Body DataMonitoring a TransactionCancelling a TransactionClosing a TransactionStringpoolProxy SupportCookie HandlingHTTP Connection ConfigurationPlatform SecurityFiltersSummary12 OMA Device Management12.112.212.3viiIntroductionDevice Management In Symbian OSOMA Device Management Essentials343344347349350353353353355356356361361364365365366367viiiCONTENTS12.412.5The Example DM AdapterSummary372387Section IV: Development Tips13 Setting Up for Development13.113.213.313.413.513.6BluetoothIrDANetwork Connections for IPTelephony‘Help, help, my serial port’s been stolen’Summary14 The Future14.114.214.314.4Better NetworksBetter InteractionBetter ServicesThe End391391394396403404406407407409410411Appendix A: Web Resources413Appendix B: Authorizing FlickrMTM to Use YourFlickr Account415Appendix C: SendWorkBench.app Guide419Index421ContributorsHead of Symbian PressFreddie GjertsenAuthorsIain CampbellDale SelfEmlyn HowellIan BunningIbrahim RahmanLucy CafferyMalcolm BoxMatthew ElliottNatasha HoPierre CochartTim HowesTwm DaviesSymbian Press EditorialManaging EditorSatu McNabbxCONTRIBUTORSReviewers and additional contributorsChris NottonDan HandleyDavid HarperDavid SingletonDonald PageGraeme DuncanIan BunningJohn RoeMalcolm BoxTim HowesAbout the AuthorsIain Campbell, lead authorIain joined the comms team (as it then was) in Symbian in 2001, workingon Symbian OS v6.1, v7.0 and v7.0s for the Nokia 7650, Sony EricssonP800 and Nokia 6600, respectively.

After spending a year working in theBluetooth team creating the Symbian OS PAN profile implementation, hemoved to Symbian’s Technical Consulting group where he has spent thelast three years helping Symbian’s licensees and partners build SymbianOS-based phones. As part of this Iain has been involved in many aspectsof Symbian OS – from debugging components at all levels of the system,through advising on adaptation to particular hardware platforms, tohigh-level system design. Iain received an MEng in Information SystemsEngineering from Imperial College, London, and enjoys spending hisspare time finding out how things work.Malcolm BoxMalcolm first joined Psion Software in 1998, shortly before it becameSymbian. His first job was writing the kernel for the Ericsson R380 phone,following which he led the design and implementation of the SymbianOS Bluetooth stack.

Subsequently he’s worked in the System Architecturegroup, Symbian’s reference design team and with licensees as a seniorconsultant. He has previously co-authored Symbian C++ for MobilePhones and contributes to various open-source projects. He would liketo thank his wife, Judith, and children Franz and Abigail for their supportand patience during the writing of this book.xiiABOUT THE AUTHORSIan BunningIan attended Trinity Hall at the University of Cambridge, where he gainedan MA in Computer Science. On graduating in 2001 he joined theShortlink team at Symbian, and soon became the expert on the IrDAsubsystem.