瑞萨RA MCU众测宝典 | 环境搭建之【RA-Eco-RA4M2】基本模板搭建与LED

瑞萨“RA MCU众测宝典”环境搭建专题再添硬核实操！这次将解锁“基本模板搭建与LED”技能，加入简易调度器实现多任务管理，一步步搞定“能直接落地”的开发模板，不管是入门练手还是项目开发都能复用。

开启宝典

前言

本人因参加嵌赛而接触到瑞萨的新赛道，由此与瑞萨结缘。当时投入到学习瑞萨对我来说很新颖的开发环境。相较于传统开发方式，瑞萨自家的FSP库（类似于HAL库）极大简化了作品的开发流程，显著提高了开发效率，并提供了更高的灵活性。在完赛后本人也是深深爱上这种简便开发。

接下来，我们将开始对瑞萨基于Arm Cortex-M处理器内核的RA4M2-100pin进行系统学习与实验测试。

NO.1

开发环境准备

首先，引用以下文档：

点击查看大图

RAM2系列是比较主流化的类型之一，主打一个低功耗，基于48 MHz Arm Cortex-M33内核，适用于电池供电、物联网终端及其他对功耗敏感的应用场景。我们自己做一些一般的嵌入式产品也完全够用，我们测试的这一款是100pin脚的，有五六个串口，与独立I2C等等。

点击查看大图

那么这里推荐用官方开放软件e2s，你也可以上网搜下用keil教程；下载器的话，省时省力当时直接到立创商城买的官方下载器，瑞萨所有系列芯片都支持用，如果板子上有板载下载器还可以直接用串口下载，就是稍微麻烦点。

01

下载e2studio

e2studio软件的官方页面和github下载页面如下，可扫描二维码或复制链接到浏览器查看。

e2studio软件的官方页面

https://www.renesas.cn/cn/zh/software-tool/e-studio

github上有各种版本下载，下载页面如下

https://github.com/renesas/fsp/releases

点击查看大图

注意在最开始让选择是快速安装还是自定义安装，选快速安装，自己安装容易少下载一些固件，在后续编码时候容易出问题。

02

下载Flash Programmer

我使用Renesas Flash Programmer软件进行烧录hex程序，下载链接在官网，可扫描二维码或复制链接到浏览器查看。

Flash Programme下载链接

https://www.renesas.cn/zh/software-tool/renesas-flash-programmer-programming-gui

NO.2

模板准备

01

入门

首先打开e2s，新建文件：

点击查看大图

根据板子上的芯片，在Device中选择对应型号，注意下面的Toolchains中选择GNU，后面编译起来更方便。

点击查看大图

后面页面默认不修改，之后得到一个初步程序。

点击查看大图

首先根据板子主晶振，修改时钟：

点击查看大图

我这块板子上芯片所接的外部晶振是24Mhz的，可能有些是12Mhz的，在下面这里可以修改晶振的大小，还可以修改不同时钟线的频率，我一般用外部晶振比较多，注意在这个小齿轮页面做出的任何改动都要最终按右上角的生成键。

点击查看大图

点击查看大图

在这个页面里，首先修改成生成hex文件；其次这几个勾选上，不然后续串口输出编译会报错。

点击查看大图

点击查看大图

02

配置基本函数

模板里面，需要一些LED和基本的串口输出；因为HAL库虽然简便，但是也有弊端，程序出了问题很难找到原因，所以我习惯用LED和串口打印帮助排除问题；程序卡住LED可以直观让我知道具体卡在哪，串口则可以排除程序逻辑错误等等。

在src新建俩文件，在俩文件内新建LED和串口的.c.h文件。

点击查看大图

现在就可以去瑞萨特有的FSP库生成初始代码，先把烧录方式改成SWD；看原理图，这三个led灯接的pin脚，并且另一端是地，也就是给高电平是点亮，找到这几个pin脚，修改为外部输入模式OUTPUT。

点击查看大图

点击查看大图

点击查看大图

SCI里面找到和typeC一起的串口9，这样既可以供电也可以用来调试。

点击查看大图

点击查看大图

串口这里要注意在pin脚页面配置好后，还有配置Stack，会生成一个块，点击它，左下角属性里面，可以修改配置串口详细的所有基础信息，函数名，波特率，回调函数等等。

点击查看大图

所使用的UART属性描述

点击生成代码后旁边的资源里面，在HAL里面就会有相应你配置模块的函数，最常见一些OPEN，ENABLE等等，你可以直接拖动出来，使用这些函数，相当于帮你封装好了功能函数，你只需要根据需求修改封装函数的入口参数即可。

