SIST EN 62516-3:2013

Terrestrial digital multimedia broadcasting (T-DMB) receivers -- Part 3: Common API (IEC 62516-3:2013)

This part of IEC 62516 describes the T-DMB common application program interface (API). It provides a software platform that, when combined with the T-DMB O/S, forms a universal interface for application programs. This interface allows application programs to be written in such a way that they run on any T-DMB receiver unit, as described in IEC 62516-1:2009 and IEC 62516-2:2011 regardless of its manufacturer. This part of IEC 62516 also defines a software environment that allows multiple application programs to be interoperable on a single receiver unit by sharing the fixed resources of the receiver, and it provides a set of interfaces that the T-DMB middleware and the ASIC specific software use.

Empfänger für terrestrischen Multimediadigitalrundfunk (T-DMB) - Teil 3: Allgemeine API (IEC 62516-3:2013)

Récepteurs pour diffusion multimédia numérique terrestre (T-DMB) - Partie 3: API commune (CEI 62516-3:2013)

La CEI 62516-3:2013 décrit l'interface de programmation d'application (API) commune T-DMB. Elle fournit une plate-forme logicielle qui, lorsqu'elle est combinée avec le système d'exploitation O/S T-DMB, constitue une interface universelle pour les programmes d'application. Cette interface permet d'écrire des programmes d'application de telle manière qu'ils puissent être exécutés sur n'importe quelle unité de récepteur T-DMB, comme décrit dans les CEI 62516-1:2009 et CEI 62516-2:2011 quel que soit son fabricant. Elle définit également un environnement logiciel permettant à plusieurs programmes d'application d'être interopérables sur une unité de récepteur unique, en partageant les ressources fixes du récepteur. Elle fournit également un ensemble d'interfaces utilisées par l'intergiciel T-DMB et le logiciel spécifique à un ASIC (Circuit intégré à application spécifique).

Sprejemniki za prizemno digitalno večpredstavnostno radiodifuzijo (T-DMB) - 3. del: Skupni API (IEC 62516-3:2013)

Ta del standarda IEC 62516 opisuje skupni aplikacijski programski vmesnik (API) za T-DMB. Zagotavlja okolje za programsko opremo, ki skupaj z operacijskim sistemom za T-DMB tvori univerzalni aplikacijski programski vmesnik. Ta vmesnik omogoča pisanje aplikacij tako, da delujejo na kateri koli sprejemni enoti za T-DMB, kot opisujeta standarda IEC 62516-1:2009 in IEC 62516-2:2011, ne glede na proizvajalca. Ta del standarda IEC 62516 prav tako določa programsko okolje, ki omogoča hkratno delovanje več aplikacij na eni sprejemni enoti s souporabo določenih virov sprejemnika in zagotavlja sklop vmesnikov za programsko opremo srednje ravni za T-DMB in posebno programsko opremo vezja ASIC.

General Information

• Status: Published
• Publication Date: 06-Jun-2013
• ICS: 33.160.25 - Television receivers
• ICS: 33.170 - Television and radio broadcasting
• Technical Committee: AVM - Audio, video and multimedia systems and equipment
• Current Stage: 6060 - National Implementation/Publication (Adopted Project)
• Start Date: 15-May-2013
• Due Date: 20-Jul-2013
• Completion Date: 07-Jun-2013
• Ref Project: EN 62516-3:2013 - Terrestrial digital multimedia broadcasting (T-DMB) receivers - Part 3: Common API

Standards Content (Sample)

