// UTF-8 w/o BOM

#ifndef FILESYSTEM_H
#define FILESYSTEM_H

#include "typedefs.h"


#define FS_MAX_URI_NAME_LENGTH		264		// file://b/a.txt // please, use FILEURI_MAX_LEN+1
#define FS_MAX_PATH_NAME_LENGTH		258		// /b/a.txt //аналогично
#define FS_MAX_FILE_NAME_LENGTH		255		// a.txt // аналогично

#define FILENAME_MAX_LEN		FS_MAX_FILE_NAME_LENGTH
#define FILEURI_MAX_LEN			FS_MAX_URI_NAME_LENGTH
#define FILEPATH_MAX_LEN		FS_MAX_PATH_NAME_LENGTH

#define FS_HANDLE_INVALID		0xFFFF
#define FILE_HANDLE_INVALID		FS_HANDLE_INVALID
#define FILE_INVALID			FS_HANDLE_INVALID

typedef UINT16					FS_HANDLE_T;
typedef FS_HANDLE_T				FILE_HANDLE_T;
#ifndef WIN32
	typedef FS_HANDLE_T				FILE;
#endif
typedef UINT64					FS_MID_T; // физический идентификатор файла

typedef UINT32					FS_COUNT_T;       /* Count for writing, reading, inserting, and removing file data */
typedef UINT8					FS_PERCENT_T;     /* Percent complete of an operation (0-100) */
typedef UINT16					FS_SEARCH_NUM_T;  /* Number of files matching search criteria */
typedef INT32					FS_SEEK_OFFSET_T; /* Seek offset value */
typedef UINT32					FS_SIZE_T;
typedef UINT8					FS_RESULT_T;		// 0 - OK, >= 1 - FAIL

typedef struct
{
	UINT32				offset;
	UINT32				size;
	FILE_HANDLE_T		file_handle;
} FILE_HANDLE_REFERENCE_T;

// Неизвестные параметры следует задавать нулём


/* Для mode в DL_FsOpenFile. За подробностями - см. описание
	стандартных функций C stdio.h  */
enum
{
	FILE_READ_MODE = 0,         // Открыть дл чтения
	FILE_WRITE_MODE,            // Для записи
	FILE_WRITE_EXIST_MODE,      // Запись, если файл не существует
	FILE_APPEND_MODE,           // Запись в конец файла
	FILE_READ_PLUS_MODE,        // Открыть для чтения и записи
	FILE_WRITE_PLUS_MODE,       // Создать для чтения и записи
	FILE_WRITE_EXIST_PLUS_MODE, // Создать для чтения и записи, если не существует
	FILE_APPEND_PLUS_MODE       // Открыть или создать файл для чтения/записи в конец
};


/* Для whence в DL_FsSeekFile */
enum
{
	SEEK_WHENCE_SET = 0,
	SEEK_WHENCE_CUR,
	SEEK_WHENCE_END
};

#define FS_ATTR_DEFAULT    	0x0000
#define FS_ATTR_READONLY   	0x0001
#define FS_ATTR_HIDDEN     	0x0002
#define FS_ATTR_SYSTEM     	0x0004
#define FS_ATTR_VOLUME     	0x0008
#define FS_ATTR_DIRECTORY  	0x0010
#define FS_ATTR_ARCHIVE    	0x0020

