在嵌入式系統(tǒng)應(yīng)用中，有時(shí)需要將常量或者函數(shù)放在代碼閃存（Code Flash）的指定地址，以便后續(xù)的功能擴(kuò)展或代碼更新。

本文基于EK-RA4M2，詳細(xì)介紹了如何在不同編譯器環(huán)境下實(shí)現(xiàn)這一目標(biāo)，涵蓋GNU、LLVM、IAR和Arm Compiler6共四種編譯器。

由于瑞薩電子RA系列開(kāi)發(fā)基于FSP（Flexible Software Package)，因此項(xiàng)目的構(gòu)建均基于FSP生成的代碼，對(duì)于第三方集成開(kāi)發(fā)環(huán)境（IDE）像IAR EW for Arm和Keil MDK，則依賴(lài)RASC（RA Smart Configurator）創(chuàng)建項(xiàng)目。

對(duì)于所有支持的編譯器來(lái)說(shuō)，修改流程基本一致，主要包括以下步驟：

在鏈接腳本文件（Linker Script File）中添加新的自定義段（section），并指定地址范圍（通常包括起始地址和大?。Ｓ捎贔SP工程會(huì)在每次重新Generate Project Content時(shí)，重寫(xiě)相關(guān)的Linker Script File，因此需先備份原始文件，重命名后再進(jìn)行修改。

使用特定關(guān)鍵字聲明需要定位的函數(shù)/常量，將其放在新增section中。

在IDE中修改配置，使更新后的Linker Script File生效。

編譯工程，通過(guò)生成的***.map文件確認(rèn)相應(yīng)標(biāo)號(hào)已正確放置在目標(biāo)地址。

假定目標(biāo)是在RA4M2中Code Flash最高地址上新增兩個(gè)section，一個(gè)用于存放函數(shù)，一個(gè)用于存放常量，由于高地址的Block Size為32K（8000h），因此兩個(gè)section大小均設(shè)定為0x8000。

可以根據(jù)自己的實(shí)際需求調(diào)整，但一定考慮到改寫(xiě)內(nèi)容時(shí)，最小的Erase/Program單元都是Block Size。

一、GNU編譯器

首先，我們介紹在e2studio中使用GNU編譯器時(shí)的操作步驟。

在e2studio中找到以下3個(gè)文件，在原始路徑下復(fù)制并重命名：

script\fsp.ld→script\fsp_new.ld

Debug\memory_regions.ld→Debug\memory_regions_new.ld

Debug\fsp_gen.ld→Debug\fsp_gen_new.ld

第一步，編輯Debug\memory_regions_new.ld，文件開(kāi)頭增加以下內(nèi)容，對(duì)標(biāo)號(hào)賦值：

FLASH_USER_DATA_LENGTH=0x8000;

FLASH_USER_TEXT_LENGTH=0x8000;

由于已指定2個(gè)Block存儲(chǔ)數(shù)據(jù)，用于其它內(nèi)容Link的地址空間需要在此基礎(chǔ)上去掉2個(gè)Block，更新FLASH_LENGTH并增加存儲(chǔ)函數(shù)的TEXT section和存儲(chǔ)常量的DATA section。

FLASH_LENGTH=0x00080000-FLASH_USER_DATA_LENGTH-FLASH_USER_TEXT_LENGTH;

FLASH_USER_DATA_START=FLASH_START+FLASH_LENGTH;

FLASH_USER_TEXT_START=FLASH_USER_DATA_START+FLASH_USER_DATA_LENGTH;

memory_regions_new.ld文件的變動(dòng)參考下圖：

memory_regions_new.ld變更內(nèi)容

第二步，修改fsp_gen_new.ld文件，MEMORY中增加FLASH_USER_DATA和FLASH_USER_TEXT，找到__flash_readonly$$（READONLY）【注意：此處是兩個(gè)下劃線】，其后增加.mydata和.mytext。

左右滑動(dòng)查看完整內(nèi)容