SLOVENSKI STANDARD
SIST EN 62516-3:2013
01-julij-2013
6SUHMHPQLNL]DSUL]HPQRGLJLWDOQRYHþSUHGVWDYQRVWQRUDGLRGLIX]LMR7'0%
GHO6NXSQL$3,,(&
Terrestrial digital multimedia broadcasting (T-DMB) receivers -- Part 3: Common API
(IEC 62516-3:2013)
Empfänger für terrestrischen Multimediadigitalrundfunk (T-DMB) - Teil 3: Allgemeine API
(IEC 62516-3:2013)
Récepteurs pour diffusion multimédia numérique terrestre (T-DMB) - Partie 3: API
commune (CEI 62516-3:2013)
Ta slovenski standard je istoveten z: EN 62516-3:2013
ICS:
33.160.25 Televizijski sprejemniki Television receivers
33.170 Televizijska in radijska Television and radio
difuzija broadcasting
SIST EN 62516-3:2013 en,fr,de
2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.

---------------------- Page: 1 ----------------------

SIST EN 62516-3:2013

---------------------- Page: 2 ----------------------

SIST EN 62516-3:2013

EUROPEAN STANDARD
EN 62516-3

NORME EUROPÉENNE
April 2013
EUROPÄISCHE NORM

ICS 33.160.25; 33.170


English version


Terrestrial digital multimedia broadcasting (T-DMB) receivers -
Part 3: Common API
(IEC 62516-3:2013)


Récepteurs pour diffusion multimédia Empfänger für terrestrischen
numérique terrestre (T-DMB) - Multimediadigitalrundfunk (T-DMB) -
Partie 3: API commune Teil 3: Allgemeine API
(CEI 62516-3:2013) (IEC 62516-3:2013)





This European Standard was approved by CENELEC on 2013-04-15. CENELEC members are bound to comply
with the CEN/CENELEC Internal Regulations which stipulate the conditions for giving this European Standard
the status of a national standard without any alteration.

Up-to-date lists and bibliographical references concerning such national standards may be obtained on
application to the CEN-CENELEC Management Centre or to any CENELEC member.

This European Standard exists in three official versions (English, French, German). A version in any other
language made by translation under the responsibility of a CENELEC member into its own language and notified
to the CEN-CENELEC Management Centre has the same status as the official versions.

CENELEC members are the national electrotechnical committees of Austria, Belgium, Bulgaria, Croatia, Cyprus,
the Czech Republic, Denmark, Estonia, Finland, Former Yugoslav Republic of Macedonia, France, Germany,
Greece, Hungary, Iceland, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, the Netherlands, Norway, Poland,
Portugal, Romania, Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey and the United Kingdom.

CENELEC
European Committee for Electrotechnical Standardization
Comité Européen de Normalisation Electrotechnique
Europäisches Komitee für Elektrotechnische Normung

Management Centre: Avenue Marnix 17, B - 1000 Brussels


© 2013 CENELEC - All rights of exploitation in any form and by any means reserved worldwide for CENELEC members.
Ref. No. EN 62516-3:2013 E

---------------------- Page: 3 ----------------------

SIST EN 62516-3:2013
EN 62516-3:2013 - 2 -
Foreword
The text of document 100/2020/CDV, future edition 1 of IEC 62516-3, prepared by Technical Area 1
“Terminals for audio, video and data services and contents” of IEC/TC 100 “Audio, video and
multimedia systems and equipment” was submitted to the IEC-CENELEC parallel vote and approved
by CENELEC as EN 62516-3:2013.

The following dates are fixed:
• latest date by which the document has (dop) 2014-01-15
to be implemented at national level by
publication of an identical national
standard or by endorsement
(dow) 2016-04-15
• latest date by which the national
standards conflicting with the
document have to be withdrawn

Attention is drawn to the possibility that some of the elements of this document may be the subject of
patent rights. CENELEC [and/or CEN] shall not be held responsible for identifying any or all such
patent rights.

Endorsement notice
The text of the International Standard IEC 62516-3:2013 was approved by CENELEC as a European
Standard without any modification.
In the official version, for Bibliography, the following note has to be added for the standard indicated :

IEC 62104:2003 NOTE Harmonised as EN 62104:2007 (not modified).

---------------------- Page: 4 ----------------------

SIST EN 62516-3:2013
- 3 - EN 62516-3:2013
Annex ZA
(normative)

Normative references to international publications
with their corresponding European publications

The following documents, in whole or in part, are normatively referenced in this document and are
indispensable for its application. For dated references, only the edition cited applies. For undated
references, the latest edition of the referenced document (including any amendments) applies.

NOTE  When an international publication has been modified by common modifications, indicated by (mod), the relevant EN/HD
applies.

Publication Year Title EN/HD Year

IEC 62516-1 2009 Terrestrial digital multimedia broadcasting EN 62516-1 2009
(T-DMB) receivers -
Part 1: Basic requirement


IEC 62516-2 2011 Terrestrial digital multimedia broadcasting EN 62516-2 2011
(T-DMB) receivers -
Part 2: Interactive data services using BIFS


ETSI EN 300 401 - Radio Broadcasting Systems; Digital Audio - -
V1.3.3 Broadcasting (DAB) to mobile, portable and
fixed receivers

---------------------- Page: 5 ----------------------

SIST EN 62516-3:2013

---------------------- Page: 6 ----------------------

SIST EN 62516-3:2013




IEC 62516-3

®


Edition 1.0 2013-03




INTERNATIONAL



STANDARD




NORME



INTERNATIONALE
colour

inside










Terrestrial digital multimedia broadcasting (T-DMB) receivers –

Part 3: Common API




Récepteurs pour diffusion multimédia numérique terrestre (T-DMB) –

Partie 3: API commune
















INTERNATIONAL

ELECTROTECHNICAL

COMMISSION


COMMISSION

ELECTROTECHNIQUE

PRICE CODE
INTERNATIONALE

CODE PRIX U


ICS 33.160.25; 33.170 ISBN 978-2-83220-685-0



Warning! Make sure that you obtained this publication from an authorized distributor.

Attention! Veuillez vous assurer que vous avez obtenu cette publication via un distributeur agréé.

® Registered trademark of the International Electrotechnical Commission
Marque déposée de la Commission Electrotechnique Internationale

---------------------- Page: 7 ----------------------

SIST EN 62516-3:2013
– 2 – 62516-3 © IEC:2013
CONTENTS
FOREWORD . 3
1 Scope . 5
2 Normative references . 5
3 Abbreviations . 5
4 T-DMB common API overview . 6
4.1 T-DMB receiver overview . 6
4.2 T-DMB receiver ASIC block . 6
4.3 Host processor block . 6
4.3.1 General . 6
4.3.2 T-DMB driver (hardware abstraction layer) sub-block . 7
4.3.3 T-DMB ASIC specific software sub-block . 7
4.3.4 T-DMB common APIs sub-block . 7
4.3.5 T-DMB receiver middleware sub-block . 7
4.4 Hardware interface block . 8
5 API description . 8
5.1 T-DMB common APIs . 8
5.2 Command types . 9
5.2.1 General . 9
5.2.2 Get receiver capability . 9
5.2.3 Tuning . 10
5.2.4 Searching . 11
5.2.5 Scanning . 14
5.2.6 Selecting a T-DMB service . 16
5.2.7 Selecting a slideshow or a dynamic label service . 18
5.2.8 Selecting a broadcast website service . 19
5.2.9 Get T-DMB service information . 21
5.2.10 Monitoring reception qualities . 22
Annex A (informative) Examples of the classes used in T-DMB APIs . 25
Bibliography . 28

Figure 1 – Block diagram of a typical T-DMB receiver . 6
Figure 2 – Three different command patterns . 8
Figure 3 – Get receiver capability . 10
Figure 4 – Tuning. 10
Figure 5 – Searching. 12
Figure 6 – Scanning . 14
Figure 7 – Selecting a T-DMB service . 17
Figure 8 – Selecting a slideshow or a dynamic label service . 18
Figure 9 – Selecting a broadcast website service . 19
Figure 10 – Get T-DMB service information . 21
Figure 11 – Monitoring reception qualities . 23

---------------------- Page: 8 ----------------------

SIST EN 62516-3:2013
62516-3 © IEC:2013 – 3 –
INTERNATIONAL ELECTROTECHNICAL COMMISSION
____________

TERRESTRIAL DIGITAL MULTIMEDIA
BROADCASTING (T-DMB) RECEIVERS –

Part 3: Common API

FOREWORD
1) The International Electrotechnical Commission (IEC) is a worldwide organization for standardization comprising
all national electrotechnical committees (IEC National Committees). The object of IEC is to promote
international co-operation on all questions concerning standardization in the electrical and electronic fields. To
this end and in addition to other activities, IEC publishes International Standards, Technical Specifications,
Technical Reports, Publicly Available Specifications (PAS) and Guides (hereafter referred to as “IEC
Publication(s)”). Their preparation is entrusted to technical committees; any IEC National Committee interested
in the subject dealt with may participate in this preparatory work. International, governmental and non-
governmental organizations liaising with the IEC also participate in this preparation. IEC collaborates closely
with the International Organization for Standardization (ISO) in accordance with conditions determined by
agreement between the two organizations.
2) The formal decisions or agreements of IEC on technical matters express, as nearly as possible, an international
consensus of opinion on the relevant subjects since each technical committee has representation from all
interested IEC National Committees.
3) IEC Publications have the form of recommendations for international use and are accepted by IEC National
Committees in that sense. While all reasonable efforts are made to ensure that the technical content of IEC
Publications is accurate, IEC cannot be held responsible for the way in which they are used or for any
misinterpretation by any end user.
4) In order to promote international uniformity, IEC National Committees undertake to apply IEC Publications
transparently to the maximum extent possible in their national and regional publications. Any divergence
between any IEC Publication and the corresponding national or regional publication shall be clearly indicated in
the latter.
5) IEC itself does not provide any attestation of conformity. Independent certification bodies provide conformity
assessment services and, in some areas, access to IEC marks of conformity. IEC is not responsible for any
services carried out by independent certification bodies.
6) All users should ensure that they have the latest edition of this publication.
7) No liability shall attach to IEC or its directors, employees, servants or agents including individual experts and
members of its technical committees and IEC National Committees for any personal injury, property damage or
other damage of any nature whatsoever, whether direct or indirect, or for costs (including legal fees) and
expenses arising out of the publication, use of, or reliance upon, this IEC Publication or any other IEC
Publications.
8) Attention is drawn to the Normative references cited in this publication. Use of the referenced publications is
indispensable for the correct application of this publication.
9) Attention is drawn to the possibility that some of the elements of this IEC Publication may be the subject of
patent rights. IEC shall not be held responsible for identifying any or all such patent rights.
International Standard IEC 62516-3 has been prepared by technical area 1: Terminals for
audio, video and data services and contents, of IEC technical committee 100: Audio, video
and multimedia systems and equipment.
The text of this standard is based on the following documents:
CDV Report on voting
100/2020/CDV 100/2110/RVC

