Professional Documents
Culture Documents
NO PUBLIC DISCLOSURE PERMITTED: Please report postings of this document on public servers or websites to:
DocCtrlAgent@qualcomm.com.
Restricted Distribution: Not to be distributed to anyone who is not an employee of either Qualcomm Technologies, Inc. or its affiliated
companies without the express approval of Qualcomm Configuration Management.
Not to be used, copied, reproduced, or modified in whole or in part, nor its contents revealed in any manner to others without the express
written permission of Qualcomm Technologies, Inc.
Qualcomm RaptorQ is a product of Qualcomm Technologies, Inc. Other Qualcomm products referenced herein are products of Qualcomm
Technologies, Inc. or its other subsidiaries.
This technical data may be subject to U.S. and international export, re-export, or transfer (“export”) laws. Diversion contrary to U.S. and
international law is strictly prohibited.
Qualcomm and RaptorQ are trademarks of Qualcomm Incorporated, registered in the United States and other countries. All
Qualcomm Incorporated trademarks are used with permission. Other product and brand names may be trademarks or registered
trademarks of their respective owners.
1 Introduction ........................................................................................................................... 6
1.1 Scope.........................................................................................................................................................6
1.2 Document organization ..............................................................................................................................6
1.3 Acronyms ...................................................................................................................................................6
1.4 References ................................................................................................................................................7
Figures
Figure 2-1 MSDC device parameters .............................................................................................................................8
Figure 2-2 CycleTimes ................................................................................................................................................. 10
Figure 2-3 FECProcessingMaxMemorySize ................................................................................................................ 12
Figure 2-4 FileSystemWriteSpeed ............................................................................................................................... 12
Figure 2-5 MSDCServiceClass .................................................................................................................................... 12
Figure 2-6 ServiceDiscoveryBootstrap ......................................................................................................................... 14
Figure 2-7 ReceptionReportingTemplateURL .............................................................................................................. 15
Figure 2-8 FileRepairTemplateURL ............................................................................................................................. 15
Figure 2-9 ServiceDiscoveryNumberOfRetries ............................................................................................................ 16
Figure 2-10 AccessPointNameMapping ....................................................................................................................... 16
Figure 2-11 NetworkConstraintForADP........................................................................................................................ 17
Figure 2-12 RSSIPollingInterval ................................................................................................................................... 17
Figure 2-13 MaxNumberOfFileDeliveryTables ............................................................................................................. 17
Figure 2-14 MaxReceptionReportingStorageSize ........................................................................................................ 18
Figure 2-15 MaxUnnotifiedFileDownloadQuota ........................................................................................................... 18
Figure 2-16 NumberOfRegistrationWithSameServiceClass ......................................................................................... 19
Figure 2-17 NumberOfConcurrentFileDownload .......................................................................................................... 19
Figure 2-18 NumberOfConcurrentStreaming ............................................................................................................... 20
Figure 2-19 UnicastFetchForDASH.............................................................................................................................. 20
Figure 2-20 Carrier PLMN list....................................................................................................................................... 20
Figure 2-21 StorageFileDelivery................................................................................................................................... 21
Figure 2-22 MaxUnnotifiedFileDownloadQuotaExtension ............................................................................................ 21
Figure 2-23 ScratchSpacePath .................................................................................................................................... 22
Figure 2-24 SuppressReceptionTime........................................................................................................................... 22
Figure 2-25 TMGIActivationTimeout ............................................................................................................................ 22
Figure 2-26 StreamingTMGIActivationRetryTimeOut ................................................................................................... 23
Tables
Table 1-1 Acronyms and abbreviations .........................................................................................................................6
Table 1-2 References....................................................................................................................................................7
Table 2-1 Recommended memory settings for some typical scenarios ...................................................................... 11
1.1 Scope
This document describes the middleware provisioning parameters. The parameters required by
evolved Multimedia Broadcast/Multicast Service (eMBMS) middleware function correctly on
eMBMS-capable User Equipment (UE). The parameters described use an Extensible Markup
Language (XML) schema. Therefore, the provisioning file is an XML that conforms to the
schema.
Currently, these parameters pre-provision with the eMBMS middleware. In later releases, this
document describes Over-The-Air (OTA) updates of the provisioning parameters.
1.3 Acronyms
Table 1-1 lists the acronyms that appear in the document.
Term Definition
FLUTE File Delivery over Unidirectional Transport
HTTPS Hypertext Transfer Protocol Secure
LTE Long Term Evolution
MCC Mobile Country Code
MNC Mobile Network Code
MSDC Multicast Service Device Client
OEM Original Equipment Manufacturer
OTA Over-The-Air
PLMN Public Land Mobile Network
RAM Random Access Memory
RSSI Received Signal Strength Indication
TCP Transmission Control Protocol
TMGI Temporary Mobile Group Identity
TSB Time-Shifted Buffer
UE User Equipment
URL Uniform Resource Locator
USD User Service Description
XML Extensible Markup Language
1.4 References
Table 1-2 References
Reference Document number Title
number
Q1 80-B7410-6 eMBMS Middleware Configuration Parameters Profile
Specification Release 3.2
Q2 80-W2333-1 FEC Settings and Behavior for Services Over eMBMS
Q3 80-B7222-1 RaptorQ™ FEC Settings and Behavior for Services Over
eMBMS
2.1 Introduction
The eMBMS capable UE installs with eMBMS middleware, which is referred to in this document
as Multicast Service Device Client (MSDC). MSDC contains parameters that are relevant for the
behavior of various features within the middleware. These parameters are grouped into two
categories: Configuration parameters (Config Params) and Provisioning parameters (Provisioning
params), shown in Figure 2-1. Configuration parameters are common across different types of UE
for a carrier network and frequently updatable OTA. Whereas values of the provisioning
parameters are device-specific and not expected to be changed OTA. Details of the configuration
parameters, OTA update mechanism, and eMBMS middleware behavior on these updates are
captured in [Q1].
The provisioning parameters allow MSDC to function properly on eMBMS-capable UE. This
chapter describes the provisioning parameters in detail. Define the parameters using an XML
schema. Every UE with MSDC installed will have a provisioning XML file that conforms to the
provisioning XML schema described at the end of this document in Appendix A. Preinstall the
provisioning XML file by the Original Equipment Manufacturers (OEMs) on the UE along with
the middleware.
One property of the provisioning parameters is that the values of the parameters may vary from
one type of UE and operator network to another. Different types of UE under the control of a
network operator may have provisioning XML files with different values of the provisioning
parameters depending on the device type. Moreover, the same type of UE may contain different
values of the provisioning parameters for deployment on different network operators.
Section 2.2 provides descriptions of the provisioning parameters. To have flexibility to extend the
schema, design the provisioning XML schema to be backward and forward compatible. Release
the new elements via extension schema(s) under different namespaces and the original schema
will import the extension schema(s). The “any##other” option at the end of the list of elements in
the schema, located in each element allows it to be extendable in the future. Sections 2.2.1 and
2.2.2 provide details about each of the elements in the provisioning XML schema.
UnicastFetchForDASH
PLMN
CarrierNetworkParamsExtension (with StorageFileDelivery and
CarrierNetworkParamsExtension1)
The OEMParams contains the following sub-elements:
ScratchSpacePath
SuppressReceptionTime
TMGIActivationTimeout
StreamingTMGIActivationRetryTimeOut
MSDCSocketInterfacePort
DASHStreamingPort
TimeShiftedBuffer
DeviceType
MSDCUpgradeCheckURI
DeviceCapabilities
OEMParamsExtension (with HTTPFileDelivery)
2.2.1 CarrierNetworkParams
NOTE: There is no support for the FileSystemWriteSpeed in the current middleware release.
NOTE: The configuration service associated with MSDC is supported when the provisioning file is
missing or the provisioning file does not include the optional parameter MSDCServiceClass. In
this case a specific MSDCFileURI is associated with purpose= “Configuration” with a specific
MSDCServiceClass name as illustrated in the following XML snippet below:
<MSDCServiceClass
Name=“urn:oma:bcast:ext_bsc_3gpp:middleware_configuration:1.0”>
<MSDCFileURIs Purpose=“Configuration”>
http://embmsconfig.qualcomm.com/configuration/msdcconfig.xml</MSDCFileURIs>
</MSDCServiceClass>
NOTE: There is no support for the BootstrapRetriesRandomPeriod parameter in the current middleware
release.
NOTE: There is no support for the MaxNumberOfFileDeliveryTables in the current middleware release.
2.2.1.20 CarrierNetworkParamsExtension
NOTE: There is no support for the MaxFileDeliveryTTL in the current middleware release.
2.2.2 OEMParams
Where:
TSB_Margin_Percentage is the parameter described in this section.
TSB_Margin_Seconds is the provisioning parameter TimeShiftBufferMarginSecond.
The average rate is the average rate in bits per second of the service as specified in the MPD.
The TSB_Buffer_Depth is the TSB buffer depth specified in the MPD and capped by both the
MaxTimeShiftBufferDepth provisioning parameter that applies to this device and the
MaxTimeShiftBufferDepth configuration parameter that applies to all the devices in the
network.
If the available memory is less than the above formula the time shift buffer feature is disabled for
the service by setting the time shift buffer attribute in the MPD to zero. The time shift buffer
feature remains disabled for the service until the service is stopped by the application; this
ensures enough memory resources and additional margin is available for the TSB feature.
NOTE: There is no support for the MSDCUpgradeCheckURI in the current middleware release.
NOTE: The value for the feature element needs to be integer numbers.
NOTE: There is no support for the DeviceCapabilities in the current middleware release.
2.2.2.11 OEMParamsExtension
NOTE: There is no support for the RateHTTPConnection in the current middleware release.
</xs:simpleType>
</xs:element>
<xs:element
name="MSDCServiceClass" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:anyAttribute processContents="skip"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:complexType>
<xs:sequence>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute
name="Name" type="xs:string" use="required"/>
<xs:anyAttribute processContents="skip"/>
</xs:complexType>
</xs:element>
<xs:element
name="ServiceDiscoveryBootstrap" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:simpleType>
<xs:restriction base="xs:duration"/>
</xs:simpleType>
</xs:element>
<xs:complexType>
<xs:sequence>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element
name="ReceptionReportingTemplateURL" type="xs:string" minOccurs="0"/>
<xs:element
name="FileRepairTemplateURL" type="xs:string" minOccurs="0"/>
<xs:element
name="ServiceDiscoveryNumberOfRetries" default="16" minOccurs="0">
<xs:simpleType>
<xs:restriction
base="xs:unsignedInt"/>
</xs:simpleType>
</xs:element>
<xs:element
name="AccessPointNameMapping" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:complexType>
<xs:sequence>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element
name="NetworkConstraintForADP" type="xs:string" default="LTE" minOccurs="0"/>
<xs:element
name="RSSIPollingInterval" default="PT2.56S" minOccurs="0">
<xs:simpleType>
<xs:restriction
base="xs:duration"/>
</xs:simpleType>
</xs:element>
<xs:element
name="MaxNumberOfFileDeliveryTables" minOccurs="0">
<xs:simpleType>
<xs:restriction
base="xs:unsignedInt"/>
</xs:simpleType>
</xs:element>
<xs:element
name="MaxReceptionReportingStorageSize" minOccurs="0">
<xs:simpleType>
<xs:restriction
base="xs:unsignedInt"/>
</xs:simpleType>
</xs:element>
<xs:element
name="MaxUnnotifiedFileDownloadQuota" minOccurs="0">
<xs:simpleType>
<xs:restriction
base="xs:unsignedInt"/>
</xs:simpleType>
</xs:element>
<xs:element
name="NumberOfRegistrationWithSameServiceClass" type="xs:unsignedInt" minOccurs="0"/>
<xs:element
name="NumberOfConcurrentFileDownload" type="xs:unsignedInt" minOccurs="0"/>
<xs:element
name="NumberOfConcurrentStreaming" type="xs:unsignedInt" default="20" minOccurs="0"/>
<xs:element
name="UnicastFetchForDASH" type="xs:unsignedInt" minOccurs="0"/>
<xs:element name="PLMN"
minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:complexType>
<xs:sequence>
<xs:complexType>
<xs:sequence>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:complexType>
<xs:sequence>
<xs:element name="MaxUnnotifiedFileDownloadQuotaExtension"
type="xs:unsignedLong" default="10737418240" minOccurs="0"/>
<xs:element name="CarrierNetworkParamsExtension2"
minOccurs="0">
<xs:complexType>
<xs:sequence>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="OEMParams" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element
name="ScratchSpacePath" type="xs:string" default="sd/scratch1" minOccurs="0"/>
<xs:element
name="SuppressReceptionTime" default="PT5S" minOccurs="0">
<xs:simpleType>
<xs:restriction
base="xs:duration"/>
</xs:simpleType>
</xs:element>
<xs:element
name="TMGIActivationTimeout" default="PT11S" minOccurs="0">
<xs:simpleType>
<xs:restriction
base="xs:duration"/>
</xs:simpleType>
</xs:element>
<xs:element
name="StreamingTMGIActivationRetryTimeOut" default="PT1S" minOccurs="0">
<xs:simpleType>
<xs:restriction
base="xs:duration"/>
</xs:simpleType>
</xs:element>
<xs:element
name="MSDCSocketInterfacePort" minOccurs="0">
<xs:complexType>
<xs:attribute
name="startingPortNumber" type="xs:unsignedInt" default="5008"/>
<xs:attribute
name="PortRange" type="xs:unsignedInt" default="10"/>
<xs:anyAttribute processContents="skip"/>
</xs:complexType>
</xs:element>
<xs:element
name="DASHStreamingPort" minOccurs="0">
<xs:complexType>
<xs:attribute
name="startingPortNumber" type="xs:unsignedInt" default="4009"/>
<xs:attribute
name="PortRange" type="xs:unsignedInt" default="10"/>
<xs:anyAttribute processContents="skip"/>
</xs:complexType>
</xs:element>
<xs:element
name="TimeShiftBuffer" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:simpleType>
<xs:restriction base="xs:duration"/>
</xs:simpleType>
</xs:element>
<xs:simpleType>
<xs:restriction base="xs:duration"/>
</xs:simpleType>
</xs:element>
<xs:simpleType>
<xs:restriction base="xs:double"/>
</xs:simpleType>
</xs:element>
<xs:complexType>
<xs:sequence>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element
name="DeviceType" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:complexType>
<xs:sequence>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute
name="ClassID" type="xs:string" use="required"/>
<xs:anyAttribute processContents="skip"/>
</xs:complexType>
</xs:element>
<xs:element
name="MSDCUpgradeCheckURI" type="xs:anyURI" minOccurs="0"/>
<xs:element
name="DeviceCapabilities" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:complexType>
<xs:sequence>
<xs:element name="MaxNumberHTTPConnections"
type="xs:unsignedInt" default="10" minOccurs="0"/>
<xs:complexType>
<xs:sequence>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:anyAttribute processContents="skip"/>
</xs:complexType>
</xs:element>
<xs:complexType>
<xs:sequence>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element
name="MSDCProvisioningParamsExtension" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:any processContents="lax"
minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="Version" type="xs:string"/>
<xs:anyAttribute processContents="skip"/>
</xs:complexType>
</xs:element>
</xs:schema>