rt-thread-official/bsp/renesas/libraries/bsp-template
latercomer fe3c4d456e bsp中option env语句替换为新语句,并同步更新了source "$xxx"语句 2024-06-20 14:40:42 +08:00
..
board bsp中option env语句替换为新语句,并同步更新了source "$xxx"语句 2024-06-20 14:40:42 +08:00
ra [gcc][armcc][armclang] rtconfig.CROSS_TOOL->rtconfig.PLATFORM 2022-08-16 09:39:00 +08:00
ra_cfg [gcc][armcc][armclang] rtconfig.CROSS_TOOL->rtconfig.PLATFORM 2022-08-16 09:39:00 +08:00
ra_gen [gcc][armcc][armclang] rtconfig.CROSS_TOOL->rtconfig.PLATFORM 2022-08-16 09:39:00 +08:00
.config modify RT_ALIGN_SIZE as 8 by default 2023-01-12 22:47:23 -05:00
.gitignore [update] 添加 RA 系列 BSP 开发教程: (#5598) 2022-03-11 09:17:46 +08:00
.ignore_format.yml [update] 添加 RA 系列 BSP 开发教程: (#5598) 2022-03-11 09:17:46 +08:00
Kconfig bsp中option env语句替换为新语句,并同步更新了source "$xxx"语句 2024-06-20 14:40:42 +08:00
README.md [update] 添加 RA 系列 BSP 开发教程: (#5598) 2022-03-11 09:17:46 +08:00
SConscript [gcc][armcc][armclang] rtconfig.CROSS_TOOL->rtconfig.PLATFORM 2022-08-16 09:39:00 +08:00
SConstruct [Scons][iar][iccarm] IAR统一使用iccarm作为判断条件而不是是用IDE的名字来进行判断 2022-06-09 07:01:59 +08:00
rtconfig.h modify RT_ALIGN_SIZE as 8 by default 2023-01-12 22:47:23 -05:00
rtconfig.py [scons][iar] 将IAR的PLATFORM字段由iar调整为iccarm 2022-06-09 07:01:59 +08:00

README.md

瑞萨 CPK-RA6M4 开发板 BSP 说明

简介

本文档为瑞萨 CPK-RA6M4 开发板提供的 BSP (板级支持包) 说明。通过阅读快速上手章节开发者可以快速地上手该 BSP将 RT-Thread 运行在开发板上。

主要内容如下:

  • 开发板介绍
  • BSP 快速上手指南

开发板介绍

基于瑞萨 RA6M4 MCU 开发的 CPK-RA6M4 MCU 评估板,通过灵活配置软件包和 IDE可帮助用户对 RA6M4 MCU 群组的特性轻松进行评估,并对嵌入系统应用程序进行开发。

开发板正面外观如下图:

image-20211011174017429

该开发板常用 板载资源 如下:

  • MCUR7FA6M4AF3CFB200MHzArm Cortex®-M33 内核1MB 代码闪存, 256kB SRAM
  • 调试接口:板载 J-Link 接口
  • 扩展接口:两个 PMOD 连接器

更多详细资料及工具

外设支持

本 BSP 目前对外设的支持情况如下:

片上外设 支持情况 备注
UART 支持 UART7 为默认日志输出端口
GPIO 支持
IIC 支持 软件
WDT 支持
RTC 支持
ADC 支持
DAC 支持
SPI 支持
FLASH 支持
PWM 支持
CAN 支持
持续更新中...
外接外设 支持情况 备注
WiFi 模块 支持 RW007 WiFi 网络模块
温湿度传感器 支持 HS300x 温湿度模块
室内空气质量传感器 支持 zmod4410 室内空气质量模块
光线传感器 支持 isl29035光线传感器模块

使用说明

使用说明分为如下两个章节:

  • 快速上手

    本章节是为刚接触 RT-Thread 的新手准备的使用说明,遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上,看到实验效果 。

  • 进阶使用

    本章节是为需要在 RT-Thread 操作系统上使用更多开发板资源的开发者准备的。通过使用 ENV 工具对 BSP 进行配置,可以开启更多板载资源,实现更多高级功能。

快速上手

本 BSP 目前仅提供 MDK5 工程。下面以 MDK5 开发环境为例,介绍如何将系统运行起来。

硬件连接

使用 USB 数据线连接开发板到 PC使用 J-link 接口下载和 DEBUG 程序。使用 USB 转串口工具连接 UART7P613(TXD)、P614(RXD)。

编译下载

  • 编译:双击 project.uvprojx 文件,打开 MDK5 工程,编译程序。

注意:此工程需要使用 J-Flash Lite 工具烧录程序。建议使用 V7.50 及以上版本烧录工程。J-Link 下载链接

  • 下载:打开 J-Flash lite 工具,选择芯片型号 R7FA6M4AF点击 OK 进入工具。选择 BSP 目录下 MDK 编译出的 /object/ra6m4.hex 文件,点击 Program Device 按钮开始烧录。具体操作过程可参考下图步骤:

image-20211011181555421

image-20211011182047981

image-20211011182434519

image-20211011182949604

查看运行结果

下载程序成功之后,系统会自动运行并打印系统信息。

连接开发板对应串口到 PC , 在终端工具里打开相应的串口115200-8-1-N复位设备后可以看到 RT-Thread 的输出信息。输入 help 命令可查看系统中支持的命令。

 \ | /
- RT -     Thread Operating System
 / | \     4.0.4 build Oct 11 2021
 2006 - 2021 Copyright by rt-thread team

Hello RT-Thread!
msh >
msh >help
RT-Thread shell commands:
reboot           - Reboot System
help             - RT - Thread shell help.
ps               - List threads in the system.
free             - Show the memory usage in the system.
hello            - say hello world
clear            - clear the terminal screen
version          - show RT - Thread version information
list_thread      - list thread
list_sem         - list semaphore in system
list_event       - list event in system
list_mutex       - list mutex in system
list_mailbox     - list mail box in system
list_msgqueue    - list message queue in system
list_timer       - list timer in system
list_device      - list device in system
list             - list all commands in 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);
    }
}

