uC/FS文件系统软件V1.26用户与参考手册

需积分: 10 107 浏览量更新于2024-07-28 收藏 712KB PDF 举报

"uC/FS用户参考手册(英文)" 这篇用户参考手册是针对uC/FS FileSystem Software Version 1.26的，由Micriµm Technologies Corporation编写并提供。uC/FS是一个高度可移植且与CPU无关的文件系统，适用于嵌入式系统。手册主要面向用户和开发者，旨在帮助他们理解和使用uC/FS。在文档中，读者可以期待找到以下关键知识点： 1. **文件系统基础**：uC/FS提供了文件系统的基本功能，如文件创建、打开、读取、写入、关闭和删除。它还可能包括目录管理，如创建、删除、遍历目录结构等。 2. **API接口**：手册将详细列出uC/FS提供的函数调用，这些函数允许程序员进行文件操作和文件系统的管理。API通常包括`fs_open()`, `fs_close()`, `fs_read()`, `fs_write()`等。 3. **文件系统结构**：手册可能会介绍uC/FS如何组织存储介质上的数据，如FAT（文件分配表）或其它定制的文件系统结构。这可能涉及到簇、扇区、根目录的概念，以及如何在有限的内存资源下高效管理这些元素。 4. **错误处理**：由于嵌入式系统可能面临各种硬件限制和异常情况，手册会解释uC/FS如何处理错误，并提供错误代码和恢复策略。 5. **性能优化**：考虑到嵌入式系统的资源限制，uC/FS可能包含一些优化技术，比如缓存策略、I/O调度等，以提高文件操作的速度和效率。 6. **移植性**：由于uC/FS是CPU无关的，手册会提供关于如何将文件系统移植到不同处理器平台上的指导。 7. **许可证和使用条款**：文档中的版权信息指出，软件的使用受到特定许可协议的约束，只有在遵循这些条款的情况下才能复制或使用软件。 8. **支持和更新**：可能还会提到Micriµm Technologies Corporation提供的支持服务，如更新、技术支持或者社区资源，以便用户获取最新信息和解决问题。这份用户参考手册对于开发和维护使用uC/FS的嵌入式系统来说是非常宝贵的资源，它涵盖了从基本操作到高级特性的全面指南，有助于用户深入理解并有效利用这个文件系统软件。

123

User's

& reference manual for

µC/FS

 2002 Micrium Technologies Corporation

configuration. Usually µC/FS‘s source code builds without any compiler

warning.

Once you can build the application, you should be able to use it with your

target’s debugger environment just like we did with the Visual C++ sample

project.

Congratulations, you have successfully integrated µC/FS into your system. .

User's & reference manual for

µC/FS

123

 2002 Micrium Technologies Corporation

5. Configuration of µC/FS

In your configuration directory for µC/FS, you will find two files, which allow you

to configure the file system according to your requirements. In this chapter, you

will find a description of each of these files.

5.1.fs_conf.h

This is the main configuration file for the file system. You define which drivers

you want to use and, the configurations for these drivers.

Example

#ifndef _FS_CONF_H_

#define _FS_CONF_H_

**********************************************************************

* Micrium, Inc.

* 949 Crestview Circle

* Weston, FL 33327-1848

* uC/FS

***********************************************************************

----------------------------------------------------------------------

File : fs_conf.h

Purpose : File system configuration

Usually all configuration of the file system for your

system can be done by changing this file.

If you are using a big endian system or a totally

different architecture, you may have to modify the file

"fs_port.h".

----------------------------------------------------------------------

Version-Date-----Author-Explanation

----------------------------------------------------------------------

1.00.00 20020815 First release

----------------------------------------------------------------------

Known problems or limitations with current version

----------------------------------------------------------------------

None.

---------------------------END-OF-HEADER------------------------------

/*********************************************************************

* #define constants

**********************************************************************

/*********************************************************************

* Number of file handles

Set the maximum number of simultaneously open files in your system.

Please be aware, that the file system requires one FS_FILE structure

for each open file. If you are using FAT, each file will also require

two sector buffers.

#define FS_MAXOPEN 4 /* Maximum number of file handles */

