*********************************************************************************************
* This file describes the content of the genAIS Utility  packages                           *
* for TMS320DM643x and related devices.                                                     *
* Description:                                                                              *
*   genAIS is a Perl script that converts the code/data                                     *
* from a linked application module, to an Application                                       *
* Image Script (AIS) file suitable for use with the                                         *
* ROMed boot loader for the device. The script was developed                                *
* using Active Perl V5.8.6 and requires minimum of Perl V5.8.0                              *
*                                                                                           *
* Dependencies:                                                                             *
*  1. Perl V5.8.0 or above.                                                                 *
*  2. Object File Display Utility (OFD, ofd6x) version                                      *
*     v6.1.0A06333 or above.                                                                *
*     NOTE:                                                                                 *
*      OFD/ofd6x is a tool distributed with the TI Code                                     *
*      Generation Tools. If the version of the tool in                                      *
*      the install directory for C6000/cgtools/bin has a                                    *
*      revision number earlier than v6.1.0A06333, please update                             *
*      the ofd6x.exe in the install directory. This can be done                             *
*      by simply copying the accompanying version of the tool                               *
*      to the cgtools/bin directory. Please remember to back up                             *
*      previous version before overwriting with new file.                                   *
*                                                                                           *
*    WARNING NOTE:!!!                                                                       *
*      Some versions of Windows/NT, Win95, do not support use of                            *
*      Perl system() function, which is used by the genAIS                                  *
*      utility to invoke OFD(ofd6x). If your operating system                               *
*      does not support this functionality, then ofd6x MUST be                              *
*      invoked prior to running the genAIS utility. The                                     *
*      resulting XML file, must then be specified as an input                               *
*      on the genAIS command line when invoked.                                             *
*                                                                                           *
*      i.e.                                                                                 *
*      ofd6x -x --obj_display=none,header,optheader,sections,symbols myApp.out -o myApp.xml *                               *
*      genAIS -i myApp.out -x myApp.xml -o myAIS.txt -bootmode uart -otype txt              *
*                                                                                           *
* The utility takes three inputs:                                                           *
*   1. a linked application file (*.out, *a64) REQUIRED                                     *
*   2. a configuration  file (*.cfg).          OPTIONAL                                     *
*   3. XML output of Object File Display       OPTIONAL if system() , REQUIRED otherwise    *
*                                                                                           *
*                                                                                           *
* Package Content:                                                                          *
*    Directory                                                                              *
*      bin              - genAIS.pl  AIS generation tool                                    *
*                         ofd6x.exe  Object File Display tool                               *
*      Example          - Contains example project, and sample .bat files                   *
*        docExample     - contains example.asm source used in generating examples           *
*                         for the bootloader Applications Note: Using the TMDS320DM643x     *
*                         Bootloader (SPRAAGO)                                              *
*        Example AIS                                                                        *
*            *.bat      - Batch file examples showing invocation of genAIS for various      *
*                         boot modes and options.                                           * 
*********************************************************************************************          