
This directory contains a utility that converts binary application images
into images that the NET+OS bootloader can process.  It does this by adding
a header at the beginning of the image and attaching a checksum value at 
the end. The command line for this utility is:

    uboothdr <config-file> <input-file> <output-file> [<custom-header-file>]
    
where <config-file> is the name of a configuration file, <input-file> is
the name of the binary application image, and <output-file> is the name
of the image file to create.  The <custom-header-file> is optional.  If
present, it must be the name of a file that contains custom header 
information to be inserted immediately after the regular header.  The
file is read as binary data.

The configuration file consists of pairs of keywords and values.  The
supported keywords and their values are:

    WriteToFlash    Yes or No
                    Sets a bit in the header that indicates whether a
                    downloaded image should be written to flash or
                    executed from RAM immediately
                    
    Compressed      Yes or No
                    Sets a bit in the header that indicates whether the
                    image has been compressed.
                    
    ExecuteFromRom  Yes or No
                    Sets a bit in the header that indicates whether the
                    image should be executed from flash ROM or from
                    RAM.
                    
    FlashOffset     offset to store image in in flash
    
    RamAddress      address in RAM to copy or decompress an image to
                    before executing it.
                    
    MaxFileSize     maximum file size for the image

    EntryPoint      entry point to begin execution

This application can be built with the GNU tools that ship with Cygwin.
These tools are shipped with NET+OS for GNU.  If you do not have them,
then you can download them for free from http://www.cygwin.com/.

To build using Microsoft Visual C++ to remove the cygwin1.dll dependency,
use these commands:

nmake /f "uboothdr.mak" CFG="uboothdr - Win32 Release"

nmake /f "uboothdr.mak" CFG="uboothdr - Win32 Release" clean

