add other tools utilities and examples
[keystone-rtos/mcsdk-tools.git] / writer / nor / docs / README.txt
1 NOR Writer Utility
3 NOR Writer is a simple utility to program a CCS format image/data file to the NOR flash.
5 Steps to program the NOR:
7 1. Be sure to set the boot mode dip switch to no boot/EMIF16 boot mode on the EVM (please refer to the EVM technical 
8    reference manual on how to set the boot mode dip switchs)
10 2. Copy the CCS format data file to tools\writer\nor\evmc6xxxl\bin directory, and rename it to app.dat.
12 3. Change the file_name and start_addr in tools\writer\nor\evmc6xxxl\bin\norwriter_input.txt if necessary. 
13    By default the nor writer will load app.dat to DSP memory and write the data to NOR device start address 0.
15 4. Open CCSv5 and launch the evmc6xxx emulator target configuration and connect to core 0.
17 5. Load the program tools\writer\nor\evmc6xxxl\bin\norwriter_evm6xxxl.out to CCS, be sure evmc6xxxl.gel is used in CCS.
19 6. Open the Memory view (in CCSv5, view->Memory Browser), and view the memory address 0x80000000.
21 7. Load app.dat to 0x80000000:
22      * In CCSv5, right click mouse in memory window, select "load memory".
23      * Browse and select tools\writer\nor\evmc6xxxl\bin\app.dat.
24      * Select the option "Use the file header information to set the start address and size of the memory block to be 
25        loaded" and click "next".
26      * Change the Start Address to "0x80000000" if it is not 0x80000000, and click "finish".
28 8. After the data file is loaded into the memory, run the program (in CCSv5, press F8), it will start to program the 
29    NOR.
31 9. When programming is completed, the console will print "NOR programming completed successfully", if there
32    is any error, the console will show the error message.
35 Steps to re-build norwriter:
37 1. Import the norwriter CCS project from tools\writer\nor\evmc6xxxl directory (in CCSv5, Project->Import Existing CCS/
38    CCE Eclipse Projects).
40 2. Clean and build the norwriter project.
42 3. After the project build is completed, norwriter_evm6xxxl.out and will be generated under 
43    tools\writer\nor\evmc6xxxl\bin directory.