ETSI TS 103 544-10-2017 Publicly Available Specification (PAS) Intelligent Transport Systems (ITS) MirrorLink Part 10 UPnP Client Profile Service (V1 3 0).pdf

1、 ETSI TS 103 544-10 V1.3.0 (2017-10) Publicly Available Specification (PAS); Intelligent Transport Systems (ITS); MirrorLink; Part 10: UPnP Client Profile Service CAUTION The present document has been submitted to ETSI as a PAS produced by CCC and approved by the ETSI Technical Committee Intelligent

2、 Transport Systems (ITS). CCC is owner of the copyright of the document CCC-TS-026 and/or had all relevant rights and had assigned said rights to ETSI on an “as is basis“. Consequently, to the fullest extent permitted by law, ETSI disclaims all warranties whether express, implied, statutory or other

3、wise including but not limited to merchantability, non-infringement of any intellectual property rights of third parties. No warranty is given about the accuracy and the completeness of the content of the present document. TECHNICAL SPECIFICATION ETSI ETSI TS 103 544-10 V1.3.0 (2017-10)2 Reference D

4、TS/ITS-88-10 Keywords interface, ITS, PAS, smartphone ETSI 650 Route des Lucioles F-06921 Sophia Antipolis Cedex - FRANCE Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 Siret N 348 623 562 00017 - NAF 742 C Association but non lucratif enregistre la Sous-Prfecture de Grasse (06) N 7803/88 Important

5、notice The present document can be downloaded from: http:/www.etsi.org/standards-search The present document may be made available in electronic versions and/or in print. The content of any electronic and/or print versions of the present document shall not be modified without the prior written autho

6、rization of ETSI. In case of any existing or perceived difference in contents between such versions and/or in print, the only prevailing document is the print of the Portable Document Format (PDF) version kept on a specific network drive within ETSI Secretariat. Users of the present document should

7、be aware that the document may be subject to revision or change of status. Information on the current status of this and other ETSI documents is available at https:/portal.etsi.org/TB/ETSIDeliverableStatus.aspx If you find errors in the present document, please send your comment to one of the follow

8、ing services: https:/portal.etsi.org/People/CommiteeSupportStaff.aspx Copyright Notification No part may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying and microfilm except as authorized by written permission of ETSI. The content of the PDF ve

9、rsion shall not be modified without the written authorization of ETSI. The copyright and the foregoing restriction extend to reproduction in all media. ETSI 2017. Car Connectivity Consortium 2011-2017. All rights reserved. ETSI logo is a Trade Mark of ETSI registered for the benefit of its Members.

10、MirrorLink is a registered trademark of Car Connectivity Consortium LLC. RFB and VNC are registered trademarks of RealVNC Ltd. UPnP is a registered trademark of UPnP Forum. Other names or abbreviations used in the present document may be trademarks of their respective owners. DECTTM, PLUGTESTSTM, UM

11、TSTMand the ETSI logo are trademarks of ETSI registered for the benefit of its Members. 3GPPTM and LTE are trademarks of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. oneM2M logo is protected for the benefit of its Members. GSM and the GSM logo are trademark

12、s registered and owned by the GSM Association. ETSI ETSI TS 103 544-10 V1.3.0 (2017-10)3 Contents Intellectual Property Rights 4g3Foreword . 4g3Modal verbs terminology 4g31 Scope 5g32 References 5g32.1 Normative references . 5g32.2 Informative references 6g33 Definitions, symbols and abbreviations .

13、 6g34 Service Modeling Definitions 6g34.1 Service Type . 6g34.2 State Variables 6g34.2.1 State Variable Overview . 6g34.2.2 UnusedProfileIDs . 6g34.2.3 A_ARG_TYPE_ClientProfile. 7g34.2.4 A_ARG_TYPE_ProfileID 13g34.2.5 A_ARG_TYPE_String . 13g34.2.6 A_ARG_TYPE_INT 13g34.2.7 A_ARG_TYPE_Bool . 13g34.2.8

14、 MaxNumProfiles . 13g34.3 Eventing and Moderation . 14g34.4 Managing Multiple Client Profiles . 14g34.5 Actions . 14g34.5.1 General 14g34.5.2 GetMaxNumProfiles . 14g34.5.2.1 General 14g34.5.2.2 Arguments. 15g34.5.2.3 Error Codes for GetMaxNumProfiles . 15g34.5.3 SetClientProfile . 15g34.5.3.1 Genera

15、l 15g34.5.3.2 Arguments. 15g34.5.3.3 Error Codes for SetClientProfile . 16g34.5.4 GetClientProfile 17g34.5.4.1 General 17g34.5.4.2 Arguments. 17g34.5.4.3 Error Codes for GetClientProfile 17g34.5.5 Relationships Between Actions 18g34.5.6 Error Code Summary 18g35 Theory of Operation . 18g35.1 Use of Q