进阶使用

资料及文档

FSP 配置

需要修改瑞萨的 BSP 外设配置或添加新的外设端口,需要用到瑞萨的 FSP 配置工具。请务必按照如下步骤完成配置。配置中有任何问题可到RT-Thread 社区论坛中提问。

  1. 下载灵活配置软件包 (FSP) | Renesas,请使用 FSP 3.5.0 版本
  2. 下载安装完成后,需要添加 CPK-RA6M4 开发板的官方板级支持包

打开 CPK-RA6M4 开发板详情页,在**“下载”**列表中找到 ”CPK-RA6M4板级支持包“,点击链接即可下载

  1. 如何将 **”CPK-RA6M4板级支持包“**添加到 FSP 中,请参考文档如何导入板级支持包
  2. 请查看文档:使用瑞萨 FSP 配置工具。在 MDK 中通过添加自定义命名来打开当前工程的 FSP 配置。

ENV 配置

此 BSP 默认只开启了 UART7 的功能,如果需使用更多高级功能例如组件、软件包等,需要利用 ENV 工具进行配置。

步骤如下:

  1. 在 bsp 下打开 env 工具。
  2. 输入menuconfig命令配置工程,配置好之后保存退出。
  3. 输入pkgs --update命令更新软件包。
  4. 输入scons --target=mdk5 命令重新生成工程。

FAQ

使用 MDK 的 DEBUG 时如果遇到提示 “Error: Flash Download failed Cortex-M33” 怎么办?

可按照下图操作,修改 Utilities 中的选项:

image-20211214102231248

联系人信息

在使用过程中若您有任何的想法和建议,建议您通过以下方式来联系到我们 RT-Thread 社区论坛

贡献代码

如果您对 CPK-RA6M4 感兴趣,并且有一些好玩的项目愿意与大家分享的话欢迎给我们贡献代码,您可以参考 如何向 RT-Thread 代码贡献