File System FSEE
[System Modules]

Files
file	fsee.h
	FSEE Module for Modtronix TCP/IP Stack.

---

Detailed Description

Format

The Modtronix HTTP Server uses a simple file system (the Modtronix EEPROM File System, or "FSEE") to store Web pages in the EEPROM. This documentation if for version 1 of the FSEE. The FSEE image is stored in an external serial EEPROM. FSEE follows a special format to store multiple files in the given storage media, which is summarized in Figure 1.

Reserved Block

FSYS Header

FAT Entry 1

.............

FAT Entry n

File 1

.............

File n

Figure 1 - File System Image Format

The length of "Reserved Block" is defined by FSEE_RESERVE_BLOCK. The reserved block can be used by the main application to store simple configuration values. FSEE storage begins with the "FSYS Header", which contains information about the File System type, length and other info. The format of the "FSYS Header" is shown in Figure 2.

FSYS Header Length (8 bits)

File System Identifier (8 bits)

File System Version (8 bits)

FAT Entries (16 bits)

Figure 2 - FSEE "FSYS Header" Format

• The "File System Identifier" of the FSEE (Modtronix EEPROM File System) with a maximum File System size of 16 Mbytes and file size of 64 Kbytes is 0x01. This is the default type for the FSEE File System.

• The "File System Identifier" of the FSEE (Modtronix EEPROM File System) with a maximum File System size of 16 Mbytes and file size of 16 Mbytes is 0x02. This is also know as the FSEE16M File System.

Following the "FSYS Header" is one or more "FAT Entries" (File Allocation Table), followed by the file data of each file. The "FAT entries" are always in alphabetic order, and all file names are in capitals. The "FAT entry" describes the file name, location and it's attributes. The format of the "FAT Entry" is shown in Figure 3.

Attributes (8 bits)

File Name (8-byte + 3-byte format)

Address (24 bits)

File Length (16 or 24 bits)

Figure 3 - FSEE FAT Entry Format

The "Attributes" indicates whether the file is a normal file or a read only file.

Each FAT entry contains a 24-bit address value. This implies a maximum FSEE image size of 16 Mbytes.

FSEE uses "short" file names of the "8 + 3" format (8 bytes for the actual file name and 3 bytes for the extension, or NNNNNNNN.EEE). The 24-bit address gives the start of the first file data block. All file names are stored in upper case to make file name comparisons easier. All FAT entries are in alphabetical order to make finding a file faster.

The address in each FAT entry points in turn to a data block that contains the actual file data. The data block format is shown in Figure 3.

Data (variable length)

Figure 3 - FSEE Data Block Format