📄 ff.c
字号:
if (res) return res;
if (fp->flag & FA__ERROR) return FR_RW_ERROR; /* Check error flag */
if (!(fp->flag & FA_READ)) return FR_DENIED; /* Check access mode */
ln = fp->fsize - fp->fptr;
if (btr > ln) btr = (WORD)ln; /* Truncate read count by number of bytes left */
for ( ; btr; /* Repeat until all data transferred */
rbuff += rcnt, fp->fptr += rcnt, *br += rcnt, btr -= rcnt) {
if ((fp->fptr % 512) == 0) { /* On the sector boundary */
if (--(fp->sect_clust)) { /* Decrement left sector counter */
sect = fp->curr_sect + 1; /* Get current sector */
} else { /* On the cluster boundary, get next cluster */
clust = (fp->fptr == 0) ?
fp->org_clust : get_cluster(fs, fp->curr_clust);
if (clust < 2 || clust >= fs->max_clust)
goto fr_error;
fp->curr_clust = clust; /* Current cluster */
sect = clust2sect(fs, clust); /* Get current sector */
fp->sect_clust = fs->sects_clust; /* Re-initialize the left sector counter */
}
#if _FS_READONLY == 0
if (fp->flag & FA__DIRTY) { /* Flush file I/O buffer if needed */
if (disk_write(fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK)
goto fr_error;
fp->flag &= ~FA__DIRTY;
}
#endif
fp->curr_sect = sect; /* Update current sector */
cc = btr / 512; /* When left bytes >= 512, */
if (cc) { /* Read maximum contiguous sectors directly */
if (cc > fp->sect_clust) cc = fp->sect_clust;
if (disk_read(fs->drive, rbuff, sect, cc) != RES_OK)
goto fr_error;
fp->sect_clust -= cc - 1;
fp->curr_sect += cc - 1;
rcnt = cc * 512; continue;
}
if (disk_read(fs->drive, fp->buffer, sect, 1) != RES_OK) /* Load the sector into file I/O buffer */
goto fr_error;
}
rcnt = 512 - ((WORD)fp->fptr % 512); /* Copy fractional bytes from file I/O buffer */
if (rcnt > btr) rcnt = btr;
memcpy(rbuff, &fp->buffer[fp->fptr % 512], rcnt);
}
return FR_OK;
fr_error: /* Abort this file due to an unrecoverable error */
fp->flag |= FA__ERROR;
return FR_RW_ERROR;
}
/*-----------------------------------------------------------------------*/
/* Write File */
/*-----------------------------------------------------------------------*/
#if _FS_READONLY == 0
FRESULT f_write (
FIL *fp, /* Pointer to the file object */
const void *buff, /* Pointer to the data to be written */
WORD btw, /* Number of bytes to write */
WORD *bw /* Pointer to number of bytes written */
)
{
DWORD clust, sect;
WORD wcnt;
BYTE cc;
FRESULT res;
const BYTE *wbuff = buff;
FATFS *fs = fp->fs;
*bw = 0;
res = validate(fs, fp->id);
if (res) return res;
if (fp->flag & FA__ERROR) return FR_RW_ERROR; /* Check error flag */
if (!(fp->flag & FA_WRITE)) return FR_DENIED; /* Check access mode */
if (fp->fsize + btw < fp->fsize) btw = 0; /* File size cannot reach 4GB */
for ( ; btw; /* Repeat until all data transferred */
wbuff += wcnt, fp->fptr += wcnt, *bw += wcnt, btw -= wcnt) {
if ((fp->fptr % 512) == 0) { /* On the sector boundary */
if (--(fp->sect_clust)) { /* Decrement left sector counter */
sect = fp->curr_sect + 1; /* Get current sector */
} else { /* On the cluster boundary, get next cluster */
if (fp->fptr == 0) { /* Is top of the file */
clust = fp->org_clust;
if (clust == 0) /* No cluster is created yet */
fp->org_clust = clust = create_chain(fs, 0); /* Create a new cluster chain */
} else { /* Middle or end of file */
clust = create_chain(fs, fp->curr_clust); /* Trace or streach cluster chain */
}
if (clust < 2 || clust >= fs->max_clust) break;
fp->curr_clust = clust; /* Current cluster */
sect = clust2sect(fs, clust); /* Get current sector */
fp->sect_clust = fs->sects_clust; /* Re-initialize the left sector counter */
}
if (fp->flag & FA__DIRTY) { /* Flush file I/O buffer if needed */
if (disk_write(fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK)
goto fw_error;
fp->flag &= ~FA__DIRTY;
}
fp->curr_sect = sect; /* Update current sector */
cc = btw / 512; /* When left bytes >= 512, */
if (cc) { /* Write maximum contiguous sectors directly */
if (cc > fp->sect_clust) cc = fp->sect_clust;
if (disk_write(fs->drive, wbuff, sect, cc) != RES_OK)
goto fw_error;
fp->sect_clust -= cc - 1;
fp->curr_sect += cc - 1;
wcnt = cc * 512; continue;
}
if (fp->fptr < fp->fsize && /* Fill sector buffer with file data if needed */
disk_read(fs->drive, fp->buffer, sect, 1) != RES_OK)
goto fw_error;
}
wcnt = 512 - ((WORD)fp->fptr % 512); /* Copy fractional bytes to file I/O buffer */
if (wcnt > btw) wcnt = btw;
memcpy(&fp->buffer[fp->fptr % 512], wbuff, wcnt);
fp->flag |= FA__DIRTY;
}
if (fp->fptr > fp->fsize) fp->fsize = fp->fptr; /* Update file size if needed */
fp->flag |= FA__WRITTEN; /* Set file changed flag */
return FR_OK;
fw_error: /* Abort this file due to an unrecoverable error */
fp->flag |= FA__ERROR;
return FR_RW_ERROR;
}
#endif /* _FS_READONLY */
/*-----------------------------------------------------------------------*/
/* Seek File Pointer */
/*-----------------------------------------------------------------------*/
FRESULT f_lseek (
FIL *fp, /* Pointer to the file object */
DWORD ofs /* File pointer from top of file */
)
{
DWORD clust;
BYTE sc;
FRESULT res;
FATFS *fs = fp->fs;
res = validate(fs, fp->id);
if (res) return res;
if (fp->flag & FA__ERROR) return FR_RW_ERROR;
#if _FS_READONLY == 0
if (fp->flag & FA__DIRTY) { /* Write-back dirty buffer if needed */
if (disk_write(fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK) goto fk_error;
fp->flag &= ~FA__DIRTY;
}
#endif
if (ofs > fp->fsize) ofs = fp->fsize; /* Clip offset by file size */
fp->fptr = ofs; fp->sect_clust = 1; /* Re-initialize file pointer */
/* Seek file pinter if needed */
if (ofs) {
ofs = (ofs - 1) / 512; /* Calcurate current sector */
sc = fs->sects_clust; /* Number of sectors in a cluster */
fp->sect_clust = sc - ((BYTE)ofs % sc); /* Calcurate sector counter */
ofs /= sc; /* Number of clusters to skip */
clust = fp->org_clust; /* Seek to current cluster */
while (ofs--)
clust = get_cluster(fs, clust);
if (clust < 2 || clust >= fs->max_clust)
goto fk_error;
fp->curr_clust = clust;
fp->curr_sect = clust2sect(fs, clust) + sc - fp->sect_clust; /* Current sector */
if (fp->fptr % 512) { /* Load currnet sector if needed */
if (disk_read(fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK)
goto fk_error;
}
}
return FR_OK;
fk_error: /* Abort this file due to an unrecoverable error */
fp->flag |= FA__ERROR;
return FR_RW_ERROR;
}
/*-----------------------------------------------------------------------*/
/* Synchronize between File and Disk */
/*-----------------------------------------------------------------------*/
#if _FS_READONLY == 0
FRESULT f_sync (
FIL *fp /* Pointer to the file object */
)
{
BYTE *ptr;
FRESULT res;
FATFS *fs = fp->fs;
res = validate(fs, fp->id);
if (res) return res;
/* Has the file been written? */
if (fp->flag & FA__WRITTEN) {
/* Write back data buffer if needed */
if (fp->flag & FA__DIRTY) {
if (disk_write(fs->drive, fp->buffer, fp->curr_sect, 1) != RES_OK)
return FR_RW_ERROR;
fp->flag &= ~FA__DIRTY;
}
/* Update the directory entry */
if (!move_window(fs, fp->dir_sect))
return FR_RW_ERROR;
ptr = fp->dir_ptr;
*(ptr+11) |= AM_ARC; /* Set archive bit */
ST_DWORD(ptr+28, fp->fsize); /* Update file size */
ST_WORD(ptr+26, fp->org_clust); /* Update start cluster */
ST_WORD(ptr+20, fp->org_clust >> 16);
ST_DWORD(ptr+22, get_fattime()); /* Updated time */
fs->winflag = 1;
fp->flag &= ~FA__WRITTEN;
}
if (!move_window(fs, 0)) return FR_RW_ERROR;
return FR_OK;
}
#endif /* _FS_READONLY */
/*-----------------------------------------------------------------------*/
/* Close File */
/*-----------------------------------------------------------------------*/
FRESULT f_close (
FIL *fp /* Pointer to the file object to be closed */
)
{
FRESULT res;
#if _FS_READONLY == 0
res = f_sync(fp);
#else
res = validate(fp->fs, fp->id);
#endif
if (res == FR_OK)
fp->fs = NULL;
return res;
}
#if _FS_MINIMIZE <= 1
/*-----------------------------------------------------------------------*/
/* Create a directroy object */
/*-----------------------------------------------------------------------*/
FRESULT f_opendir (
DIR *dirobj, /* Pointer to directory object to create */
const char *path /* Pointer to the directory path */
)
{
BYTE *dir;
char fn[8+3+1];
FRESULT res;
FATFS *fs;
if ((res = auto_mount(&path, &fs, 0)) != FR_OK)
return res;
dirobj->fs = fs;
res = trace_path(dirobj, fn, path, &dir); /* Trace the directory path */
if (res == FR_OK) { /* Trace completed */
if (dir != NULL) { /* It is not a root dir */
if (*(dir+11) & AM_DIR) { /* The entry is a directory */
dirobj->clust = ((DWORD)LD_WORD(dir+20) << 16) | LD_WORD(dir+26);
dirobj->sect = clust2sect(fs, dirobj->clust);
dirobj->index = 0;
} else { /* The entry is not a directory */
res = FR_NO_FILE;
}
}
dirobj->id = ~fs->id;
}
return res;
}
/*-----------------------------------------------------------------------*/
/* Read Directory Entry in Sequense */
/*-----------------------------------------------------------------------*/
FRESULT f_readdir (
DIR *dirobj, /* Pointer to the directory object */
FILINFO *finfo /* Pointer to file information to return */
)
{
BYTE *dir, c, res;
FATFS *fs = dirobj->fs;
res = validate(fs, dirobj->id);
if (res) return res;
finfo->fname[0] = 0;
while (dirobj->sect) {
if (!move_window(fs, dirobj->sect))
return FR_RW_ERROR;
dir = &fs->win[(dirobj->index & 15) * 32]; /* pointer to the directory entry */
c = *dir;
if (c == 0) break; /* Has it reached to end of dir? */
if (c != 0xE5 && c != '.' && !(*(dir+11) & AM_VOL)) /* Is it a valid entry? */
get_fileinfo(finfo, dir);
if (!next_dir_entry(dirobj)) dirobj->sect = 0; /* Next entry */
if (finfo->fname[0]) break; /* Found valid entry */
}
return FR_OK;
}
#if _FS_MINIMIZE == 0
/*-----------------------------------------------------------------------*/
/* Get File Status */
/*-----------------------------------------------------------------------*/
FRESULT f_stat (
const char *path, /* Pointer to the file path */
FILINFO *finfo /* Pointer to file information to return */
)
{
BYTE *dir;
char fn[8+3+1];
FRESULT res;
DIR dirobj;
FATFS *fs;
if ((res = auto_mount(&path, &fs, 0)) != FR_OK)
return res;
dirobj.fs = fs;
res = trace_path(&dirobj, fn, path, &dir); /* Trace the file path */
if (res == FR_OK) /* Trace completed */
get_fileinfo(finfo, dir);
return res;
}
#if _FS_READONLY == 0
/*-----------------------------------------------------------------------*/
/* Get Number of Free Clusters */
/*-----------------------------------------------------------------------*/
FRESULT f_getfree (
const char *drv, /* Logical drive number */
DWORD *nclust, /* Pointer to the double word to return number of free clusters */
FATFS **fatfs /* Pointer to pointer to the file system object to return */
)
{
DWORD n, clust, sect;
BYTE fat, f, *p;
FRESULT res;
FATFS *fs;
/* Get drive number */
if ((res = auto_mount(&drv, &fs, 0)) != FR_OK)
return res;
*fatfs = fs;
/* Count number of free clusters */
fat = fs->fs_type;
n = 0;
if (fat == FS_FAT12) {
clust = 2;
do {
if ((WORD)get_cluster(fs, clust) == 0) n++;
} while (++clust < fs->max_clust);
} else {
clust = fs->max_clust;
sect = fs->fatbase;
f = 0; p = 0;
do {
if (!f) {
if (!move_window(fs, sect++)) return FR_RW_ERROR;
p = fs->win;
}
if (fat == FS_FAT16) {
if (LD_WORD(p) == 0) n++;
p += 2; f += 1;
} else {
if (LD_DWORD(p) == 0) n++;
p += 4; f += 2;
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -