idlehomescreen/inc/ai3performance.h
author Shabe Razvi <shaber@symbian.org>
Thu, 02 Sep 2010 15:42:21 +0100
branchRCL_3
changeset 84 20d75ec6647e
parent 0 f72a12da539e
permissions -rw-r--r--
Merge RCL_3 fixes with reverted delivery

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