Full information on the voting for the approval of this standard can be found in the report on
voting indicated in the above table.
This publication has been drafted in accordance with the ISO/IEC Directives, Part 2.
A list of all parts in the IEC 62516 series, published under the general title Terrestrial digital
multimedia broadcasting (T-DMB) receivers, can be found on the IEC website.

---------------------- Page: 9 ----------------------

SIST EN 62516-3:2013
– 4 – 62516-3 © IEC:2013
The committee has decided that the contents of this publication will remain unchanged until
the stability date indicated on the IEC web site under "http://webstore.iec.ch" in the data
related to the specific publication. At this date, the publication will be
• reconfirmed,
• withdrawn,
• replaced by a revised edition, or
• amended.


IMPORTANT – The 'colour inside' logo on the cover page of this publication
indicates that it contains colours which are considered to be useful for the correct
understanding of its contents. Users should therefore print this document using a
colour printer.

---------------------- Page: 10 ----------------------

SIST EN 62516-3:2013
62516-3 © IEC:2013 – 5 –
TERRESTRIAL DIGITAL MULTIMEDIA
BROADCASTING (T-DMB) RECEIVERS –

Part 3: Common API



1 Scope
This part of IEC 62516 describes the T-DMB common application program interface (API). It
provides a software platform that, when combined with the T-DMB O/S, forms a universal
interface for application programs. This interface allows application programs to be written in
such a way that they run on any T-DMB receiver unit, as described in IEC 62516-1:2009 and
IEC 62516-2:2011 regardless of its manufacturer.
This part of IEC 62516 also defines a software environment that allows multiple application
programs to be interoperable on a single receiver unit by sharing the fixed resources of the
receiver, and it provides a set of interfaces that the T-DMB middleware and the ASIC specific
software use.
2 Normative references
The following documents, in whole or in part, are normatively referenced in this document and
are indispensable for its application. For dated references, only the edition cited applies. For
undated references, the latest edition of the referenced document (including any
amendments) applies.
IEC 62516-1:2009, Terrestrial digital multimedia broadcasting (T-DMB) receivers – Part 1:
Basic requirements
IEC 62516-2:2011, Terrestrial digital multimedia broadcasting (T-DMB) receivers – Part 2:
Interactive data services using BIFS
ETSI EN 300 401 v1.3.3, Radio Broadcasting Systems; Digital Audio Broadcasting (DAB) to
mobile, portable and fixed receivers
3 Abbreviations
ADC Analog to Digital Converter
API Application Programming Interface
ASIC Application Specific Integrated Circuit
FIC Fast Information Channel
HAL Hardware Abstraction Layer
ISR Interrupt Service Routine
MAC Media Access Control
PAD Program Associated Data
RF Radio Frequency
R-S Reed Solomon
SDIO Secure Digital Input/Output
SI Service Identifier
T-DMB Terrestrial-Digital Multimedia Broadcasting

