readme

用于TM1300/PNX1300系列DSP（主要用于视频处理）的flash文件系统的程序源码。

This directory contains sample code for autonomous boot from flash
when this is managed by the TriMedia Flash File System software:

   L1 code resides in EEPROM and
   L2 code resides as a boot image in flash


1. For details on general issues about autonomous booting, 
   please see the section on "Bootstrapping TriMedia in 
   Autonomous Mode" in Part 3 of the CookBook, and the 
   examples under $TCS/examples/autoboot


2. There is one makefile in this directory -

     makefile.unix - for making l1.mi and l1.eeprom on Sun and HP.


3. The macros SDRAM_BASE and SDRAM_LIMIT can be modified to suit
   any customized TriMedia board design. The macros FLASH_BASE,
   SZOF_FLASH_BLOCK and NROF_FLASH_BLOCKS (where a flash block is
   considered to be the flash's eraseable unit) can be modified to suit
   any on board flash; the general assumption on this flash is
   that it is memory mapped in PCI space.

   To modify the macros, simply use a text editor and change the
   SDRAM_BASE value to match your board's SDRAM base address and
   the SDRAM_LIMIT value to the value of SDRAM_BASE plus the
   board's SDRAM memory size.

   NOTE: SDRAM_LIMIT should contain an address value that is
         just one byte beyond the highest SDRAM address.

         For example, if the SDRAM_BASE is 0xfe000000 and there
         are 4 mega bytes of SDRAM, then SDRAM_LIMIT should be
         set to  0xfe400000.

4. This boot code assumes that the flash contents are initialized
   to form a legal TriMedia Flash File System. An example
   of a program that creates such a TFFS is in the sibling directory
   $TCS/examples/flash_file_system/mkfs.

5. A Flash Specific driver must be exist. In General the BSP Flash 
   driver is used. However the BSP is too large to include
   in 2K boot program. Therefore a Flash specific driver must be 
   written specifically for booting. Example Flash drivers exists in 
   $TCS/examples/flash_file_system/sample_drivers. At the very
   minimum the Flash Drivers should contain the decalaration and
   initialization of the 'int's "SZOF_FLASH_BLOCK" & 
   "NROF_FLASH_BLOCKS", and the functions "FLASH_read" and 
   "FLASH_block_read".

6. The boot image residing in this flash can be written there as shown
   by the example in $TCS/examples/flash_file_system/writeboot

7. Compressed, self expanding boot images can be generated using the
   demo tool in $TCS/examples/compression/zlib/utilities/tmSEI

8. See also sibling_directory $TCS/examples/flash_file_system/all_together