DVB-H Receiver Information Library Overview

Purpose

The DVB-H Receiver Information library provides the functionality to get information about the DVB-H receiver and track its usage.

DVB-H Receiver Information Library Details

The Symbian platform does not include an implementation of this API, but a lib is provided, along with stub functionality, allowing you to implement your own DVB-H information receiver. In order to use this API you must include dvbhreceiverinfo.h in your code. This will import the necessary functionality of dvbhreceiverinfo.lib, such as the CDvbhReceiverInfo class to your code.

Architectural Relationship

This API is part of the Mobile TV DVB-H Receiver HAI component.

Description

DVB-H Receiver Information API allows you to retrieve information about the signal and the hardware. It is not possible to change or interfere with the operation of the receiver by using CDvbhReceiverInfo class but only to read the information.

DVB-H Receiver Information API is used to:

• Retrieve current receiver state, signal quality, platform, network time and frequency

• Retrieves performance data of the receiver

• Notify the request of receiver state, signal quality, platform, network time and frequency.

This API does not provide access to the DVB-H datagram packets but to information about the IP packets and the state of the hardware. To access the DVB-H data stream use the DVB-H Receiver API.

Key DVB-H Receiver Information Library Classes

The key classe of the DVB-H Receiver Information API is

• CDVBHReceiverInfo

  This class is used to create appropriate function calls to perform the various information requests.

The class diagram of CDVBHReceiverInfo is shown below:

The enhanced functionality of CDvbhReceiverInfo API are provided by a number of additional utilty classes, they are such as:

• MDvbhNetworkIdObserver : To observer interface for tracking changes in network id.

• MDvbhStateObserver : To observer interface for receiver state changes.

• MDvbhNetworkTimeObserver : To observe interface for tracking updates in network time.

• MDvbhSignalQualityObserver : To observe interface for tracking signal quality of DVB-H reception.

• MDvbhFrequencyObserver : To observer interface for tracking changes in frequency.

• MDvbhPlatformObserver : To observer interface for tracking changes to the selected DVB-H platform.

Using DVB-H Receiver Information Library

• This library retrieves you some current information like state of the receiver, quality of the DVB-H signal, performance metrics, network time and frequency.

• This library receives you notification changes of state, signal quality, platform, frequency and network time.