File System

The AMX/FSTM File System is a full-featured, high performance, MS-DOS® compatible file system. Designed for use with AMXTM and KwikNet® in real-time embedded applications, AMX/FS allows multiple tasks to manipulate files concurrently.

The AMX/FS File System is available for many different target processors. For each processor family, KADAK supports software development toolsets from one or more of the industry's best known tool vendors. Each AMX/FS implementation is exercised by KADAK on hardware platforms which can support a RAM drive and for which the prerequisite AMX board support is available.

  Introduction to AMX/FS

The AMX/FS File System is provided as a library of C procedures which permit multiple tasks to concurrently manipulate files.

The file system can be easily configured to meet your particular disk requirements using the AMX Configuration Builder. Simple commands instruct the Builder to create a File System Configuration Module which defines the logical disk drives and selects the RAM disk, PC BIOS, floppy or IDE device drivers in various combinations. No AMX/FS library reconstruction or creation is necessary.

  AMX/FS Drivers

A RAM disk device driver is included. For embedded PC applications with AMX 86, a device driver which uses the standard PC BIOS floppy and hard disk services is also provided.

Optional floppy and IDE disk device drivers, ready for use with PC compatible hardware interfaces, can be readily ported to meet your device requirements.

Alternatively, you can easily adapt the RAM disk driver or the shell driver provided with AMX/FS to create your own custom device driver.

  AMX/FS File Services

The AMX/FS library provides a wide range of file services from which to choose. Many of the services are optional and, if not used, will not even be present in your final system. The following lists summarize all of the AMX/FS procedures which are accessible to the user.

  File System Control Services
fjfserrfn Install a task Error Handler
fjfserrno Fetch AMX/FS error code
fjfsfatal AMX/FS fatal trap
fjfsfault AMX/FS fault trap
fjfsperror Record (log) an AMX/FS error
fjfssignin Register to use AMX/FS
fjfssignout Renounce use of AMX/FS

  Drive Access Services
fjdrvabort Abort all operations on a drive
fjdrvclose Close (unmount) a disk drive
fjdrvget Fetch task's current drive number
fjdrvgetcwd Fetch task's current working directory
fjdrvnfree Determine free space on a drive
fjdrvopen Open (mount) a disk drive
fjdrvparse Parse a drive name
fjdrvset Set task's default drive

  Directory Access Services
fjchdir Change current working directory
fjmkdir Make a directory
fjrmdir Remove (delete) a directory

  File Access Services
fjchsize Change size of (grow or shrink) a file
fjclose Close a file
fjeof Test if file pointer is at end of file
fjfattr Get or set file attributes
fjffdone Finished a file find search
fjfffirst Find first occurrence of a matching file
fjffnext Find next occurrence of a matching file
fjflush Flush a file to disk
fjfstat Fetch status of an open file
fjlseek Move current file pointer
fjopen Open a file
fjread Read from a file
fjremove Remove a file (synonym for fjunlink)
fjrename Rename a file or directory
fjstat Fetch status of a named file
fjtell Fetch current file pointer
fjunlink Unlink (delete) a file
fjwrite Write to a file

  Format Services
fjfmtfloppy Format a floppy diskette
fjfmtram Format (initialize) a preconfigured RAM Disk
fjfmtxram Create and format (initialize) a RAM Disk

  Miscellaneous Services
fjisdir Check if path is a directory
fjisvol Check if path is a volume (drive)
fjmkfs Make a file system on a drive
fjmkpath Concatenate a pathname and filename

  String Format Services
fj_itoa Format an int as a string
fj_ltoa Format a long as a string
fj_sprintf Format a string
fj_stoa Format a short int as a string
fj_strjust Copy and justify a string

  Additional Materials

You can also download the complete AMX/FS Reference Manual. The AMX/FS User's Guide describes how to use the AMX/FS File System an incorporate it into your AMX application. The AMX/FS Tool Guide describes how AMX/FS is used with each of the software development toolsets supported by KADAK.

Copyright © 1996-2013

File System
White Papers
Site Map
Get Info