前言
在嵌入式系统应用中,有时需要将常量或者函数放在代码闪存(Code Flash)的指定地址,以便后续的功能扩展或代码更新。
本文基于EK-RA4M2,详细介绍了如何在不同编译器环境下实现这一目标,涵盖GNU、LLVM、IAR和Arm Compiler6共四种编译器。
由于瑞萨电子RA系列开发基于FSP(Flexible Software Package),因此项目的构建均基于FSP生成的代码,对于第三方集成开发环境(IDE)像IAR EW for Arm和Keil MDK,则依赖RASC(RA Smart Configurator)创建项目。
对于所有支持的编译器来说,修改流程基本一致,主要包括以下步骤:
在链接脚本文件(Linker Script File)中添加新的自定义段(section),并指定地址范围(通常包括起始地址和大小)。由于FSP工程会在每次重新Generate Project Content时,重写相关的Linker Script File,因此需先备份原始文件,重命名后再进行修改。
使用特定关键字声明需要定位的函数/常量,将其放在新增section中。
在IDE中修改配置,使更新后的Linker Script File生效。
编译工程,通过生成的***.map文件确认相应标号已正确放置在目标地址。
假定目标是在RA4M2中Code Flash最高地址上新增两个section,一个用于存放函数,一个用于存放常量,由于高地址的Block Size为32K(8000h),因此两个section大小均设定为0x8000。
可以根据自己的实际需求调整,但一定考虑到改写内容时,最小的Erase/Program单元都是Block Size。
一、GNU编译器
首先,我们介绍在e2studio中使用GNU编译器时的操作步骤。
在e2studio中找到以下3个文件,在原始路径下复制并重命名:
scriptfsp.ld→scriptfsp_new.ld
Debugmemory_regions.ld→Debugmemory_regions_new.ld
Debugfsp_gen.ld→Debugfsp_gen_new.ld
第一步,编辑Debugmemory_regions_new.ld,文件开头增加以下内容,对标号赋值:
FLASH_USER_DATA_LENGTH=0x8000;
FLASH_USER_TEXT_LENGTH=0x8000;
由于已指定2个Block存储数据,用于其它内容Link的地址空间需要在此基础上去掉2个Block,更新FLASH_LENGTH并增加存储函数的TEXT section和存储常量的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文件的变动参考下图:

memory_regions_new.ld变更内容
第二步,修改fsp_gen_new.ld文件,MEMORY中增加FLASH_USER_DATA和FLASH_USER_TEXT,找到__flash_readonly$$(READONLY)【注意:此处是两个下划线】,其后增加.mydata和.mytext。
左右滑动查看完整内容
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变更内容
第三步,修改源码,将const类型变量和函数声明在新增.mydata和.mytext两个section中。增加函数定义。在hal_entry()中增加函数调用,避免优化。
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文件,使得改动后的Linker Script File(memory_regions_new.ld和fsp_gen_new.ld)生效。

fsp_new.ld变更点
最后一步,在e2studio中设置Linker Script File为fsp_new.ld。

更新Linker Script File为fsp_new.ld
完成上述所有步骤后,编译工程,目标函数和常量已经放在指定地址了,打开***.map文件,用常量和函数名作为关键字搜索,可以看到以下匹配:

***.map文件中常量和函数的编译地址
二、LLVM编译器
接下来,介绍在e2studio中使用LLVM编译器时的操作步骤。
在e2studio中找到3个文件,在原始路径下复制并重命名:
scriptfsp.lld→scriptfsp_new.lld
Debugmemory_regions.lld→Debugmemory_regions_new.lld
Debugfsp_gen.lld→Debugfsp_gen_new.lld
第一步,编辑Debugmemory_regions_new.lld,文件变动参考下图:

memory_regions_new.lld变更内容
第二步,修改fsp_gen_new.lld文件,参考下图:

fsp_gen_new.lld变更内容
第三步,修改源码,将const类型变量和函数声明在新增.mydata和.mytext两个section中。增加函数定义。在hal_entry()中增加函数调用,避免优化。
左右滑动查看完整内容
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));
左右滑动查看完整内容

第四步,按照以下方式更新fsp_new.lld文件,使得改动后的Linker Script File (memory_regions_new.lld和fsp_gen_new.lld)生效

fsp_new.lld变更点
最后一步,在e2studio中设置Linker Script File为fsp_new.lld

更新Linker Script File为fsp_new.lld
完成上述所有步骤后,编译工程,目标函数和常量已经放在指定地址了,打开***.map文件,用常量和函数名作为关键字搜索,可以看到以下匹配:

