Symbian OS Communications Programming. 2nd Edition

Size: px

Start display at page:

Download "Symbian OS Communications Programming. 2nd Edition"

Ira Underwood
5 years ago
Views:

3 Symbian OS Communications Programming 2nd Edition

5 Symbian OS Communications Programming 2nd Edition By Iain Campbell With Dale Self, Emlyn Howell, Ian Bunning, Ibrahim Rahman, Lucy Caffery, Malcolm Box, Matthew Elliott, Natasha Ho, Pierre Cochart, Tim Howes, Twm Davies Reviewed by Chris Notton, Dan Handley, David Harper, David Singleton, Donald Page, Graeme Duncan, Ian Bunning, John Roe, Malcolm Box, Tim Howes Head of Symbian Press Freddie Gjertsen Managing Editor Satu McNabb

6 Copyright 2007 Published by Symbian Software Ltd John Wiley & Sons, Ltd The Atrium, Southern Gate, Chichester, West Sussex PO19 8SQ, England Telephone (+44) (for orders and customer service enquiries): Visit our Home Page on or All Rights Reserved. No part of this publication may be reproduced, stored in a retrieval system or transmitted in any form or by any means, electronic, mechanical, photocopying, recording, scanning or otherwise, except under the terms of the Copyright, Designs and Patents Act 1988 or under the terms of a 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 to the Permissions Department, John Wiley & Sons Ltd, The Atrium, Southern Gate, Chichester, West Sussex PO19 8SQ, England, or ed to permreq@wiley.co.uk, or faxed to (+44) Designations used by companies to distinguish their products are often claimed as trademarks. All brand names and product names used in this book are trade names, service marks, trademarks or registered trademarks of their respective owners. The Publisher is not associated with any product or vendor mentioned in this book. This publication is designed to provide accurate and authoritative information in regard to the subject matter covered. It is sold on the understanding that the Publisher is not engaged in rendering professional services. If professional advice or other expert assistance is required, the services of a competent professional should be sought. The Bluetooth word mark and logos are registered trademarks owned by Bluetooth SIG, Inc. and any use of such marks by Symbian Software Ltd is under license. Other trademarks and trade names are those of their respective owners. Other Wiley Editorial Offices John Wiley & Sons Inc., 111 River Street, Hoboken, NJ 07030, USA Jossey-Bass, 989 Market Street, San Francisco, CA , USA Wiley-VCH Verlag GmbH, Boschstr. 12, D Weinheim, Germany John Wiley & Sons Australia Ltd, 42 McDougall Street, Milton, Queensland 4064, Australia John Wiley & Sons (Asia) Pte Ltd, 2 Clementi Loop #02-01, Jin Xing Distripark, Singapore John Wiley & Sons Canada Ltd, 6045 Freemont Blvd, Mississauga, Ontario, L5R 4J3, Canada Wiley also publishes its books in a variety of electronic formats. Some content that appears in print may not be available in electronic books. Library of Congress Cataloging-in-Publication Data Campbell, 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, Includes bibliographical references and index. ISBN (pbk. : alk. paper) 1. Symbian OS (Computer file) 2. Operating systems (Computers) 3. Data transmission systems. I. Jipping, Michael J. Symbian OS communications programming. II. Title. QA J dc British Library Cataloguing in Publication Data A catalogue record for this book is available from the British Library ISBN: Typeset in 10/12pt Optima by Laserwords Private Limited, Chennai, India Printed and bound in Great Britain by Bell & Bain, Glasgow This book is printed on acid-free paper responsibly manufactured from sustainable forestry in which at least two trees are planted for each one used for paper production.

7 Contents Contributors About the Authors Acknowledgments Symbian Press Acknowledgements ix xi xv xvii Section I: Introduction and Overview 1 Introduction What is in this Book What isn t in this Book Expected Level of Knowledge Structure of this Book To which Versions of Symbian OS does the Information in this Book Apply? Example Applications Reading Guide Other Sources of Information The History of Symbian OS Communications Summary 12 2 Overview Low-level Functionality High-level Functionality Summary 23