---------------------- Page: 11 ----------------------

SIST EN 62516-3:2013
– 6 – 62516-3 © IEC:2013
O/S Operating System
4 T-DMB common API overview
4.1 T-DMB receiver overview
A T-DMB receiver provides the device functionality specified in the T-DMB receivers (see
IEC 62516-1:2009 and IEC 62516-2:2011). Figure 1 shows the block diagram of a typical T-
DMB receiver. For the T-DMB receiver depicted in Figure 1, only those blocks that conform to
the scope of this standard are shown.
Figure 1 also shows the T-DMB common API with respect to the T-DMB receiver block
diagram.
Host Processor Block
T-DMB Receiver middleware
Sub-block
T-DMB Common APIs Sub-block
T-DMB ASIC Specific Software Sub-block
T-DMB Driver (Hardware
Abstraction Layer)
Sub-block
Hardware Interface Block
T-DMB Receiver ASIC Block
IEC  562/13

Figure 1 – Block diagram of a typical T-DMB receiver
4.2 T-DMB receiver ASIC block
The T-DMB receiver ASIC block represents the semiconductor hardware that provides the
functionality of demodulating a T-DMB signal and retrieving data carried by the T-DMB
physical layer. This block provides functionality like RF front-end, ADC, timing and frequency
estimation, channel estimation, viterbi decoding, etc. In short this block provides the complete
physical layer implementation of ETSI EN 300 401 v1.3.3. Depending upon the
implementation, this block can also provide outer decoding functionality (e.g. R-S decoding
and/or convolutional de-interleaving).
4.3 Host processor block
4.3.1 General
The host processor block represents the T-DMB functionality provided by the host processor
based device. In other words, this represents the host processor hardware and
in a T-DMB
the software implementation residing in the host processor. The host processor block retrieves
and processes the T-DMB information obtained from the T-DMB receiver ASIC block. The T-
DMB information retrieved consists of multiplex configuration information received on fast

