FATFS 初学之 f_getfree

/*-----------------------------------------------------------------------*/
/* Get Number of Free Clusters                                           */
/*-----------------------------------------------------------------------*/

FRESULT f_getfree (
    const TCHAR *path,    /* Pointer to the logical drive number (root dir) */
    DWORD *nclst,        /* Pointer to the variable to return number of free clusters */
    FATFS **fatfs        /* Pointer to pointer to corresponding file system object to return */
)
{
    FRESULT res;
    DWORD n, clst, sect, stat;
    UINT i;
    BYTE fat, *p;


    /* Get drive number */
    res = chk_mounted(&path, fatfs, 0);
    if (res == FR_OK) {
        /* If free_clust is valid, return it without full cluster scan */
        if ((*fatfs)->free_clust <= (*fatfs)->n_fatent - 2) {
            *nclst = (*fatfs)->free_clust;
        } else {
            /* Get number of free clusters */
            fat = (*fatfs)->fs_type;
            n = 0;
            if (fat == FS_FAT12) {
                clst = 2;
                do {
                    stat = get_fat(*fatfs, clst);
                    if (stat == 0xFFFFFFFF) { res = FR_DISK_ERR; break; }
                    if (stat == 1) { res = FR_INT_ERR; break; }
                    if (stat == 0) n++;
                } while (++clst < (*fatfs)->n_fatent);
            } else {
                clst = (*fatfs)->n_fatent;
                sect = (*fatfs)->fatbase;
                i = 0; p = 0;
                do {
                    if (!i) {
                        res = move_window(*fatfs, sect++);
                        if (res != FR_OK) break;
                        p = (*fatfs)->win;
                        i = SS(*fatfs);
                    }
                    if (fat == FS_FAT16) {
                        if (LD_WORD(p) == 0) n++;
                        p += 2; i -= 2;
                    } else {
                        if ((LD_DWORD(p) & 0x0FFFFFFF) == 0) n++;
                        p += 4; i -= 4;
                    }
                } while (--clst);
            }
            (*fatfs)->free_clust = n;
            if (fat == FS_FAT32) (*fatfs)->fsi_flag = 1;
            *nclst = n;
        }
    }
    LEAVE_FF(*fatfs, res);
}

函数功能：获取空闲簇的数目

描述：

f_getfree函数当 _FS_READONLY == 0并且 _FS_MINIMIZE == 0时有效。
f_getfree函数获取驱动器上空闲簇的数目。文件系统对象中的成员csize是每簇中的扇区数，因此，以扇区为单位的空闲空间可以被计算出来。当FAT32卷上的FSInfo结构不同步时，该函数返回一个错误的空闲簇计数。

例：

unsigned long total,free;

if(exf_getfree("0",&total,&free))
{
    // 错误代码...
}

//得到磁盘剩余容量
//drv:磁盘编号("0:"/"1:")
//total:总容量     （单位KB）
//free:剩余容量     （单位KB）
//返回值:0,正常.其他,错误代码
u8 exf_getfree(u8 *drv,u32 *total,u32 *free)
{
    FATFS *fs1;
    u8 res;
    DWORD fre_clust=0, fre_sect=0, tot_sect=0;
    //得到磁盘信息及空闲簇数量
    res = f_getfree((const TCHAR*)drv, &fre_clust, &fs1);
    if(res==0)
    {
        tot_sect=(fs1->n_fatent-2)*fs1->csize;    //得到总扇区数
        fre_sect=fre_clust*fs1->csize;            //得到空闲扇区数
#if _MAX_SS!=512                                  //扇区大小不是512字节,则转换为512字节
        tot_sect*=fs1->ssize/512;
        fre_sect*=fs1->ssize/512;
#endif      
        *total=tot_sect>>1;    //单位为KB
        *free=fre_sect>>1;    //单位为KB 
     }
    return res;
}