点击查看大图

03

key板块

首先是编写key常用封装函数，包括LED的开闭，反转以及定时闪烁。

点击查看大图

左右滑动查看完整内容

//LED单独开闭#define LED1_OFF R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_05, BSP_IO_LEVEL_LOW);#define LED1_ON R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_05, BSP_IO_LEVEL_HIGH);
#define LED2_OFF R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_04, BSP_IO_LEVEL_LOW);#define LED2_ON R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_04_PIN_04, BSP_IO_LEVEL_HIGH);
#define LED3_OFF R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_00_PIN_02, BSP_IO_LEVEL_LOW);#define LED3_ON R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_00_PIN_02, BSP_IO_LEVEL_HIGH);
//LED翻转#defineLED1_TURN R_PORT4->PODR ^=1 <<(BSP_IO_PORT_04_PIN_05 & 0xFF);#define LED2_TURN         R_PORT4->PODR ^=1 <<(BSP_IO_PORT_04_PIN_04 & 0xFF);#define LED3_TURN         R_PORT0->PODR ^=1 <<(BSP_IO_PORT_00_PIN_02 & 0xFF);
//LED闪烁函数#defineLED1_SHINE() R_PORT4->PODR ^=1 <<(BSP_IO_PORT_04_PIN_05 & 0xFF);\                             R_BSP_SoftwareDelay(500,BSP_DELAY_UNITS_MILLISECONDS);#define LED2_SHINE()            R_PORT4->PODR ^=1 <<(BSP_IO_PORT_04_PIN_04 & 0xFF);\                             R_BSP_SoftwareDelay(500,BSP_DELAY_UNITS_MILLISECONDS);#define LED3_SHINE()            R_PORT0->PODR ^=1 <<(BSP_IO_PORT_00_PIN_02 & 0xFF);\                             R_BSP_SoftwareDelay(500,BSP_DELAY_UNITS_MILLISECONDS);

开关函数（ON/OFF）

实现方式：调用瑞萨现成的库函数R_IOPORT_PinWrite；

工作原理：直接向指定的引脚写入明确的高电平或低电平信号，就像直接给灯下命令“开”或“关”；

特点：代码最清晰，可移植性好，但执行效率相对较低。

翻转函数（TURN）

实现方式：直接操作硬件寄存器。

工作原理：使用按位异或操作符^=。1 << (PIN号)会生成一个只有目标位为1的掩码，与该寄存器的当前值进行异或运算。

异或规则：相同为0，不同为1

效果：如果目标位当前是0（灯灭），异或后变为1（灯亮）；如果当前是1（灯亮），异或后变为0

特点：执行速度极快（直接操作寄存器），但代码可读性稍差，且高度依赖硬件，但我个人最喜欢用这个排除错误

闪烁函数（SHINE）

实现方式：翻转函数+阻塞延时。

工作原理：它其实是先做了一次翻转操作，然后立即调用一个延时函数R_BSP_SoftwareDelay。这个延时函数会让整个CPU停下来等待指定的时间（500毫秒）。

特点：

这是一个组合动作（翻转并延时）。

阻塞式：在延时的半秒内，CPU不能做任何其他事情。因此它通常需要放在循环里才能实现连续闪烁，并且不适合在需要同时处理多任务的系统中使用。

个人喜欢用这个解决程序堵塞。

将其放在.h文件内，在主函数中声明后，全局就都可以使用。

04

uart模块

回显输出

左右滑动查看完整内容

#include"debug.h"
voidUart9_Init(){ fsp_err_terr = FSP_SUCCESS;
//串口初始化 err =R_SCI_UART_Open(&g_uart9_ctrl, &g_uart9_cfg);
assert(FSP_SUCCESS == err);}

//R_SCI_UART_Write(&g_uart9_ctrl, p_src, bytes);//使用该函数后，标志位会被置位，使用时要及时在被置位后清零标志位，否则在连续调用时，会导致数据丢失

