/****************************************************************************

**

** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

** All rights reserved.

** Contact: Nokia Corporation (qt-info@nokia.com)

**

** This file is part of the Qt Mobility Components.

**

** $QT_BEGIN_LICENSE:LGPL$

** No Commercial Usage

** This file contains pre-release code and may not be distributed.

** You may use this file in accordance with the terms and conditions

** contained in the Technology Preview License Agreement accompanying

** this package.

**

** GNU Lesser General Public License Usage

** Alternatively, this file may be used under the terms of the GNU Lesser

** General Public License version 2.1 as published by the Free Software

** Foundation and appearing in the file LICENSE.LGPL included in the

** packaging of this file.  Please review the following information to

** ensure the GNU Lesser General Public License version 2.1 requirements

** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

**

** In addition, as a special exception, Nokia gives you certain additional

** rights.  These rights are described in the Nokia Qt LGPL Exception

** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

**

** If you have questions regarding the use of this file, please contact

** Nokia at qt-info@nokia.com.

**

**

**

**

**

**

**

**

** $QT_END_LICENSE$

**

****************************************************************************/

#ifndef SENSORBACKENDSYM_H

#define SENSORBACKENDSYM_H

// QT Mobility Sensor API headers

#include <qsensorbackend.h>

// Standard Symbian Headers

#include <e32std.h>

#include <e32cmn.h>

// Sensor client headers

// Common Sensor Headers

#include <sensrvchannel.h>

#include <sensrvchannelinfo.h>

#include <sensrvtypes.h>

#include <sensrvchannelfinder.h>

#include <sensrvdatalistener.h>

#include <sensrvpropertylistener.h> 

// Internal Headers

#include "sensorbackenddatasym.h"

QTM_USE_NAMESPACE

class CSensorBackendSym : public CBase, public QSensorBackend, public MSensrvDataListener, public MSensrvPropertyListener

    {

    public:

        // From QSensorBackend

        /**

         *  start is used to start listening to the sensor

         */

        virtual void start();

        /*

         * stop is used to stop listening to the sensor

         */

        virtual void stop();

        /*

         * Backend Destructor

         */

        ~CSensorBackendSym();

        // From MSensrvDataListener

        /*

         * DataReceived is called by the Sensor Server when ever data is available in the

         * sensor buffer

         */

        void  DataReceived(CSensrvChannel &aChannel, TInt aCount, TInt aDataLost);

        /**

         * DataError is called to indicate an error, fatal errors are inrecoverable

         */

        void  DataError(CSensrvChannel &aChannel, TSensrvErrorSeverity aError);

        /*

         * GetDataListenerInterfaceL is used to get a pointer to the sensor server backend

         * It is not required for QT Mobility Sensors API

         */

        void  GetDataListenerInterfaceL(TUid aInterfaceUid, TAny *&aInterface);

        // From MSensrvProeprtyListener        

        /**

         * Notification about the changed value of a property.

         */

        void  PropertyChanged (CSensrvChannel &aChannel, const TSensrvProperty &aChangedProperty);

        /**

         *  Property listening failed.

         */

        void  PropertyError (CSensrvChannel &aChannel, TSensrvErrorSeverity aError);

        /**

         * Set a listener for the indication, if the setting of the property succeeded.

         */ 

        void  SetPropertySuccessIndicationChanged (TSetPropertySuccessIndicator aIndication);

        /*

         * Returns a pointer to a specified interface extension - to allow future extension of this class without breaking binary compatibility.

         */

        void  GetPropertyListenerInterfaceL (TUid aInterfaceUid, TAny *&aInterface);

        /*

         * To enable/disable data/property listening

         */ 

        void SetListening(TBool aDataListening, TBool aPropertyListening);

    protected:

        /*

         * Default C++ constructor

         */

        CSensorBackendSym(QSensor *sensor);

        /**

         * Deriving class implements this if it requires property change notification

         */

        virtual void HandlePropertyChange(CSensrvChannel &aChannel, const TSensrvProperty &aChangedProperty);

        /*

         * RecvData is used to retrieve the sensor reading from sensor server

         * It is implemented the the sensor concrete class and handles sensor specific

         * reading data and provides conversion and utility code

         */

        virtual void RecvData(CSensrvChannel &aChannel) = 0;

        /*

         * InitializeL is used to create and init the sensor server objects

         */ 

        void InitializeL();

        /*

         * Close is used to release all the sensor server objects

         * May change when error handling is supported by mobility apis

         */

        TInt Close();

        /*

         * FindSensorL is used to find if a specific sensor is available on the

         * device, if FindSensorL leaves then the sensor is not supported

         */

        void FindSensorL();

        /*

         * OpenSensorChannelL is used to open the channel for sensor as indicated by

         * iPrivateData.iChannelInfo

         */

        void OpenSensorChannelL();

        /*

         * CloseSensorChannel is used to close the sensor channel and release the

         * resources

         */

        void CloseSensorChannelL();

        /*

         * Used to start listening to the sensor

         */

        void StartListeningL();

        /*

         * Used to stop listening to the sensor

         */

        void StopListeningL();

        /*

         * timerEvent is called when timer expires, this is used for supporting time based

         * sensor update policies

         */

        void timerEvent(QTimerEvent *aTimerEvent);

    protected:

        TSensorBackendDataSym iBackendData;

    };

#endif //SENSORBACKENDSYM_H