123

User's

& reference manual for

µC/FS

 2002 Micrium Technologies Corporation

/*********************************************************************

* OS Layer

Set all to 0, if you do not want OS support.

#define FS_OS_EMBOS 1 /* 1 = use embOS */

#define FS_OS_UCOS_II 0 /* 1 = use uC/OS-II */

#define FS_OS_WINDOWS 0 /* 1 = use WINDOWS */

#if ((FS_OS_WINDOWS==1) && ((FS_OS_EMBOS==1) || (FS_OS_UCOS_II==1)))

#error You must not use Windows at the same time as embOS or uC/OS-II!

#endif

/*********************************************************************

* Time/Date support

If your system does support ANSI C library functions for time/date,

you can set this to 1. If it is set to 0, functions FS_OS_Get_Date

and FS_OS_Get_Time will return the date 1.01.1980 0:00 unless you

modify them.

#define FS_OS_TIME_SUPPORT 0 /* 1 = time()/date supported */

/*********************************************************************

* File System Layer

You can turn on/off the file system layers used in your system.

At least one layer has to be active. Because currently there is only

one file system layer supported (FAT), you will usually not change

this setting.

#define FS_USE_FAT_FSL 1 /* FAT12/FAT16 file system */

/*********************************************************************

* Device Driver Support

You can turn on/off device driver supported in your system.

If you turn on a driver, please check also its settings in this

file below.

#define FS_USE_SMC_DRIVER 1 /* SmartMedia card driver */

#define FS_USE_WINDRIVE_DRIVER 0 /* Windows Logical Drive driver */

#define FS_USE_RAMDISK_DRIVER 1 /* RAM Disk driver */

#if (!defined(_WIN32) && (FS_USE_WINDRIVE_DRIVER))

#error Windows Logical Drive driver needs Windows API

#endif

/*********************************************************************

* FAT File System Layer defines

#if FS_USE_FAT_FSL

For each media in your system using FAT, the file system reserves

memory to keep required information of the boot sector of that media.

FS_MAXDEV is the number of device drivers in your system used

with FAT, FS_FAT_MAXUNIT is the maximum number of logical units

supported by one of the activated drivers.

#define FS_MAXDEV (FS_USE_SMC_DRIVER + FS_USE_WINDRIVE_DRIVER +

FS_USE_RAMDISK_DRIVER)

User's & reference manual for

µC/FS

123

 2002 Micrium Technologies Corporation

#define FS_FAT_MAXUNIT 2 /* max number of medias per device

Do not change following defines !

They may become configurable in future versions of the file system.

#define FS_FAT_SEC_SIZE 0x200 /* do not change for FAT */

#define FS_FAT_MAXCLST 100000 /* max cluster number (do not

change) */

#endif /* FS_USE_FAT_FSL */

/*********************************************************************

* RAMDISK_DRIVER defines

#if FS_USE_RAMDISK_DRIVER

Define size of your RAM disk here.

You specify the number of sectors (512 bytes) here.

#define FS_RR_BLOCKNUM 32 /* 16KB RAM */

Do not change following define !

It may become configurable in future versions of the file system.

#define FS_RR_BLOCKSIZE 0x200 /* do not change for FAT */

#endif /* FS_USE_RAMDISK_DRIVER */

/*********************************************************************

* SMC_DRIVER defines

Settings of the generic Smartmedia Card driver.

For using SMC in your system, you will have to provide basic

hardware access functions. Please check device\smc\hardware\XXX\smc_hw.c

and device\smc\hardware\XXX\smc_hw.h for samples.

#if FS_USE_SMC_DRIVER

Number of card readers in your system.

Please note, that even if your system does have more than one

SMC slot, it might be unable to access them both at the same

time, because they share resources (e.g. same data port). If that

is true for your system, you must ensure, that your implementation

of "FS_OS_Lock_deviceop(&_FS_smcdevice_driver,id)" blocks the device

driver for all values of "id"; the default implementation of the

file system's OS Layer does so.

#define FS_SMC_MAXUNIT 2 /* EP7312 SMC + on board NAND

The following define does tell the generic driver, if your

system can directly check the SMC RY/BY line.

#define FS_SMC_HW_SUPPORT_BSYLINE_CHECK 0 /* EP7312 does not support */

