options: add support of using any file as linker script

Modify logic of LINKER_SCRIPT_FILE=xxx, the file provided in this option
now will be sent directly to linker.
Add LINKER_USE_TEMPLATE=0|1 toggle, when set to 1, LINKER_SCRIPT_FILE
will be treated as a template and be sent to compiler. It then generates .ldf
file as linker script.

Signed-off-by: Yuguo Zou <yuguo.zou@synopsys.com>

Author: YuguoWH

doc/documents/getting_started/makefile_manual.rst

@@ -78,7 +78,8 @@ In the following part of this manual, we will only use ``make`` in example, you
 	"  DIG_NAME=xxx                                - Specify Digilent JTAG which to be used, most useful when more than one Digilent USB-JTAG plugged in"
 	"  HEAPSZ=xxx                                  - Specify heap size for program, xxx stands for size in bytes"
 	"  STACKSZ=xxx                                 - Specify stack size for program, xxx stands for size in bytes"
-	"  LINKER_SCRIPT_FILE=xxx                      - Specify customized linker script (.ld .lcf), xxx stands for the relative path of linker script file to current directory"
+	"  LINKER_SCRIPT_FILE=xxx                      - Specify customized linker script, the script will be sent directly to linker. xxx stands for the relative path of linker script file to current directory"
+	"  LINKER_USE_TEMPLATE=0|1                     - If set this option to 1, then use LINKER_SCRIPT_FILE=xxx file as template and send it to compiler. Compiler only accept .ld .lcf files as template and will generate .ldf file as linker script"
 	"Example Usage:"
 	"  make all                                                                - build example in current directory using default configuration"
 	"  make BOARD=emsk BD_VER=22 CUR_CORE=arcem7d OLEVEL=O2 TOOLCHAIN=gnu all  - build example using configuration (emsk, 22, arcem7d, O2, gnu)"

options/rules.mk

@@ -135,7 +135,8 @@ help :
 	@$(ECHO) '  DIG_NUM=xxx                                 - Specify device serial number which to be used for OpenOCD, most useful when more than one device plugged in'
 	@$(ECHO) '  HEAPSZ=xxx                                  - Specify heap size for program, xxx stands for size in bytes'
 	@$(ECHO) '  STACKSZ=xxx                                 - Specify stack size for program, xxx stands for size in bytes'
-	@$(ECHO) '  LINKER_SCRIPT_FILE=xxx                      - Specify customized linker script (.ld .lcf), xxx stands for the relative path of linker script file to current directory'
+	@$(ECHO) '  LINKER_SCRIPT_FILE=xxx                      - Specify customized linker script, the script will be sent directly to linker. xxx stands for the relative path of linker script file to current directory'
+	@$(ECHO) '  LINKER_USE_TEMPLATE=0|1                     - If set this option to 1, then use LINKER_SCRIPT_FILE=xxx file as template and send it to compiler. Compiler only accept .ld .lcf files as template and will generate .ldf file as linker script'
 	@$(ECHO) 'Example Usage:'
 	@$(ECHO) '  make all                                                                - build example in current directory using default configuration'
 	@$(ECHO) '  make BOARD=emsk BD_VER=22 CUR_CORE=arcem7d OLEVEL=O2 TOOLCHAIN=gnu all  - build example using configuration (emsk, 22, arcem7d, O2, gnu)'
@@ -326,10 +327,14 @@ $(EMBARC_GENERATED_DIR)/$(GENE_MEMORY_X): $(EMBARC_GENERATED_DIR)/$(GENE_TCF)
 
 
 #####RULES FOR GENERATING LINK FILE FROM TEMPLATE#####
+ifeq ($(LINKER_USE_TEMPLATE), 1)
 .SECONDEXPANSION:
 $(APPL_LINK_FILE): $(LINKER_SCRIPT_FILE) $$(COMMON_COMPILE_PREREQUISITES)
 	$(TRACE_GEN_LINKFILE)
 	$(Q)$(CC) -c $(ALL_DEFINES) $(LINK_FILE_OPT) $< -o $@
+else
+APPL_LINK_FILE = $(LINKER_SCRIPT_FILE)
+endif
 
 #####RULES FOR GENERATING ELF FILE#####
 .SECONDEXPANSION:

options/toolchain.mk

@@ -25,6 +25,9 @@ VALID_TOOLCHAIN = $(call check_item_exist, $(TOOLCHAIN), $(SUPPORTED_TOOLCHAINS)
 ifneq ($(VALID_TOOLCHAIN), )
 COMMON_COMPILE_PREREQUISITES += $(EMBARC_ROOT)/options/toolchain/toolchain_$(VALID_TOOLCHAIN).mk
 include $(EMBARC_ROOT)/options/toolchain/toolchain_$(VALID_TOOLCHAIN).mk
+ifeq ($(LINKER_SCRIPT_FILE), )
+LINKER_USE_TEMPLATE ?= 1
+endif
 LINKER_SCRIPT_FILE ?= $(EMBARC_ROOT)/options/toolchain/linker_template_$(VALID_TOOLCHAIN).ld
 else
 $(info TOOLCHAIN - $(SUPPORTED_TOOLCHAINS) are supported)