***.map文件中常量和函数的编译地址
三、IAR编译器
前面介绍的都是在瑞萨e2studio中使用GNU和LLVM的配置步骤,对于第三方IDE如IAR和Keil MDK,可以利用RASC(Renesas RA Smart Configurator)创建相应工程并修改。
对于IAR Project,在workspace的路径找到3个文件,在原始路径下复制并重命名:
scriptfsp.icf →[JX1] [JW2] scriptfsp_new.icf
memory_regions.icf → memory_regions_new.icf
fsp_gen.icf → fsp_gen_new.icf
第一步,编辑memory_regions_new.icf,文件变动参考下图:

memory_regions_new.icf变更内容
第二步,修改fsp_gen_new.icf文件,参考下图:

第三步,修改源码,将const类型变量和函数声明在新增.user_const和.user_text两个section中。增加函数定义。在hal_entry()中增加函数调用,避免优化。

代码中增加变量和函数声明
第四步,按照以下方式更新fsp_new.icf文件,使得改动后的Linker Script File (memory_regions_new.icf和fsp_gen_new.icf)生效

fsp_new.icf变更点
最后一步,在IAR EW for Arm 中设置Linker Script File为fsp_new.icf

更新Linker Script File为fsp_new.icf
特别提醒
在IAR中执行clean操作后,该配置会恢复为默认值(fsp.icf),需重新进行修改。
完成上述所有步骤后,编译工程,目标函数和常量已经放在指定地址了,打开***.map文件,用常量和函数名作为关键字搜索,可以看到以下匹配:

***.map文件中常量和函数的编译地址
四、Arm Compiler
对于Keil MDK工程,在工程路径找到3个文件,在原始路径下复制并重命名:
scriptfsp.scat → scriptfsp_new.scat
memory_regions.scat → memory_regions_new.scat
fsp_gen.scat → fsp_gen_new.scat
第一步,编辑memory_regions_new.scat,文件变动参考下图:

memory_regions_new.scat变更内容
第二步,修改fsp_gen_new.scat文件,参考下图:
找到关键字“LOAD_REGION_OPTION_SETTING_OFS0”在该段落前增加.my_data_setion和.my_text_section两个section。

fsp_gen_new.scat变更内容
第三步,修改源码,将const类型变量和函数声明在新增.my_data_section和.my_text_section两个section中。增加函数定义。在hal_entry()中增加函数调用,避免优化。
左右滑动查看完整内容

第四步,按照以下方式更新fsp_new.scat文件,使得改动后的Linker Script File(memory_regions_new.scat和fsp_gen_new.scat)生效

fsp_new.scat变更点
最后一步,在Keil MDK 中设置Linker >> Scatter File为fsp_new.scat

更新Linker Script File为fsp_new.scat
完成上述所有步骤后,编译工程,目标函数和常量已经放在指定地址了,打开***.map文件,用常量和函数名作为关键字搜索,可以看到以下匹配:

***.map文件中常量和函数的编译地址
关于const变量/函数定位到Code Flash指定地址的方法,我们已经在本文中,基于GNU、LLVM、IAR和Arm Compiler 6共四款主流编译器,做了完整的对比与说明。
理论讲清楚了,接下来就是实操环节啦。
我们也准备了对应的示例工程,方便你直接验证、复用:
示例工程
https://gitee.com/recn-mcu-ae/20260507rasectiongccllvmiarac6
-
mcu
+关注
关注
147文章
19285浏览量
405438 -
FlaSh
+关注
关注
10文章
1764浏览量
156253 -
瑞萨
+关注
关注
38文章
22549浏览量
91777 -
函数
+关注
关注
3文章
4424浏览量
68156 -
编译器
+关注
关注
1文章
1674浏览量
52131
原文标题:瑞萨RA MCU如何将常量和函数放在Code Flash/ROM指定地址
文章出处:【微信号:瑞萨嵌入式小百科,微信公众号:瑞萨嵌入式小百科】欢迎添加关注!文章转载请注明出处。
发布评论请先 登录
如何搭建瑞萨RA VS code开发环境
如何将某个函数或变量放在固定的地址 ?
【瑞萨RA6E2地奇星开发板试用】内部Code flash和Data flash写入数据并通过OLED显示
【RA-Eco-RA4M2开发板评测】+VS Code 下瑞萨 RA4M2 开发环境搭建与 GPIO 点灯实验教程
瑞萨RISC 32MCU Flash SuperH的相关资料推荐
IAR中如何定向把数组和函数放在指定的地址单元
瑞萨RA MCU如何将常量和函数放在Code Flash/ROM指定地址
评论