---------------------- Page: 12 ----------------------

SIST EN 62516-3:2013
62516-3 © IEC:2013 – 7 –
information channel (FIC), content received on the main service channel. This block
communicates with the T-DMB receiver ASIC block to retrieve the information received from
the T-DMB signal. The host processor block consists of the following functional sub-blocks.
4.3.2 T-DMB driver (hardware abstraction layer) sub-block
The T-DMB Driver or hardware abstraction layer (HAL) Block represents the driver level
software in the main processor that directly interfaces with the T-DMB receiver ASIC block.
The T-DMB driver sub-block provides controller functions (e.g. turning on or turning off the T-
DMB receiver ASIC block) and data exchange functions (e.g. retrieving the data from the T-
DMB receiver ASIC block or conveying the characteristics of a sub-channel to be received) for
a given T-DMB receiver ASIC hardware. The T-DMB Driver software is specific to the type of
hardware interface mechanism that exists between the Host Processor Block and the T-DMB
Receiver ASIC block.
For example, the T-DMB driver software will be different depending upon whether the
hardware interface between the main processor and the T-DMB receiver ASIC block is
interrupt driven, implemented with memory mapped address/registers or packet based
transaction interface like SDIO. Some examples of tasks performed by T-DMB driver sub-
block are:
• hardware interactions such as initialization, sleep or wakeup triggers;
• data exchange with hardware such as emptying hardware buffers into main memory or
providing ISR implementation.
The T-DMB driver software functions are tightly coupled with the T-DMB receiver ASIC
hardware and are considered time sensitive in nature. Therefore the T-DMB driver software is
typically given a higher priority with respect to other sub-blocks shown. For example, the T-
DMB driver performs the tasks of retrieving the data received by the T-DMB receiver ASIC
block or instructing the T-DMB receiver ASIC block to tune to a frequency as requested by the
application layer.
4.3.3 T-DMB ASIC specific software sub-block
T-DMB ASIC specific software sub-block provides the MAC layer functionality not covered by
the T-DMB driver sub-block. Depending upon the division of MAC layer functionality across
different sub-blocks, it may provide complete or partial MAC layer functionality. At the least,
the T-DMB ASIC specific software sub-block is expected to provide high level MAC layer
functionality that is not practical to be delegated to T-DMB driver sub-block. It interfaces with
the T-DMB receiver middleware sub-block using the T-DMB common APIs.
4.3.4 T-DMB common APIs sub-block
The T-DMB common APIs sub-block defines the interfaces that allow the T-DMB ASIC
specific software sub-block to communicate with the T-DMB receiver middleware. Any T-DMB
receiver middleware that adheres to the interfaces defined by the T-DMB common APIs will
work with any T-DMB ASIC specific software sub-block that adheres to these interfaces as
well. More details on this interface are provided in the rest of this standard.
4.3.5 T-DMB receiver middleware sub-block
The T-DMB receiver middleware sub-block communicates with the T-DMB ASIC specific
software sub-block using the T-DMB common APIs. The T-DMB receiver middleware
implements the control and stream layer and provides the interface with application layer
protocols. It triggers the T-DMB ASIC specific software to receive the specified contents as
requested by the application layer. It acts on the notifications or content provided by the T-
DMB ASIC specific software. It delivers any content received from the T-DMB ASIC specific
software to the application layer protocols.

