Zilog EZ80F91AZA - Manual (Page 13)

UM017914-1211 Zilog File System Overview
Zilog File System
User Manual
3
The Zilog File System directory contains a common directory for all target processors.
Figure 1 displays the following four subdirectories of the Zilog File System:
ZTPX.Y.Z_Lib\RZK\Inc. This directory contains the header files that must be included in
the user application.
ZTPX.Y.Z_Lib\RZK\Lib. This directory contains the NOFS.obj stub file (for the ZDS II
development environment) that must be included if Zilog File System support is not
required in the system, even though the system uses the Zilog File System APIs.
ZTPX.Y.Z_Lib\RZK\Conf. This directory contains the ZFS_Conf.c file that describes the
configuration of the Zilog File System. This file must be included in the application proj-
ect workspace to interoperate with the Zilog File System.
ZTPX.Y.Z_Lib\RZK\SamplePrograms\FS. This directory contains sample programs writ-
ten for the Zilog File System. One such sample program is the FSShell program, which
is an interactive shell application that showcases different operations performed by the
Zilog File System. Only a few commands are provided in the
FSShell application. For
detailed information about the FSShell application shell commands, refer to the readme
file present in the following directory:
\Program Files\Zilog\

ZDSII_eZ80Acclaim!_A.B.C\ZTP\ZTPX.Y.Z_Lib\RZK\SamplePrograms\FS\

FSShell
The above directory also contains all of the sample programs associated with the RZK
release.
The name of the four subdirectories listed above is the same for every target eZ80 micro-
processor or microcontroller.
Use Model
The Zilog File System is provided as a library and interfaces to the file system via well-
known APIs. The Zilog File System provides you with these APIs; however, you must call
the appropriate API to obtain service from the file system. The
ZFSInit API must be
called before performing any file- or directory-related operations on the volume.
ZFSInit() must be called in a thread body and not in the main() function.
The code segment below provides an example of Zilog File System calls, from the initial-
ization of the file system to calling an API.
void AppThreadEntry(void)
{
ZFS_STATUS_t status;
int cnt;
int ctr;
PZFS_VOL_PARAMS_t pvol_params, ptmp_vol;