8 vi CONTENTS Section II: Low-level Technology and Frameworks 3 An Introduction to ESOCK Overview of ESOCK Into Practice Summary 62 4 Bluetooth Bluetooth Technology Overview Bluetooth in Symbian OS Example Symbian OS Bluetooth Application AV Protocols and Profiles Summary Infrared Introduction Infrared Overview IrDA in Symbian OS Summary IP and Related Technologies IP Networks Overview IP Networks and Symbian OS Network Bearer Technologies in Symbian OS Using the Network Connection Information Gathering and Connection Management Quality of Service Summary Telephony in Symbian OS Overview Using the ETel ISV API Restrictions and Considerations Summary 214 Section III: High-level Technology and Frameworks 8 Receiving Messages Example Application Summary Screen The Message Server The Message Store Messaging Application Design and Implementation 233

9 CONTENTS vii 8.5 Receiving Application-specific SMS Messages Summary Sending Messages Examples Provided in this Chapter SendAs Overview Services/Accounts Technical Description Using the UI Platform Send Dialogs A Brief Background to MTMs The Flickr MTM The Flickr Data MTM The Flickr UI MTM Flickr Client MTM The Flickr Server MTM MTM DLLs and Platsec FlickrMTM Shared Settings Installation of an MTM Summary OBEX OBEX Overview OBEX in Symbian OS Summary HTTP HTTP Overview Getting Started: Creating a Session Creating and Submitting a Transaction Supplying Body Data Monitoring a Transaction Cancelling a Transaction Closing a Transaction Stringpool Proxy Support Cookie Handling HTTP Connection Configuration Platform Security Filters Summary OMA Device Management Introduction Device Management In Symbian OS OMA Device Management Essentials 367

10 viii CONTENTS 12.4 The Example DM Adapter Summary 387 Section IV: Development Tips 13 Setting Up for Development Bluetooth IrDA Network Connections for IP Telephony Help, help, my serial port s been stolen Summary The Future Better Networks Better Interaction Better Services The End 411 Appendix A: Web Resources 413 Appendix B: Authorizing FlickrMTM to Use Your Flickr Account 415 Appendix C: SendWorkBench.app Guide 419 Index 421

11 Contributors Head of Symbian Press Freddie Gjertsen Authors Iain Campbell Dale Self Emlyn Howell Ian Bunning Ibrahim Rahman Lucy Caffery Malcolm Box Matthew Elliott Natasha Ho Pierre Cochart Tim Howes Twm Davies Symbian Press Editorial Managing Editor Satu McNabb

12 x CONTRIBUTORS Reviewers and additional contributors Chris Notton Dan Handley David Harper David Singleton Donald Page Graeme Duncan Ian Bunning John Roe Malcolm Box Tim Howes

13 About the Authors Iain Campbell, lead author Iain joined the comms team (as it then was) in Symbian in 2001, working on Symbian OS v6.1, v7.0 and v7.0s for the Nokia 7650, Sony Ericsson P800 and Nokia 6600, respectively. After spending a year working in the Bluetooth team creating the Symbian OS PAN profile implementation, he moved to Symbian s Technical Consulting group where he has spent the last three years helping Symbian s licensees and partners build Symbian OS-based phones. As part of this Iain has been involved in many aspects of Symbian OS from debugging components at all levels of the system, through advising on adaptation to particular hardware platforms, to high-level system design. Iain received an MEng in Information Systems Engineering from Imperial College, London, and enjoys spending his spare time finding out how things work. Malcolm Box Malcolm first joined Psion Software in 1998, shortly before it became Symbian. His first job was writing the kernel for the Ericsson R380 phone, following which he led the design and implementation of the Symbian OS Bluetooth stack. Subsequently he s worked in the System Architecture group, Symbian s reference design team and with licensees as a senior consultant. He has previously co-authored Symbian C++ for Mobile Phones and contributes to various open-source projects. He would like to thank his wife, Judith, and children Franz and Abigail for their support and patience during the writing of this book.

