/*

* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "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:

*

* Description:  Network field intensity sensor implementation

*

*/

#ifndef CNETWORKFIELDINTENSITYSENSOR_H

#define CNETWORKFIELDINTENSITYSENSOR_H

#include <etel3rdparty.h>

#include "csensorbase.h"

class CNetworkFieldIntensitySensor : public CSensorBase

{

    // Asynchronous query helper class

    class CSignalAsyncHandler : public CActive

    {

    public:

        enum TOperation

        {

            EOperationNone = 0,

            EGetSignalIntensity,

            ENotifySignalIntensityChange

        };

    public:

        static CSignalAsyncHandler* NewL(CNetworkFieldIntensitySensor& aSensor);

        virtual ~CSignalAsyncHandler();

    protected:

        CSignalAsyncHandler(CNetworkFieldIntensitySensor& aSensor);

        void ConstructL();

    public: // From CActive

        void RunL();

        void DoCancel();

    public: // New methods

        void SetDataListeningMode(TBool aIsDataListening);

        void SetConditionListeningMode(TBool aIsConditionListening);

    private: // New Methods

        void Start();

    private: // Members

        CNetworkFieldIntensitySensor& iSensor;

        CTelephony* iTelephony;

        CTelephony::TSignalStrengthV1 iSigStrengthV1;

        CTelephony::TSignalStrengthV1Pckg iSigStrengthV1Pckg;

        CSignalAsyncHandler::TOperation iCurrentOperation;

        /**

         * State variables

         */

        TBool iDataListening;

        TBool iConditionListening;

        /**

         * Used to evaluate whether to execute condition evaluation

         * when conditions are set and data listening is ongoing.

         */

        TInt iPrevSignalStrength;

    };

public:

    /**

     * Creates new CNetworkFieldIntensitySensor

     */

    static CNetworkFieldIntensitySensor* NewL();

    /**

     * Destructor

     */

    virtual ~CNetworkFieldIntensitySensor();

protected:

    /**

     * Symbian second phase constructor

     */

    void ConstructL();

    /**

     * Constructor

     */

    CNetworkFieldIntensitySensor();

public: // From Sensor

    virtual int OpenChannel(SensorListener* aListener);

public: // From CSensorBase

    virtual    HBufC* CreateDescriptionLC();

    virtual CSensorBase* DuplicateL();

    virtual TReal InterpretValue(TReal aValue);

    virtual void StartDataListeningL();

    virtual void CancelDataListeningL();

    virtual void CloseChannelL();

    virtual void StartConditionListeningL();

    virtual void StopConditionListeningL();

public: // New methods

    /**

     * Reset data object and those member variables that are

     * involved in data accumulation round.

     */

    void ResetAccumulationData();

    /**

     * Used by AccumulateDataL to send data to Java side and do

     * necessary cleanup.

     */

    void SendData();

    /**

     * Callback method called by RunL of iSignalRequest

     */

    void SignalLevelReceivedL(TInt aLevel);

    /**

     * Callback method called by RunL of iNotifier

     */

    void SignalLevelChangedL(TInt aLevel);

private: // Member data

    /**

     * Used to request notifications about signal level changes

     */

    CSignalAsyncHandler* iNotifier;

    /**

     * Values used in data accumulation

     */

    TTime iStartTime;

    TInt iBufferPosition;

};

#endif // CNETWORKFIELDINTENSITYSENSOR_H