/*

* 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:    

*

*/

#ifndef CIAUPDATEFWFOTAMODEL_H

#define CIAUPDATEFWFOTAMODEL_H

//  INCLUDES

#include <fotaengine.h>

// FORWARD DECLARATIONS

// CLASS DECLARATION

/**

*  Functionality required by the fota user interface.

*

*  @lib IAUpdateFWSyncApp

*  @since Series 60 3.1

*/

class CIAUpdateFWFotaModel : public CBase

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

         static CIAUpdateFWFotaModel* NewL( /*KNST CNSCDocument* aDocument*/ );

        /**

        * Destructor.

        */

        virtual ~CIAUpdateFWFotaModel();

    public: // New functions

        /**

        * Retrieves the human readable name of the profile.

        * @since Series 60 3.1

        * @param aProfileId Profile identifier

        * @param aProfileId Human readable name of the profile, or KNullDesC if not found.

        * @return None

        */

        void GetProfileNameL( const TInt aProfileId,

                                    HBufC* aProfileName ) const;

        /**

        * Retrieves the default fota profile identifier from

        * the central repository.

        * @since Series 60 3.1

        * @param None

        * @return Profile identifier

        */

          TInt DefaultFotaProfileIdL() const;

        /**

        * Saves the default fota profile identifier to the

        * central repository.

        * @since Series 60 3.1

        * @param aProfileId Profile identifier.

        * @return None

        */

        void SetDefaultFotaProfileIdL( const TInt aProfileId );

        /**

        * Sets the central repository key to indicate that the

        * defined profile should be used to request firmware

        * update.

        * @since Series 60 3.1

        * @param aProfileId Profile identifier.

        * @return None

        */

          void EnableFwUpdRequestL( const TInt aProfileId );

        /**

        * Retrieves the device management profile names into a list.

        * @since Series 60 3.1

        * @param aItems Array into which the profile names are appended.

        * @return None

        */

        void ReadProfileListL( CDesCArray* aItems,

                               CArrayFixFlat<TInt>* aProfileIdList );

        /**

        * Returns the index of the default fota profile in the

        * given list of identifiers.

        * @since Series 60 3.1

        * @param aProfileIdList List of profile identifiers.

        * @return Index of the default fota profile in the list.

        */

        TInt SelectDefaultProfileFromList(

            const CArrayFixFlat<TInt>* aProfileIdList ) const;

        /**

        * Checks that the profile identifier is included in the

        * devie management profiles list.

        * @since Series 60 3.1

        * @param aProfileIdList List of profile identifiers.

        * @return Index of the default fota profile in the list.

        */

        TBool VerifyProfileL( const TInt aProfileId ) const;

        /**

        * Retrieves the list of firmware update packages known to

        * the FOTA server component.

        * @since Series 60 3.1

        * @param None.

        * @return Array that includes the package identifiers.

        */

        RArray< TInt > RetrieveFwUpdPkgIdListL();

        /**

        * Checks if the FOTA server component has knowledge of firmware update

        * packages that are in the given state. 

        * @since Series 60 3.1

        * @param aState Package state to be searched for.

        * @return Identifier of the package that has the given state, or

        *         KErrNotFound if none are found.

        */

         TInt FindFwUpdPkgWithStateL( RFotaEngineSession::TState aState );

        /**

        * Initiates the instalklation of a firmware update package.

        * @since Series 60 3.1

        * @param aPkgId Identifier of the update package.

        * @return error code.

        */

         TInt InitiateFwUpdInstall( TInt aPkgId, TInt aProfileId );

        /**

        * Returns the version string of the current firmware.

        * @since Series 60 3.1

        * @param aVersionString The version string of the current firmware.

        * @return Error code.

        */

        TInt CurrentFwVersionString( TDes& aVersionString );

        /**

        * Returns the time of the last successful firmware update.

        * @since Series 60 3.1

        * @param aVersionString The time of the last firmware update.

        * @return Error code.

        */

        TInt LastUpdateTime( TTime& aTime );

        /**

        * Saves the current state of update packages.

        * @param None.

        * @return None.

        */

         void MarkFwUpdChangesStartL();

        /**

        * Checks if the state of update packages has changed since the saved

        * situation.

        * @param None.

        * @return True if there are differences in pcakage identifiers or states.

        */

         TBool FwUpdStatesChangedL();

         RFotaEngineSession::TState GetCurrentFwUpdState();

         /**

          * Runtime if DM support is available or not

          * @return ETrue if DM support is available

          */

         TBool IsDMSupportAvailableL();

    public: // Functions from base classes

        /**

        * From ?base_class ?member_description.

        * @since Series ?XX ?SeriesXX_version

        * @param ?arg1 ?description

        * @return ?description

        */

        //?type ?member_function( ?type ?arg1 );

    protected:  // New functions

        /**

        * ?member_description.

        * @since Series ?XX ?SeriesXX_version

        * @param ?arg1 ?description

        * @return ?description

        */

        //?type ?member_function( ?type ?arg1 );

    protected:  // Functions from base classes

        /**

        * From ?base_class ?member_description

        */

        //?type ?member_function();

    private:

        /**

        * C++ default constructor.

        */

        CIAUpdateFWFotaModel( /*KNST CNSCDocument* aDocument*/ );

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL();

    private:    // Data

        // Data structure used in storing the update package identifiers

        // and states.

        struct TFwUpdIdState

            {

            TInt                        iPkgId;

            RFotaEngineSession::TState  iState;

            };

        // Array containing a snapshot state of the update pcakage identifiers

        // and corresponding states.

        RArray< TFwUpdIdState > iFwUpdIdStateList;

        // Pointer to the application document instance.

        //KNST CNSCDocument*    iDocument;

        // Is the data package download in progress.

        TBool                   iDpDlInProgress;

        RFotaEngineSession      iFotaEngine;     

    };

#endif      // CIAUpdateFWFOTAMODEL_H   

// End of File