16、uotation Marks . 18g35.2 Client Certificates . 19g35.2.1 Client Device Certificate 19g35.2.2 Client CA Certificate 20g35.2.3 Testing Considerations . 20g35.3 Example Values of State Variables 20g35.3.1 UnusedProfileIDs . 20g35.3.2 A_ARG_TYPE_ClientProfile. 20g36 A_ARG_TYPE_ClientProfile XSD Schema .

17、 21g37 XML Service Description 24g3Annex A (informative): Authors and Contributors . 27g3History 28 ETSI ETSI TS 103 544-10 V1.3.0 (2017-10)4 Intellectual Property Rights Essential patents IPRs essential or potentially essential to the present document may have been declared to ETSI. The information

18、 pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found in ETSI SR 000 314: “Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in respect of ETSI standards“, which is available from the ETSI S

19、ecretariat. Latest updates are available on the ETSI Web server (https:/ipr.etsi.org/). Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updat

20、es on the ETSI Web server) which are, or may be, or may become, essential to the present document. Trademarks The present document may include trademarks and/or tradenames which are asserted and/or registered by their owners. ETSI claims no ownership of these except for any which are indicated as be

21、ing the property of ETSI, and conveys no right to use or reproduce any trademark and/or tradename. Mention of those trademarks in the present document does not constitute an endorsement by ETSI of products, services or organizations associated with those trademarks. Foreword This Technical Specifica

22、tion (TS) has been produced by ETSI Technical Committee Intelligent Transport Systems (ITS). The present document is part 10 of a multi-part deliverable. Full details of the entire series can be found in part 1 i.1. Modal verbs terminology In the present document “shall“, “shall not“, “should“, “sho

23、uld not“, “may“, “need not“, “will“, “will not“, “can“ and “cannot“ are to be interpreted as described in clause 3.2 of the ETSI Drafting Rules (Verbal forms for the expression of provisions). “must“ and “must not“ are NOT allowed in ETSI deliverables except when used in direct citation. ETSI ETSI T

24、S 103 544-10 V1.3.0 (2017-10)5 1 Scope The present document is part of the MirrorLinkspecification which specifies an interface for enabling remote user interaction of a mobile device via another device. The present document is written having a vehicle head-unit to interact with the mobile device in

25、 mind, but it will similarly apply for other devices, which provide a color display, audio input/output and user input mechanisms. The TmClientProfile service is a UPnP service that allows control points to register client profiles with the MirrorLink Server device and notifies it regarding MirrorLi

26、nk Client preferences, settings and capabilities, which is be used for governing the interaction between the MirrorLink Server and the Client. 2 References 2.1 Normative references References are either specific (identified by date of publication and/or edition number or version number) or non-speci

27、fic. For specific references, only the cited version applies. For non-specific references, the latest version of the referenced document (including any amendments) applies. Referenced documents which are not found to be publicly available in the expected location might be found at https:/docbox.etsi

28、.org/Reference. NOTE: While any hyperlinks included in this clause were valid at the time of publication, ETSI cannot guarantee their long-term validity. The following referenced documents are necessary for the application of the present document. 1 UPnPTMForum: “UPnPTMDevice Architecture 1.1“, 15 O

29、ctober 2008. NOTE: Available at http:/www.upnp.org. 2 ETSI TS 103 544-2 (V1.3.0): “Publicly Available Specification (PAS); Intelligent Transport Systems (ITS); MirrorLink; Part 2: Virtual Network Computing (VNC) based Display and Control“. 3 ETSI TS 103 544-3 (V1.3.0): “Publicly Available Specificat

30、ion (PAS); Intelligent Transport Systems (ITS); MirrorLink; Part 3: Audio“. 4 ETSI TS 103 544-26 (V1.3.0): “Publicly Available Specification (PAS); Intelligent Transport Systems (ITS); MirrorLink; Part 26: Consumer Experience Principles and Basic Features“. 5 W3C Recommendation, 10 June 2008: “XML S

31、ignature Syntax and Processing (Second Edition)“. NOTE: Available at http:/www.w3.org/TR/xmldsig-core/. 6 Unicode Consortium: “Unicode 7.0 Character Code Charts“. NOTE: Available at http:/www.unicode.org/charts/. ETSI ETSI TS 103 544-10 V1.3.0 (2017-10)6 2.2 Informative references References are eit

32、her specific (identified by date of publication and/or edition number or version number) or non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the referenced document (including any amendments) applies. NOTE: While any hyperlinks

33、 included in this clause were valid at the time of publication, ETSI cannot guarantee their long-term validity. The following referenced documents are not necessary for the application of the present document but they assist the user with regard to a particular subject area. i.1 ETSI TS 103 544-1 (V

34、1.3.0): “Publicly Available Specification (PAS); Intelligent Transport Systems (ITS); MirrorLink; Part 1: Connectivity“. 3 Definitions, symbols and abbreviations Not applicable. 4 Service Modeling Definitions 4.1 Service Type The following service type identifies a service that is compliant with the

35、 present document: urn:schemas-upnp-org:service:TmClientProfile:1. TmClientProfile service is used herein to refer to this service type. The TmClientProfile service shall follow defined UPnP behaviour within the UPnP Device Architecture 1.1 1. 4.2 State Variables 4.2.1 State Variable Overview Table

