<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-F0C47F37-354B-51BD-B607-D4575C249DC8" xml:lang="en"><title>DVB-H

Receiver Library Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>This document introduces you to the DVB-H Receiver library. </p>

<section><title>Purpose</title> <p>The DVB-H Receiver library provides you

space to access hardware control for broadcasting TV service. This library

gives some services like signal scanning, signal strength monitoring, IP platform

selection, IP filter creation to mobile TV middleware. </p> </section>

<section><title>DVB-H Receiver Library Library Details</title><p>In order

to use this library, you must obtain necessary binaries in the form of DLL

file to implement <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> class. The DLL file must

be available to the build system if dvbhreceiver.h or dvbhreceiver.lib are

to be referenced in any source code. </p> <table id="GUID-43069104-FF3E-513F-A70C-65B94902DC00">

<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>

<thead>

<row>

<entry>DLL</entry>

<entry>LIB</entry>

<entry>Short Description</entry>

</row>

</thead>

<tbody>

<row>

<entry><p> <b>You must create your own *.dll file, we do not supply one. </b>  </p> </entry>

<entry><p> <filepath>dvbhreceiver.lib</filepath>  </p> </entry>

<entry><p>These files are used for implementing <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> class. </p> </entry>

</row>

</tbody>

</tgroup>

</table></section>

<section><title>Architectural Relationship</title> <p>This library is part

of the Mobile TV DVB-H Receiver HAI component. </p> </section>

<section><title>Description</title> <p>The DVB-H Receiver library is the main

library for interacting with hardware. It performs function such as: </p> <ul>

<li id="GUID-1D4A1942-4581-579F-B773-2F0D9E75F2F4"><p>Opening sessions to

the DVB-H Hardware Adaptation Layer (HAL) </p> </li>

<li id="GUID-C6BFB233-A72E-58BC-AC79-B7118B5093E6"><p>Scanning for DVB-H signals </p> </li>

<li id="GUID-2D33B235-192E-574E-848C-250BF2016F38"><p>Setting IP platforms </p> </li>

<li id="GUID-5386FD76-07C3-5ED9-B25E-884F52D42D94"><p>Creating IP filters

in order to filter out certain IP streams from a DVB-H broadcast </p> </li>

<li id="GUID-D750A108-F880-53A9-B9F3-556BBD58FEB3"><p>Receiving filtered IP

streams </p> </li>

<li id="GUID-DDF0E17F-8937-5135-AC2B-0E60208FC8D1"><p>Requesting the network

time. </p> </li>

</ul> </section>

<section><title>Key DVB-H Receiver Llibrary Classes</title> <p>The key class

is: </p> <ul>

<li id="GUID-5D07536C-3AC9-57C7-9491-DC5F2F90BFAA"><p> <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref>  </p> <p>It

provides an interface to DVB-H reception hardware. It grants a hardware control

and data reception interface for you to operate the receiver hardware. </p> </li>

</ul> <p>The enhanced functionality of <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> llibrary

is provided by a number of additional utilty classes that are accessed through

it, such as: </p> <ul>

<li id="GUID-F30B5BB4-9E2E-5174-BA05-212F16E8AE20"><p> <xref href="GUID-A02A8090-2D79-3BDC-9B97-91CEA6472C60.dita"><apiname>MDvbhDataObserver</apiname></xref>  </p> <p>Provides

notification of received IP data packets. </p> </li>

<li id="GUID-3114D3AB-22FA-52FC-A097-427C639BE066"><p> <xref href="GUID-7A97A0BE-1EDA-380F-B5BB-630E3E0614C4.dita"><apiname>MDvbhScanObserver</apiname></xref>  </p> <p>Provides

notification of scan operations. </p> </li>

</ul> <p>The Class diagram of <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita"><apiname>RDvbhReceiver</apiname></xref> is shown below: </p> <fig id="GUID-5124410C-180C-5DF5-BB13-DECD361AF1F5">

<image href="GUID-6E5625BF-88E0-579A-B2CA-32F3EBDD83CB_d0e525710_href.png" placement="inline"/>

