Changeset 759 for trunk/softs/tsar_boot/README

Timestamp:

Jul 24, 2014, 4:38:36 PM (10 years ago)

Author:

cfuguet

Message:

tsar_boot: preloader ldscript is automatically generated

• Stack for processor 0 is allocated at the end of the cluster(0,0) ram segment:

SEG_RAM_BASE + SEG_RAM_SIZE - RESET_STACK_SIZE

• code base is equal to the SEG_ROM_BASE constant defined in the hard_config.h file.

File:

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

trunk/softs/tsar_boot/README

@@ -12 +12 @@
 driver/     Drivers source files and headers
 
-conf/       Platform specific files and ldscript
+conf/       Platform specific files
             For each platform, we must define a new directory.
             Mandatory files:
@@ -18 +18 @@
               - hard_config.h (can be generated using giet-vm genmap tool)
 
-              - ldscript
+                This file contains all physical segments addresses and sizes of the
+                hardware platform. It also contains other configuration definitions
+                as the disk controller type, mesh size, etc. Examples can be found
+                in the conf/ directory.
 
             Optional files:
@@ -27 +30 @@
             Mandatory arguments:
 
-              - PLATFORM_DIR=<platform_dir>
+              - HARD_CONFIG_PATH=<platform_dir>
 
-                Defines the directory where to find the plateform specific
-                files
+                Defines the directory where to find the hard_config.h file
 
            Optional arguments:
@@ -48 +50 @@
                 Platform device tree (by default is platform.dts)
 
+Important characteristics of this preloader:
+
+  - Processor 0 performs loading of Operating System Boot Loader which must
+    be an ELF file located at the third block of the disk.
+
+  - Other processors wait to be waken up through an interruption generated
+    from a XICU mailbox. Each processor other than 0 has its own mailbox
+    in the local XICU.
+
+  - Stack allocation is only made for processor 0. The loaded Operating System
+    boot loader or kernel must perform stack allocation for other processors.
+
+  - Stack for processor 0 is allocated at the end of RAM segment in the
+    cluster (0,0).
+
 Examples:
 
-    make PLATFORM_DIR=<platform_dir> USE_DT=0
+    make HARD_CONFIG_PATH=<platform_dir> USE_DT=0
 
         Compile for <platform_dir> and do not compile device tree file
 
-    make PLATFORM_DIR=<platform_dir> DTS=platform_fpga.dts SYSTEM_CLK=25000
+    make HARD_CONFIG_PATH=<platform_dir> DTS=platform_fpga.dts SYSTEM_CLK=25000
 
         Compile for <platform_dir> and compile the 'platform_dpga.dts'
         device tree file. System clock frequency is 25 MHz
 
-    make PLATFORM_DIR=<platform_conf> SYSTEM_CLK=25000
+    make HARD_CONFIG_PATH=<platform_conf> SYSTEM_CLK=25000
 
         Compile for <platform_dir> and compile the 'platform.dts'