RT-Thread 瑞萨 RA 系列 BSP 全解析：开发板支持矩阵、外设驱动配置与 FSP 实战指南

操作系统嵌入式物联网嵌入式OSRTOS【免费下载链接】rt-threadRT-Thread is an open source IoT Real-Time Operating System (RTOS). https://rt-thread.github.io/rt-thread/项目地址https://gitcode.com/gh_mirrors/rt/rt-thread点击查看免费下载RT-Thread 官方仓库在bsp/renesas目录下维护了面向瑞萨 RA 系列RA2/RA4/RA6/RA8与 RZ 系列 MCU 的完整板级支持包BSP集合覆盖 Renesas 官方评估板与 RT-Thread 联合开发板。本文以 bsp/renesas/README.md 为主线系统梳理各 BSP 的定位、配套文档体系并结合仓库源码与 docs 目录下的教程演示如何使用 ENV/menuconfig 与 FSP 工具为这些 BSP 添加 UART、SPI、ADC、PWM、CAN 等外设驱动帮助读者快速选板、上手并完成从最小系统到完整外设的工程扩展。1. RA 系列 BSP 支持矩阵bsp/renesas目录下按芯片系列与开发板组织 BSP 工程每个子目录都是一个独立可编译的 RT-Thread 工程包含Kconfig、SConstruct、SConscript、project.uvprojxMDK5 工程、board/、src/、ra_gen/、ra_cfg/等标准结构。当前支持情况如下BSP 文件夹名称开发板名称RA6 系列ebf_qi_min_6m5野火 启明6 开发板ra6m4-cpkRenesas 官方 CPK-RA6M4 开发板ra6m4-iotRenesas 官方 IOT-RA6M4 开发板ra6m3-ekRenesas 官方 RA6M3-EK 开发板ra6m3-hmi-boardRenesas 联合 RT-Thread RA6M3-HMI-Board 开发板RA4 系列ra4m2-ecoRenesas 官方 RA-Eco-RA4M2 开发板RA2 系列ra2l1-cpkRenesas 官方 CPK-RA2L1 开发板RA8 系列ra8m1-ekRenesas 官方 EK-RA8M1 开发板ra8d1-ekRenesas 官方 EK-RA8D1 开发板ra8d1-vision-boardRenesas 联合 RT-Thread RA8D1-Vision-Board 开发板ra8p1-titan-boardRenesas 联合 RT-Thread RA8P1-Titan-Board 开发板RZ 系列rzt2m_rskRenesas 官方 RSK-RZT2M 开发板rzn2l_rskRenesas 官方 RSK-RZN2L 开发板除上述表格外仓库中还包含更多处于不同维护阶段的 BSP 目录如ra2a1-ek、ra2e2-ek、ra4e2-eco、ra4e2-ek、ra4m1-ek、ra6e2-ek、ra6e2-fpb、ra6w1-ek、rzn2l_etherkit等每个 BSP 的 README 都给出了该开发板的板载资源、外设支持情况与上手步骤。从仓库源码结构看这些 BSP 共享同一套底层驱动实现bsp/renesas/libraries/HAL_Drivers/drivers 目录下集中存放了drv_adc.c、drv_can.c、drv_dac.c、drv_flash.c、drv_gpio.c、drv_i2c.c、drv_pwm.c、drv_rtc.c、drv_sci.c、drv_sdhi.c、drv_spi.c、drv_timer.c、drv_usart_v2.c、drv_wdt.c等驱动文件BSP 的Kconfig通过rsource ../libraries/Kconfig见 ra6m4-cpk/Kconfig引入统一的片上外设配置项实现了一个驱动库、多块开发板复用的架构。2. 配套文档体系导航每个 BSP 的 README 都可以帮助快速上手而更深入的外设开发、BSP 定制则参考bsp/renesas/docs下的说明文档BSP 使用教程简介外设驱动使用教程讲解 BSP 上更多外设驱动的使用方法外设驱动介绍与应用讲解 RA 系列 BSP 驱动的支持情况以及如何利用驱动框架开发应用程序使用 FSP 配置外设驱动介绍如何使用 FSP 工具添加和配置外设BSP 制作与提交简介BSP 制作教程讲解 RA 系列 BSP 的制作方法以及在制作 BSP 和提交 BSP 时应当遵守的规范外设驱动添加指南讲解 BSP 添加更多设备驱动的方法英文文档同步维护于同目录下BSP Peripheral Driver Tutorial of RA Series、Introduction to RA Series Drives、RA Series Uses FSP to Configure Peripheral Drivers、Building a BSP for the RA Series Dev Board、Peripheral Driver Addition Guide of RA Series。此外个别 BSP 还带有关键特性的专题文档例如 ra2l1-cpk/docs/Captouch板载触摸按键配置说明.md、ra2l1-cpk/docs/LPM低功耗配置说明.md、ra6m3-ek/docs/lvgl使用文档.md、ra6m4-iot/docs/使用PPP方式上网.md可按需查阅。3. 驱动体系三类外设与 I/O 设备管理框架在 RT-Thread 实时操作系统中各种设备驱动通过一套 I/O 设备管理框架统一管理框架为上层应用提供标准设备操作 API开发者通过调用这些标准 API 即可高效地与底层硬件外设交互应用层无需关心芯片寄存器细节。按位置与作用一个 RA BSP 涉及的驱动分为三类见 RA系列驱动介绍板载外设驱动Onboard Peripheral DriversMCU 之外、开发板上自带的外设例如 TF 卡、以太网、板载传感器等片上外设驱动On-chip Peripheral DriversMCU 芯片内部外设例如硬件定时器、ADC、看门狗、串口等扩展模块驱动Board extended module Drivers通过扩展接口或杜邦线外接的模块例如 SPI 接口的 RW007 WiFi 模块。RA 系列 BSP 当前已支持的片上外设驱动包括 GPIO、UART、I2C软件 I2C、SPI、ADC、SDIO、TIMER硬件定时器、PWM、RTC、WDT、QSPI板载外设包括 I2C 传感器与 SD(TF) 卡扩展模块包括 RW007SPI 接口 WiFi 模块、HS300xI2C 温湿度传感器、ZMOD4410I2C 室内空气质量传感器等。仓库中对应的驱动实现位于 bsp/renesas/libraries/HAL_Drivers/drivers例如串口驱动 drv_sci.c、SPI 驱动 drv_spi.c、SDHI 驱动 drv_sdhi.c。驱动示例代码位于仓库根目录examples/test下在 ENV 中开启要测试的驱动后将对应驱动框架测试文件加入工程即可快速验证 BSP 中的驱动功能。4. 以 CPK-RA6M4 为例快速上手与外设支持以 ra6m4-cpk 为例该开发板基于瑞萨 RA6M4 MCUR7FA6M4AF3CFB200 MHz Arm Cortex-M33 内核1 MB 代码闪存、256 kB SRAM板载 J-Link 调试接口与两个 PMOD 扩展连接器。该 BSP 的外设支持情况如下片上外设支持情况备注UART支持UART7 为默认日志输出端口GPIO支持IIC支持软件WDT / RTC / ADC / DAC / SPI / FLASH / PWM / CAN支持SEGGER_RTT支持打开默认 segger_rtt 为 console快速上手步骤以 MDK5 为例硬件连接使用 USB 线连接开发板到 PCJ-Link 接口下载/调试用 USB 转串口工具连接 UART7 的 P613(TXD)、P614(RXD)编译双击 BSP 目录下的project.uvprojx打开 MDK5 工程并编译下载点击 Debug 按钮下载调试也可用 J-Flash Lite建议 V7.50 及以上选择芯片型号 R7FA6M4AF烧录 MDK 编译产物object/ra6m4.hex查看结果终端打开对应串口115200-8-1-N复位后可见 RT-Thread 启动信息输入help查看支持的命令list_device可查看系统中注册的设备。应用入口应用层入口函数位于 bsp/renesas/ra6m4-cpk/src/hal_entry.c 的void hal_entry(void)用户编写的源文件可直接放在src目录下#define LED3_PIN BSP_IO_PORT_01_PIN_06 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); } }该函数以rt_pin_write配合rt_thread_mdelay实现了典型的 GPIO 翻转闪灯逻辑是理解 RT-Thread 引脚驱动与线程延时 API 的最小示例。类似地ra8d1-vision-board/src/hal_entry.c 中通过#define LED_PIN BSP_IO_PORT_01_PIN_02定义 P102 引脚控制板载 RGB-LED共阳 LED阴极接单片机引脚输出低电平点亮。5. 使用 ENV 与 menuconfig 开启外设驱动开发板默认只开启了最小系统通常仅 UART 日志更多外设需通过 ENV 工具配置。以 CPK-RA6M4 上开启 SPI 为例完整流程见 RA系列BSP外设驱动使用教程打开配置界面在 BSP 目录下打开 ENV输入menuconfig进入配置界面进入硬件驱动配置菜单选中Hardware Drivers Config回车其下包含板载外设配置菜单、片上外设配置菜单与扩展模块配置菜单三个选项选择对应菜单进入开启外设选项在片上外设或板载外设菜单中找到 SPI 相关选项并开启例如 SPI Flash / SPI 总线保存退出右移光标选中Save回车保存按Esc退出配置工具重新生成工程输入scons --targetmdk5重新生成 MDK5 工程若使用 GCC/其他工具链可替换为对应 targetFSP 添加外设在 FSP 中配置 SPI1 端口引脚注意SSLx 片选引脚应设为 None片选由驱动程序中软件控制编译验证FSP 配置完成后新增文件不会立即加入工程首次编译若弹出导入变更提醒选择是后再次编译编译成功下载运行后输入list_device即可看到名为spi1的总线设备。菜单项的底层来源是各 BSP 的Kconfig与共享驱动库的 HAL_Drivers/drivers/Kconfig每个外设驱动对应一个RT_USING_XXX之类的开关宏menuconfig 的勾选结果会写入rtconfig.h进而由 SConscript 决定是否编译对应drv_xxx.c。6. 使用 FSP 添加与配置各类外设瑞萨外设的引脚分配、中断通道、时钟等需要通过 FSPFlexible Software Package/ RASC 配置工具生成底层代码。BSP 的configuration.xml、ra_gen/、ra_cfg/目录即由 FSP 生成。完整的分外设配置步骤见 RA系列使用FSP配置外设驱动.md要点如下准备工作在 MDK 中通过Tools - Customize Tools Menu…添加自定义命令 RA Smart ConfiguratorCommand 指向安装目录下的rasc.exeInitial Folder 填$PArguments 填--device $D --compiler ARMv6 configuration.xml保存后即可通过Tools - RA smart Configurator打开配置工具。务必检查 FSP 版本、Board、Device 配置项RA 系列已更新 FSP 3.5.0 版本支持旧版本可能存在兼容性问题RA8 系列 BSP 使用 FSP 5.1.0例如 ra8d1-vision-board。各类外设添加要点所有外设均遵循RT-Thread 驱动命名约定name/channel/callback 需保持编号一致UART在 Stacks 配置页新建 UART stack将 name、channel、callback 设置为一致的标号如g_uart7/7/uart7_callback以适配 RT-Thread 驱动中的命名GPIO 中断在 Pins 中选中引脚如 P105查看其可映射的 IRQx 通道号打开对应 ICU 中断通道 IRQ00创建 stack 后将 name、channel 设为一致标号、callback 统一命名为irq_callback选择触发方式上升沿/下降沿等。验证代码可参考 ra6m4-cpk/src/hal_entry.c 中的icu_sample示例rt_pin_get(p105)获取引脚号、rt_pin_attach_irq挂接回调、rt_pin_irq_enable使能中断并以MSH_CMD_EXPORT(icu_sample, icu sample)导出为 msh 命令WDT / RTC / FlashRT-Thread 中每种只使用一个设备实例因此无编号驱动中默认使用g_wdt、g_rtc、g_flash命名新建设备时注意 name 字段保持一致随后在 ENV 中开启对应驱动SPI配置 channel、name、Clock Phase、Clock Polarity、Callback、SPI Mode 等参数波特率可在代码中通过 API 修改这里设置默认值Pins 中打开 SPI1 配置端口引脚注意不要在此配置 SSLx 片选引脚ADC/DACADC 配置 name、unit、mode 并选择扫描通道编号与对应引脚DAC 需先关闭 P014 的默认 mode开启 DAC0 通道并将通道号改为 0TimerGPT设置定时器名称timer0/1…、通道与名称后缀相同、中断回调函数timer0_callback等与中断优先级在 ENV 中使能 timer 外设并选择要打开的定时器PWMGPTGPT 提供 gpt0-gpt9 共 10 个通道每通道两个输出端口。将Common - Pin Output Support设为 Enable指定 GPT 通道与名称如通道 3 对应g_timer3定时器模式设为 PWM设定周期计数值与默认占空比如 50%在 Pins 中把输出引脚设为GTIOCA or GTIOCB。当前版本 PWM 驱动将每个通道看作独立 PWM 设备每设备仅一个通道可只开一个端口或两端口全开两端口同时开启时输出波形完全一致CAN添加 CAN 后配置 Callback 为can0_callback或can1_callback在 ENV 中使能 CANSDHISD 卡添加 sdhi 驱动与 DMAC设置 DMAC 中断、SDHI 中断与引脚在 ENV 中打开 SDHI再配置 DFS 添加文件系统如 FatFS。命令行中依次执行mkfs sd0 -t elm格式化 SD 卡、mount sd0 / elm挂载到根目录RW007 WiFi 模块在软件包配置中找到 RW007menuconfig 中打开 RW007 驱动默认使用 SPI1需同时打开 SPI1 总线开启 WLAN 框架、NETDEV 组件与内核 mempoolFSP 中按 SPI 章节添加 SPI 端口为 RW007 的 INT 引脚占用一个 IRQ 通道如 P506RESET 引脚在 RASC 中将 mode 关闭交由 RW007 软件控制。配置完成后编译下载系统启动自动获取 RW007 信息输入wifi scan扫描信号、WiFi join连接热点、ping rt-thread.com测试网络。7. RA8 与 RZ 系列 BSP 的特色RA8 系列以 ra8d1-vision-board 为例这是 RT-Thread 与瑞萨联合推出的机器视觉开发板基于 Cortex-M85 架构 RA8D1 芯片支持 UARTUART9 为默认日志口、GPIO、USBTinyUSB、Cameraov2640、ov7725、ov7670 等、SDHC1-bit/4-bit、ADC、DAC、SPI、PWM、RTC、FLASH、WDT、I2C、Wi-FiRW007等外设。其编译环境除 MDKarmclang AC6外还支持 LLVM 工具链在 ENV 中设置set RTT_CCllvm-arm与set RTT_EXEC_PATHLLVM 安装路径\bin后执行scons编译。RZ 系列rzt2m_rsk 与 rzn2l_rsk 对应 Renesas 官方 RSK-RZT2M、RSK-RZN2L 评估板另含网络套件 rzn2l_etherkit其 README 同时提供中英文说明适合面向工业控制、网络应用等场景的开发。8. 注意事项与 FAQFSP 版本不同系列 BSP 依赖的 FSP 版本不同RA6/RA4/RA2 多为 FSP 3.5.0RA8 为 FSP 5.1.0使用 RASC 前务必核对 FSP version、Board、Device 三项配置工程同步FSP 配置完成后新增文件不会自动加入 MDK 工程首次编译需在弹出的导入变更提醒中选择是并再次编译引脚冲突文档中的外设添加步骤均为单独配置说明排版顺序不代表添加顺序如遇引脚冲突请查阅开发板与芯片手册相关章节调试烧录CPK-RA6M4 若在 MDK DEBUG 时遇到 Error: Flash Download failed Cortex-M33可修改 Utilities 中的算法配置解决见 ra6m4-cpk/README.md FAQSEGGER_RTTRA6M4 串口需外接 USB 转 TTL 工具可在RT-Thread Settings - 硬件 - 板载设备驱动下使能 SEGGER_RTT直接用 J-Link 作为 RT-Thread 的 console 口避免频繁插拔串口线。9. 总结总体而言RT-Thread 的瑞萨 RA 系列 BSP 遵循共享驱动库 独立板级配置的架构bsp/renesas/libraries/HAL_Drivers提供统一外设驱动各开发板目录通过 Kconfig 与 FSP 生成文件差异化配置。开发者只要掌握ENV menuconfig 使能驱动 FSP 配置引脚与 stack scons 重新生成工程三步流程即可在任意 RA/RZ 系列开发板上按需扩展外设快速进入应用开发阶段。赞分享操作系统嵌入式物联网嵌入式OSRTOS【免费下载链接】rt-threadRT-Thread is an open source IoT Real-Time Operating System (RTOS). https://rt-thread.github.io/rt-thread/项目地址https://gitcode.com/gh_mirrors/rt/rt-thread点击查看免费下载相关推荐Open Generative AI开源AI内容创作的终极革命200模型自由创作指南Open Generative AI开源AI内容创作的终极革命200模型自由创作指南 在AI内容创作领域真正的创作自由不应被高昂费用、内容过滤或技术壁垒操作系统嵌入式物联网嵌入式OSRTOSRT-Thread 瑞萨 RA 系列 BSP通过 ENV 与 FSP 配置开启片上外设驱动的完整实战教程RT Thread 瑞萨 RA 系列 BSP通过 ENV 与 FSP 配置开启片上外设驱动的完整实战教程 本文以 RT Thread 中瑞萨 RA 系列 BS操作系统嵌入式物联网嵌入式OSRTOSRT-Thread 瑞萨 RA 系列 BSP 制作实战基于 FSP 与 Scons 构建可发布的板级支持包RT Thread 瑞萨 RA 系列 BSP 制作实战基于 FSP 与 Scons 构建可发布的板级支持包 本文以 RT Thread 仓库自带的《RA 系列操作系统嵌入式物联网嵌入式OSRTOS上一篇Solargraph类型检查器深度解析从基础到高级的完整指南下一篇CANN/asc-devkit bfloat16转ll函数创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考