--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/iaupdate/IAD/firmwareupdate/inc/iaupdatefwfotamodel.h Thu Dec 17 08:51:10 2009 +0200
@@ -0,0 +1,249 @@
+/*
+* 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