Flash Programming Utility
-------------------------------------
-------------------------------------

Create a Program for FLASH Memory
-------------------------------------

In order to program the FLASH and boot up from FLASH, you must build a .out file with
your application code. The program size is limited to 0x20000.  The program must be 
converted from the COFF format to hex format. 

Perform the following steps to convert your code:

1)	Make a copy of hex.cmd.

2)	Edit the file hex.cmd.

First, replace the .out filename with your filename and the output filename with your
selected filename. Then, in the ROMS field, change the value of the "len" parameter to
your code size. This value must be a multiple of 0x80 (128) and less than the flash
size (0x20000).

3)	In a DOS window, run hex6x hex.cmd to generate the hex data file.

4)	Run flash.exe to program the flash.

The following is the hex.cmd file.

post.out
-a
-image
-zero
-memwidth  8ROMS
{
   FLASH: org = 0, len = 0x10000,romwidth = 8, files = {post.hex}
}

The POST is used as an example program and it is included in the following directory:
\ti\c6000\examples\dsk\flash\pgm2flash


Load Program into FLASH Memory
-------------------------------------

The code generation process converts a DSP program into an executable image that
follows the COFF. The hex conversion utility hex6x converts a COFF file to hex format. The flash programming utility is a host-based program that loads a hex file into the FLASH memory of the DSK board.

To invoke the DSK FLASH programming utility, use the following syntax:

flash [options] [filename]

flash	    Command that invokes the FLASH programming utility.
options	    Options that affect the way the FLASH programming utility behaves. Options
            are not case sensitive and can appear anywhere on the command line 
			following the command. 
filename	Filename used for the hex file. If no filename is supplied, you are asked
            to supply a hex file name.Most often, the file will have the .hex type
			extension.

****NOTE: This utility works with ASCII-Hex files ONLY!

The following options are available with the FLASH programming utility:

-? or -h	Displays command-line help information. 
-pport	    Defines the virtual port address of the board being tested.This option can
            be used in conjunction with the -s option.
-saddr	    Defines the starting address to write the hex program in FLASH. This
            option can be used in conjunction with the -p option.

Example:    Type the following at the command line to load post.hex
            to the FLASH memory on the DSK which locates at virtual port b.

flash -pb post -s0x90000000



Rebuild the FLASH Programming Utility
-------------------------------------

FLASH DSP program:
This program uses the DSP to program the FLASH memory based on interaction with hex
data provided by the host.

Run one of the following two methods to rebuild the DSP program:

Method 1 - Code Composer Studio	
Select the Open menu item from the Project menu within Code Composer Studio.
Use the make file flash_prog.mak.

Method 2 - Command Line Option
cl6x -@options
	
The files needed to rebuild the DSP program are located in the following directory:
\ti\c6000\examples\dsk\flash\dsp

FLASH HOST program:
This program demonstrates a PC program that can load and run the DSP program without
using CCS. To build the host utility, use the Visual C++ files provided in the 
following directory:
\ti\c6000\examples\dsk\flash\host