/* search flags */
#define FS_SEARCH_EXCLUDE						0x80	// (?) 
#define FS_SEARCH_COMBINED						0x40	// (?) возможно поиск в нескольких местах сразу
#define FS_SEARCH_SORT_CHRONOLOGICAL			0x20	// сортировка по времени (создания/редактирования?)
#define FS_SEARCH_DIR_LISTING					0x10	// (?) возможно выдаст список папок
#define FS_SEARCH_PATH_START					0x08	// имена файлов в результате будут содержать полный путь
#define FS_SEARCH_SORT_ALPHANUMERIC				0x04	// сортировка по алфавиту
#define FS_SEARCH_OWNER_MATCH					0x02	// (?) проверять владельца
#define FS_SEARCH_RECURSIVE						0x01	// рекурсивный поиск (будет искать в подпапках)
// для удобства
#define FS_SEARCH_START_PATH					0x08
#define FS_SEARCH_FOLDERS						0x10
#define FS_SEARCH_SORT_BY_NAME					0x04
#define FS_SEARCH_RECURSIVE_AND_SORT_BY_NAME	0x0D
#define FS_SEARCH_RECURSIVE_AND_SORT_BY_TIME	0x29

/* спец-символы в запросе для поиска */
#define FS_VOLUME_NULL      0x0000
#define FS_VOLUME_SEPARATOR 0xFFFE

#define FS_MATCH_NULL                           0x0000
#define FS_MATCH_SEPARATOR                      0xFFFE
#define FS_MATCH_PATH_SEPARATOR                 0xFFFD
#define FS_MATCH_PATH_NONREC_SEPARATOR          0xFFFC
#define FS_MATCH_PATH_EXCLUDE_SEPARATOR         0xFFFB
#define FS_MATCH_PATH_NONREC_EXCLUDE_SEPARATOR  0xFFFA

typedef struct
{
#if defined(FTR_L7E) || defined(FTR_L9)
	UINT32				flags;
#else 
	UINT8				flags;
#endif
	UINT16				attrib; // Очевидно, в результат попадают те файлы, у которых аттрибуты&mask==attrib
	UINT16				mask;
} FS_SEARCH_PARAMS_T;


typedef struct
{
	WCHAR			name[FILEPATH_MAX_LEN+1]; // Полное имя фалйа (с путём)
	UINT16			attrib;
	UINT16			owner;
} FS_SEARCH_RESULT_T;

typedef UINT8 FS_SEARCH_HANDLE_T;


// VOLUME_DESCR_T.device
typedef enum
{
	FS_DEVICE_NONE                = 0x0000,
	FS_DEVICE_FLASH               = 0x0001,
	FS_DEVICE_MMC_INTERNAL        = 0x0002,
	FS_DEVICE_MMC                 = 0x0004,
	FS_DEVICE_MMC_EXTERNAL        = FS_DEVICE_MMC,
	FS_DEVICE_SDC                 = 0x0008,
	FS_DEVICE_NETWORK             = 0x0010,
	FS_DEVICE_FLASH_NONUSER       = 0x0020,
	FS_DEVICE_TFR                 = 0x0040,
	FS_DEVICE_MMC_RAMDISK         = 0x0100,
	FS_DEVICE_ALL                 = 0x7FFF,
	FS_DEVICE_UNSUPPORTED         = 0x8000,
	FS_DEVICE_INVALID             = FS_DEVICE_UNSUPPORTED
} FS_DEVICE_T;


// Свойства раздела
typedef struct {
	WCHAR		volume[3];		// +0
	WCHAR		vol_name[12];	// +6  
	UINT32		free;			// +32 in bytes
	UINT32		capacity;		// +36 in bytes
	UINT16		vol_attr;		// +40 
	UINT8		device_id;		// +42 0x01
	UINT16		device;			// +44
	UINT32		serial_num;		// +48 

} VOLUME_DESCR_T;


enum FS_REMOVE_T_ENUM_
{
	FS_REMOVE_DEFAULT = 0,
	FS_REMOVE_FORCE   = 1
};
typedef UINT8 FS_REMOVE_T;