---------------------- Page: 13 ----------------------

SIST EN 62516-3:2013
– 8 – 62516-3 © IEC:2013
4.4 Hardware interface block
The hardware interface block represents the hardware interface mechanism that exists
between the host processor block and the T-DMB receiver ASIC block. This interface provides
the communication and data exchange functionality. The T-DMB driver sub-block uses this
block to exchange commands and data with the T-DMB receiver ASIC block. The hardware
interface block can be any desired interface, such as proprietary bus interface or a standard
based interface (e.g. SDIO).
5 API description
5.1 T-DMB common APIs
This clause provides a detailed description of each T-DMB common API. The API function
prototype details are provided along with defined types needed by the T-DMB common APIs.
Commands are executed by sending requests, confirmations and notifications. Figure 2 shows
three different command patterns. These are used in the T-DMB common APIs.
If commands are interleaved which means two commands running at the same time, an
arbitrary sequence of message types is possible.






IEC  563/13
Figure 2 – Three different command patterns

---------------------- Page: 14 ----------------------

SIST EN 62516-3:2013
62516-3 © IEC:2013 – 9 –
5.2 Command types
5.2.1 General
The commands supported by the T-DMB common APIs can be categorized as follows.
• API-inquiry functions:
– GetAPIVersion: Returns the API version.
– Get T-DMBCapability: Returns API’s T-DMB receiver capabilities and properties.
• Selecting an ensemble:
– Tune: Tunes directly to a specified frequency.
– Search: Searches for an ensemble.
• Accessing service directory:
– SelectSI: Subscribes to service directory information.
– GetEnsembleInfo: Gets information about a specified ensemble.
– GetServiceInfo: Gets information about a specified service.
– GetComponentInfo: Gets information about a specified component.
• Monitoring reception conditions:
– SelectReceptionInfo: Subscribes to reception condition information.
• Selecting services:
– SelectComponent: Starts or stops a service. In case of an audio/video service
decoding of audio/video samples is started automatically. In case of a data service, the
service can be accessed with the SelectObject command.
– SelectApplication: Launches a T-DMB application.
– SelectComponentStream: Gets access to the packet stream of the component.
• Selecting objects:
– SelectObject: Requests data objects for delivery with or without automatic updating.
• Scanning for T-DMB services:
– Scan: Scans a specified frequency range for T-DMB ensembles and updates the
service directory.
• Miscellaneous:
– OperationControl: accesses and modifies parameters of the receiver.
– GetLocationInfo: retrieves location information from the receiver.
5.2.2 Get receiver capability
Figure 3 shows the get receiver capability. The T-DMB common APIs asks the T-DMB
receiver for its capabilities.

