/****************************************Copyright (c)**************************************************
**                               廣州周立功單片機發展有限公司
**                                     研    究    所
**                                        ARM開發組
**
**                                 http://www.zlgmcu.com
**
**--------------文件信息--------------------------------------------------------------------------------
**文   件   名: disk.c
**創   建   人: 陳明計
**最后修改日期: 2004年3月11日
**描        述: FAT文件系統關于cache管理的部分
**              
**--------------歷史版本信息----------------------------------------------------------------------------
** 創建人: 陳明計
** 版  本: V1.0
** 日　期: 2003年9月3日
** 描　述: 原始版本
**
**--------------當前版本修訂------------------------------------------------------------------------------
** 修改人: 陳明計
** 日　期: 2004年4月10日
** 描　述: 增加注釋
**
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
#define IN_RWSEC
#include "config.h"
Disk_cache DiskCache[MAX_DISK_CACHES];      /* 磁盤cache */

/*********************************************************************************************************
** 函數名稱: CacheInit
** 功能描述: 初始化磁盤cache
**
** 輸　入: 無
**
** 輸　出: 無
**         
** 全局變量: DiskCache
** 調用模塊: 無
**
** 作　者: 陳明計
** 日　期: 2003年9月3日
**-------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 日　期: 2004年4月10日
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
        void CacheInit(void)
{
    uint16 i;
    
    for (i = 0; i < MAX_DISK_CACHES; i++)
    {
        DiskCache[i].Drive = EMPTY_DRIVE;   /* cache空閑 */
        DiskCache[i].Flag = 0;              /* 扇區無需回寫 */
        DiskCache[i].RW_ID = 0;             /* 訪問紀錄 */
        DiskCache[i].RW_ID--;               /* 訪問紀錄 */
        DiskCache[i].SecIndex = 0;          /* 緩沖的扇區號  */
    }
}


/*********************************************************************************************************
** 函數名稱: CloseSec
** 功能描述: 解鎖指定cache（允許切換出內存）
**
** 輸　入: Drive：邏輯驅動器號
**        Index：緩沖的扇區號
** 輸　出: 無
**         
** 全局變量: DiskCache
** 調用模塊: 無
**
** 作　者: 陳明計
** 日　期: 2003年9月3日
**-------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 日　期: 2004年4月10日
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
        void CloseSec(uint8 Drive, uint32 Index)
{
    Drive = Drive;
    Index = Index;
}

/*********************************************************************************************************
** 函數名稱: CacheWriteBack2
** 功能描述: 把指定扇區寫回邏輯盤
**
** 輸　入: Index：cache索引
**
** 輸　出: 無
**         
** 全局變量: DiskCache
** 調用模塊: GetDiskInfo
**
** 作　者: 陳明計
** 日　期: 2003年9月3日
**-------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 日　期: 2004年4月10日
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
        void CacheWriteBack2(uint16 Index)
{
    Disk_RW_Parameter Pa;
    Disk_Info * Disk;

    Disk = GetDiskInfo(DiskCache[Index].Drive);     // 獲取邏輯盤信息
    if (Disk != NULL)
    if (Disk->DiakCommand != NULL)
    {
        DiskCache[Index].Flag &= ~CACHE_WRITED;     // cache 不再需要回寫
        /* 傳遞參數 */
        Pa.Drive = DiskCache[Index].Drive;               
        Pa.SectorIndex = DiskCache[Index].SecIndex;
        Pa.RsvdForLow = Disk->RsvdForLow;
        Pa.Buf = DiskCache[Index].buf;
        
        Disk->DiakCommand(DISK_WRITE_SECTOR, &Pa);  /* 調用底層驅動寫扇區 */ 
    }
}

/*********************************************************************************************************
** 函數名稱: CacheWriteBack
** 功能描述: 把指定cache寫回邏輯盤
**
** 輸　入: Drive：邏輯驅動器號
**        Index：緩沖的扇區號
** 輸　出: 無
**         
** 全局變量: DiskCache
** 調用模塊: CacheWriteBack2
**
** 作　者: 陳明計
** 日　期: 2003年9月3日
**-------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 日　期: 2004年4月10日
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
       void CacheWriteBack(uint8 Drive, uint32 Index)
{
    uint16 i;
    
    for (i = 0; i < MAX_DISK_CACHES; i++)
    {
        if (DiskCache[i].Drive == Drive)
        if (DiskCache[i].SecIndex == Index)
        {
            if ((DiskCache[i].Flag & CACHE_WRITED) != 0)
            {
                CacheWriteBack2(i);
            }
            break;
        }
    }
}

/*********************************************************************************************************
** 函數名稱: AllCacheWriteBack
** 功能描述: 把所有已改變的扇區寫回邏輯盤
**
** 輸　入: 無
**
** 輸　出: 無
**         
** 全局變量: DiskCache
** 調用模塊: CacheWriteBack2
**
** 作　者: 陳明計
** 日　期: 2003年9月3日
**-------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 日　期: 2004年4月10日
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
       void AllCacheWriteBack(void)
{
    uint16 i;

    for (i = 0; i < MAX_DISK_CACHES; i++)
    {
        if ((DiskCache[i].Flag & CACHE_WRITED) != 0)
        {
            CacheWriteBack2(i);
        }
    }
}

/*********************************************************************************************************
** 函數名稱: GetCache
** 功能描述: 獲取一個cache
**
** 輸　入: 無
**
** 輸　出: cache索引
**         
** 全局變量: DiskCache
** 調用模塊: 無
**
** 作　者: 陳明計
** 日　期: 2003年9月3日
**-------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 日　期: 2004年4月10日
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
        uint16 GetCache(void)
{
    uint16 Max;
    uint16 i,j;

    Max = 0;
    j = 0;
    j--;
    for (i = 0; i < MAX_DISK_CACHES; i++)
    {
        if (Max <= DiskCache[i].RW_ID)
        {
            Max = DiskCache[i].RW_ID;
            j = i;
        }
        if (Max == (uint16)(-1))
        {
            break;
        }
    }
    if (j < MAX_DISK_CACHES)	/*j為Cache中DiskCache[i].RW_ID次數最多的*/
    {
        if (DiskCache[j].Drive != EMPTY_DRIVE)			/*如果該Cache已被使用*/
        if ((DiskCache[j].Flag & CACHE_WRITED) != 0)	/*同時,進行過寫操作*/
        {
            CacheWriteBack2(j);							/*則應寫回到設備扇區*/
        }
    }
    return j;
}