14 xii ABOUT THE AUTHORS Ian Bunning Ian attended Trinity Hall at the University of Cambridge, where he gained an MA in Computer Science. On graduating in 2001 he joined the Shortlink team at Symbian, and soon became the expert on the IrDA subsystem. Since then he has also worked on a number of OBEX projects, as well as a smaller number of Bluetooth projects the main one being part of the initial implementation of Bluetooth PAN profile. He is currently focusing on USB, but frequently supports maintenance work on IrDA and OBEX. Out of work hours, Ian is a keen photographer, and also makes items of jewellery. Lucy Caffery Pierre Cochart Lucy has been at Symbian since 2000, where she has worked for the Licensee Product Development team helping UIQ licensees to create Symbian products. Starting out as a Bluetooth specialist, she became Head of the Comms Porting group in LPD, a team which specializes in consultancy in all areas of the Symbian OS Comms subsystem. More recently Lucy has become the Deputy Head of LPD. Lucy has been involved in comms on all the UIQ devices that have shipped to date: Sony Ericsson P8xx, P9xx, M600i, W950i and P990, Motorola A92x, A1000 and M1000. Pierre Cochart graduated from King s College London in He then joined Symbian as a graduate in the telephony team to help with the development of the 7.0 OS release. In 2003 he joined Licensee Product Development group to work in the Comms Porting group where he assisted customers with software development in various areas of comms. Pierre is now responsible for handling the communications area for the Japanese licensees. Twm Davies Twm joined Symbian as a graduate in Twm has had a varied career within Symbian, initially working as a developer of the crystal messaging application which provided the UI to the Nokia communicator range, then as a technical consultant for Motorola, Nokia and significantly the technical lead on the first non-nokia S60 handset, the Siemens SX1. Twm currently works as Product Manager for performance. Twm graduated

15 ABOUT THE AUTHORS xiii from Cardiff University with a First Honours Computer Science BSc. Interests outside of work include collecting mispronunciations of his name, scuba diving, Vespas and he runs a web site selling his art works. Matt Elliott Matt joined Symbian in 2004 as a software engineer, and has spent his time at Symbian in the Device Provisioning team. He graduated with a BEng in Digital Electronics from the University of Kent, and coming from a hardware background still misses his soldering iron (but not the burnt fingers). Matt would like to thank all the past and present members of the Device Provisioning team for their carefully worded criticism/help, and his long suffering girlfriend Elaine. Natasha Ho Natasha joined Symbian in 1998, where she worked on the development of the Ericsson R380. Since then, she has contributed to almost every UIQ smartphone including the Motorola A920 and A1000, the Arima U300 and more recently the Sony Ericsson P800, P900, M600i, W950i and P990i. She has worked on various parts of the Symbian OS but now likes to concentrate solely on networking. Prior to Symbian, Natasha worked at Motorola designing and writing software for the GSM and GPRS cellular infrastructures. Natasha graduated from University College London with a BSc in Computer Science. Emlyn Howell Emlyn Howell has worked on various technologies within Symbian over the past seven years including messaging and telephony. He is currently the Comms Architect for the Reference Designs team. He lives and works in Cambridge. Tim Howes After studying for a PhD in the effects of indirect lightning strikes on power lines, Tim joined Symbian Software, where for seven years he has worked primarily within the Bluetooth area. Within the Bluetooth SIG, Tim represents Symbian on the Bluetooth Architecture Review Board, and contributes to the Core Specification, Audio Video and Medical Devices Working groups. Despite the high technology area Tim works in, he has a strong interest in mechanical timepieces.

16 xiv ABOUT THE AUTHORS Ibrahim Rahman Ibrahim has been at Symbian for eight years. Working as a software developer in areas including and HTTP. Dale Self Dale started work for Psion Software in mid-1998, which transformed to Symbian about a week later. Initially working in the messaging team on an IMAP4 mail client, he later moved to the PAN team where he has worked with Bluetooth, OBEX and USB technologies ever since. During this time he has seen a great deal of growth; both in Symbian, and, sadly, in his waist measurement.

17 Acknowledgements Firstly we d like to thank the Symbian Press team who helped put this book together, especially Satu, who kept us working on it until it was finished without her it would probably be sitting half-written on various hard disks around Symbian. Secondly we d like to thank all of our wives, husbands, partners and significant others for putting up with us whilst we hid away in the evenings and weekends writing the material for this book. I d like to thank Apple for creating a computer that s a pleasure to use it made the whole editing process so much less painful. And finally I d like to extend an additional thank you to my wife Chris, who put up with me not moving from in front of the computer for a month whilst I pulled the book into shape. Iain Campbell

19 Symbian Press Acknowledgements Symbian Press would like to thank Iain for his patience during this project and for the countless hours he spent polishing the text into perfection. We d also like to thank the authors Dale, Emlyn, Ian, Ibrahim, Lucy, Malcolm, Matt, Natasha, Pierre, Tim and Twm for their dedication and hard work, and all the reviewers for their time and willingness to share their technical knowledge.

S60 Programming A Tutorial Guide

S60 Programming A Tutorial Guide S60 Programming A Tutorial Guide Paul Coulton, Reuben Edwards With Helen Clemson Reviewed by Alex Wilbur, Alastair Milne, Filippo Finelli, Graeme Duncan, Iain Campbell,