Loading...
/* * Copyright (c) 2020, Synopsys, Inc. * * SPDX-License-Identifier: Apache-2.0 */ /** * @file * @brief Metware toolchain linker defs * * This header file defines the necessary macros used by the linker script for * use with the metware linker. */ #ifndef ZEPHYR_INCLUDE_LINKER_LINKER_TOOL_MWDT_H_ #define ZEPHYR_INCLUDE_LINKER_LINKER_TOOL_MWDT_H_ /* * mwdt linker doesn't have the following directives */ #define ASSERT(x, y) #define SUBALIGN(x) ALIGN(x) /* * The GROUP_START() and GROUP_END() macros are used to define a group * of sections located in one memory area, such as RAM, ROM, etc. * The <where> parameter is the name of the memory area. */ #define GROUP_START(where) #define GROUP_END(where) /* * The GROUP_LINK_IN() macro is located at the end of the section * description and tells the linker that this section is located in * the memory area specified by <where> argument. */ #define GROUP_LINK_IN(where) > where /** * The GROUP_ROM_LINK_IN() macro is located at the end of the section * description and tells the linker that this a read-only section * that is physically placed at the 'lregion` argument. * */ #define GROUP_ROM_LINK_IN(vregion, lregion) > lregion /* * As GROUP_LINK_IN(), but takes a second argument indicating the * memory region (e.g. "ROM") for the load address. Used for * initialized data sections that on XIP platforms must be copied at * startup. * * And, because output directives in GNU ld are "sticky", this must * also be used on the first section *after* such an initialized data * section, specifying the same memory region (e.g. "RAM") for both * vregion and lregion. */ #ifdef CONFIG_XIP #define GROUP_DATA_LINK_IN(vregion, lregion) > vregion AT > lregion #else #define GROUP_DATA_LINK_IN(vregion, lregion) > vregion #endif /** * Route memory for read-write sections that are NOT loaded; typically this * is only used for 'BSS' and 'noinit'. */ #ifdef CONFIG_XIP #define GROUP_NOLOAD_LINK_IN(vregion, lregion) > vregion AT > vregion #else #define GROUP_NOLOAD_LINK_IN(vregion, lregion) > vregion #endif /* * The SECTION_PROLOGUE() macro is used to define the beginning of a section. * The <name> parameter is the name of the section, and the <option> parameter * is to include any special options such as (NOLOAD). Page alignment has its * own parameter since it needs abstraction across the different toolchains. * If not required, the <options> and <align> parameters should be left blank. */ #define SECTION_PROLOGUE(name, options, align) name options align : /* * As for SECTION_PROLOGUE(), except that this one must (!) be used * for data sections which on XIP platforms will have differing * virtual and load addresses (i.e. they'll be copied into RAM at * program startup). Such a section must (!) also use * GROUP_LINK_IN_LMA to specify the correct output load address. */ #ifdef CONFIG_XIP #define SECTION_DATA_PROLOGUE(name, options, align) \ name options ALIGN(8) align : #else #define SECTION_DATA_PROLOGUE(name, options, align) name options align : #endif #define SORT_BY_NAME(x) SORT(x) #endif /* ZEPHYR_INCLUDE_LINKER_LINKER_TOOL_MWDT_H_ */ |