Changeset 759 for trunk

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.

Location:

trunk/softs/tsar_boot

Files:

• Makefile (modified) (6 diffs)
• README (modified) (4 diffs)
• conf/platform_de2_115_fpga/ldscript (deleted)
• conf/platform_tsar_generic_iob/ldscript (deleted)
• preloader.ld.in (added)

trunk/softs/tsar_boot/Makefile

@@ -1 @@
-# let the user have a default configuration (ie for PLATFORM_DIR)
+# let the user have a default configuration (ie for HARD_CONFIG_PATH)
 -include ./build.mk
 
@@ -8 +8 @@
 
 ifneq ($(MAKECMDGOALS),$(filter $(MAKECMDGOALS),clean distclean clean-doc doc))
-  ifndef PLATFORM_DIR
-    $(error please define PLATFORM_DIR 'make PLATFORM_DIR=foo')
+  ifndef HARD_CONFIG_PATH
+    $(error please define HARD_CONFIG_PATH 'make HARD_CONFIG_PATH=foo')
   else
-    $(info Make for $(PLATFORM_DIR))
+    $(info Make for $(HARD_CONFIG_PATH))
   endif
 endif
@@ -26 +26 @@
 AR         := mipsel-unknown-elf-ar
 RM         := rm -rf
+SED        := sed
 ECHO       := @echo
 MKDIR      := mkdir
@@ -38 +39 @@
 # =============================================================================
 
-INCLUDE    += -I. -Iinclude -Idrivers -I$(PLATFORM_DIR)
+INCLUDE    += -I. -Iinclude -Idrivers -I$(HARD_CONFIG_PATH)
 
 # =============================================================================
@@ -108 +109 @@
         ./version.sh > $@
 
-$(TARGET): $(BUILD_DIR) $(OBJS) $(PLATFORM_DIR)/ldscript $(BUILD_DIR)/platform.ld $(BUILD_DIR)/$(DRV_LIB)
+$(BUILD_DIR)/preloader.ld: preloader.ld.in
+        $(ECHO) "[   CC    ]     $(notdir $<)"
+        $(CC) -x c $(INCLUDE) -E $< | $(SED) -e '/#/d' -e '/^[\s\t]*$$/d' > $@
+
+$(TARGET): $(BUILD_DIR) $(OBJS) $(BUILD_DIR)/preloader.ld $(BUILD_DIR)/platform.ld $(BUILD_DIR)/$(DRV_LIB)
         $(ECHO) "[   LD    ]     $@"
-        $(LD) -o $@ -T $(PLATFORM_DIR)/ldscript $(OBJS) -L$(BUILD_DIR) -ldrivers
+        $(LD) -o $@ -T $(BUILD_DIR)/preloader.ld $(OBJS) -L$(BUILD_DIR) -ldrivers
         $(DU) -D $@ > $@.txt
 
@@ -123 +128 @@
 endif
 
-$(BUILD_DIR)/platform.dtb: $(PLATFORM_DIR)/$(DTS)
+$(BUILD_DIR)/platform.dtb: $(HARD_CONFIG_PATH)/$(DTS)
         $(ECHO) "[   DTC   ]     $(notdir $<)"
         ${DTC} -O dtb -o $@ $< &> /dev/null

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'