// Copyright (c) 1996-2009 Nokia Corporation and/or its subsidiary(-ies).

 // All rights reserved.

 // This component and the accompanying materials are made available

 // under the terms of the License "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:

 // f32\sfat\sl_cache.cpp

 // 

 //

 #include "sl_std.h"

 #include "sl_cache.h"

 //!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 //!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 //!!

 //!! WARNING!! DO NOT edit this file !! '\sfat' component is obsolete and is not being used. '\sfat32'replaces it

 //!!

 //!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 //!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

 //---------------------------------------------------------------------------------------------------------------------------------

 /**

     CWTCachePage factory function.    

     @param  aPageSizeLog2 Log2(cache page size in bytes)

     @return a pointer to the created object.

 */

 CWTCachePage* CWTCachePage::NewL(TUint32 aPageSizeLog2)

     {

     CWTCachePage* pSelf = new (ELeave)CWTCachePage;

     pSelf->ConstructL(aPageSizeLog2);

     return pSelf;

     }

 /**

     2nd stage constructor.

     @param  aPageSizeLog2 Log2(cache page size in bytes)

 */

 void CWTCachePage::ConstructL(TUint32 aPageSizeLog2)

     {

     iData.CreateMaxL(1 << aPageSizeLog2);

     }

 CWTCachePage::CWTCachePage()

     {

     iStartPos = 0xDeadDeadul;

     iValid  = 0;

     }

 CWTCachePage::~CWTCachePage() 

     { 

     iData.Close(); 

     }

 //---------------------------------------------------------------------------------------------------------------------------------

 CMediaWTCache::CMediaWTCache(TFatDriveInterface& aDrive)

           :iDrive(aDrive), iPageSizeLog2(0), iAllPagesValid(EFalse)

     {

     iCacheDisabled = EFalse;

     iCacheBasePos  = 0; 

     }

 CMediaWTCache::~CMediaWTCache()

     {

     //-- delete pages

     TInt cnt = iPages.Count();

     while(cnt--)

         {

         delete iPages[cnt];

         }

     iPages.Close();

     }

 /**

     Directory cache factory function.

     @param  aDrive  reference to the driver for media access.

     @param  aNumPages     number of cache pages to be created

     @param  aPageSizeLog2 Log2 of the page size in bytes

     @return a pointer to the created object.

 */

 CMediaWTCache* CMediaWTCache::NewL(TFatDriveInterface& aDrive, TUint32 aNumPages, TUint32 aPageSizeLog2)

     {

 #ifndef ENABLE_DEDICATED_DIR_CACHE    

     //-- dedicated directory cache isn't enabled

     (void)aDrive; //-- supress compiler's warning

     (void)aClusterSizeLog2;

     return NULL;

 #else    

     //-- dedicated directory cache is enabled, create it

     ASSERT(aPageSizeLog2);

     ASSERT(aNumPages);

     CMediaWTCache* pSelf = new (ELeave) CMediaWTCache(aDrive);

     CleanupStack::PushL(pSelf);

     pSelf->ConstructL(aNumPages, aPageSizeLog2);

     CleanupStack::Pop();

     return pSelf;

 #endif

     }

 /**

     2nd stage constructor.

     @param  aNumPages number of pages in the directory cache.

     @param  aPageSizeLog2 Log2(single cache page size in bytes)

 */

 void CMediaWTCache::ConstructL(TUint32 aNumPages, TUint32 aPageSizeLog2)

     {

     ASSERT(aNumPages && aPageSizeLog2);

     __PRINT2(_L("#CMediaWTCache::CreateL() Pages=%d, PageSize=%d"), aNumPages, 1<<aPageSizeLog2);

     iPageSizeLog2 = aPageSizeLog2; 

     //-- create cache pages

     for(TUint cnt=0; cnt<aNumPages; ++cnt)

         {

         CWTCachePage* pPage = CWTCachePage::NewL(aPageSizeLog2);

         iPages.Append(pPage);

         }

     InvalidateCache();  

     }

 /**

     @return size of the cache in bytes. Can be 0.

 */

 TUint32 CMediaWTCache::CacheSizeInBytes() const

     {

     const TUint32 cacheSz = iPages.Count() << iPageSizeLog2; //-- Page size is always power of 2

     return cacheSz;

     }

 /**

 Implementation of pure virtual function.

 @see MWTCacheInterface::MakePageMRU()

 */

 void CMediaWTCache::MakePageMRU(TInt64 /*aPos*/)

     {

     return;

     }

 /**

 Implementation of pure virtual function.

 @see MWTCacheInterface::PageSizeInBytesLog2()

 */

 TUint32 CMediaWTCache::PageSizeInBytesLog2() const

     {

     return iPageSizeLog2;

     }

 /**

     Control method.

     @param  aFunction   control function

     @param  aParam1     just arbitrary parameter 

     @param  aParam2     just arbitrary parameter 

     @return Standard error code.

 */

 TInt CMediaWTCache::Control(TUint32 aFunction, TUint32 aParam1, TAny* /*aParam2*/)

     {

     TInt nRes = KErrNotSupported;

 #ifdef _DEBUG

     switch(aFunction)

         {

         //-- disable / enable cache, for debug

         //-- if aParam1 !=0 cache will be disabled, enabled otherwise

         case EDisableCache: 

             iCacheDisabled = aParam1 ? 1 : 0;

             nRes = KErrNone;

         break;

         case EDumpCache:

         break;

         case ECacheInfo:

         break;

         default:

             __PRINT1(_L("CMediaWTCache::Control() invalid function: %d"), aFunction);

             ASSERT(0);

         break;

         }

 #else

     (void)aFunction; //-- supress warnings

     (void)aParam1;

     User::Invariant(); //-- don't call this method in release build

 #endif //_DEBUG   

     return nRes;

     }

 //-------------------------------------------------------------------------------------

 /**

     Invalidate whole cache

 */

 void CMediaWTCache::InvalidateCache(void)

     {

     const TUint nPages = iPages.Count();    

     for(TUint i=0; i<nPages; ++i)

         {

         iPages[i]->iValid=EFalse;

         }

     iAllPagesValid = EFalse;

     }

 //-------------------------------------------------------------------------------------

 /** 

     invalidate a single cache page if the aPos is cached (belongs to some page)

     If the cache user wants to invalidate some media address range, it will have to calculate 

     pages positions itself. The best way to do this - is to write another method that takes lenght of the 

     region being invalidated. 

     @param aPos media position. If it is cached, the corresponding single cache page will be marked as invalid

 */

 void CMediaWTCache::InvalidateCachePage(TUint64 aPos)

     {

     const TUint nPages = iPages.Count();    

     for(TUint i=0; i<nPages; ++i)

         {

         if( iPages[i]->PosCached(aPos))  

             {

             iPages[i]->iValid=EFalse;

             iAllPagesValid = EFalse;

             break;

             }

         }

     }

 //-------------------------------------------------------------------------------------

 /**

     Find cache page by given media position.

     @param  aPos    linear media position

     @return positive cache page number or -1 if no pages containing data at aPos found.

 */

 TInt CMediaWTCache::FindPageByPos(TInt64 aPos) const

     {

     const TUint nPages = iPages.Count();    

     for(TUint i=0; i<nPages; ++i)

         {

         if( iPages[i]->PosCached(aPos))  

             return i; 

         }

     return KErrNotFound;

     }

 /**

     Push given page aPageNo to the 1st position in the pages array. Used for LRU mechanism

     @param  aPageNo page number to be made LRU

 */

 void CMediaWTCache::MakePageLRU(TInt aPageNo)

     {

     ASSERT(aPageNo >=0);

     if(aPageNo <= 0)

         return; //-- nothing to do

     const TInt nPages = iPages.Count();

     ASSERT(aPageNo < nPages);

     if(aPageNo < nPages)

         {

         CWTCachePage* pPage=iPages[aPageNo];

         iPages.Remove(aPageNo);

         iPages.Insert(pPage,0); //-- insert the pointer to the 1st position in the array

         ASSERT(nPages == iPages.Count());

         }

     }

 /*

     Find a spare page or evict the last from LRU list

     @return page number

 */

 TUint32  CMediaWTCache::GrabPage() const

     {

     const TUint nPages = iPages.Count();

     if(!iAllPagesValid)

         {//-- try to find unused cache page

         for(TUint i=0; i<nPages; ++i)

             {

             if(! iPages[i]->iValid)

                 return i; //-- found unused page

             }

         }

     //-- no spare pages, evict the last one, it shall be last used

     iAllPagesValid = ETrue;

     return nPages-1;

     }

 /*

     Find a spare page or evict the last from LRU list, then read data to this page from media starting from aPos

     @param  aPos    media linear position from where the data will be read to the page

     @return cache page number

 */

 TUint32 CMediaWTCache::GrabReadPageL(TInt64 aPos)

     {

     //-- find a spare or page to evict

     TUint nPage = GrabPage();

     CWTCachePage& page = *iPages[nPage]; 

     //-- read data to this page

     page.iStartPos = CalcPageStartPos(aPos);

     __PRINT4(_L("#CMediaWTCache::GrabReadPageL() Reading page:%d, Pos=0x%x, PageStartPos=0x%x, page=0x%X"),nPage, (TUint32)aPos, (TUint32)page.iStartPos, iPages[nPage]);

     const TInt nErr = iDrive.ReadNonCritical(page.iStartPos, PageSize(), page.iData);

     if(nErr !=KErrNone)

         {//-- some serious problem occured during reading, invalidate cache.

         InvalidateCache();

         User::Leave(nErr);

         }

     page.iValid = ETrue;

     return nPage;

     }

 /**

     Try to find the page with cached data at "aPos" media position.

     If such page found, returns its number, otherwise takes least recently used page and reads data there.

     @param  aPos    media linear position to find in the cache

     @return cache page number

 */

 TUint32 CMediaWTCache::FindOrGrabReadPageL(TInt64 aPos)

     {

     //-- find out if aPos is in cache

     TInt nPage=FindPageByPos(aPos);

     if(nPage < 0)

         {//-- no page contains data to read

         nPage = GrabReadPageL(aPos); //-- find a spare page and read data into it

         }

     return nPage;

     }

 /**

     Finds out if the media position "aPosToSearch" is in the cache and returns cache page information in this case.

     @param  aPosToSearch    linear media position to lookup in the cache

     @param  aCachedPosStart if "aPosToSearch" is cached, here will be media position of this page start

     @return 0 if aPosToSearch isn't cached, otherwise  cache page size in bytes (see also aCachedPosStart).

 */

 TUint32 CMediaWTCache::PosCached(const TInt64& aPosToSearch, TInt64& aCachedPosStart)

     {

     TInt nPage = FindPageByPos(aPosToSearch);

     if(nPage <0 )

         return 0; //-- cache page containing aPos not found

     aCachedPosStart = iPages[nPage]->iStartPos;

     return PageSize();

     }

 /**

     Read data from the media through the directory cache.

     @param  aPos    linear media position to start reading with

     @param  aLength how many bytes to read

     @param  aDes    data will be placed there

 */

 void CMediaWTCache::ReadL(TInt64 aPos,TInt aLength,TDes8& aDes)

     {

 #ifdef _DEBUG

     if(iCacheDisabled)

         {//-- cache is disabled for debug purposes

         User::LeaveIfError(iDrive.ReadNonCritical(aPos, aLength, aDes));

         return;

         }

 #endif //_DEBUG

     const TUint32 PageSz = PageSize();//-- cache page size

     //-- find out if aPos is in cache. If not, find a spare page and read data there

     TInt nPage = FindOrGrabReadPageL(aPos);

     CWTCachePage* pPage = iPages[nPage];

     const TUint32 bytesToPageEnd = (TUint32)(pPage->iStartPos+PageSz - aPos); //-- number of bytes from aPos to the end of the page

 //    __PRINT5(_L("CMediaWTCache::ReadL: aPos=%lx, aLength=%x, page:%lx, pageSz:%x, bytesToPageEnd=%x"), aPos, aLength, pPage->iStartPos, PageSz, bytesToPageEnd);

     if((TUint32)aLength <= bytesToPageEnd) 

         {//-- the data section is in the cache page entirely, take data directly from the cache

         aDes.Copy(pPage->PtrInCachePage(aPos), aLength);

         }

     else

         {//-- Data to be read cross cache page boundary or probably we have more than 1 page to read

         TUint32 dataLen(aLength);   //-- current data length

         TInt64  currMediaPos(aPos); //-- current media position

         //-- 1. read data that are already in the current page

         aDes.Copy(pPage->PtrInCachePage(currMediaPos), bytesToPageEnd);

         dataLen -= bytesToPageEnd;

         currMediaPos += bytesToPageEnd;

         //-- 2. read whole pages of data

         while(dataLen >= PageSz)

             {

             nPage = FindOrGrabReadPageL(currMediaPos); //-- find out if currMediaPos is in cache. If not, find a spare page and read data there

             pPage = iPages[nPage];

             aDes.Append(pPage->PtrInCachePage(currMediaPos),PageSz);

             dataLen -= PageSz;

             currMediaPos += PageSz;

             MakePageLRU(nPage); //-- push the page to the top of the priority list

             }

         //-- 3. read the rest of the data

         if(dataLen >0)

             {

             nPage = FindOrGrabReadPageL(currMediaPos); //-- find out if currMediaPos is in cache. If not, find a spare page and read data there

             pPage = iPages[nPage];

             aDes.Append(pPage->PtrInCachePage(currMediaPos), dataLen);

             }

         } //else((TUint32)aLength <= bytesToPageEnd) 

     MakePageLRU(nPage); //-- push the page to the top of the priority list

     }

 /**

     Write data to the media through the directory cache.

     @param  aPos    linear media position to start writing with

     @param  aDes    data to write

 */

 void CMediaWTCache::WriteL(TInt64 aPos,const TDesC8& aDes)

     {

 #ifdef _DEBUG

     if(iCacheDisabled)

         {//-- cache is disabled for debug purposes

         User::LeaveIfError(iDrive.WriteCritical(aPos,aDes));

         return;

         }

 #endif //_DEBUG

           TUint32 dataLen = aDes.Size();

     const TUint8* pData   = aDes.Ptr();

     const TUint32 PageSz  = PageSize(); //-- cache page size

     //-- find out if aPos is in cache. If not, find a spare page and read data there

     TInt nPage = FindOrGrabReadPageL(aPos);

     CWTCachePage* pPage = iPages[nPage];

     const TUint32 bytesToPageEnd = (TUint32)(pPage->iStartPos+PageSize() - aPos); //-- number of bytes from aPos to the end of the page

 //    __PRINT5(_L("CMediaWTCache::WriteL: aPos=%lx, aLength=%x, page:%lx, pageSz:%x, bytesToPageEnd=%x"), aPos, dataLen, pPage->iStartPos, PageSz, bytesToPageEnd);

     if(dataLen <= bytesToPageEnd)

         {//-- data section completely fits to the cache page

         Mem::Copy(pPage->PtrInCachePage(aPos), pData, dataLen);   //-- update cache

         }

     else

         {//-- Data to be written cross cache page boundary or probably we have more than 1 page to write

         TInt64  currMediaPos(aPos); //-- current media position

         //-- 1. update the current page

         Mem::Copy(pPage->PtrInCachePage(currMediaPos), pData, bytesToPageEnd);

         pData += bytesToPageEnd;

         currMediaPos += bytesToPageEnd;

         dataLen -= bytesToPageEnd;

         //-- 2. write whole pages of data to the cache

         while(dataLen >= PageSz)

             {

             nPage = FindPageByPos(currMediaPos); //-- ?? shall we read data there ??

             if(nPage >=0)

                 {

                 pPage = iPages[nPage];

                 Mem::Copy(pPage->PtrInCachePage(currMediaPos), pData, PageSz);

                 MakePageLRU(nPage); //-- push the page to the top of the priority list

                 }

             else

                 nPage=0;

             pData += PageSz;

             currMediaPos += PageSz;

             dataLen -= PageSz;

             }

         //-- 3. write the rest of the data

         if(dataLen)

             {

             nPage = FindOrGrabReadPageL(currMediaPos); //-- find out if currMediaPos is in cache. If not, find a spare page and read data there

             pPage = iPages[nPage];

             Mem::Copy(pPage->PtrInCachePage(currMediaPos), pData, dataLen);

             }

         }// else(dataLen <= bytesToPageEnd)

     //-- write data to the media

     const TInt nErr = iDrive.WriteCritical(aPos,aDes); 

     if(nErr != KErrNone)

         {//-- some serious problem occured during writing, invalidate cache.

         InvalidateCache();

         User::Leave(nErr);

         }

     MakePageLRU(nPage); //-- push the page to the top of the priority list

     }