基于 RT-Thread Studio的CPK-RA6M4 开发环境搭建指南
转载于：基于 RT-Thread Studio的CPK-RA6M4 开发环境搭建指南
本文将使用瑞萨的 CPK-RA6M4 开发板介绍如何在 RA 系列 MCU 上让 RT-Thread 运行起来。开发环境的搭建将分为以下几个部分：
- RA 开发环境搭建
- 基于 RT-Thread Studio开发环境搭建
RA 开发环境搭建
- 灵活配置软件包 (FSP) ：
可快速配置开发板的外设功能，请使用 v3.5.0 版本，目前可在github上下载3.5.0版本（下载地址：https://github.com/renesas/fsp/releases/tag/v3.5.0 ，注意文件名称为：setup_fsp_v3_5_0_rasc_v2021-10.exe）
<注意官网为3.6.0版本，不向前兼容，使用3.6.0版本会会导致本工程不可用>
- CPK-RA6M4 板级支持包：
配合 FSP 一起使用，是开发板的图形化配置支持包,请使用 v3.5.0 版本
可在Renesas官网下载：
https://www2.renesas.cn/cn/zh/products/microcontrollers-microprocessors/ra-cortex-m-mcus/cpk-ra6m4-evaluation-board
-
网盘下载链接：
https://cowtransfer.com/s/b9eddec169d544 ，已包含 上述FSP 软件和 FSP 板级支持包，从此链接下载可一步到位。
灵活配置软件包 (FSP)
1、打开链接下载 FSP，请确认下载的 3.5.0 版本，从网盘下载可忽略此下载步骤。
目前 RT-Thread 中 CPK-RA6M4 的 BSP 支持的版本是 3.5.0。可以在 BSP 的 README 中确认目前支持的 FSP 版本。
2、找到下载的文件打开（注意文件名称包含为rasc）：setup_fsp_v3_5_0_rasc_v2021-10.exe
3、配置安装路径，安装完成后找到此路径，之后添加 CPK-RA6M4 板级支持包 时会用到
4、勾选 Licenese
5、点击 install 等待安装完成。
6、运行 rasc.exe，验证是否安装成功。路径：\eclipse\rasc.exe
7、成功启动后关闭即可，继续接下来的操作
CPK-RA6M4 板级支持包
此部分，你可以参考Renesas官网文档《向FSP中添加CPK评估板的BSP 》https://www2.renesas.cn/cn/zh/document/gde/1596896?language=zh&r=1527191
-
下载 3.5**.0 版本支持包**。从网盘下载可忽略此下载步骤。
-
在下载的支持包中可以找到以下三个文件
-
此时找到 FSP 的安装路径，进入 \internal\projectgen\ra\ ，将文件复制到对应的文件夹中。
-
再次打开 rasc.exe，查看是否添加成功。点击 next 进入工程创建
-
确认是否存在已添加的 CPK-RA6M4 开发板的支持包，此步骤仅为验证是否添加成功，不必继续创建工程，关闭即可。
-
到此基本将瑞萨开发板相关的环境搭建完成。调试器 J-link 的安装，在下面的步骤中介绍。
RT-Thread 开发环境搭建
基于 RT-Thread studio
下载安装必备软件环境
-
下载并安装 RT-Thread studio
-
打开 RT-Thread studio，进入包管理器，下载 RT-Thread 的 bsp 支持包及相关工具。
-
下载 BSP 支持包，勾选最新版即可。
PS:BSP 支持包会自动下载依赖的资源包：
-
-
RT-Thread 系统源码包
-
GCC工具链：版本 10.2.1
-
调试器 J-link：版本 7.50a
-
创建工程测试结果
1、打开 RT-Thread studio，新建 RT-Thread 项目 —> 基于开发板，创建CPK-RA6M4的工程
2、打开创建的工程，双击 RA Smart Configurator 即可打开刚刚安装的 FSP 配置工具
3、第一次打开需要配置 FSP 路径，选择到安装路径即可。确认可打开 FSP 即可关闭，先不做修改继续后续操作。
4、编译工程，确认工具链配置正确
5、接线：连接串口工具、USB-Jlink
6、连接 UART7 （TX:P613; RX:P614）,波特率 115200。此路串口用于 RT-Thread 系统命令行交互。
7、下载程序到开发板，注意下载的是 HEX 文件。
- 查看运行结果
下载程序成功之后，系统会自动运行并打印系统信息。
连接开发板对应串口到 PC , 在终端工具里打开相应的串口（115200-8-1-N），复位设备后，可以看到 RT-Thread 的输出信息。输入 help 命令可查看系统中支持的命令。
\ | /
- RT - Thread Operating System
/ | \ 4.1.0 build Jan 18 2022 18:48:37
2006 - 2021 Copyright by rt-thread team
Hello RT-Thread!
msh >
RT-Thread shell commands:
icu_sample - icu sample
list - list all commands in system
list_device - list device in system
list_timer - list timer in system
list_msgqueue - list message queue in system
list_mailbox - list mail box in system
list_mutex - list mutex in system
list_event - list event in system
list_sem - list semaphore in system
list_thread - list thread
version - show RT - Thread version information
clear - clear the terminal screen
hello - say hello world
free - Show the memory usage in the system.
ps - List threads in the system.
help - RT - Thread shell help.
reboot - Reboot System
msh >
- 应用入口函数
应用层的入口函数在 bsp\ra6m4-cpk\src\hal_emtry.c 中 的 void hal_entry(void) 。用户编写的源文件可直接放在 src 目录下。
void hal_entry(void)
{
rt_kprintf("\nHello RT-Thread!\n"); while (1)
{
rt_pin_write(LED3_PIN, PIN_HIGH);
rt_thread_mdelay(500);
rt_pin_write(LED3_PIN, PIN_LOW);
rt_thread_mdelay(500);
}
}
**关于RA系列MCU 相关资源可见：
**
-
RA系列MCU：
https://www2.renesas.cn/cn/zh/products/microcontrollers-microprocessors/ra-cortex-m-mcus
-
CPK-RA6M4 评估板页面：
https://www2.renesas.cn/cn/zh/products/microcontrollers-microprocessors/ra-cortex-m-mcus/cpk-ra6m4-evaluation-board -
RA系列MCU RT-Thread BSP：
https://github.com/RT-Thread/rt-thread/tree/master/bsp/renesas
-
RA系列RT-Thread驱动介绍：
https://github.com/RT-Thread/rt-thread/blob/master/bsp/renesas/docs/RA%E7%B3%BB%E5%88%97%E9%A9%B1%E5%8A%A8%E4%BB%8B%E7%BB%8D.md -
RA系列BSP外设驱动使用教程：https://github.com/RT-Thread/rt-thread/blob/master/bsp/renesas/docs/RA%E7%B3%BB%E5%88%97BSP%E5%A4%96%E8%AE%BE%E9%A9%B1%E5%8A%A8%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B.md
-
RA系列使用 FSP 配置外设驱动 https://github.com/RT-Thread/rt-thread/blob/master/bsp/renesas/docs/RA%E7%B3%BB%E5%88%97%E4%BD%BF%E7%94%A8FSP%E9%85%8D%E7%BD%AE%E5%A4%96%E8%AE%BE%E9%A9%B1%E5%8A%A8.md