PBAP_SPEC_V11r00(Phone_Book_Access_Profile)

BLUETOOTH® DOC Date / Year-Month-Day Approved Revision Document No 2010-26-08 Adopted V11r00 PBAP_SPEC Prepared e-mail address N.B. Car Working Group Car-feedback@bluetooth.org PHONE BOOK ACCESS PROFILE Abstract The Phone Book Access Profile (PBAP) specification defines the procedures and protocols to exchange Phone Book objects between devices. It is especially tailored for the automotive Hands-Free use case where an onboard terminal device (typically a Car-Kit installed in the car) retrieves Phone Book objects from a mobile device (typically a mobile phone or an embedded phone). This profile may also be used by any client device that requires access to Phone Book objects stored in a server device. BLUETOOTH SPECIFICATION Page 2 of 41 Phone Book Access Profile (PBAP) 26 August 2010 Revision History Revision Date Comments D05r00 04-05-20 First preliminary draft D05r01 04-05-22 Draft 0.5 prepared for BARB review D05r02 04-06-22 BSTS Editorial Review D05r04 04-08-04 Editorial improvements D05r05 04-08-18 0.5 level BARB comments reflected D05r06 04-08-20 Addition of SIM cards handling. Clarification of the Phone Book Download feature. D05r07 04-08-25 Editorial comments and corrections included. S. Raxter D07r01 04-09-21 Result of the NissanUK Face to Face meeting D07r03 04-10-26 Editorial comments and corrections included. S. Raxter D09r01 04-11-29 0.7 level BARB comments reflected D09r02 04-11-29 Denso comments taken into account D09r03 04-11-30 Other BARB comments processed D09r04 04-12-24 Cosmetic improvements. D09r05 05-02-22 Changes from BARB review. D09r06 05-02-28 Comments included. GP. D09r07 05-03-07 Search mechanism + comments adressed D09r08 05-03-08 Fix format and spelling errors. SR. D09r09 05-03-16 More format changes and review comments- SR D09r10 05-04-10 Change mandatory Char Set requirement- SR D09r11 05-04-21 Changed Section 3.4 for IEEE language.SR D09r12 05-05-13 More feedback from the WG included. SB D09r13 05-06-25 Feedback from IOP in UPF21. SB D09r14 05-06-27 More Feedback included D09r15 06-01-12 Errata included. Additional comments from CWG review. D10r03 06-03-15 Editorial updates D10r04 06-04-12 Inclusion of errata from tech review. D10r05 06-14-13 Inclusion of additional errata from tech review V10r00 06-04-27 Adopted by the Bluetooth Board of Directors D11r00 07-08-28 Edits for core spec revision 2.1 + EDR D11r01 07-08-29 Updates from review comments D11r02 09-01-12 Security mode minor edit D11r03 09-01-14 Removed security mode table in favor of text as discussed with BARB D11r04 09-01-28 Updated text with Terry’s suggested edit D11r07 2009-08-17 Review updates (includes ver’s 5 & 6) D11r08 2009-11-03 Review comments integrated D11r09 2010-03-30 More comment resolutions D11r10 2010-04-01 Changed null to NULL in all places for consistency D1111b 2010-06-17 Voting version V11r00 2010-08-26 Adopted by the Bluetooth SIG Board of Directors BLUETOOTH SPECIFICATION Page 3 of 41 Phone Book Access Profile (PBAP) 26 August 2010 Contributors Name Company Souichi SAITO Denso Don LIECHTY Extended Systems Stephen RAXTER Johnson Controls Michael CARTER Motorola Leonard HINDS Motorola Tony MANSOUR Motorola Stephane BOUET Nissan Patrick CLAUBERG Nokia Jamie MCHARDY Nokia Jurgen SCHNITZLER Nokia Brian TRACY Nokia Nicolas BESNARD Parrot Guillaume POUJADE Parrot Terry BOURK Qualcomm Dmitri TOROPOV Siemens Erwin WEINANS Sony Ericsson Tim REILLY Stonestreet One Kentaro NAGAHAMA Toshiba Robert MALING Toyota Akira MIYAJIMA Toyota Ryan BRUNER Visteon Burch SEYMOUR Continental Automotive Systems BLUETOOTH SPECIFICATION Page 4 of 41 Phone Book Access Profile (PBAP) 26 August 2010 Disclaimer and Copyright Notice The copyright in this specification is owned by the Promoter Members of Bluetooth® Special Interest Group (SIG), Inc. (“Bluetooth SIG”). Use of these specifications and any related intellectual property (collectively, the “Specification”), is governed by the Promoters Membership Agreement among the Promoter Members and Bluetooth SIG (the “Promoters Agreement”), certain membership agreements between Bluetooth SIG and its Adopter and Associate Members (the “Membership Agreements”) and the Bluetooth Specification Early Adopters Agreements (1.2 Early Adopters Agreements) among Early Adopter members of the unincorporated Bluetooth SIG and the Promoter Members (the “Early Adopters Agreement”). Certain rights and obligations of the Promoter Members under the Early Adopters Agreements have been assigned to Bluetooth SIG by the Promoter Members. Use of the Specification by anyone who is not a member of Bluetooth SIG or a party to an Early Adopters Agreement (each such person or party, a “Member”) is prohibited. The legal rights and obligations of each Member are governed by their applicable Membership Agreement, Early Adopters Agreement or Promoters Agreement. No license, express or implied, by estoppel or otherwise, to any intellectual property rights are granted herein. Any use of the Specification not in compliance with the terms of the applicable Membership Agreement, Early Adopters Agreement or Promoters Agreement is prohibited and any such prohibited use may result in termination of the applicable Membership Agreement or Early Adopters Agreement and other liability permitted by the applicable agreement or by applicable law to Bluetooth SIG or any of its members for patent, copyright and/or trademark infringement. THE SPECIFICATION IS PROVIDED “AS IS” WITH NO WARRANTIES WHATSOEVER, INCLUDING ANY WARRANTY OF MERCHANTABILITY, NONINFRINGEMENT, FITNESS FOR ANY PARTICULAR PURPOSE, SATISFACTORY QUALITY, OR REASONABLE SKILL OR CARE, OR ANY WARRANTY ARISING OUT OF ANY COURSE OF DEALING, USAGE, TRADE PRACTICE, PROPOSAL, SPECIFICATION OR SAMPLE. Each Member hereby acknowledges that products equipped with the Bluetooth technology ("Bluetooth products") may be subject to various regulatory controls under the laws and regulations of various governments worldwide. Such laws and regulatory controls may govern, among other things, the combination, operation, use, implementation and distribution of Bluetooth products. Examples of such laws and regulatory controls include, but are not limited to, airline regulatory controls, telecommunications regulations, technology transfer controls and health and safety regulations. Each Member is solely responsible for the compliance by their Bluetooth Products with any such laws and regulations and for obtaining any and all required authorizations, permits, or licenses for their Bluetooth products related to such regulations within the applicable jurisdictions. Each Member acknowledges that nothing in the Specification provides any information or assistance in connection with securing such compliance, authorizations or licenses. NOTHING IN THE SPECIFICATION CREATES ANY WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING SUCH LAWS OR REGULATIONS. ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY INTELLECTUAL PROPERTY RIGHTS OR FOR NONCOMPLIANCE WITH LAWS, RELATING TO USE OF THE SPECIFICATION IS EXPRESSLY DISCLAIMED. BY USE OF THE SPECIFICATION, EACH MEMBER EXPRESSLY WAIVES ANY CLAIM AGAINST BLUETOOTH SIG AND ITS PROMOTER MEMBERS RELATED TO USE OF THE SPECIFICATION. Bluetooth SIG reserve the right to adopt any changes or alterations to the Specification as it deems necessary or appropriate. Copyright © 2001–2010. Bluetooth SIG Inc. All copyrights in the Bluetooth Specifications themselves are owned by Ericsson AB, Lenovo, Intel Corporation, Microsoft Corporation, Motorola, Inc., Nokia Corporation, and Toshiba Corporation. *Other third-party brands and names are the property of their respective owners. *Other third-party brands and names are the property of their respective owners. BLUETOOTH SPECIFICATION Page 5 of 41 Phone Book Access Profile (PBAP) 26 August 2010 Contents 1 Introduction .................................................................................................................................... 8 1.1 Scope ......................................................................................................................................... 8 1.2 Profile Dependencies ................................................................................................................ 8 1.3 Symbols and conventions .......................................................................................................... 8 1.3.1 Requirement status symbols ............................................................................................... 8 1.3.2 Signaling diagram conventions ........................................................................................... 9 2 Profile Overview ........................................................................................................................... 10 2.1 Profile stack ............................................................................................................................. 10 2.2 Configuration and roles ........................................................................................................... 10 2.3 User Requirements and Scenarios ......................................................................................... 11 2.4 Profile Fundamentals ............................................................................................................... 11 2.5 Bluetooth Security ................................................................................................................... 12 2.6 Conformance ........................................................................................................................... 12 3 Application layer .......................................................................................................................... 13 3.1 Phone Book Access Profile Objects and Formats................................................................... 13 3.1.1 Phone Book Repositories ................................................................................................. 13 3.1.2 Phone Book Objects ......................................................................................................... 13 3.1.3 Phone Book object representations .................................................................................. 13 3.1.4 Phone Book Entries format ............................................................................................... 14 3.1.5 PBAP virtual folders structure ........................................................................................... 14 3.1.6 vCard-Listing Object (x-bt/vcard-listing) ............................................................................ 17 4 Phone Book Access Features .................................................................................................... 19 4.1 Phone Book Access Profile Features ...................................................................................... 19 4.2 Phone Book Download Feature .............................................................................................. 19 4.3 Phone Book Browsing Feature ................................................................................................ 20 5 Phone Book Access Profile Functions ...................................................................................... 22 5.1 PullPhoneBook Function ......................................................................................................... 22 5.1.1 Connection ID ................................................................................................................... 22 5.1.2 Name ................................................................................................................................. 22 5.1.3 Type .................................................................................................................................. 23 5.1.4 Application Parameters Header ........................................................................................ 23 5.2 SetPhoneBook Function .......................................................................................................... 25 5.3 PullvCardListing Function ........................................................................................................ 26 5.3.1 Connection ID ................................................................................................................... 27 5.3.2 Type .................................................................................................................................. 27 5.3.3 Name ................................................................................................................................. 27 5.3.4 Application Parameters ..................................................................................................... 27 5.4 PullvCardEntry Function .......................................................................................................... 29 5.4.1 Connection ID ................................................................................................................... 29 5.4.2 Name ................................................................................................................................. 29 5.4.3 Type .................................................................................................................................. 29 5.4.4 Application parameters ..................................................................................................... 29 6 OBEX ............................................................................................................................................. 32 6.1 OBEX Operations Used ........................................................................................................... 32 6.2 OBEX Headers ........................................................................................................................ 32 6.2.1 Application Parameters Header ........................................................................................ 33 6.2.2 OBEX Headers in Multi-Packet Responses ...................................................................... 33 6.2.3 OBEX Error Codes ............................................................................................................ 33 6.3 Initializing OBEX ...................................................................................................................... 35 6.4 Establishing an OBEX Session ............................................................................................... 36 6.5 Terminate an OBEX Session ................................................................................................... 36 7 Service Discovery ........................................................................................................................ 37 7.1 SDP Interoperability Requirements ......................................................................................... 37 BLUETOOTH SPECIFICATION Page 6 of 41 Phone Book Access Profile (PBAP) 26 August 2010 7.1.1 SDP record for the PCE device ........................................................................................ 37 7.1.2 SDP record for the PSE device ......................................................................................... 37 7.1.3 Class Of Device/Service Field .......................................................................................... 37 8 Generic Access Profile ................................................................................................................ 38 8.1 Modes ...................................................................................................................................... 38 8.2 Security Aspects ...................................................................................................................... 38 8.2.1 Bonding ............................................................................................................................. 39 9 References .................................................................................................................................... 40 10 ANNEX A: Synopsis of the PBAP functions.............................................................................. 41 Figures Figure 1.1: Conventions used in signaling diagrams .................................................................................... 9 Figure 2.1: Profile Stack .............................................................................................................................. 10 Figure 2.2: Phone Book Access Profile applied to the Hands-Free use case ............................................ 11 Figure 3.1: PBAP virtual folders architecture .............................................................................................. 15 Figure 4.1: Phone Book Download Sequence ............................................................................................ 19 Figure 4.2: Phone Book Browsing Sequence ............................................................................................. 21 Figure 6.1:Logical tree of the PBAP error codes: ....................................................................................... 35 Tables Table 5.1: Attribute Mask ............................................................................................................................ 24 Table 5.2 Attribute Mask ............................................................................................................................. 31 Table 6.1 OBEX Operations........................................................................................................................ 32 Table 6.2 OBEX Headers ............................................................................................................................ 32 Table 6.3: Application Parameter Headers ................................................................................................. 33 Table 6.4 Error Codes ................................................................................................................................. 34 Table 8.1: Modes ........................................................................................................................................ 38 Table 8.3: Idle Mode Procedures ................................................................................................................ 38 BLUETOOTH SPECIFICATION Page 7 of 41 Phone Book Access Profile (PBAP) 26 August 2010 Foreword Interoperability between devices from different manufacturers is provided for a specific service and usage model if the devices conform to a Bluetooth SIG defined profile specification. A profile defines a selection of messages and procedures (generally termed capabilities) from the Bluetooth SIG specifications and gives an unambiguous description of the air interface for specified service(s) and usage model(s). All defined features are process-mandatory. This means that if a feature is used, it is used in a specified manner. Whether the provision of a feature is mandatory or optional is stated separately for both the Client role and the Server role. BLUETOOTH SPECIFICATION Page 8 of 41 Phone Book Access Profile (PBAP) 26 August 2010 1 Introduction 1.1 Scope The Phone Book Access Profile (PBAP) defines the protocols and procedures that shall be used by devices for the retrieval of phone book objects. It is based on a Client-