MEMORY{ RAM (rwx) : ORIGIN = RAM_START, LENGTH =RAM_LENGTH FLASH(rx) : ORIGIN = FLASH_START, LENGTH =FLASH_LENGTH FLASH_USER_DATA(rx) : ORIGIN = FLASH_USER_DATA_START, LENGTH =FLASH_USER_DATA_LENGTH FLASH_USER_TEXT(rx) : ORIGIN = FLASH_USER_TEXT_START, LENGTH =FLASH_USER_TEXT_LENGTH DATA_FLASH(rx) : ORIGIN = DATA_FLASH_START, LENGTH =DATA_FLASH_LENGTH QSPI_FLASH(rx) : ORIGIN = QSPI_FLASH_START, LENGTH = QSPI_FLASH_LENGTH
.mydata : { *(.rodata*) }> FLASH_USER_DATA .mytext : { *(.text*) }> FLASH_USER_TEXT

fsp_gen_new.ld變更內(nèi)容

第三步，修改源碼，將const類(lèi)型變量和函數(shù)聲明在新增.mydata和.mytext兩個(gè)section中。增加函數(shù)定義。在hal_entry()中增加函數(shù)調(diào)用，避免優(yōu)化。

const uint8_t test_data[8] BSP_PLACE_IN_SECTION(".mydata") = {0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07};

uint32_t test_function_fibonacci(uint32_t num) BSP_PLACE_IN_SECTION(".mytext") __attribute__((noinline));

第四步，按照以下方式更新fsp_new.ld文件，使得改動(dòng)后的Linker Script File（memory_regions_new.ld和fsp_gen_new.ld）生效。

fsp_new.ld變更點(diǎn)

最后一步，在e2studio中設(shè)置Linker Script File為fsp_new.ld。

更新Linker Script File為fsp_new.ld

完成上述所有步驟后，編譯工程，目標(biāo)函數(shù)和常量已經(jīng)放在指定地址了，打開(kāi)***.map文件，用常量和函數(shù)名作為關(guān)鍵字搜索，可以看到以下匹配：

***.map文件中常量和函數(shù)的編譯地址

二、LLVM編譯器

接下來(lái)，介紹在e2studio中使用LLVM編譯器時(shí)的操作步驟。

在e2studio中找到3個(gè)文件，在原始路徑下復(fù)制并重命名：

script\fsp.lld→script\fsp_new.lld

Debug\memory_regions.lld→Debug\memory_regions_new.lld

Debug\fsp_gen.lld→Debug\fsp_gen_new.lld

第一步，編輯Debug\memory_regions_new.lld，文件變動(dòng)參考下圖:

memory_regions_new.lld變更內(nèi)容

第二步，修改fsp_gen_new.lld文件，參考下圖：

fsp_gen_new.lld變更內(nèi)容

第三步，修改源碼，將const類(lèi)型變量和函數(shù)聲明在新增.mydata和.mytext兩個(gè)section中。增加函數(shù)定義。在hal_entry()中增加函數(shù)調(diào)用，避免優(yōu)化。

左右滑動(dòng)查看完整內(nèi)容

constuint8_ttest_data_0[8] BSP_PLACE_IN_SECTION(".mydata") = {0x00,0x01,0x02,0x03,0x04,0x05,0x06,0x07};constuint8_ttest_data_1[8] BSP_PLACE_IN_SECTION(".mydata") = {0x08,0x09,0x0A,0x0B,0x0C,0x0D,0x0E,0x0F};
uint32_ttest_function_fibonacci(uint32_t num)BSP_PLACE_IN_SECTION(".mytext") __attribute__((noinline));inttest_function_is_prime(int num)BSP_PLACE_IN_SECTION(".mytext") __attribute__((noinline));

左右滑動(dòng)查看完整內(nèi)容

第四步，按照以下方式更新fsp_new.lld文件，使得改動(dòng)后的Linker Script File （memory_regions_new.lld和fsp_gen_new.lld）生效

fsp_new.lld變更點(diǎn)

最后一步，在e2studio中設(shè)置Linker Script File為fsp_new.lld

更新Linker Script File為fsp_new.lld

完成上述所有步驟后，編譯工程，目標(biāo)函數(shù)和常量已經(jīng)放在指定地址了，打開(kāi)***.map文件，用常量和函數(shù)名作為關(guān)鍵字搜索，可以看到以下匹配：

***.map文件中常量和函數(shù)的編譯地址

三、IAR編譯器

前面介紹的都是在瑞薩e2studio中使用GNU和LLVM的配置步驟，對(duì)于第三方IDE如IAR和Keil MDK，可以利用RASC（Renesas RA Smart Configurator）創(chuàng)建相應(yīng)工程并修改。

對(duì)于IAR Project，在workspace的路徑找到3個(gè)文件，在原始路徑下復(fù)制并重命名：

script\fsp.icf →[JX1] [JW2] script\fsp_new.icf

memory_regions.icf → memory_regions_new.icf

fsp_gen.icf → fsp_gen_new.icf

第一步，編輯memory_regions_new.icf，文件變動(dòng)參考下圖:

memory_regions_new.icf變更內(nèi)容

第二步，修改fsp_gen_new.icf文件，參考下圖：

第三步，修改源碼，將const類(lèi)型變量和函數(shù)聲明在新增.user_const和.user_text兩個(gè)section中。增加函數(shù)定義。在hal_entry()中增加函數(shù)調(diào)用，避免優(yōu)化。

代碼中增加變量和函數(shù)聲明

第四步，按照以下方式更新fsp_new.icf文件，使得改動(dòng)后的Linker Script File （memory_regions_new.icf和fsp_gen_new.icf）生效

fsp_new.icf變更點(diǎn)

最后一步，在IAR EW for Arm 中設(shè)置Linker Script File為fsp_new.icf

更新Linker Script File為fsp_new.icf

特別提醒

在IAR中執(zhí)行clean操作后，該配置會(huì)恢復(fù)為默認(rèn)值（fsp.icf），需重新進(jìn)行修改。

完成上述所有步驟后，編譯工程，目標(biāo)函數(shù)和常量已經(jīng)放在指定地址了，打開(kāi)***.map文件，用常量和函數(shù)名作為關(guān)鍵字搜索，可以看到以下匹配：

***.map文件中常量和函數(shù)的編譯地址

四、Arm Compiler

對(duì)于Keil MDK工程，在工程路徑找到3個(gè)文件，在原始路徑下復(fù)制并重命名：

script\fsp.scat → script\fsp_new.scat

memory_regions.scat → memory_regions_new.scat

fsp_gen.scat → fsp_gen_new.scat

第一步，編輯memory_regions_new.scat，文件變動(dòng)參考下圖:

memory_regions_new.scat變更內(nèi)容

第二步，修改fsp_gen_new.scat文件，參考下圖：

找到關(guān)鍵字“LOAD_REGION_OPTION_SETTING_OFS0”在該段落前增加.my_data_setion和.my_text_section兩個(gè)section。

fsp_gen_new.scat變更內(nèi)容

第三步，修改源碼，將const類(lèi)型變量和函數(shù)聲明在新增.my_data_section和.my_text_section兩個(gè)section中。增加函數(shù)定義。在hal_entry()中增加函數(shù)調(diào)用，避免優(yōu)化。

左右滑動(dòng)查看完整內(nèi)容

第四步，按照以下方式更新fsp_new.scat文件，使得改動(dòng)后的Linker Script File（memory_regions_new.scat和fsp_gen_new.scat）生效

fsp_new.scat變更點(diǎn)

最后一步，在Keil MDK 中設(shè)置Linker >> Scatter File為fsp_new.scat

更新Linker Script File為fsp_new.scat

完成上述所有步驟后，編譯工程，目標(biāo)函數(shù)和常量已經(jīng)放在指定地址了，打開(kāi)***.map文件，用常量和函數(shù)名作為關(guān)鍵字搜索，可以看到以下匹配：

***.map文件中常量和函數(shù)的編譯地址

關(guān)于const變量/函數(shù)定位到Code Flash指定地址的方法，我們已經(jīng)在本文中，基于GNU、LLVM、IAR和Arm Compiler 6共四款主流編譯器，做了完整的對(duì)比與說(shuō)明。

理論講清楚了，接下來(lái)就是實(shí)操環(huán)節(jié)啦。

我們也準(zhǔn)備了對(duì)應(yīng)的示例工程，方便你直接驗(yàn)證、復(fù)用：

示例工程

https://gitee.com/recn-mcu-ae/20260507rasectiongccllvmiarac6