1. 课程导入与开发环境搭建

Renesas RA 系列是瑞萨电子基于 Arm Cortex-M 内核打造的可扩展 MCU 家族，覆盖 Cortex-M23、M33、M4、M85 等内核，主频从 48 MHz 到 480 MHz 不等。它在低功耗物联网终端中的定位非常清晰：以 RA4、RA6 系列承担需要安全、低功耗与丰富外设的节点设备，例如智能表计、环境传感器、工业网关、可穿戴设备。RA 家族的关键优势在于统一的 FSP（Flexible Software Package）软件栈、可裁剪的 HAL 驱动、内置 TrustZone 与安全加密引擎，以及多种低功耗模式（Sleep、Software Standby、Snooze、Deep Software Standby）。这些特性决定了它适合做“长期电池供电 + 间歇唤醒 + 安全通信”的终端。

在开始写代码之前，需要先理解 RA 的开发工具链分工。e² studio 是集成开发环境，负责工程管理、编辑、编译、调试；FSP 是软件包，提供 BSP、HAL 驱动、中间件和 RTOS；RA Smart Configurator（RASC）是图形化配置工具，用于引脚、时钟、外设、堆栈和中断的配置，并自动生成初始化代码。三者关系可以理解为：RASC 生成配置代码，FSP 提供底层驱动，e² studio 负责构建与调试。下面这张图展示了从安装到点灯的完整工具链与数据流关系。

安装与创建工程

第一步是安装 e² studio。建议从瑞萨官网下载带 FSP 的安装包，安装时勾选 RA 系列器件支持包和 GCC Arm Embedded 工具链。安装完成后首次启动会要求选择工作区目录，建议路径不含中文和空格，例如 D:\RA_Workspace。接着安装 RA Smart Configurator，它通常随 e² studio 一起安装，也可以在独立安装后通过 e² studio 的“Renesas Views → RA Configurator”打开。

创建第一个 RA 项目时，选择 File → New → Renesas C/C++ Project → Renesas RA。在向导中依次选择目标器件（例如 R7FA4M2AD3CFP，即 RA4M2，Cortex-M33，100 MHz）、工程模板（选择“Flat Project”或“Bare Metal - Blinky”）、工具链（GCC Arm Embedded）和调试器（J-Link 或 E2 Lite）。工程创建完成后，RASC 会自动打开 configuration.xml，这是整个工程的配置中心。

在 RASC 中需要完成三项关键配置。第一是时钟：在“Clocks”页选择 HOCO 作为主时钟源，设置频率为 48 MHz，并确认系统时钟分频后 CPU 时钟为 48 MHz。第二是引脚：在“Pins”页找到 P405，将其功能设置为“GPIO Output”，初始电平为低。第三是堆栈：在“Stacks”页添加 GPIO Output (r_gpio) 模块，通道选择 P405，驱动能力设为 Low。配置完成后点击“Generate Project Content”，RASC 会生成 hal_data.c、pin_data.c 等文件。

点亮 LED 的代码实现

在 src/hal_entry.c 中编写主逻辑。FSP 的入口函数是 hal_entry()，它会在 BSP 初始化完成后被调用。下面是一段可直接参考的点灯代码，使用 R_IOPORT_PinWrite 控制 P405 电平，并用 R_BSP_SoftwareDelay 实现 500 ms 延时。

#include "hal_data.h"

void hal_entry(void)
{
    /* 初始化 IOPORT 模块 */
    R_IOPORT_Open(&g_ioport_ctrl, &g_bsp_pin_cfg);

    while (1)
    {
        /* P405 输出高电平，点亮 LED */
        R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_05,
                          BSP_IO_LEVEL_HIGH);
        R_BSP_SoftwareDelay(500, BSP_DELAY_UNITS_MILLISECONDS);

        /* P405 输出低电平，熄灭 LED */
        R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_05,
                          BSP_IO_LEVEL_LOW);
        R_BSP_SoftwareDelay(500, BSP_DELAY_UNITS_MILLISECONDS);
    }
}

编译工程后，通过调试配置下载到目标板。如果使用 E2 Lite，需要在“Debug Configurations”中选择对应的调试器，并确认 SWD 接口连接正确。复位运行后，观察开发板上的 LED1 是否以约 1 Hz 的频率闪烁。若 LED 不亮，优先检查 P405 是否与板上 LED 的阳极或阴极对应，以及初始电平配置是否与硬件电路一致。用示波器测量 P405 引脚，应看到周期约 1 s、占空比 50% 的方波。

低功耗视角下的环境检查

虽然本章只点亮一个 LED，但环境搭建阶段就要为后续低功耗开发做好准备。建议在工程创建后立即确认三件事：一是 FSP 版本与器件包版本匹配，避免后续低功耗 API 缺失；二是调试接口在量产版本中可关闭，以降低休眠电流；三是 BSP_DELAY_UNITS_MILLISECONDS 这类延时函数在低功耗模式下会阻塞 CPU，后续应替换为基于 SysTick 或 RTC 的事件驱动方式。下表给出本章环境搭建的检查清单，可直接用于自查。

完成以上步骤后，你已经拥有一个可编译、可下载、可观察的 RA 工程。这个工程虽然简单，但它包含了后续所有低功耗实验的基础结构：BSP 初始化、RASC 配置、FSP 驱动调用和调试下载链路。下一阶段将在这个工程上引入 Sleep 模式和 Snooze 模式，逐步把平均功耗从毫安级降到微安级。