---------------------- Page: 15 ----------------------

SIST EN 62516-3:2013
– 10 – 62516-3 © IEC:2013

IEC  564/13
Figure 3 – Get receiver capability
void capabilityReq ()
The T-DMB Common APIs asks the T-DMB receiver for its capabilities.
Parameters
None
void capabilityCnf(ReceiverCapability)
T-DMB receiver provides its capabilities to the API.
5.2.3 Tuning
Figure 4 shows the tuning. The T-DMB receiver is tuned by calling tuneReq. The receiver
tunes to the requested frequency and responds afterwards with tuneCnf confirmation. The
confirmation contains information about the reception quality.

IEC  565/13
Figure 4 – Tuning
void tuneReq(int tuneFrequency,int transmissionMode)
The tuneReq request initiates the Tune command. The Tune command sets directly a
specified T-DMB frequency. A T-DMB receiver shall be tuned to a T-DMB frequency and
synchronized in order to get access to T-DMB services. A tuned T-DMB receiver tries
automatically to synchronize on a T-DMB ensemble. The Tune command is used to select a

---------------------- Page: 16 ----------------------

SIST EN 62516-3:2013
62516-3 © IEC:2013 – 11 –
specified T-DMB frequency. Depending on the specification for the transmissionMode it is
tested if a T-DMB ensemble can be detected. If the connected T-DMB receiver supports
automatic detection the default setting for transmissionMode can be used. Otherwise it has to
be specified which transmission modes should be tested. The result of the command is
delivered by the tuneCnf confirmation. All currently existing selections of audio and data
services or selections of data objects are automatically stopped before tuning is performed by
the T-DMB receiver.
Parameters
• tuneFrequency – This parameter specifies the frequency the T-DMB receiver will be tuned
to in hertz.
• transmissionModes –
This parameter specifies the transmission modes a T-DMB receiver tests for T-DMB
ensembles. The default value is T-DMBConstants.transmissionModeAutomatic which
means that the receiver is automatically detecting the transmission mode. The parameter
is a flag field supporting the following flags which can be specified together:
– T-DMBConstants.transmissionModeAutomatic: The transmission mode is automatically
detected. All other flags are ignored in this case.
– T-DMBConstants.transmissionMode1: At the specified frequency it is tested if a T-DMB
ensemble is sent in transmission mode 1.
– T-DMBConstants.transmissionMode2: At the specified frequency it is tested if a T-DMB
ensemble is sent in transmission mode 2.
– T-DMBConstants.transmissionMode3: At the specified frequency it is tested if a T-DMB
ensemble is sent in transmission mode 3.
– T-DMBConstants.transmissionMode4: At the specified frequency it is t
...