ETSI TS 103 544-10 V1.3.1 (2019-10)
Publicly Available Specification (PAS); Intelligent Transport Systems (ITS); MirrorLink®; Part 10: UPnP Client Profile Service
Publicly Available Specification (PAS); Intelligent Transport Systems (ITS); MirrorLink®; Part 10: UPnP Client Profile Service
RTS/ITS-98-10
General Information
Standards Content (Sample)
ETSI TS 103 544-10 V1.3.1 (2019-10)
TECHNICAL SPECIFICATION
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 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 otherwise 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.
---------------------- Page: 1 ----------------------
2 ETSI TS 103 544-10 V1.3.1 (2019-10)
Reference
RTS/ITS-98-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 enregistrée à la
Sous-Préfecture de Grasse (06) N° 7803/88
Important 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 authorization of ETSI. In case of any
existing or perceived difference in contents between such versions and/or in print, the prevailing version of an ETSI
deliverable is the one made publicly available in PDF format at www.etsi.org/deliver.
Users of the present document should 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 following 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 version shall not be modified without the written authorization of ETSI.
The copyright and the foregoing restriction extend to reproduction in all media.
©ETSI 2019.
© Car Connectivity Consortium 2011-2019.
All rights reserved.
ETSI logo is a Trade Mark of ETSI registered for the benefit of its Members.
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 Open Connectivity Foundation, Inc.
Other names or abbreviations used in the present document may be trademarks of their respective owners.
DECT™, PLUGTESTS™, UMTS™ and the ETSI logo are trademarks of ETSI registered for the benefit of its Members.
3GPP™ and LTE™ are trademarks of ETSI registered for the benefit of its Members and
of the 3GPP Organizational Partners.
oneM2M™ logo is a trademark of ETSI registered for the benefit of its Members and
of the oneM2M Partners.
®
GSM and the GSM logo are trademarks registered and owned by the GSM Association.
ETSI
---------------------- Page: 2 ----------------------
3 ETSI TS 103 544-10 V1.3.1 (2019-10)
Contents
Intellectual Property Rights . 4
Foreword . 4
Modal verbs terminology . 4
1 Scope . 5
2 References . 5
2.1 Normative references . 5
2.2 Informative references . 6
3 Definition of terms, symbols and abbreviations . 6
3.1 Terms . 6
3.2 Symbols . 6
3.3 Abbreviations . 6
4 Service Modeling Definitions . 6
4.1 Service Type . 6
4.2 State Variables . 6
4.2.1 State Variable Overview . 6
4.2.2 UnusedProfileIDs . 7
4.2.3 A_ARG_TYPE_ClientProfile. 7
4.2.4 A_ARG_TYPE_ProfileID . 14
4.2.5 A_ARG_TYPE_String . 14
4.2.6 A_ARG_TYPE_INT . 14
4.2.7 A_ARG_TYPE_Bool . 14
4.2.8 MaxNumProfiles . 14
4.3 Eventing and Moderation . 14
4.4 Managing Multiple Client Profiles . 14
4.5 Actions . 15
4.5.1 General . 15
4.5.2 GetMaxNumProfiles . 15
4.5.2.1 General . 15
4.5.2.2 Arguments . 15
4.5.2.3 Error Codes for GetMaxNumProfiles . 16
4.5.3 SetClie ntP rofile . 16
4.5.3.1 General . 16
4.5.3.2 Arguments . 16
4.5.3.3 Error Codes for SetClientProfile . 17
4.5.4 GetClientProfile . 18
4.5.4.1 General . 18
4.5.4.2 Arguments . 18
4.5.4.3 Error Codes for GetClientProfile . 18
4.5.5 Relationships Between Actions . 18
4.5.6 Error Code Summary . 19
5 Theory of Operation . 19
5.1 Use of Quotation Marks . 19
5.2 Client Certificates . 20
5.2.1 Client Device Certificate . 20
5.2.2 Client CA Certificate . 21
5.2.3 Testing Considerations . 21
5.3 Example Values of State Variables . 21
5.3.1 UnusedProfileIDs . 21
5.3.2 A_ARG_TYPE_ClientProfile. 21
6 A_ARG_TYPE_ClientProfile XSD Schema . 22
7 XML Service Description . 25
Annex A (informative): Authors and Contributors . 28
History . 29
ETSI
---------------------- Page: 3 ----------------------
4 ETSI TS 103 544-10 V1.3.1 (2019-10)
Intellectual Property Rights
Essential patents
IPRs essential or potentially essential to the present document may have been declared to ETSI. The information
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 Secretariat. 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 updates 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 being 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 Specification (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", "should 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
---------------------- Page: 4 ----------------------
5 ETSI TS 103 544-10 V1.3.1 (2019-10)
1 Scope
®
The present document is part of the MirrorLink specification 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 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 MirrorLink 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-specific. 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.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.
TM TM
[1] UPnP Forum: "UPnP Device Architecture 1.1", 15 October 2008.
NOTE: Available at http://upnp.org/specs/arch/UPnP-arch-DeviceArchitecture-v1.1.pdf.
[2] ETSI TS 103 544-2 (V1.3.1): "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.1): "Publicly Available Specification (PAS); Intelligent Transport
Systems (ITS); MirrorLink®; Part 3: Audio".
[4] ETSI TS 103 544-26 (V1.3.1): "Publicly Available Specification (PAS); Intelligent Transport
Systems (ITS); MirrorLink®; Part 26: Consumer Experience Principles and Basic Features".
[5] W3C Recommendation 11 April 2013: "XML Signature Syntax and Processing Version 1.1".
NOTE: Available at http://www.w3.org/TR/xmldsig-core/.
[6] Unicode Consortium: "Unicode 12.1 Character Code Charts".
NOTE: Available at http://www.unicode.org/charts/.
[7] ETSI TS 103 544-4 (V1.3.1): "Publicly Available Specification (PAS); Intelligent Transport
Systems (ITS); MirrorLink®; Part 4: Device Attestation Protocol (DAP)".
[8] IETF RFC 5280: "Internet X.509 Public Key Infrastructure Certificate", May 2008.
NOTE: Available at http://tools.ietf.org/html/rfc5280.
ETSI
---------------------- Page: 5 ----------------------
6 ETSI TS 103 544-10 V1.3.1 (2019-10)
2.2 Informative references
References are either 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 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 (V1.3.1): "Publicly Available Specification (PAS); Intelligent Transport
Systems (ITS); MirrorLink®; Part 1: Connectivity".
3 Definition of terms, symbols and abbreviations
3.1 Terms
Void.
3.2 Symbols
Void.
3.3 Abbreviations
Void.
4 Service Modeling Definitions
4.1 Service Type
The following service type identifies a service that is compliant with the 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 4-1: Service State Variables
Req. or Data Allowed Default Eng.
Variable Name
Opt. Type Value Value 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 Empty string N/A
ETSI
---------------------- Page: 6 ----------------------
7 ETSI TS 103 544-10 V1.3.1 (2019-10)
Req. or Data Allowed Default Eng.
Variable Name
Opt. Type Value Value Units
A_ARG_TYPE_INT R integer Undefined 0 N/A
A_ARG_TYPE_Bool R string true | false false N/A
MaxNumProfiles R ui2 Undefined 1 N/A
R = 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 currently not being used by
any MirrorLink service hosted on the device. Each entry in the list is of type A_ARG_TYPE_ProfileID.
This state variable is evented hence, any MirrorLink UPnP Control Point is notified using eventing mechanisms
whenever the list 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. 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
ID of the MirrorLink Client
clientID clientProfile Mandatory
(A_ARG_TYPE_String)
Short user-friendly description of client
friendlyName clientProfile Optional
(A_ARG_TYPE_String)
Manufacturer Name
manufacturer clientProfile Mandatory
(A_ARG_TYPE_String)
Model Name
modelName clientProfile Optional
(A_ARG_TYPE_String)
Model Number
modelNumber clientProfile Mandatory
(A_ARG_TYPE_String)
Desired properties for icons delivered from the
iconPreference clientProfile Optional
MirrorLink Server device
Type of icon image
(A_ARG_TYPE_String)
mimetype iconPreference Optional
Default: “image/png”
Width of icon
(A_ARG_TYPE_INT)
width iconPreference Optional
Default: “128”
Height of icon
(A_ARG_TYPE_INT)
height iconPreference Optional
Default: “128”
Color depth of icon
depth (A_ARG_TYPE_INT) iconPreference Optional
Default: “24”
connectivity Client Connectivity settings clientProfile Optional
ETSI
---------------------- Page: 7 ----------------------
8 ETSI TS 103 544-10 V1.3.1 (2019-10)
Element Description Parent Availability
+
bluetooth Bluetooth settings connectivity Optional
Bluetooth MAC address (BD_ADDR). Indicates
device support for Bluetooth on the MirrorLink
Client.
bdAddr bluetooth Optional
(A UTF-8 encoded string representing an
unsigned 48-bit integer in hexadecimal format
(without any “0x” prefix).)
A_ARG_TYPE_Bool
Bluetooth Connection will be initiated from
startConnection bluetooth Optional
MirrorLink Client
Default: “true”
wifi WiFi settings of the device connectivity Optional
WiFi MAC address
(A UTF-8 encoded string representing an
macAddr unsigned 48-bit integer in hexadecimal format wifi Mandatory
(without any “0x” prefix, and without any
grouping using “:”, “.” or “-”)
Service Set Identifier (SSID), Base64 encoded
ssid wifi Optional
(A_ARG_TYPE_String)
Comma separated list of supported roles.
Allowed values are
• AP (Access Point role)
• Client (Client role)
roles wifi Optional
• P2P (Infrastructure-less)
(A_ARG_TYPE_String)
Default: AP,Client,P2P
protectionList List of WiFi access protection wifi Optional
protection* Access protection protectionList Optional
Security protocol used to protect WiFi access.
Allowed values are
• WEP
• WPA
protocol protection Mandatory
• WPA2
• WPS
NOTE: WEP/WPA is listed for legacy reasons,
and should not be used
(A_ARG_TYPE_String)
Passkey/Shared key, Base64 encoded
Shall be left empty, if transmitted over an
passkey unprotected or shared transport channel protection Mandatory
(e.g. WiFi)
(A_ARG_TYPE_String)
RTP streaming parameters
rtpStreaming clientProfile Mandatory
(optional in ≤ MirrorLink 1.2)
Comma separated list of supported RTP
playload types.
payloadType rtpStreaming Optional
(A_ARG_TYPE_String)
Default: “99”
Audio Initial Playback Latency in reference to
payload type 99.
audioIPL rtpStreaming Optional
(A_ARG_TYPE_INT)
Default: “4800”
ETSI
---------------------- Page: 8 ----------------------
9 ETSI TS 103 544-10 V1.3.1 (2019-10)
Element Description Parent Availability
Audio Maximum Playback Length in reference
to payload type 99.
audioMPL rtpStreaming Optional
(A_ARG_TYPE_INT)
Default: “9600”
Maximum Latency Switched Sources time as
defined in [3]. Value is in ms.
lssMax rtpStreaming Mandatory
(A_ARG_TYPE_INT)
( ≥ MirrorLink 1.3)
Average Latency Switched Sources time as
defined in [3]. Value is in ms.
lssAvg rtpStreaming Mandatory
(A_ARG_TYPE_INT)
( ≥ MirrorLink 1.3)
Application UI content rules
contentRules clientProfile Deprecated
Depreciated
User Interface property
rule* contentRules Deprecated
Depreciated
Rule identifier
ruleId Depreciated rule Deprecated
(A_ARG_TYPE_INT)
Specific value
ruleValue Depreciated rule Deprecated
(A_ARG_TYPE_String)
Profile information on different services
services clientProfile Optional
supported from the client
Configuration of the UPnP TmNotifi-
notification services Optional
cationService
Support for native notification UI
(A_ARG_TYPE_Bool)
notiUiSupport notification Optional
Default: “false”
Maximum number of actions
Shall be equal or greater than 2.
MirrorLink Client should support at least 2
maxActions notification Optional
actions.
(A_ARG_TYPE_INT)
Default: “2”
Maximum supported length of the action name
Shall be equal or greater than 10.
actionName
notification Optional
MaxLength
(A_ARG_TYPE_INT)
Default: “10”
Maximum supported length of the notification
title.
notiTitle
Shall be equal or greater than 20.
notification Optional
MaxLength
(A_ARG_TYPE_INT)
Default: “20”
Maximum supported length of the notification
body.
notiBody
Shall be equal or greater than 80.
notification Optional
MaxLength
(A_ARG_TYPE_INT)
Default: “80”
mirrorLink
MirrorLink Client version clientProfile Mandatory
Version
ETSI
---------------------- Page: 9 ----------------------
10 ETSI TS 103 544-10 V1.3.1 (2019-10)
Element Description Parent Availability
Major Version
mirrorLink
majorVersion Mandatory
Version
A_ARG_TYPE_INT
MinorVersion
mirrorLink
minorVersion Mandatory
Version
A_ARG_TYPE_INT
Presentation protocols supported from the
MirrorLink Client.
presentations clientProfile Mandatory
( ≥ MirrorLink 1.2; optional in MirrorLink 1.2)
Comma-separated list of presentation protocols
supported from the MirrorLink Client.
• hsml
• wfd
presentation presentations Mandatory
• vncu
• vncw
(A_ARG_TYPE_String)
Default: “vncu”
Miscellaneous information
misc clientProfile Mandatory
( ≥ MirrorLink 1.2; optional in MirrorLink 1.2)
Boolean flag, which Indicates whether MirrorLink
Client supports driver distraction regulation.
driverDistractionS
misc Mandatory
(A_ARG_TYPE_Bool)
upport
Default: “true”
Supported MirrorLink modes from the MirrorLink
Client.
mlUiMode misc Mandatory
( ≥ MirrorLink 1.3)
Supported MirrorLink mode. Allowed values are:
• immersive
mode* mlUiMode Mandatory
• classic
(A_ARG_TYPE_String)
Supported UI control mechanisms from the
MirrorLink Client.
mlUiControl misc Mandatory
( ≥ MirrorLink 1.3)
Supported UI control mechanisms. Allowed
values are:
• pointer
• touch
• knob
control* mlUiControl Mandatory
• vc_bt_hfp
• vc_rtp
• ptt
(A_ARG_TYPE_String)
Server status information presented from the
MirrorLink Client.
serverInfo misc Mandatory
( ≥ MirrorLink 1.3)
Server status information shown from MirrorLink
Client. Allowed values are:
• battery
• time
info* serverInfo Mandatory
• operator
• signalStrength
• none
(A_ARG_TYPE_String)
ETSI
---------------------- Page: 10 ----------------------
11 ETSI TS 103 544-10 V1.3.1 (2019-10)
Element Description Parent Availability
Provide information about the localization
support from the MirrorLink Client.
localization clientProfile Optional
( ≥ MirrorLink 1.2)
Comma-separated list of entry points into the
UniCode Character Code Charts, which are
supported from the MirrorLink Client device.
characterSet localization Mandatory
(UTF-8 encoded string; each entry point is given
in hexadecimal format (with “0x” prefix).
N/A for ML
Server
Certification certificates.
certificates clientProfile
( ≥ MirrorLink 1.3)
Mandatory for
ML Client
X.509v3 certificate [8] issued during MirrorLink
N/A for ML
device certification. Certificate shall be validated
Server
using public key from clientCA.
clientDevice certificates
The certificate is Base64 encoded from ASN.1
Mandatory for
DER format.
ML Client
(A_ARG_TYPE_String)
X.509v3 certificate [8] issued by the Ceritifcate
N/A for ML
Authority. Certificate shall be validated using
Server
public Certificate Authority's root key.
clientCA certificates
The certificate is Base64 encoded from ASN.1
Mandatory for
DER format.
ML Client
(A_ARG_TYPE_String)
XML signature over entire contents of the
clientProfile element. This is done as specified
in [5].
The key used in calculating the signature shall
be the private part of the application-specific key
Mandatory for
which public part was bound to the attestation of
MirrorLink
UPnP-Server component. (The public part can
Server
be used to verify the signature.) The Reference
Signature clientProfile
element of the XML signature shall point to
N/A for
device element.
MirrorLink
The SignatureMethod shall be RSA with SHA1.
Client
The KeyInfo element may be omitted. The
mechanism for generation, exchange and
maintenance of keys is out of scope for the
present document.
( ≥ MirrorLink 1.2)
The elements marked with a (*) can have multiple instances.
Implementation Note
The manufacturer of some older MirrorLink Client devices may be unavailable.
The clientID is a unique identifier of the MirrorLink Client device instance; this identifier shall be unique for all device
instances from the device manufacturer given in the manufacturer element. It shall survive the MirrorLink Client's shut
down and reboot. If may be reset during a factory reset.
Implementation Note
The clientID of some older MirrorLink Client devices need not be unique for all device instances.
ETSI
---------------------- Page: 11 ----------------------
12 ETSI TS 103 544-10 V1.3.1 (2019-10)
The modelNumber is a unique number identifying a family of devices, which expose identical MirrorLink related
behavior, from the device manufacturer given in the manufacturer element. The model number format is vendor
specific. It shall be smaller than 32 bytes. The modelNumber values are recorded by the CCC Certification Body.
Implementation Note
Some older MirrorLink Client devices need not provide a (unique) model number.
UPnP Client Profile Service shall provide a valid MirrorLink minor and major version, not higher than the supported
version in the UPnP TmServerDevice device description. The MirrorLink Server device shall use the MirrorLink
version provided from the UPnP Client Profile Servic
...
Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.