--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/idlehomescreen/inc/ai3performance.h	Thu Dec 17 08:40:49 2009 +0200
@@ -0,0 +1,190 @@
+/*
+* Copyright (c) 2009 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 AI3PERFORMANCE_H
+#define AI3PERFORMANCE_H
+
+//  INCLUDES
+#include <e32debug.h>
+#include <e32base.h>
+#include <e32std.h>
+#include <hal.h>
+#include <e32cmn.h>
+#include <flogger.h>
+#include <f32file.h>
+
+_LIT(KLogFileName,"ai3perf.log");
+_LIT(KLogFileDir,"ai3logs");
+_LIT(KLogFileRootDir,"c:\\logs\\");
+
+/**
+ *  @class CAi3Perf
+ *
+ *  Provides API to measure performance (memory and time). Results are saved to a file.
+ *
+ *  @since Series 60 5.0
+ */
+class CAi3Perf : public CBase
+    {
+    public:
+       /**
+        * Struct which holds data before measuring is started.
+        */
+        struct TPerfData
+            {
+           /**
+            * Time when measure starts
+            */
+            TTime iStartTime;
+            
+           /**
+            * Memory when measure starts
+            */
+            TInt iStartMemory;
+            };
+
+    public:  // Constructors and destructor
+       /**
+        * Constructor.
+        */
+        static CAi3Perf* NewL();
+        
+       /**
+        * Destructor.
+        */
+        virtual ~CAi3Perf();
+
+    public: // New functions
+       /**
+        * Prints current amount of memory to file.
+        *
+        * @param aMsg User defined message which is printed before amount of memory
+        */
+        inline static void PrintUserMem(const TDesC& aMsg);
+        
+       /**
+        * Saves current amount of memory and time and returns those to user.
+        *
+        * @param aMsg User defined message.
+        * @return TPerfData which holds current memory consumption and time.
+        */
+        inline static TPerfData* StartTestCase(const TDesC& aMsg = KNullDesC);
+        
+       /**
+        * Reads current amount of memory and time and calculates performance using
+        * values got from StartTestCase.
+        *
+        * @param aData Data which has got when calling StartTestCase.
+        * @param aMsg User defined message.
+        */
+        inline static void StopTestCase(TPerfData* aData, const TDesC& aMsg = KNullDesC);
+        
+       /**
+        * Create file where results are written to.
+        */
+        inline static void CreateLogFile();
+    private:
+       /**
+        * Internal constructor.
+        */
+        CAi3Perf();
+        
+       /**
+        * Internal constructor.
+        */
+        void ConstructL();
+    };
+
+inline void CAi3Perf::PrintUserMem(const TDesC& aMsg)
+    {
+    TBuf<512> buffer;
+    TInt freeRAM;
+    HAL::Get(HALData::EMemoryRAMFree, freeRAM);
+    RHeap heap = User::Heap();
+    heap.Open();
+    TInt _size = heap.Size();
+    TInt largest = 0;
+    TInt available = heap.Available(largest);
+    heap.Close();
+    _LIT( KMemoryFormat, "FreeRAM: %d kB, User: - heap %d kB, available %d kB, largest block %d kB" );
+    buffer.Format(KMemoryFormat, freeRAM / 1024, _size / 1024, available / 1024, largest / 1024);
+    CreateLogFile();
+    //Write logs into file
+    RFileLogger::WriteFormat( KLogFileDir,KLogFileName,EFileLoggingModeAppend,_L("RAM - %S - %S"), &aMsg, &buffer);
+    }
+
+inline CAi3Perf::TPerfData* CAi3Perf::StartTestCase(const TDesC& aMsg)
+    {
+    CreateLogFile();
+    //Write logs into file
+    RFileLogger::WriteFormat(KLogFileDir,KLogFileName,EFileLoggingModeAppend,_L("Test case %S starts"), &aMsg);
+    CAi3Perf::TPerfData* data = new (ELeave) TPerfData;
+    TTime readyTime;
+    data->iStartTime.HomeTime();
+    User::AllocSize(data->iStartMemory);
+    return data;
+    }
+
+inline void CAi3Perf::StopTestCase(CAi3Perf::TPerfData* aData, const TDesC& aMsg)
+    {
+    if(!aData)
+        {
+        return;
+        }
+    TTime readyTime;
+    readyTime.HomeTime();
+    TTimeIntervalMicroSeconds delay = readyTime.MicroSecondsFrom(aData->iStartTime);
+    TTime transferTime(delay.Int64());
+    TBuf<64> timeString;
+    transferTime.FormatL(timeString, _L("- Elapsed time: %S%C microseconds"));
+    TBuf<256> tmp;
+    tmp.Append(timeString);
+
+    RFileLogger::Write(KLogFileDir,KLogFileName,EFileLoggingModeAppend,tmp);
+    // Memory consumption
+    TInt endMemory;
+    User::AllocSize(endMemory); 
+
+    CreateLogFile();
+    //Write logs into file
+    RFileLogger::WriteFormat(KLogFileDir,KLogFileName,EFileLoggingModeAppend,_L("- Allocated memory: %d kB"), (endMemory - aData->iStartMemory) / 1024);
+    delete aData;
+    aData = NULL;
+    RFileLogger::WriteFormat(KLogFileDir,KLogFileName,EFileLoggingModeAppend,_L("Test case %S ends"), &aMsg);
+    }
+inline void CAi3Perf::CreateLogFile()
+    {
+        RFs fsSession;
+        RFile file;
+        User::LeaveIfError(fsSession.Connect());
+        TFileName filename;
+        filename.Append(KLogFileRootDir);
+        filename.Append(KLogFileDir);
+        filename.Append(_L("\\"));
+        //create logs directory if it doesn't exist
+        fsSession.MkDir(filename);
+        filename.Append(KLogFileName);
+        //check if log file already exists
+        TInt retStatus = file.Open(fsSession,filename,EFileRead);
+        if(retStatus == KErrNotFound)
+            file.Create(fsSession,filename,EFileWrite);         //create a new log file
+        file.Close();
+        fsSession.Close();
+    }
+#endif // AI3PERFORMANCE_H
+            
+// End of File