CRadioFmTunerUtility Class Reference

class CRadioFmTunerUtility : public CBase

This class provides an interface to allow clients to control the FM tuner hardware present on a device.

RadioUtility.lib
Since
S60 3.2

Inherits from

  • CRadioFmTunerUtility

Nested Classes and Structures

Constructor & Destructor Documentation

CRadioFmTunerUtility()

CRadioFmTunerUtility()[private]

~CRadioFmTunerUtility()

~CRadioFmTunerUtility()[private, virtual]

Member Functions Documentation

CancelSetFrequency()

IMPORT_C voidCancelSetFrequency()

Cancels an ongoing tune operation, as initiated by a call to Tune. The usual callback will not occur if this has been called.

Has not effect if no tune operation is ongoing.

Since
S60 3.2

CancelSetFrequencyRange()

IMPORT_C voidCancelSetFrequencyRange()

Cancels an ongoing set frequency range operation, as initiated by a call to SetFrequencyRange. The usual callback will not occur if this has been called.

Has not effect if no set frequency range operation is ongoing.

Since
S60 3.2

CancelStationSeek()

IMPORT_C voidCancelStationSeek()

Cancels an ongoing station seek operation, as initiated by a call to StationSeek. The usual callback will not occur if this has been called.

Has not effect if no station seek operation is ongoing.

Since
S60 3.2

Close()

IMPORT_C voidClose()

Close the tuner and free all memory allocated. Any ongoing playing activity will be stopped, control of the tuner will be released, and the hardware will be powered down if no other clients need it.

Since
S60 3.2

ConstructL()

voidConstructL()[private]

EnableTunerInOfflineMode(TBool)

IMPORT_C TIntEnableTunerInOfflineMode(TBoolaEnable)

Enable tuner functions when the device is in offline mode. Client should first check the capabilities to see if this feature is supported.

When requested prior to requesting tuner control, this function will succeed with KErrNone, however, tuner will only be enabled in offline mode if supported by the tuner device.

Tuner functions are disabled in offline mode by default.

Since
S60 3.2

Parameters

TBool aEnableETrue to enable tuner functions in offline mode, EFalse to disable.

ForceMonoReception(TBool)

IMPORT_C TIntForceMonoReception(TBoolaForcedMono)

Indicates whether the reception should be forced into monophonic mode.

Since
S60 3.2

Parameters

TBool aForcedMono

GetCapabilities(TFmTunerCapabilities &)

IMPORT_C TIntGetCapabilities(TFmTunerCapabilities &aCaps)

Get the capabilities of the FM tuner on the device.

Since
S60 3.2

Parameters

TFmTunerCapabilities & aCapsThe capabilities object to fill

GetForcedMonoReception(TBool &)

IMPORT_C TIntGetForcedMonoReception(TBool &aForcedMono)const

Find out whether reception is forced into monophonic mode or not.

Since
S60 3.2

Parameters

TBool & aForcedMonoOn return, will be ETrue if a forced mono is currently enabled.

GetFrequency(TInt &)

IMPORT_C TIntGetFrequency(TInt &aFrequency)const

Get the currently tuned frequency.

Since
S60 3.2

Parameters

TInt & aFrequencyOn return contains the current frequency (Hz).

GetFrequencyRange(TFmRadioFrequencyRange &, TInt &, TInt &)

IMPORT_C TIntGetFrequencyRange(TFmRadioFrequencyRange &aRange,
TInt &aMinFreq,
TInt &aMaxFreq
)const

Get the current frequency range. It also returns the minimum and maximum frequencies (Hz) for the returned range. Client should always use the minimum and maximum frequencies returned by the tuner device, since it may vary slightly depending on the hardware.

Since
S60 3.2

Parameters

TFmRadioFrequencyRange & aRangeOn return contains the current frequency range.
TInt & aMinFreqOn return contains the minimum frequency for the current frequency range.
TInt & aMaxFreqOn return contains the maximum frequency for the current frequency range.

GetMaxSignalStrength(TInt &)

IMPORT_C TIntGetMaxSignalStrength(TInt &aMaxSignalStrength)const

Get the maximum possible signal strength of a tuned frequency.

Since
S60 3.2

Parameters

TInt & aMaxSignalStrengthOn return contains the maximum signal strength.

GetSignalStrength(TInt &)

IMPORT_C TIntGetSignalStrength(TInt &aSignalStrength)const

Get the signal strenth of the currently tuned frequency.

Since
S60 3.2

Parameters

TInt & aSignalStrengthOn return contains the signal strength.

GetSquelch(TBool &)

IMPORT_C TIntGetSquelch(TBool &aSquelch)const

Get the current squelching (muting in frequencies without reception) setting.

Since
S60 3.2

Parameters

TBool & aSquelchOn return, will be ETrue if a squelching is currently enabled.

GetStereoMode(TBool &)

IMPORT_C TIntGetStereoMode(TBool &aStereo)const

Get the current frequency's stereo mode (stereo or mono).

Since
S60 3.2

Parameters

TBool & aStereoOn return, will be ETrue if a stereo signal is currently being received.

NewL(RRadioSession &, MRadioFmTunerObserver &)

CRadioFmTunerUtility *NewL(RRadioSession &aRadioSession,
MRadioFmTunerObserver &aObserver
)[private, static]

Factory function to create a new instance of the FM tuner.

Since
S60 3.2

Parameters

RRadioSession & aRadioSessionReference to radio session
MRadioFmTunerObserver & aObserverThe observer object for receiving async completion callbacks

RequestTunerControl()

IMPORT_C voidRequestTunerControl()

Asynchronous request to get control of the FM tuner. This method call must be made before any other method calls in this API. User must be ready to receive callback method MrftoRequestTunerControlComplete. Control to the tuner must be granted before any functions that require control of the tuner (such as SetFrequency) can be made. The only API call that doesn't require tuner control to be granted is EnableTunerInOfflineMode().

SetFrequency(TInt)

IMPORT_C voidSetFrequency(TIntaFrequency)

Asynchronous request to tune the tuner to the speficied frequency (Hz). User must be ready to receive callback method MrftoTuneComplete.

Since
S60 3.2
MRadioFmTunerObserver::MrftoTuneComplete

Parameters

TInt aFrequencyThe frequency to tune to

SetFrequencyRange(TFmRadioFrequencyRange)

IMPORT_C voidSetFrequencyRange(TFmRadioFrequencyRangeaRange)

Asynchronous request to set the frequency range. User must be ready to receive callback method MrftoSetFrequencyRangeComplete. If not set, it will be defaulted to EFmRangeEuroAmerica.

Since
S60 3.2

Parameters

TFmRadioFrequencyRange aRangeFrequency range

SetSquelch(TBool)

IMPORT_C TIntSetSquelch(TBoolaSquelch)

Set the current squleching (muting in frequencies without reception) setting. Squelching is enabled by default.

Since
S60 3.2

Parameters

TBool aSquelch

StationSeek(TBool)

IMPORT_C voidStationSeek(TBoolaUpwards)

Asynchronous request to find a radio station, starting from the currently tuned frequency and searching in the direction specified (i.e. up or down). User must be ready to receive callback method MrftoSeekComplete. The station found is returned in the callback.

If no station is found after a complete loop, seek will stop and return KErrNotfound in the callback method and frequency will not change.

Parameters

TBool aUpwardsThe direction to search in. Searches upwards if set to ETrue.

Member Data Documentation

CBody * iBody

CBody *iBody[private]

FM tuner utility implementation body Own.