36、4-1: Service State Variables Variable Name Req. or Opt. Data Type Allowed Value Default Value Eng. Units UnusedProfileIDs R string Undefined Empty string N/A A_ARG_TYPE_ClientProfile R string Undefined Empty string N/A A_ARG_TYPE_ProfileID R ui4 Undefined 0 N/A A_ARG_TYPE_String R string Undefined E

37、mpty string N/A A_ARG_TYPE_INT R integer Undefined 0 N/AA_ARG_TYPE_Bool R string true | false false N/A MaxNumProfiles R ui2 Undefined 1 N/A1R = REQUIRED, O = OPTIONAL, X = Non-standard 4.2.2 UnusedProfileIDs A string formatted as UTF-8 which consists of a comma separated list of profileIDs that are

38、 currently not being used by any MirrorLink service hosted on the device. Each entry in the list is of type A_ARG_TYPE_ProfileID. ETSI ETSI TS 103 544-10 V1.3.0 (2017-10)7 This state variable is evented hence, any MirrorLink UPnP Control Point is notified using eventing mechanisms whenever the list

39、of unused profileIDs changes. Support for multiple Client Profiles reserved for future use, therefore only profileID=0 shall be initially available. 4.2.3 A_ARG_TYPE_ClientProfile A string formatted as UTF-8 XML represents identification and monitoring capability information of the MirrorLink Client

40、. Its structure is given in table 4-2. Table 4-2: Structure of A_ARG_TYPE_ClientProfile Element Description Parent Availability clientProfile Profile Information about a MirrorLink Client - Mandatory clientID ID of the MirrorLink Client (A_ARG_TYPE_String) clientProfile Mandatory friendlyName Short

41、user-friendly description of client (A_ARG_TYPE_String) clientProfile Optional manufacturer Manufacturer Name (A_ARG_TYPE_String) clientProfile Mandatory modelName Model Name (A_ARG_TYPE_String) clientProfile Optional modelNumber Model Number (A_ARG_TYPE_String) clientProfile Mandatory iconPreferenc

42、e Desired properties for icons delivered from the MirrorLink Server device clientProfile Optional mimetype Type of icon image (A_ARG_TYPE_String) Default: “image/png” iconPreference Optional width Width of icon (A_ARG_TYPE_INT) Default: “128” iconPreference Optional height Height of icon (A_ARG_TYPE

43、_INT) Default: “128” iconPreference Optional depth Color depth of icon (A_ARG_TYPE_INT) Default: “24” iconPreference Optional connectivity Client Connectivity settings clientProfile Optional bluetooth+Bluetooth settings connectivity Optional bdAddr Bluetooth MAC address (BD_ADDR). Indicates device s

44、upport for Bluetooth on the MirrorLink Client. (A UTF-8 encoded string representing an unsigned 48-bit integer in hexadecimal format (without any “0x” prefix).) bluetooth Optional startConnection A_ARG_TYPE_Bool Bluetooth Connection will be initiated from MirrorLink Client Default: “true” bluetooth

45、Optional wifi WiFi settings of the device connectivity Optional ETSI ETSI TS 103 544-10 V1.3.0 (2017-10)8 Element Description Parent Availability macAddr WiFi MAC address (A UTF-8 encoded string representing an unsigned 48-bit integer in hexadecimal format (without any “0x” prefix, and without any g

46、rouping using “:”, “.” or “-”) wifi Mandatory ssid Service Set Identifier (SSID), Base64 encoded (A_ARG_TYPE_String) wifi Optional roles Comma separated list of supported roles. Allowed values are AP (Access Point role) Client (Client role) P2P (Infrastructure-less) (A_ARG_TYPE_String) Default: AP,C

47、lient,P2P wifi Optional protectionList List of WiFi access protection wifi Optional protection* Access protection protectionList Optionalprotocol Security protocol used to protect WiFi access. Allowed values are WEP WPA WPA2 WPS NOTE: WEP/WPA is listed for legacy reasons, and should not be used (A_A

48、RG_TYPE_String) protection Mandatory passkey Passkey/Shared key, Base64 encoded Shall be left empty, if transmitted over an unprotected or shared transport channel (e.g. WiFi) (A_ARG_TYPE_String) protection Mandatory rtpStreaming RTP streaming parameters clientProfile Optional payloadType Comma sepa

49、rated list of supported RTP playload types. (A_ARG_TYPE_String) Default: “99” rtpStreaming Optional audioIPL Audio Initial Playback Latency in reference to payload type 99. (A_ARG_TYPE_INT) Default: “4800” rtpStreaming Optional audioMPL Audio Maximum Playback Length in reference to payload type 99. (A_ARG_TYPE_INT) Default: “9600” rtpStreaming Optional lssMax Maximum Latency Switched Sources time as defined in 3. Value is in ms. (A_ARG_TYPE_INT) rtpStreaming Mandatory lssAvg Average Latency Switched Sources time as defined in