/*********************************************************************************************************
** 函數名稱: OpenSec
** 功能描述: 為邏輯盤上的一個扇區打開一個cache并鎖定
**
** 輸　入: Drive：磁盤號
**        Index：扇區號
** 輸　出: 指向指定扇區數據的指針
**         
** 全局變量: DiskCache
** 調用模塊: 無
**
** 作　者: 陳明計
** 日　期: 2003年9月3日
**-------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 日　期: 2004年4月10日
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
        uint8 *OpenSec(uint8 Drive, uint32 Index)
{
    uint16 i;
    uint8 *Rt;
    Disk_Info *Disk;
   
    /* 增加訪問間隔 */
    for (i = 0; i < MAX_DISK_CACHES; i++)
    {
        if (DiskCache[i].Drive != EMPTY_DRIVE)
        {
            if (DiskCache[i].RW_ID < (uint16)(-1))
            {
                DiskCache[i].RW_ID++;
            }
        }
    }

    /* 看扇區是否已經緩存 */
    Rt = NULL;
    for (i = 0; i < MAX_DISK_CACHES; i++)
    {
        if (DiskCache[i].Drive == Drive )
        if (DiskCache[i].SecIndex == Index)
        {
            Rt = DiskCache[i].buf;
            DiskCache[i].RW_ID = 0;
            break;
        }
    }
    
    /* Rt == NULL則未緩存 */
    if (Rt == NULL)
    {
        Disk = GetDiskInfo(Drive);
        if (Disk != NULL)
        if (Disk->SecPerDisk > Index)
        {
            i = GetCache();                     /* 獲取cache */
            if (i < MAX_DISK_CACHES)
            {
                /* 初始化cache  */
                DiskCache[i].Drive = Drive;     
                DiskCache[i].RW_ID = 0;
                DiskCache[i].Flag = 0;
                DiskCache[i].SecIndex = Index;
                Rt = DiskCache[i].buf;
                for (i = 0; i < Disk->BytsPerSec; i++)
                {
                    Rt[i] = 0;
                }
            }
        }
    }
    return Rt;
}

/*********************************************************************************************************
** 函數名稱: ReadSec
** 功能描述: 從邏輯盤讀扇區
**
** 輸　入: Disk：邏輯盤信息
**        Index：扇區號
** 輸　出: TRUE:成功
**         FALSE:失敗
** 全局變量: DiskCache
** 調用模塊: GetDiskInfo
**
** 作　者: 陳明計
** 日　期: 2003年9月5日
**-------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 日　期: 2004年4月10日
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
        uint8 ReadSec(uint8 Drive, uint32 Index)
{
    uint16 i;
    Disk_RW_Parameter Pa;
    Disk_Info *Disk;
    uint8 Rt;
    
    for (i = 0; i < MAX_DISK_CACHES; i++)
    {
        if (DiskCache[i].Drive == Drive)
        if (DiskCache[i].SecIndex == Index)
        {
            if ((DiskCache[i].Flag & CACHE_READED) != 0)
            {
                return RETURN_OK;
            }
            break;
        }
    }
    Rt = SECTOR_NOT_IN_CACHE;
    if (i < MAX_DISK_CACHES)
    {
        Disk = GetDiskInfo(Drive);    

        DiskCache[i].Flag |= CACHE_READED;

        /* 從磁盤讀取扇區數據 */
        Pa.Drive = Drive;
        Pa.SectorIndex = Index;
        Pa.RsvdForLow = Disk->RsvdForLow;
        Pa.Buf = DiskCache[i].buf;
        Rt = NOT_FIND_DISK;
        if (Disk->DiakCommand != NULL)
        {
            Rt = SECTOR_READ_ERR;
            if (Disk->DiakCommand(DISK_READ_SECTOR, &Pa) == DISK_READ_OK)
            {
                return RETURN_OK;
            }
        }
    }
    return Rt;
}

/*********************************************************************************************************
** 函數名稱: WriteSec
** 功能描述: 說明指定邏輯盤的指定一個扇區被改寫
**
** 輸　入: Disk：邏輯盤信息
**        Index：扇區號
** 輸　出: 無
**         
** 全局變量: DiskCache
** 調用模塊: 無
**
** 作　者: 陳明計
** 日　期: 2003年9月3日
**-------------------------------------------------------------------------------------------------------
** 修改人: 陳明計
** 日　期: 2004年4月10日
**------------------------------------------------------------------------------------------------------
********************************************************************************************************/
        void WriteSec(uint8 Drive, uint32 Index)
{
    uint16 i;
    
    for (i = 0; i < MAX_DISK_CACHES; i++)
    {
        if (DiskCache[i].Drive == Drive)
        if (DiskCache[i].SecIndex == Index)
        {
            DiskCache[i].Flag |= (CACHE_WRITED | CACHE_READED);
            break;
        }
    }
}

/*********************************************************************************************************
**                            End Of File
********************************************************************************************************/