?? fat.h
字號:
/*
2007-4-11 2008-1-30
Web: http://www.wch.cn
FAT文件系統接口 V1.4
支持: FAT12/FAT16/FAT32 支持大扇區U盤
*/
#ifndef __FAT_H__
#define __FAT_H__
#ifdef __cplusplus
extern "C" {
#endif
#define F_FAT_VER 0X14 /*程序版本定義*/
/*包含文件*/
#include <LIMITS.H> /*提供類型的大小定義*/
#include "TYPE.H" /*完成對類型的定義*/
#include "CH375.H" /*提供磁盤操作函數*/
/*程序配置*/
/******************************************************************************/
/*命令緩沖區長度(與字節緩沖區共用)從9到256*/
#define FAT_CMD_BUF_LEN 30
/*定義支持扇區的最大字節數 為512的倍數*/
#define FAT_SECTOR_SIZE_DEF 512
/*文件緩沖區從( 1到255 ) * FAT_SECTOR_SIZE*/
#define FAT_FILE_BUF_LEN (16*FAT_SECTOR_SIZE_DEF)
/*構建有用簇鏈表的深度2到254*/
#define FAT_CHAIN_LENGTH 2
/*以上配置根據需要進行改寫*/
/*大小端配置及是否使用DSP*/
#define MCU_USE_BIG_ENDIAN 0 /*1(CHAR_BIT=8)大端的MCU,0為小端*/
#define MCU_USE_DSP 0 /*1(CHAR_BIT=16),否則不是*/
/*以下 1為加入對此類型的文件系統支持，0 取消支持，減少占用空間(確定所用磁盤的文件系統
類型時使用)*/
#define F_USE_FAT32 1 /*是否支持FAT32文件系統*/
#define F_USE_FAT16 1 /*是否支持FAT16文件系統*/
#define F_USE_FAT12 1 /*是否支持FAT12文件系統*/
/*其它配置*/
#define F_EN_DISK_BUF 1 /*1開啟磁盤緩沖,0為關閉*/
#define F_EN_ENUM_BACK 0 /*1為允許枚舉文件時 調用回調函數,0為禁止*/
#define F_EN_WRITE 1 /*1為允許寫磁盤,0為禁止寫*/
#define F_EN_BYTE 1 /*1為允許字節方式操作 0為禁止*/
#define F_RE_TIME 0X03 /*讀寫扇區重試次數*/
#define F_EN_LONG_NAME 0 /*1為在fat_fopen時收集長文件名,0為不收集*/
#if F_EN_LONG_NAME == 1
#define F_LNAME_BUF_LEN (10*26) /*存放顯示長文件名緩沖區長度從1*26到20*26*/
#endif
#define STATIC static
/******************************************************************************/
/*基礎宏定義*/
/******************************************************************************/
#define F_CREATE_NEW 0X00 /*創建一個文件,存在返回錯誤*/
#define F_CREATE_ALWAYS 0X01 /*文件存在,刪除后再建*/
#define F_TYPE_FAT12 0X01 /*文件系統為FAT12*/
#define F_TYPE_FAT16 0X02 /*文件系統為FAT16*/
#define F_TYPE_FAT32 0X03 /*文件系統為FAT32*/
#define DEF_ATTR 0XFF /*不修改屬性*/
#define DEF_TIME 0XFFFF /*不修改時間*/
#define DEF_DATE 0XFFFF /*不修改日期*/
#define DEF_LEN 0XFFFFFFFF /*不修改文件長度*/
#define END_FILE 0XFFFFFFFF /*文件末尾*/
#define SEC_SIZE fat_sector_size /*當前扇區大小*/
/*文件屬性定義*/
#define ATTR_FILE ((UINT8)0X00) /*通常屬性*/
#define ATTR_READ_ONLY ((UINT8)0X01) /*只讀屬性*/
#define ATTR_HIDDEN ((UINT8)0X02) /*隱藏屬性*/
#define ATTR_SYSTEM ((UINT8)0X04) /*系統屬性*/
#define ATTR_VOLUME_ID ((UINT8)0X08) /*卷標屬性*/
#define ATTR_DIRECTORY ((UINT8)0X10) /*目錄屬性*/
#define ATTR_ARCHIVE ((UINT8)0X20) /*存檔屬性*/
#define ATTR_LFN_ENTRY ((UINT8)0X0F) /*長文件名屬性*/
#define ATTR_ROOT_DIR ((UINT8)0X90) /*根目錄屬性*/
#define FILE_EMPTY ((UINT8)0X00) /*文件空*/
#define FILE_DELETED ((UINT8)0XE5) /*文件刪除標志*/
/*函數宏*/
#define MDATE( y, m, d ) (((y-1980)<<9) + (m<<5) + d ) /*生成文件時間*/
#define MTIME( h, m, s ) ((h<<11) + (m<<5) + (s>>1) ) /*生產文件日期*/
/*函數返回定義*/
#define F_OK 0X00 /*正確返回*/
#define F_ERROR 0X01 /*錯誤返回*/
#define PARAMETER_CMD_ERR 0X02 /*參數錯誤*/
#define READ_DATA_ERR 0X03 /*讀數據出錯*/
#define WRITE_DATA_ERR 0X04 /*寫數據出錯*/
#define NO_FREE_ROOM_ERR 0X05 /*磁盤空間不夠*/
#define BUFFER_OVERFLOW_ERR 0X06 /*存放簇鏈的數組緩沖區溢出錯誤*/
#define NO_FREE_DIR_ERR 0X07 /*在根目錄下沒有空間來創建文件(FAT12/16)*/
#define CMDBUF_OVERFLOW_ERR 0X08 /*命令緩沖區溢出錯誤*/
#define NO_DISK_BUF_ERR 0X09 /*沒有開啟磁盤緩沖區錯誤*/
#define FILE_EXIST_ERR 0X0A /*文件或文件夾存在錯誤*/
#define NOT_FIND_FILE_ERR 0X0B /*沒有發現文件*/
#define NOT_FIND_DIR_ERR 0X0C /*沒有發現目錄*/
#define FILE_DIR_FAT_ERR 0X0E /*文件或目錄的FAT表破壞*/
#define FILE_NOT_OC_ERR 0X0F /*文件沒有打開或以關閉錯誤*/
#define NO_DEF_FAT_ERR 0X10 /*此文件系統支持,但沒有使用此文件系統錯誤*/
#define NO_SUPPORT_FS_ERR 0X11 /*不支持此類型的文件系統*/
#define SET_ENDIAN_ERR 0X13 /*大小端設置錯誤*/
#define PART_ACTIVE_ERR 0x14 /*MBR分區激活標志錯誤*/
#define SECTOR_SIZE_ERR 0x15 /*定義磁盤緩沖區太小*/
#define END_OF_FILE_ERR 0X16 /*到達文件末尾*/
#define FAT12_SIZE_ERR 0X17 /*FAT12只支持512字節扇區的盤*/
#define NO_LONG_NAME_ERR 0X20 /*沒有發現長文件名*/
#define BAD_LONG_NAME_ERR 0X21 /*壞的長文件名*/
#define LNAME_BUFF_OVER_ERR 0X22 /*長件名緩沖區溢出錯誤*/
#define ENUM_FILE_OK 0XFF /*成功枚舉到一個文件*/
/******************************************************************************/
/*程序使用全局變量*/
/******************************************************************************/
/*定義結構體類型*/
typedef union
{
struct
{
UINT8 buffer[ FAT_CMD_BUF_LEN ];
} all;
struct
{
UINT8 buffer[ FAT_CMD_BUF_LEN ]; /*打開文件*/
} open;
struct
{
UINT8 buffer[ FAT_CMD_BUF_LEN ]; /*創建文件*/
} create;
struct
{
UINT8 buffer[ FAT_CMD_BUF_LEN ]; /*刪除文件*/
} del;
struct
{
UINT8 sector; /*每次讀出扇區數,返回實際讀取扇區數*/
} read;
struct
{
UINT16 sector; /*寫入總扇區數*/
} write;
struct
{
UINT8 sector; /*每次讀出扇區數,返回實際讀取扇區數*/
UINT8 reserv[3];
PUINT8 buffer; /*讀取數據存放緩沖區*/
} readx;
struct
{
UINT16 sector; /*寫入總扇區數,返回剩余扇區數*/
UINT8 reserv[2];
PUINT8 buffer; /*寫入數據存放緩沖區*/
} writex;
struct
{
UINT32 sector; /*扇區偏移*/
} locate;
struct
{
UINT32 size; /*文件長度 0XFFFFFFFF則不修改*/
UINT16 date; /*文件訪問日期 0XFFFF則不修改*/
UINT16 time; /*文件訪問時間 0XFFFF則不修改*/
UINT8 attr; /*文件屬性 0XFF則不修改*/
} modify; /*修改文件目錄數據*/
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -