概述
本文档仅介绍如何通过使用Eclipse、ARM-GCC编译工具、GNU-ARM插件、J-Link或AT-Link等资源来配置及调试AT32F403A的sLib,并提供sLib方案商开发算法范例及终端用户应用范例。关于AT32F403A的sLib详细介绍及说明,请详阅:
《AN0040_AT32F403A_407_Security_Library_Application_Note》。
环境说明:
本文档安装说明基于WINDOWS 7 x64系统下实现,开发板使用AT-START-F403A。
关于Eclips调试环境的安装及Eclipse工程的建立,请参阅《AN0033_Eclipse_with_GCC》。
本文档所使用的软件都打包到Setup_SLIB_with_Eclipse_and_GCC_V2.0.0.zip,直接解压重新编译后即可运行。
解压后Eclipse的workspace位于目录:
Setup_SLIB_with_Eclipse_and_GCC_V2.0.0\utilities\slib_with_eclipse_and_gcc_demo。
其中包含文件:
.metadata:此workspace的环境设定
project_l0:方案商开发算法范例
project_l1:终端用户应用范例
Project_L0方案商范例
在此阶段的范例程序,将完成下列几个项目:
-
将低通滤波器函数编译成可执行(executr-only)的代码;
-
将低通滤波器函数的代码编排放置到主闪存区地址0x08004000~0x08004FFF(sector8~9);
-
将低通滤波器函数的系数编排放置到主闪存区地址0x08005000~0x08005FFF(sector10~11);
-
验证成功后,将sector8~9设置为指令安全库区,将sector10~11设置为数据安全库区,此部分可在范例的主程序中以调用slib_enable()函数来完成,或使用Artery ICP Programmer来完成(建议使用ICP工具完成设置);
-
产出终端用户程序调用低通滤波函数时,需用到的头文件及符号定义文件。
产生只执行(Exacute-only)代码
设置方式如下:
1) 选择C文件群组或个别的C文件,范例中是把要保护的相关C文件都放在FIR_Filter群组,点击FIR_Filter群组内需要设置只执行的文件,按鼠标右键选择“Properties”
2) 点选C/C++Build->Settings->GNU ARM Cross C Complier->Miscellaneous,在”Other compiler flags”填入-mpure-code以及-mslow-flash-data这两个关键字,然后按Apply使设定生效
编排安全库区的地址
Project_L0范例的主闪存映像及RAM的使用分区如下图,RAM的分区主要是为了避免sLib保护区的代码与终端用户的代码用到相同的RAM而产生的冲突问题。
其中滤波器函数的代码编排放置到主闪存区的地址0x08004000~0x08004FFF(sector8~9),并将滤波器函数的系数编排放置到主闪存区的地址0x08005000~0x08005FFF(sector10~11)。RAM的部分则是将0x20000000到0x200000FF共256个字节保留给sLib保护区的代码使用。
步骤如下:
1) 依据”AT32F403AxC_FLASH.ld”linker descriptor文件做修改,编写一个ld文件,如project_l0\eclipse_gcc\ld目录下的slib.ld。
2) 在slib.ld当中,将主闪存及RAM分区划分如下:
3) 将算法代码放到.slib_inst section,低通滤波器的系数放到.slib_data section,并将算法使用到的全局变量指定到.slib_ram section,如下图:
4) 在Project->Properties->C/C++Build->Setting->GNU ARM Cross C Linker->General设定中的Script files,加入slib.ld。
5) 本范例会使用到gcc的数学运算函数库libm.a,在Properties->GNU ARM Cross C Linker->Miscellaneous设定中的Other linker flags填入--specs=rdimon.specs,linker才不会出现错误讯息。
关于ld文件的语法,可参考GNU linker的相关名文件。
产生头文件及符号定义文件
头文件(header file)跟符号定义文件(symbol definition file)是终端客户应用范例Project_L1在调用FIR低通滤波函数时需要用到。在范例中,就是main.c中包含的fir_filter.h文件。符号定义文件则是定义低通滤波函数的实际地址。
产生符号定义文件的方法:
1) 进入Project->Properties->C/C++Build->Setting的Build Steps设定画面。
在Post-build steps的命令行中输入以下命令:
arm-none-eabi-objcopy.exe--keep-symbols="..\keep_sym.txt"-S--remove-section=.ARM.attributes--extract-symbol"${BuildArtifactFileBaseName}.elf""..\fir_filter_symbol.sym"
2) 此处fir_filter_symbol.sym是要产出的符号定义文件,keep_sym.txt放在project_l0\eclipse_gcc目录下,是用来选择要产生哪些函数的符号,内容如下:
3) 重新编译整个项目后,在project_l0\eclipse_gcc目录下,就会产生一个名为fir_filter_symbol.sym的符号定义文件。
启用安全库区保护
要启用安全库区的保护功能,有以下两种方式:
1) 使用ICP刻录工具Artery ICP Programmer(建议用此方式)。
使用ICP Programmer启用sLib的方法,请参阅《AT32F403A Security Library Application Note》。
2) 使用范例程序main.c之中的slib_enable()函数。
在低通滤波函数测试正确后执行过一次此函数,就可以启用安全库区的保护功能。要执行此函数,只要在main.c中使能#define USE_SLIB_FUNCTION即可。
Project_L1终端用户范例
Project_L1范例会使用到在Project_L0中调试好,并已经被刻录到AT32F403A芯片的主闪存中且被sLib保护的FIR低通滤波器函数。根据Project_L0提供的头文件、符号定义文件以及主闪存区块映像,终端用户就可以参照Project_L1做到
-
建立一个应用项目;
-
引用Project_L0提供的头文件及符号定义文件到项目里;
-
调用FIR低通滤波器函数;
-
开发并调试用户自己的应用程序。
注:Project_L1必须使用跟Project_L0开发时一样的工具链及相同版本的编译程序,不然有可能会因为版本差异的兼容性问题,而无法使用Project_L0提供的代码。
建立用户的应用项目
因为Project_L0启用的安全库区已经占用了一些特定的主闪存页面,Project_L1的代码必须参照Project_L0提供的主闪存区块映像来编排放置的地址。其中sector8~11为安全库区所占用,终端用户需使用ld文件将这个区域隔离起来,避免代码在编译时被编排到这个区域内,方式如下:
参照project_l1\eclipse_gcc\ld目录下的end_user_code.ld文件,将主闪存空间切成两个区块FLASH_1及FLASH_2,中间空出来的区域就是sLib保护区。此外,RAM的区域也要保留0x20000000到0x200000FF的区域。如下图:
其中SLIB_CODE及SLIB_DATA两个区域,方案商已事先刻录代码,所以设定为NOLOAD,在下载Project_L1代码到主闪存时,就不会再次被下载。
在项目中加入符号定义文件
Project_L0所产生的符号定义文件fir_filter_symbol.sym必须被添加到Project_L1项目中,才能被正确的编译并链结到sLib保护区的代码。方法如下:
1) 将fir_filter_symbol.sym这个文件加到FIR_Filter群组;
2) 打开Project->Properties->C/C++Build->Settings->Tool Setting->GNU ARM Cross C Linker->Miscellaneous设定画面,在Other objects选单中加入此文件,在编译项目时就会可以被引用到。
来源:AT32 MCU 雅特力科技
免责声明:本文为转载文章,转载此文目的在于传递更多信息,版权归原作者所有。本文所用视频、图片、文字如涉及作品版权问题,请联系小编进行处理(联系邮箱:cathy@eetrend.com)。