2. 如何安装e2 studio/Keil开发环境¶
本章配套视频介绍:
《02-如何安装e2studio&Keil开发环境》
https://www.bilibili.com/video/BV11z4y1J7DB/
2.1. e2 studio和Keil简介¶
e2 studio (简称为 e2 或 e2s)是瑞萨电子的一款包含代码开发、构建和调试的开发工具。 e2 studio 基于开源Eclipse IDE和与之相关的C/C++开发工具(CDT)。 e2 studio 托管了瑞萨的FSP灵活配置软件包,这是一个用于支持瑞萨MCU开发的固件库。 通过使用FSP库,我们可以轻松配置和管理瑞萨MCU,从而轻松实现复杂的应用程序。
Keil (也称为 Keil5、Keil MDK uVision5、MDK、MDK-ARM 等)是ARM官方的一款专为微控制器应用而设计的集成开发工具。 Keil 软件为基于 Cortex-M、Cortex-R0/R3/R4、ARM7、ARM9 处理器设备提供了一个完整的开发环境,功能强大,能够满足大多数的嵌入式应用。 我们在使用 Keil 软件开发瑞萨 RA MCU 时,为了方便配置芯片和生成FSP库代码, 需要配合 RA Smart Configurator (RASC) 软件一起使用。
RA Smart Configurator (简称为 RASC)是一款桌面应用程序,可为用户提供与集成到 e2 studio 中的 FSP 配置器(Smart Configurator)相同的功能。 借助 RASC,使用第三方工具链和 IDE (比如 Keil、IAR、GCC)的开发人员可以像 e2 studio 的用户一样, 以相同的方式访问软件系统(BSP、HAL 驱动程序、中间件、RTOS)的项目设置和图形化配置、引脚分配和时钟设置等。
2.2. 如何安装e2 studio开发环境¶
2.2.1. 获取e2 studio安装包¶
e2 studio 的下载页面为:https://github.com/renesas/fsp/releases。 我们可以找到在该页面的 Assets 栏下面发布的与 FSP 4.0.0 相关的软件工具, 其中就包含了 e2 studio 的安装程序,如下图。
例如:文件“setup_fsp_v4_0_0_e2s_v2022-07.exe”,其文件名表示安装程序包含的 FSP 库版本为 v4.0.0、e2s 版本为 v2022-07。
小技巧
e2 studio 软件的官方页面为:https://www.renesas.cn/cn/zh/software-tool/e-studio。 此页面下也包含了 e2s 最新版本的下载。
e2 studio 软件也可直接从野火提供的开发板配套资料中获取。
2.2.2. 安装e2 studio软件¶
e2s 的安装步骤如下。 首先双击 e2s 安装包,并且等待安装程序准备完成后,会弹出一个安装界面,如下图所示。
点击选中“Quick Install”,然后单击“Next”。接着稍等片刻,得到如下图所示的界面。
继续单击“Next”,得到如下图所示的界面。 然后勾上“I accept the terms of the Software Agreements”之后,单击“Install”即可开始安装。
在 e2s 软件安装完成之后,会弹出如下界面,最后点“OK”即可完成安装。
2.2.3. 新建启动e2 studio快捷方式¶
在安装路径下可以找到 e2 studio 的启动程序,如下图所示。 建议单击右键发送 e2 studio 启动程序的快捷方式到桌面上, 方便下一次可以直接在电脑桌面上双击图标来快速打开 e2 studio。
注解
关于 e2 studio 的软件汉化: e2s 安装完成后的软件界面默认是英文的,如果需要中文界面,则需要下载安装汉化语言包进行汉化。 语言包可以从 Eclipse 的网站(https://www.eclipse.org/babel/downloads.php)上下载下来,进行手动安装; 还有另一种安装语言包方法是在线安装,即不需要手动下载和安装,相对来说比较方便。 汉化的具体步骤请读者以“Eclipse配置国内镜像源”和“Eclipse汉化”这两个关键词进行搜索,这里不再赘述。
2.3. 如何安装Keil开发环境¶
注解
本小节内容所涉及的 Keil 软件只供教学使用,不得用于商业用途。个人或公司因商业用途导致的法律责任,后果需自行负责。
2.3.1. 获取Keil安装包、RA芯片包和RASC¶
Keil(MDK-ARM) 的下载页面为: https://www.keil.com/download/product/。
使用 Keil 软件开发瑞萨 RA MCU 还需要 RA 芯片包以及 RASC 软件,它们和 e2s 一样都可以在同一个下载页面获得。
Renesas Advanced Smart Configurator (RASC) 的下载页面为:https://github.com/renesas/fsp/releases。 在该页面下可以找到 RASC 的安装程序,还有 RA 芯片包。
例如:
“setup_fsp_v4_0_0_rasc_v2022-07.exe”,其文件名表示安装程序包含的 FSP 库版本为 v4.0.0、RASC 版本为 v2022-07。
“MDK_Device_Packs_v4.0.0.zip” 该压缩包解压之后得到文件“Renesas.RA_DFP.4.0.0.pack”, 即对应 FSP 4.0.0 版本的 RA 芯片包(适用于 Keil 软件)。
小技巧
注意:建议下载安装 Keil v5.30 以上的版本,因为版本过低可能导致后续的步骤提示“无法安装RA芯片包”的错误。 若安装RA芯片包时遇到此错误提示安装失败,请尝试重新安装较新版本的 Keil 软件之后,再重新安装RA芯片包。
上述软件也可直接从野火提供的开发板配套资料中获取。
2.3.2. 安装Keil软件、RA芯片包和RASC¶
Keil 软件和 RA 芯片包的安装只需双击它们的安装包然后根据提示进行安装即可,非常简单,在此不再赘述。 需要注意的是,需要先安装好 Keil 软件,然后再安装 RA 芯片包,因为这里的“芯片包”是作为 Keil 软件的一种组件而存在的。
RASC 的安装步骤如下。
首先双击 RASC 安装包,并且等待安装程序准备完成后,会弹出一个安装界面,如下图所示。
继续单击“Next”,得到如下图所示的界面。 然后勾上“I accept the terms of the Software Agreements”之后,单击“Install”即可开始安装。
在 RASC 软件安装完成之后,会弹出如下界面,最后点“OK”即可完成安装。
2.3.3. 新建启动RASC快捷方式¶
在安装路径下可以找到 RASC 的启动程序,如下图所示。 建议单击右键发送 RASC 启动程序的快捷方式到桌面上, 方便下一次直接在电脑桌面上双击图标快速打开 RASC。
注解
当 RASC 软件安装完成之后,还需要将 RASC 软件集成到 Keil 软件上面,方便使用。
2.3.4. 将RASC集成到Keil¶
本小节参考文档《RA Smart Configurator Quick Start Guide》, 该文档为安装RASC软件附带,可以从软件安装路径中找到:
“C:/Renesas/RA/sc_v2022-07_fsp_v4.0.0/eclipse/rasc_quick_start.html”
将 RASC 集成到 Keil 的具体步骤如下。
首先打开 Keil 软件,在菜单栏依次点击:“Tools”→“Customize Tools Menu”。
将弹出如下图所示的定制工具菜单的界面。
在“Menu Content”窗口中新建一个菜单项 “RA Smart Configurator”, 然后在“Command”一栏中输入 RASC 程序的路径,在“Initial Folder”一栏中输入 “$P”, 在“Arguments”一栏中输入:
--device $D --compiler ARMv6 configuration.xml
如下图所示。
同理,在“Menu Content”窗口中再次新建一个菜单项 “Device Partition Manager”, 然后在“Command”一栏中输入 RASC 程序的路径,在“Initial Folder”一栏中输入 “$P”, 在“Arguments”一栏中输入:
-application com.renesas.cdt.ddsc.dpm.ui.dpmapplication configuration.xml "$L%L"
最后再点击“OK”即可。
再次点开 Keil 软件菜单栏的“Tools”,我们可以看到 “RA Smart Configurator” 和 “Device Partition Manager” 这两个菜单项已经被加入到 Tools 栏上面了。
2.4. 如何更新开发环境的FSP库版本¶
更新 e2s 和 Keil/RASC 这两种开发环境的 FSP 库版本很简单,读者可以根据以下方式来进行更新。
首先打开 FSP 的发布页面(https://github.com/renesas/fsp/releases), 在这个网页下面定位到所需的 FSP 发布版本,以 FSP 4.0.0 版本为例, 在 Assets 栏下面发布了与 FSP 4.0.0 相关的工具软件,如下图所示。
- 对于 e2s 开发环境:
在 FSP 发布页面下载适用于 e2s 软件的 FSP 安装包, 比如“FSP_Packs_v4.0.0.exe”,它是 FSP v4.0.0 版本的 FSP 库安装包, 下载到本地之后双击该安装包根据提示进行安装即可。
- 对于 Keil/RASC 开发环境:
也是在 FSP 发布页面,需要下载适用于 Keil MDK 的芯片包, 比如“MDK_Device_Packs_v4.0.0.zip”,它包含 FSP v4.0.0 版本的芯片包; 同时还需要下载对应 FSP 版本 RASC 安装包,比如“setup_fsp_v4_0_0_rasc_v2022-07.exe”, 它是包含的 FSP v4.0.0 版本的 RASC 软件安装程序。 将相同 FSP 版本的芯片包和 RASC 安装程序都下载到本地之后分别双击打开根据提示进行安装即可。