-------------------------------------------------------------------------------
Example: Flash Programmer (Source data in internal memory)
Target: ADSP-21262
Date: September 15, 2003
Tools: VisualDSP++ 3.0 SP1
Hardware: ADSP-21262 EZ-KIT LITE
-------------------------------------------------------------------------------
This hardware example will use the Parallel Port to take a data buffer or ldr file
in internal memory and program it into the AMD 1Mx8 flash memory on the ADSP-21262
Ez-Kit-Lite.

This example is intended for use with the AMD 1Mx8 flash that is included on the
ADSP-21262 EZ-KIT-LITE, but could be easily ported to program another type or size
of flash.

The example has several subroutines that are of interest.
The subroutines will:
    -FLASH_FILE_SIZE:   - check to see that the buffer 'my_file' is not too large
                         to fit in the 1Mx8 flash
    -FLASH_RESET:       - issue the flash reset command
    -ERASE_FLASH_CHIP;  - erase the entire flash and wait until the erase command
                         is completed
    -SECTOR_ERASE:      - calculate the number of sector needed to hold the data
                         and erase accordingly (and verify erasure)
    -PROGRAM_FLASH:     - program the flash with the data/code in my_file and
                         check for write cmd completion after each byte
    -VERIFY_FLASH:      - verify the contents of the flash with the values in 'my
                         _file',
The user has the ability to erase the entire flash before programming
(ERASE_FLASH_CHIP) or to erase on a sector-by-sector basis, preserving previously
programmed code in other sectors.

-------------------------------------------------------------------------------
Instructions:
BYTES         The parallel port uses an 8-bit external width, but we're using a 16-
bit data width, so to keep sense of the counts in terms of bytes-per-word, define
BYTES as seen here:
                        #define BYTES 2//     4 * 8bits = 32 bit logical data
                                       //or   2 * 8bits = 16 bit logical data
                                       //or   1 * 8bits =  8 bit logical data

my_file:     this is a DSP loader file generated using the Loader Utility in
             VisualDSP. By default, this project expects the loader file to be a 16-
             bit include format generated using the PROM option of the loader.

If -------------------------------------------------------------------------------
Source Files contained in this directory:
AMD Parallel Flash Programmer.dpj     VisualDSP project file
AMD Parallel Flash Programmer.asm     ADSP-21262 source
21262_IVT.asm            Interrupt Vector Table
ADSP-21262-EZKIT.ldf           Linker description file
input.ldr                File holding data to be programmed to FLash
-------------------------------------------------------------------------------
Dependencies contained in VisualDSP++ default include path:
def21262.h               Header file with generic definitions
*******************************************************************************
Analog Devices, Inc.
DSP Division
One Technology Way
Norwood, MA 02062

(c) 2003 Analog Devices, Inc.  All rights reserved.
*******************************************************************************