#ifdef __cplusplus
extern "C" {
#endif


// Неизвестные параметры следует задавать нулём

FILE_HANDLE_T DL_FsOpenFile( const WCHAR* uri,  UINT8 mode,  UINT16 owner );

UINT8 DL_FsCloseFile( FILE_HANDLE_T handle );

UINT8 DL_FsReadFile( void* buffer,
                     UINT32 size,
                     UINT32 count,
                     FILE_HANDLE_T handle,
                     UINT32* read );

UINT8 DL_FsWriteFile( void* buffer,
                      UINT32 size,
                      UINT32 count, 
                      FILE_HANDLE_T handle,
                      UINT32* written);

UINT8 DL_FsFSeekFile( FILE_HANDLE_T handle,  INT32 off,  UINT8 whence );

UINT32 DL_FsGetFileSize( FILE_HANDLE_T handle );

UINT32 DL_FsSGetFileSize( const WCHAR* uri,  UINT16 owner );

WCHAR * DL_FsSGetFileName( const WCHAR * file_uri, WCHAR name[] );
WCHAR * DL_FsSGetPath( const WCHAR * file_uri, WCHAR path[] );
WCHAR * DL_FsSGetVolume( const WCHAR * file_uri, WCHAR vol_uri[] );

BOOL DL_FsDirExist( const WCHAR* uri );
BOOL DL_FsFFileExist( const WCHAR* uri );

UINT32 DL_FsFGetPosition( FILE_HANDLE_T handle );

UINT8 DL_FsRenameFile( FILE_HANDLE_T handle, const  WCHAR* new_name );

UINT8 DL_FsSRenameFile( const WCHAR* old_uri,  const WCHAR* new_name,  UINT16 owner );

UINT8 DL_FsDeleteFile( const WCHAR* uri,  UINT16 param1 );

UINT8 DL_FsFMoveFile( const WCHAR* src_uri,  const WCHAR* dst_uri,  UINT16 owner );

UINT8 DL_FsMkDir( const WCHAR* uri,  UINT16 owner );

UINT8 DL_FsRmDir( const WCHAR* uri,  UINT16 owner,  FS_REMOVE_T rmtype );

UINT8 DL_FsFSetAttr( FILE_HANDLE_T handle,  UINT16 attrib );

UINT8 DL_FsSSetAttr( const WCHAR* uri,  UINT16 owner,  UINT16 attrib );

UINT16 DL_FsGetAttr( FILE_HANDLE_T handle );

UINT16 DL_FsSGetAttr( const WCHAR* uri,  UINT16 owner );

void DL_FsFlush( void );

// получить физический идентификатор файла
UINT32 DL_FsGetIDFromURI( const WCHAR * uri, FS_MID_T * id );
// получить путь к файлу по id
WCHAR* DL_FsGetURIFromID( const FS_MID_T * id, WCHAR * uri );


// получает список дисков
WCHAR* DL_FsVolumeEnum( WCHAR *result ); // result = L{'/','a',0xfffe,'/', ...}

/* Свойства раздела (диска) */
VOLUME_DESCR_T * DL_FsGetVolumeDescr( WCHAR * volume, VOLUME_DESCR_T * vd );

BOOL DL_FsIsCardInserted( const WCHAR *vol_uri );

/**************************
  Поиск файлов
 **************************/

/* Функция синхронного поиска файлов */
/* search_string формируется из uri папки, где ведётся поиск, затем разделитель 0xFFFE, затем паттерны.
	Например: "file://b/Elf/\xFFFE*.elf" */
UINT16 DL_FsSSearch( 	FS_SEARCH_PARAMS_T	params,
						const WCHAR			*search_string,
						FS_SEARCH_HANDLE_T	*handle, 		// out
						UINT16				*res_count,		// out
						UINT16 				owner );

/* Функция для получения [части] списка результатов поиска */
UINT16 DL_FsSearchResults(	FS_SEARCH_HANDLE_T		handle,
							 UINT16 				start_index, // 0 based
							 UINT16					*count,		 // in and out
							 FS_SEARCH_RESULT_T		*results );

UINT16 DL_FsSearchClose( FS_SEARCH_HANDLE_T handle );


#ifdef __cplusplus
} /* extern "C" */
#endif

#endif