Changeset 425 for trunk/softs/tsar_boot/README.txt

Timestamp:

Jun 30, 2013, 8:28:58 PM (11 years ago)

Author:

cfuguet

Message:

Modifications in tsar_boot:

• Creating new files boot_utils.[c h] containing the memcpy, memset and some ELF format debug functions

• Introducing assert in the boot_elf_loader to show an error when some of segments to load conflicts with some of the pre-loader segments

• Cosmetic changes in boot_elf_loader to improve code readibility

• Fixing bug in dcache_buf_invalidate function used by boot_ioc_read when cache coherence not supported. The condition in the for loop was erroneous.

• Modification in Makefile: The SYSCLK_FREQ parameter is not passed anymore

as a Makefile parameter but it is definesd in the defs_platform.h file

File:

• trunk/softs/tsar_boot/README.txt (modified) (4 diffs)

trunk/softs/tsar_boot/README.txt

@@ -17 +17 @@
              the TTY, IOC and XICU devices.
              It defines also:
+
               -> CACHE_COHERENCE
                  This constant is used by the boot_ioc_read function to know
@@ -22 +23 @@
                  must be invalidated in the dcache after the transfert has
                  finished.
-                                 0 means invalidation must be made.
-
-              -> INSTRUMENTATION
-                 Set value different to 0 if some instrumentation of the
-                 bootloader is needed.
 
               -> CACHE_LINE_SIZE
+                 This constant is mandatory if CACHE_COHERENCE=0
                  This constant defines the size in bytes of a cache line.
+
+              -> BOOT_DEBUG
+                 Set value to 1 to show some debug messages during loading 
+
+              -> BOOT_DEBUG_IOC
+                 Set value to 1 to show some debug messages during loading
+                 concerning the disk accesses. 
 
               -> IRQ_PER_PROC
@@ -37 +41 @@
       --->  platform_soclib.dts:
 
-             Device tree file. It is mandatory if compiling
-             for a SOCLIB platform. If the application to execute does not use
-             a device tree file, create an empty one.
+             Device tree file. It is mandatory if compiling for a SOCLIB
+             platform and USE_DT=1.
 
       --->  platform_fpga.dts:
 
-             Device tree file. It is mandatory if compiling
-             for a FPGA platform. If the application to execute does not use
-             a device tree file, create an empty one.
+             Device tree file. It is mandatory if compiling for a FPGA platform
+             and USE_DT=1.
 
       --->  ldscript:
@@ -70 +72 @@
                    drivers
 
-             ---> SYSCLK_FREQ=<value hz>
+             ---> USE_DT=0
 
-                   If not SOCLIB platform, this flag allows us to choose the
-                   CLK frequency used in the hardware platform (i.e. FPGA).
-                   This information is used to configurate the SPI device
-                   which allow us to drive a SD card device.
+                   If a device tree file is not used, set this flag to 0. It
+                   is set by default to 1.
 
-              i.e. make PLATFORM_DIR=conf/<platform_dir> SYSCLK_FREQ=50000000
-                   make PLATFORM_DIR=conf/<platform_dir> SOCLIB=1
+              e.g. make PLATFORM_DIR=conf/<platform_dir> SOCLIB=1 USE_DT=0