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

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

《uC/FS文件系统手册》是Microchip Technologies Corporation发布的一份用户参考文档，版本为1.26，适用于各种CPU的嵌入式系统。这份手册旨在详细介绍µC/FS（μC File System）——一个轻量级、高度可配置且高效的文件系统解决方案，特别适合资源受限的微控制器环境。uC/FS的设计目标是提供一种在嵌入式环境中管理和组织文件的方法，确保了在存储空间有限的条件下也能实现高效的数据管理。手册首先强调了版权和免责声明，指出文档中的信息可能会随时更新，虽然在发布时被认为是准确的，但Microchip Technologies Corporation不对任何错误或遗漏承担责任。供应商明确表示，不提供明示或默示的质保，包括适销性和特定用途的适用性。版权方面，所有文档内容未经Microchip Technologies Corporation事先书面许可，禁止任何形式的复制、存储、检索或通过电子、机械、复印、录音等手段传输。软件本身是在特定许可下提供的，用户必须按照这些条款进行使用和复制。手册的核心内容主要包括以下几个部分： 1. **概述**：介绍了uC/FS的基本概念，包括其设计目标、特点（如小型化、低内存占用、高性能）、以及它如何在嵌入式系统架构中发挥作用。 2. **安装和配置**：详细说明了如何在目标硬件上安装和配置uC/FS，包括必要的驱动程序集成和配置设置。 3. **文件系统结构**：阐述了uC/FS的目录结构、文件类型（如文本、二进制、压缩等）、以及如何创建、删除和管理文件和目录。 4. **API接口**：提供了uC/FS的函数库接口，包括读写文件、目录操作、文件系统管理、错误处理等，帮助开发者实现与文件系统的交互。 5. **性能和优化**：探讨了uC/FS的性能指标，以及针对不同应用场景如何进行性能调优和内存管理。 6. **示例和应用**：包含了实用的代码片段和实际应用案例，以便读者更好地理解和实践uC/FS的使用。 7. **升级和维护**：指导用户如何检查和更新文件系统，以及在遇到问题时的故障排除步骤。 8. **许可证和支持**：明确了许可协议的细节，以及Microchip Technologies Corporation提供的技术支持方式。《uC/FS文件系统手册》为嵌入式开发人员提供了丰富的资源，帮助他们有效管理数据存储，提升系统性能，同时理解并遵守相关的版权和使用限制。无论是初次接触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页未读，继续阅读

畅游天空

粉丝: 0
资源: 3

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

UCOS-II文件系统使用手册

STM32F4 UCOS开发手册_V3.0_STM32F4UCOS_正点原子UCOS_

《Micrium-uCOS-III-UsersManual》_uCOS-III_uCOS-III手册_ucOSIII用户手册_源

stm32g0移植ucosii系统

针对STM32F303微控制器，如何详细地进行uCosIII操作系统的移植、编译和调试？

STM32 UCOSII使用内部晶振

嵌入式实时操作系统UCOS IIIpdf

如何在UCOSIII操作系统中启用统计任务以及监控和优化CPU使用率？

在STM32F10x标准外设库基础上整理并移植UCos-II操作系统时，如何合理组织源代码和构建工程目录结构？

ucos移植到stm32f103c8t6

最新资源