</fig> <p> </p> </section>

<section><title>Using DVB-H Receiver Library</title> <ul>

<li id="GUID-A899FDD6-B1FD-5B9F-A1C7-C67DED8249AA"><p>A receiver hardware

session is opened by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-44B80593-8400-3084-AC33-B8E4F00DFE8F"><apiname>RDvbhReceiver::Open()</apiname></xref>  </p> </li>

<li id="GUID-14B9BD98-4BB1-5162-893D-9B49E4753444"><p>The receiver hardware

is powered on by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-3C48A641-C307-37D6-9931-D627363C8942"><apiname>RDvbhReceiver::PowerOn()</apiname></xref>  </p> </li>

<li id="GUID-86415409-9E44-5C9E-B566-FC9E48846A96"><p>Data reception preparation

is made by implementing <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-B0D7B27B-7952-3212-90CA-67B08D52AB7B"><apiname>RDvbhReceiver::ReceiveIPData()</apiname></xref>  </p> </li>

<li id="GUID-065A28AC-53CD-5DBC-BE1C-FC035EBF4E61"><p>Signal scanning is prepared

by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-742B86CD-4F94-3290-94C5-8BA38A679503"><apiname>RDvbhReceiver::Scan()</apiname></xref>  </p> </li>

<li id="GUID-347347E7-9094-591A-A1D6-C65A937436EC"><p>IP platform is set by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-63CE38E1-247D-3363-9D34-2CF5072D063B"><apiname>RDvbhReceiver::SetPlatform()</apiname></xref>  </p> </li>

<li id="GUID-B5DEECE1-94B6-5A5F-A655-73CA37C9C736"><p>IP filter is created

by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-8C4EBEA3-59A7-3738-98CC-FE40D3DAEF91"><apiname>RDvbhReceiver::CreateFilter()</apiname></xref>. </p> </li>

<li id="GUID-B88939D4-4341-5DFC-A0DC-7BAFEA7859D0"><p>Network time is updated

by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-F2B7A84B-C7A8-3F65-A464-08B0FE50C433"><apiname>RDvbhReceiver::UpdateNetworkTime()</apiname></xref>  </p> </li>

<li id="GUID-2C825DF5-8346-5348-A950-907C258B2E5D"><p>The receiver hardware

is powered down by<xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-67BCF315-6BA2-3968-8E9B-091099B839A6"><apiname>RDvbhReceiver::PowerOff()</apiname></xref>  </p> </li>

<li id="GUID-BA4AC3A0-E3D2-50F0-81A6-D1EA12693710"><p>The session of receiver

hardware is closed by <xref href="GUID-617CD367-CF68-3932-8E77-669820A7B9AF.dita#GUID-617CD367-CF68-3932-8E77-669820A7B9AF/GUID-FFE19627-4B07-3246-BCB2-957122BD1FBD"><apiname>RDvbhReceiver::Close()</apiname></xref>  </p> </li>

</ul> </section>

</conbody><related-links>

<link href="GUID-3C9BE2FF-8D5C-51D0-8BC1-BED7BC1288BA.dita"><linktext>Turn On Broadcast

Receiver Tutorial</linktext></link>

<link href="GUID-2C8BE998-BCCE-5A06-AFC1-4B611D9233AB.dita"><linktext>Turn Off

Broadcast Receiver Tutorial</linktext></link>

<link href="GUID-0297CAF5-4EB7-5E84-8A8C-8758D6F3B75F.dita"><linktext>Setting Data

Reception Tutorial</linktext></link>

<link href="GUID-567585CC-26EC-553D-99D5-D3C178C455F6.dita"><linktext>DVB-H Signal

Scanning Tutorial</linktext></link>

<link href="GUID-743D3117-095B-58D5-947D-A8713475C9A5.dita"><linktext>Tuning IP

Platform Tutorial</linktext></link>

<link href="GUID-F5FE22F3-B7C4-50B3-9B36-5CB8BC1BA18A.dita"><linktext>Receiving

Broadcast Data Tutorial</linktext></link>

</related-links></concept>