Emerson PMT1 Manuel D’Utilisation

 Standard Monitor Functions

PmT1 and PmE1 User’s Manual

StartMon.c, NvMonDefs.h, NVTable.c, “Boot Commands” Section .

InitFifo(FPtr, StartAddr, Length)
struct Fifo *FPtr;
unsigned char *StartAddr;
int Length;

ToFifo(FPtr, c)
struct Fifo *FPtr;
unsigned char c;

FromFifo(FPtr, Ptr)
struct Fifo *FPtr;
unsigned char *Ptr;

These functions provide the necessary interface to initialize, read, and write a software 
FIFO. The FIFO is used for buffering serial I/O when using transparent mode, but could be 
used for a variety of applications. All three functions accept a pointer FPtr as the first argu-
ment to a FIFO management structure. This FIFO structure is described briefly below:

struct Fifo {
unsigned char *Top;
unsigned char *Bottom;
int Length;
unsigned char *Front;
unsigned char *Rear;
int Count;
} Fifo;

The function InitFifo initializes the FIFO control structure specified by FPtr to use the 
unsigned character buffer starting at StartAddr that is of size Length. 

The function ToFifo writes the byte c to the specified FIFO. This function returns TRUE if 
there is room in the FIFO (before adding c to the FIFO), or FALSE if the FIFO is full. 

The function FromFifo reads a byte from the specified FIFO. If a character is available, it is 
written to the address specified by the pointer Ptr and the function returns TRUE. If no char-
acter is available, the function returns FALSE.

IsLegal(Type,Str)
unsigned char Type;
char *Str;

This function is used to determine if the specified character string Str contains legal values 
to allow the string to be parsed as decimal, hex, uppercase, or lowercase. The function IsLe-
gal traverses the character string until a NULL is reached. Each character is verified accord-
ing to the Type argument. 

The effects of specifying each type are described below: