readme.txt for ADSP-BF518F EZ-Board Power On Self Test (POST)

Last updated:	10/31/08

Last tested on:	10/31/08 using rev 0.1 BF518F EZ-Board and
				VisualDSP 5.0 Update 5

__________________________________________________________

CONTENTS

I. FUNCTIONAL DESCRIPTION
II. IMPLEMENTATION DESCRIPTION
III. OPERATION DESCRIPTION
IV. POST NOTES
V. USING LOADER FILES

__________________________________________________________

I.  FUNCTIONAL DESCRIPTION

This directory contains an example power-on-self-test (POST) project which
tests the many peripherals of the BF518F EZ-Board.  It is also the application
which is loaded into the parallel flash on the BF518F EZ-Board.  By following
the instructions below, users can create a loader file suitable for loading
into the on-board flash.

__________________________________________________________

II.  IMPLEMENTATION DESCRIPTION

Executes a POST on the EZ-Board.  By selecting certain pushbutton sequences the
user can choose which test or tests to run.

__________________________________________________________

III.  OPERATION DESCRIPTION

Certain tests require special switch and jumper settings.  Most tests use the
default settings which can be found in the EZ-KIT Lite User's Manual.  Configure
the EZ-KIT with these settings and if changes are needed you may refer to the
individual test notes below.

Switch settings for rev 0.1 EZ-KIT:

		SWITCH									POSITION
									1	2	3	4	5	6	7	8
	======================================================================
	SW1  (BOOT MODE)				POSITION = 1
	SW2  							ALL ON
	SW3  							ALL ON
	SW4  							ALL OFF
	SW5								ON	ON	OFF	ON
	SW6								OFF	OFF	ON	OFF
	SW7								ON	ON	ON	OFF
	SW8								ON	ON	ON	OFF
	SW10							ON	ON	ON	OFF
	SW15							ALL ON
	SW16							ON	OFF	ON	OFF	ON	OFF
	SW17							ON	ON	ON	OFF	ON	OFF
	SW18							ON	ON	ON	OFF	OFF	OFF
	SW19							ALL ON
	SW20							ALL OFF
	SW21							ALL OFF
	
Jumper settings for rev 0.1 EZ-KIT:
	
	JP3				INSTALLED
	JP4				NOT INSTALLED
	JP11			NOT INSTALLED
	JP12			INSTALLED
	JP13			NOT INSTALLED
	JP14			NOT INSTALLED
	JP15			INSTALLED ON 2 AND 3
	JP16			NOT INSTALLED
	JP17 - JP28		INSTALLED ON 2 AND 3	
	P8 - P11		INSTALLED
	
	
__________________________________________________________

 IV.  POST TEST NOTES
 
This POST was designed so the user can choose to run any specific test at startup.  The POST
enters a state waiting for pushbutton input from the user.  Please refer to the table in main.c
for the pushbutton sequence for each test.

Most tests are self-explanatory and run with the standard settings.  The following tests require
additional information and/or user interaction.  For more information also refer to the source
code which attempts to be self-documenting.
   
 	  
__________________________________________________________

 V.  USING LOADER FILES
 
POST ships already programmed into the parallel flash.  If you wish to make changes to POST
or create your own application to program into flash you may do so as well.  Parallel flash
and serial flash drivers are provided for this EZ-KIT to allow you to use the VisualDSP++
Flash Programmer to program each flash.

The first step is to make a loader (.ldr) file.

- Open an ADSP-BF518F EZ-Board session in VisualDSP++.
- Open the "Power_On_Self_Test" project.
- Click on the "Project" menu item and select "Project Options...".
- Select "Project" in the left hand window.
- Make sure that "Type" is set to "Loader file".
- Select the "Project:Load:Options" from the left hand window.
- Under "Boot Mode" choose "Flash/PROM" for parallel flash and "SPI" for serial flash.
- "Boot Format" should be "Intel hex".
- "Output Width" should be "16-bit" for parallel flash and "8-bit" for serial flash.
- "Use default start address" should be checked.
- "Verbose" should be unchecked
- Since we are using external memory, the "Initialization file" should be:
  "$(VDSP)\Blackfin\ldr\ezkitBF518_initcode_ROM-V00.dxe".
- "Output file" and "Additional options" should be blank. 
- After all the options are set up select "OK".
- Click the "Project" menu item and select "Rebuild Project" to build the loader file.
- The loader file should now be in your output folder.

Next we need to download the loader file.  We can use the VisualDSP++ Flash Programmer to
accomplish this.

- Using your current session, click on the "Tools" menu item and select "Flash Programmer...".
- The Flash Programmer window will pop up.
- On the "Driver" tab, click on the "Browse..." button to browse for the driver.
- For parallel flash you want to choose the executable (dxe) located here:
  "<VDSP>\Blackfin\Examples\ADSP-BF518F EZ-Board\Flash Programmer\Parallel".
  For serial flash you want to choose the executable (dxe) located here:
  "<VDSP>\Blackfin\Examples\ADSP-BF518F EZ-Board\Flash Programmer\Serial".
- Select the dxe file and then click "Load Driver".
- Click on the "Programming..." tab.
- "Pre-program erase options" should be "Erase affected".
- "File format" should be "Intel Hex".
- Click on the "Browse..." button for to browse for the "Data file".
- Select the ldr file you just created and click "Program".
- You can monitor the progress with the status bar.
- When complete you can close the Flash Programmer window.

To boot from flash just close down VisualDSP, configure SW1 (BOOT MODE), and reset the EZ-Board.
For parallel flash booting use position 1 and for serial flash booting use position 3.
    
Note, an alternate method for users connecting with the EZ-Board on-board debug agent.  The
above steps will work, however for your convenience, there is an alternate method of resetting
the board and performing a boot without exiting VisualDSP++.
  
- Go to the "Settings" menu and choose "Boot Load".  This will cause the board to boot from flash
  and run.
- You can halt the processor at any time by clicking on the "Debug:Halt" menu item.
- You can then load the symbols of your application using the "File:Load Symbols" menu item and 
  selecting the dxe file.  This will not change the state of the processor from where it was
  halted, but it will correlate debug information to what was booted from the flash.