Add NAND/NOR writer support and update POST for C6670
[keystone-rtos/mcsdk-tools.git] / post / docs / README.txt
1 Power On Self Test Utility
3 POST is a test program that can be programmed to I2C EEPROM and boot directly from I2C bus address 0x50 after POR.
4 It performs board specific tests, such as external memory test, NAND/NOR/EEPROM read test, LED test, etc.
6 Steps to build POST:
8 1. Import the POST CCS project from tools\post\evmc66xxl directory. (in CCSv5, Project->Import Existing CCS/
9    CCE Eclipse Projects)
11 2. Be sure the lite version of the Platform Lib is pre-built: 
12    pdk_C66xx_1_x_x_x\packages\ti\platform\evmc66xxl\platform_lib\lib\debug\ti.platform.evm6670l.lite.lib
13    If the lib is not pre-built, refer to Platform Lib User Guide under pdk_C66xx_x_x_x\packages\ti\platform\docs 
14    on how to build the platform library.
16    Note that the lite version of platform lib only contains the functions that are required by the POST, so that 
17    POST can be fit into the EEPROM.
19 3. Clean the POST project and re-build the project, after build is completed, post_evm66xxl.out and post_evm66xxl.map
20    will be generated under tools\post\evmc66xxl\bin directory.
23 Steps to run POST in CCSv5:
25 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 
26    reference manual on how to set the boot mode dip switches)
28 2. Load the program tools\post\evmc66xxl\bin\post_evm66xxl.out to CCS.
30 3. Connect the 3-pin RS-232 cable from the EVM to the serial port of the PC, and start Hyper Terminal.
32 4. Create a new connection with the Baud rate set to 115200 bps, Data bits 8, Parity none, Stop bits 1 and 
33    Flow control none. Be sure the COM port # is set correctly.
35 5. Run the program in CCS, POST will send the test status and result to the Hyper Terminal.
38 Steps to program POST to EEPROM:
40 1. Be sure that IBL romparse.exe is pre-built under tools\boot_loader\ibl\src\util\romparse, if IBL is not built,
41    refer to tools\boot_loader\ibl\doc\release_info.txt on how to build IBL for EVMC66xxL.
43 2. Go to the tools\post\evmc66xxl\bin directory in Windows Explorer and open the post_romparse.bat in a text editor, 
44    change "C6000_CG_DIR", "TARGET", "ENDIAN" and "IBL_ROOT_DIR" parameters accordingly and set the Cygwin PATH 
45    where you installed.
47 3. Double click post_romparse.bat. This will generate a CCS format image file "post_i2crom.dat", which can be programmed 
48    to I2C EEPROM slave bus address 80 (0x50), below are the steps how to program the EEPROM using the EEPROM writer utility:
50    * Copy post_i2crom.dat to tools\writer\eeprom\evmc66xxl\bin directory and rename it to "app.dat".
51    * Change bus_addr to "80" (0x50) in tools\writer\eeprom\evmc66xxl\bin\eepromwriter_input.txt and save the file.
52    * Refer to tools\writer\eeprom\evmc66xxl\docs\README.txt on how to program the CCS data file to EEPROM.
54 4. Once the programming is completed successfully, user can set the boot mode to I2C mode with bus address 0x50 
55    (please refer to the EVM technical reference manual on how to set the boot mode dip switches) and
56    boot the POST directly from the EEPROM after POR. The boot status and test result can be monitored using the Hyper
57    Terminal as mentioned in "Steps to run POST in CCSv5".