volatilebool uart_complete_flag =false;
voidcallback_uart9_debug(uart_callback_args_t*p_args){ switch(p_args->event) { caseUART_EVENT_RX_CHAR: { R_SCI_UART_Write(&g_uart9_ctrl, (uint8_t*)&(p_args->data),1); //当接受字符，出发中断，发送原字符 break; }
caseUART_EVENT_TX_COMPLETE: { uart_complete_flag=true; break; } default: break; }}

虽然Uart9_Init里面只有一行指令，但还是最好封装为一个函数，这样方便后续程序多起来后我们可以直观的理解与调用，也方便他人阅读。

这样编写好了串口的回显，为了后续可以直接用printf串口打印调试信息，我们还需要在debug.c中加入printf向串口的重定义。

左右滑动查看完整内容

//串口重定向//首先是条件编译，检查是否是GCC编译；根据条件选择使用哪种函数进行重定向#ifdefined __GNUC__ && !defined __clang__int_write(intfd,char*pBuffer,intsize);//防止编译警告int_write(intfd,char*pBuffer,intsize){ (void)fd; R_SCI_UART_Write(&g_uart9_ctrl,(uint8_t*)pBuffer,(uint32_t)size); while(uart_complete_flag ==false); uart_complete_flag =false;
returnsize;}#elseintfputc(intch, FILE *f){ (void)f; R_SCI_UART_Write(&g_uart9_ctrl,(uint8_t*)&ch,1); while(uart_complete_flag==false); uart_complete_flag =false;
returnch;}#endif

05

主函数部分

调度器

瑞萨主函数为hal_entry，你也可以理解为main。对于一般集成了较多的程序，我习惯使用调度器，可以自由直观的开闭需要的部分，后期对于大项目也可以试试用rtos。

左右滑动查看完整内容

#include"hal_data.h"#include"gpt/gpt.h"#include"key/key.h"#include"led/led.h"#include"debug/debug.h"

FSP_CPP_HEADERvoidR_BSP_WarmStart(bsp_warm_start_event_tevent);FSP_CPP_FOOTER

/*变量声明区*//*------------------------------------------------------*/uint32_tuwTick; //系统计时变量
/*------------------------------------------------------*/uint32_tKey_Val, Key_Down, Key_Up, Key_Old;
/*------------------------------------------------------*/
voidKey_Proc(){ Key_Val =Key_Read(); Key_Down = Key_Val & (Key_Old ^ Key_Val);// 按键按下检测 Key_Up = ~Key_Val & (Key_Old ^ Key_Val); // 按键抬起检测 Key_Old = Key_Val;
switch(Key_Down) { case3: LED1_TURN; break;
case4: LED2_TURN; break; }
}
voidLED_Proc(){ LED3_TURN;}

/* 调度器任务结构体定义 */typedefstruct{ void(*task_func)(void); // 任务函数 unsignedlongint rate_ms; // 任务执行周期（毫秒） unsignedlongint last_run;// 任务上次运行时间}task_t;
/* 调度器任务列表 */task_tScheduler_Task[] = {
{Key_Proc,10,0}, // 键盘任务，每10毫秒执行一次 {LED_Proc,1000,0}, // 数码管任务，每100毫秒执行一次

};
uint8_ttask_num=0;//任务数量
/* 调度器初始化 */voidScheduler_Init(void){ task_num =sizeof(Scheduler_Task) /sizeof(task_t);// 计算任务数量}
/* 调度器运行 */voidScheduler_Run(void){ uint8_ti=0; for(i =0; i < task_num; i++)  {    uint32_t now_time = uwTick; // 获取当前时间    if (now_time >= (Scheduler_Task[i].last_run + Scheduler_Task[i].rate_ms)) { Scheduler_Task[i].last_run = now_time;// 更新任务上次运行时间 Scheduler_Task[i].task_func(); // 执行任务 } }}

/*******************************************************************************************************************//*** main() is generated by the RA Configuration editor and is used to generate threads if an RTOS is used. This function* is called by main() when no RTOS is used.**********************************************************************************************************************/voidhal_entry(void){ /*TODO:add your own code here */
Scheduler_Init(); Uart9_Init();
System_Init(); while(1) { Scheduler_Run(); }#ifBSP_TZ_SECURE_BUILD /* Enter non-secure code */ R_BSP_NonSecureEnter();#endif}

功能

代码里我写了，LED3的调度器设定的时间，间隔闪烁。

1000毫秒的闪烁间隔：

而按键则是，按键sw1，sw2分别对着LED1和LED2，按下则反转一次。

NO.3

下载

然后准备的差不多了，就可以下载了，打开Flash Programmer，点击左上角file，新建立一个。

按照这样选：

点击查看大图

这里推荐给SWD下载这里做个段子，一来方便下载，二来这里要注意SWDIO,SWCLK两条线要接紧一点，不然老下不下去。

点击查看大图

这样就下载成功了。

如果在FSP配置、调度器编写或下载调试中遇到问题，或是有模板优化、功能扩展的巧思，欢迎在评论区分享交流～

环境搭建专题会持续覆盖更多RA系列开发板的实操指南，关注瑞萨嵌入式小百科，让嵌入式开发“从0 到1”更高效，后续还能解锁更多项目模板和避坑技巧！