Accessing DVB-H Receiver Information

Purpose

The purpose of this tutorial is to retrieve current information about the receiver.

Required Background

CDvbhReceiverInfo supplies static " getter" methods which may be used to retrieve information about the receiver. These methods are described in more detail in Setup and Configuration Requirements section below.

Introduction

The following receiver information may be queried as follows:

• state

• signal quality

• platform

• performance data

• network time

• frequency

• Cell Id

• Network Id

Setup and Configuration Requirements

To retreive any of the above information you simply have to call one of the following static methods on CDvbhReceiverInfo.

• To retrieve the current state of the receiver, call CDvbhReceiverInfo::GetState()

• To retrieve the quality of the DVB-H signal, call CDvbhReceiverInfo::GetSignalQuality()

• To retrieve the currently set IP platform, call CDvbhReceiverInfo::GetPlatform()

• To retrieve the current performance metrics, call CDvbhReceiverInfo::GetPerformanceData()

• To retrieve the current network time, call CDvbhReceiverInfo::GetNetworkTime()

• To retrieve the current frequency, call CDvbhReceiverInfo::GetFrequency()

• To retrieve the current cellId, call CDvbhReceiverInfo::GetCellId()

• To retrieve the current networkId, call CDvbhReceiverInfo::GetNetworkId().

Using Accessing DVB-H Receiver Information Tutorial

The following tasks will be covered in this tutorial:

• How to retrieve the current information about the receiver

Basic Procedure

The high level steps to retrieve current information about the receiver are shown here:

1. You must call the appropriate getter method to retrieve the current information. For example in order to get information about signal quality, call CDvbhReceiverInfo::GetSignalQuality().

   An example flow, to get signal quality is shown below.

Example

TDvbhState currentState;
User::LeaveIfError(CDvbhReceiverInfo::GetState(currentState));
//Have obtained the current state.
if (currentState == EDvbhReceivingState)
    {
    //Receiver is in the right state to call GetSignalQuality()
    TDvbhSignalQuality currentSignalQuality;
    //Do not expect the following to leave.
    User::LeaveIfError(CDvbhReceiverInfo::GetSignalQuality(
                                                 currentSignalQuality));
    }
else
    {
    //Receiver is not in the right state for GetSignalQuality(). 
    }