《DN8P1开发指南_V1.0》第七章 e²studio开发工具的使用

第七章 e²studio开发工具的使用

e²studio（常写为 e2 studio/e2s）是瑞萨电子官方、基于Eclipse的免费集成开发环境，专门用于瑞萨全系列MCU/MPU（含RA8P1）的开发、构建与调试。
本章将分为如下几个小节：
1，什么是e²studio
2，FSP图形化配置与使用
3，FSP开发助手

7.1 什么是e²studio
e²studio是瑞萨电子官方推出的、基于Eclipse/CDT深度定制的集成开发环境（IDE），专为瑞萨全系列MCU/MPU（RA、RZ、RL78、RX、RH850等）开发设计，是使用RA系列（包括 RA8P1）开发的推荐IDE。下面我们打开e²studio开发工具，并讲解这个开发工具的界面核心组成，如下图所示。

图7.1.1 e²studio界面

根据上图所示，我们把e²studio的FSP Configuration视图划分为6个功能区域，其中①、②、③为固定区域，其余为可变区域。
① 主菜单栏：
它是位于窗口最顶部，包含了文件(F)、编辑(E)、导航(N)、搜索(A)、项目(P)、瑞萨视图(V)、运行(R)、Renesas 365、Renesas AI、窗口(W)、帮助(H)等多种菜单配置。其作用是提供 IDE 全局控制能力，涵盖文件管理、编辑、搜索、窗口布局、项目配置、调试运行、官方支持与帮助文档等功能入口。
② 快捷工具栏：
它位于主菜单栏下方，提供用户保存文件、管理项目、编译工程和调试工程。
③ 透视图切换栏：
它位于窗口右上角，包含了C/C++、调试、FSP Configuration三个视图切换按钮，用于快速切换IDE工作模式。它们的作用如下：
C/C++：代码编辑视图，用于编写、修改用户代码。
调试：调试专用视图，用于单步、全速等调试操作，以及变量监控等。
FSP Configuration：配置视图，用于芯片、外设、堆栈、时钟的图形化配置。
④ 项目资源管理器：
它位于窗口左侧，用来管理当前工作空间内的所有工程与文件，直观展示工程目录结构。当然，我们可以点击工程右键新建项目、文件夹、源文件等操作，也可以导入现有工程。
⑤ FSP 配置主窗口：
它位于窗口中央，用来RA系列开发的核心配置界面，用于可视化配置芯片、外设、时钟等参数，并自动生成初始化代码。下面我们来看一下这个配置页面有哪些。
Summary：确认芯片型号、工具链版本。
BSP：配置基础启动参数。
Clocks：配置时钟树。
Pins：外设配置。
Interrupts：配置中断。
Event Links：配置硬件联动。
Stacks：添加外设堆栈配置。
Linker Sections：配置内存分段（双核/特殊需求时）。
点击Generate Project Content：生成代码。
⑥ 底部状态栏/辅助窗口：
它位于窗口底部，包含属性、问题、Smart Browser等标签页。下面我们来看一下这些标签页有啥作用：
属性：显示选中配置项的详细参数，支持直接修改。
问题：显示编译错误、警告、配置冲突信息。
Smart Browser：瑞萨官方文档、API手册、示例代码的快捷入口。
以上是e²studio IDE开发工具的简单页面描述，若大家想深入了解这个IDE开发工具，可进入瑞萨官方找到e²studio使用指南。下面，笔者讲解FSP图形化配置器的使用方式，了解这个配置器，我们基本上算是入门e²studio。

7.2 FSP图形化配置与使用
前面我们了解到，FSP图形化配置器是瑞萨e²studio 中RA系列MCU开发的核心工具，也是区别于通用IDE的标志性功能，专门用于可视化配置芯片底层参数并自动生成初始化代码。它是一个基于图形界面的零代码配置工具，集成在e²studio中，配合FSP固件包使用，支持从芯片级到外设级的全参数配置，最终一键生成标准的初始化代码、链接脚本和工程配置文件，彻底替代手动寄存器配置。
本节以基础例程11_24C02为例，结合e² studio与FSP图形化配置器，一步步完成IIC 外设配置、驱动生成与24C02读写功能实现。
1，硬件原理图
24C02是常用的IIC接口EEPROM存储芯片，采用标准两线IIC总线通信，硬件接线如下图所示。