FS_SMC_HW_NEEDS_POLL has to be set, if your SMC hardware driver

needs to be called periodically for status check (e.g. diskchange).

In such a case, the generic driver does provide a function

"void FS_smc_check_card(FS_u32 id)", which has to be called

periodically by your system for each card reader.

#define FS_SMC_HW_NEEDS_POLL 1 /* EP7312 needs poll for

diskchange */

#endif /* FS_USE_SMC_DRIVER */

/*********************************************************************

* WINDRIVE_DRIVER defines

123

User's

& reference manual for

µC/FS

 2002 Micrium Technologies Corporation

This driver does allow to use any Windows logical driver on a

Windows NT system with the file system. Please be aware, that Win9X

is not supported, because it cannot access logical drives with

"CreateFile".

#if FS_USE_WINDRIVE_DRIVER

The following define tells WINDRIVE, how many logical drives

of your NT system you are going to access with the file system.

if your are going to use more than 2 logical drives, you

will have to modify function "_FS_wd_devstatus" of module

device\windriver\wd_misc.c.

#define FS_WD_MAXUNIT 2 /* number of windows drives */

Specify names of logical Windows drives used with the file system. For

example,

"\\\\.\\A:" is usually the floppy of your computer.

#define FS_WD_DEV0NAME "\\\\.\\E:" /* Windows drive name for

"windrv:0:" */

#define FS_WD_DEV1NAME "\\\\.\\A:" /* Windows drive name for

"windrv:1:" */

To improve performance of WINDRIVE, it does use sector caches

for read/write operations to avoid real device operations for

each read/write access. The number of caches can be specified

below and must not be smaller than 1.

#define FS_WD_CACHENUM 40 /* number of read caches per

drive */

#define FS_WD_WBUFFNUM 20 /* number of write caches per

drive */

Do not change following define !

It may become configurable in future versions of the file system.

#define FS_WD_BLOCKSIZE 0x200 /* do not change for FAT */

#endif /* FS_USE_WINDRIVE_DRIVER */

#endif /* _FS_CONF_H_ */

5.1.1.OS support

You can specify whether you are using uC/OS-II, embOS, Windows or no OS

support at all. Please set FS_OS_UCOS_II, FS_OS_EMBOS,

FS_OS_WINDOWS to 1, respectively. For no OS support at all, set all of them to

0. If you need support for an additional OS, you will have to provide functions

described in the chapter “OS integration”.

5.1.2.Time/Date support

If you want to be able to add date and times to your files, you will need to set

FS_OS_TIME_SUPPORT to 1.

5.1.3.File System Layer Support

µC/FS can support different file system at the same time. You can enable them

by setting FS_USE_XXX_FSL, where XXX is the name of the file system layer.

The current version of µC/FS only supports the FAT file system, so you will

need to set FS_USE_FAT_FSL to 1.

剩余122页未读，继续阅读

lpxvczx

粉丝: 0
资源: 2

uC/FS文件系统软件V1.26用户与参考手册

uc/fs v3.10d

uC/FS Manual V3.10

uc_FS的文档 Ver1.26

uC/FS 文件系统用户及参考手册 V2.36b

uC/FS文件系统用户手册V2-10a完整指南

uC/FS Version 4 用户手册：API函数与移植指南

uC/FS 文件系统实用指南：UCOS-II 操作详解

μC/FS 1.26文件系统用户与参考手册

μC/FS中文手册：RTOS文件系统详解与架构

uC-FS-UserManual

最新资源