Collapse all Symbian^3 Product Developer Library

Phone Signal Tutorial

This tutorial describes how to retrieve the phone signal strength using the multimode phone sub-sessions. Phone signal strength information is expressed as two integers:

Signal strength in dBm
Number of signal bars that the phone must display.

Find if the signal information can be obtained using RMobilePhone::GetSignalCaps()
Get the signal information using RMobilePhone::GetSignalStrength().
Use RMobilePhone::NotifySignalStrengthChange() to get the notification if signal information changes.

The function must return the signal strength and the number of bars to be displayed to the user.

Phone signal example

The following code checks if the signal information can be obtained, and if so, gets the signal information. The code assumes iMobilePhone is an RMobilePhone object.

TUint32 signalCaps;
User::LeaveIfError(iMobilePhone.GetSignalCaps(signalCaps));

TInt32 signalStrength = 0;
TInt8 bars = -1;
if (signalCaps & RMobilePhone::KCapsGetSignalStrength)
    {
    TRequestStatus status;
    iMobilePhone.GetSignalStrength(status, signalStrength, bars);
    User::WaitForRequest(status);
    User::LeaveIfError(status.Int());
    }

Parent topic: Multimode Phone Sub-session Tutorials