图7.2.1 24C02B连接图

从上图所示，SDA（数据线）连接RA8P1的P409，而SCL（时钟线）连接RA8P1的P410。

2，FSP配置
打开e²studio开发工具，并设置工作空间地址，然后将18_24C02例程拷贝到工作空间的根目录下，并点击导入项目。如下图所示。

图7.2.2 导入项目工程

找到常规，点击 “现有项目到工作空间中”选项，并单击“下一步”，如下图所示。

图7.2.3 导入项目工程

在项目资源管理器打开工程，然后双击“configuration.xml”文件打开FSP配置图形，如下图所示。

图7.2.4 打开FSP配置图形

在FSP配置界面下，点击“clocks”选项配置时钟（参考现有的例程配置即可）。然后点击“Pins”配置IIC管脚，如下图所示。

图7.2.5 配置IIC管脚

单击SCL0和SDA0的③处箭头，配置该两个管脚为推挽模式，如下图所示。

图7.2.6 配置SCL0和SDA0为推挽模式

点击“Stacks”选项，并添加IIC堆栈，如下图所示。

图7.2.7 添加IIC堆栈

添加IIC堆栈完成后，点击IIC堆栈，且单击底部状态栏的“属性”，这样我们就可以配置IIC参数了，如下图所示。

图7.2.8 配置IIC0参数

上图中，我们配置了IIC0 7位地址是0x50，也就是24C02B的7位从机地址，然后配置回调函数和中断优先级。
注意：配置完成后，必须点击右上角的“Generate Project Content”生成代码。

3，编写IIC驱动
“Generate Project Content”生成代码后，可在项目资源管理器下“Developer Assistance”调用IIC函数，如下图所示。

图7.2.9 IIC函数

调用上图中的函数，就可以编写IIC驱动了。24C02B驱动，我们会在后面的实验章节中讲解。这里，笔者只教大家如何使用FSP图形化配置。

7.3 FSP开发助手
e²studio的项目资源管理器中，每个工程都会自动生成一个开发者助手（Developer Assistance）。它是一个专为当前工程配置打造的辅助工具集，能够大幅降低开发者查找资料、编写代码的门槛。
FSP开发助手特点：
新手快速上手：刚接触FSP开发时，通过助手可以快速了解每个外设支持的API，无需通读整个驱动手册。
代码快速编写：开发过程中，直接从助手拖拽API函数到代码编辑器，自动补全函数名、参数列表，减少拼写错误。
问题快速定位：遇到外设初始化失败、通信异常时，通过助手提供的文档链接与调试提示，快速定位配置问题。
复杂外设开发：对于 IIC、SPI、ADC等外设，助手提供的API列表，可直接查看API作用与各个传参的描述。
下面，我们以打开IIC API函数为例。通过点击API，然后通过推拉形式将函数拉到空白的代码段，这样就可以调用该函数了，如下图所示。

图7.3.1 推拉函数到代码段当中

然后，我们可以通过点击该函数，并在底部状态栏的“属性”当中，可以看到该API的作用与传参的描述，如下图所示。

图7.3.2 查看API的作用

通过这个工具，让我们在开发过程中无需频繁翻阅厚厚的芯片手册，也不用死记硬背API函数名。所有外设的可用接口、官方示例和说明文档都在工程内触手可及，不仅降低了开发门槛，还能大幅减少拼写错误和查阅资料的时间，让我们可以把更多精力放在业务逻辑的实现上，而不是反复核对底层驱动细节。
同时，它也为团队协作提供了便利——开发者助手的内容与当前工程的配置强绑定，团队成员打开工程就能看到所有外设的API列表和相关文档，减少了信息差，让项目交接和维护更加高效。