
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:

    boothdr <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

    BypassCrcCheck  Yes or No
                    Sets a bit in the header that indicates whether the
                    bootloader should perform a CRC check on the image.

    BackupAddress   starting address in Flash memory where the backup
                    recovery image is located.

This application is built with Visual C++.

To successfuilly build this application, follow these steps:

1. Open a DOS window, and set the directory to \netos\netos\src\utilities\boothdr.  For instance:

        C:> cd \netos\netos\src\utilities\boothdr

2. Execute the copytolocal batch file:

        C:\netos\netos\src\utilities\boothdr>copytolocal

3. In Visual Studio, open the workspace C:\netos\netos\src\utilities\boothdr\boothdr.dsw
4. Set the Active Configuration to Release
5. Build boothdr.exe (F7)

This will now replace the boothdr.exe in the \netos\netos\bin directory.


    


