RT-Thread RA6M3-HMI-Board BSP 实战指南:RA6M3 人机交互开发板的快速上手与外设进阶配置
操作系统嵌入式物联网嵌入式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 仓库中瑞萨 RA6M3-HMI-Board 开发板的 BSP 说明文档README、中文文档展开覆盖开发板硬件资源、MDK5 环境下的最小系统编译下载流程、应用入口函数hal_entry以及通过 ENV 工具和 FSP 框架使能 LCD、SDHI、RJ11 网口、WiFi 等更多板载资源的完整进阶方法。读完本文你可以在该 HMI 评估板上从零跑通 RT-Thread 最小系统并能自行扩展出带 LVGL 图形界面、文件系统、网络的完整应用。一、开发板介绍与硬件框架基于瑞萨 RA6M3 MCU 的 HMI-Board 评估板面向“人机交互HMI”场景设计。通过灵活的软件包和 IDE 配置开发者可以评估 RA6M3 MCU 族群的特性并开发嵌入式应用。核心硬件构成如下原文档 Hardware Framework 部分MCURA6M3R7FA6M3AH3CFBArm Cortex-M4F 内核120 MHz 主频2 MB Flash / 640 KB RAM片上集成TFT 控制器、2D 图形加速器G2D和JPEG 解码器——这是它区别于普通 MCU 评估板、适合做 HMI 的关键4.3 寸 LCDRGB 888 接口即直接接 TFT 控制器 RGB 引脚板载仿真器可直接在线下载调试以太网EthernetRW007SPI 接口高速 WiFi 芯片USB-DeviceTF 卡槽SDHICAN1 路麦克风、1 路扬声器Arduino 扩展接口2 路 PMOD 扩展接口4 个按键3 个用户按键 1 个复位按键。开发板背面back.png集中了接口与排针资源。片上外设支持矩阵BSP 文档给出的外设支持情况如下片上外设驱动支持情况备注UART支持UART9 为默认日志输出端口GPIO支持LCD支持SDHI支持JPEG支持G2D支持RW007WiFi支持ETH以太网支持SPI支持I2C支持CAN支持需要强调一点中文文档特别说明仓库刚拉下来时是最小系统。默认只开启了 GPIO 与 UART9上述其他外设驱动虽然都已存在代码但需要通过后文的 ENV/FSP 配置流程使能。二、BSP 目录结构与关键文件从源码结构看该 BSP 采用 RT-Thread 标准的“板级目录 FSP 代码生成目录”组织方式各目录职责如下目录 / 文件作用src/hal_entry.c应用层入口用户代码放置目录board/板级代码堆栈定义、中断表以及 LVGL 移植、GT911 触摸、RW007 WiFi、G2D/JPEG 驱动、PWM 音频、AVI 播放器、SD 卡挂载等模块board/rtduino/Arduino 生态RTduino引脚映射支持 Arduino 扩展接口ra/fsp/FSPFlexible Software Pack运行时库BSP、r_ioport、r_sci_uart 等外设 APIra_cfg/FSP 生成的外设配置头文件bsp_cfg、pin_cfg、sci_uart_cfg 等ra_gen/FSP 自动生成的初始化代码main.c、hal_data.c、pin_data.c、vector_data.c等标注 do not editscript/链接脚本fsp.ldGCC、fsp.scatIAR/MDK、memory_regions.ldproject.uvprojxMDK5 工程文件本 BSP 目前仅提供 MDK5 工程configuration.xml、R7FA6M3AH3CFC.pincfgFSP 工程配置文件与引脚配置供 FSP 工具解析rtconfig.h、rtconfig.py、Kconfig当前生效的配置及 env 工具入口SConstruct、SConscriptSCons 构建脚本用于scons --targetmdk5重生成工程最小系统的配置依据查看当前已生效的 rtconfig.h 与 外设配置段可以确认最小系统只包含#define RT_USING_CONSOLE #define RT_CONSOLE_DEVICE_NAME uart9 /* 控制台设备为 uart9 */ ... #define BSP_USING_GPIO #define BSP_USING_UART #define BSP_USING_UART9 #define BSP_UART9_RX_BUFSIZE 256 #define BSP_UART9_TX_BUFSIZE 0即控制台设备挂在uart9上配合 GPIO 驱动构成“串口 shell LED”的最小系统。同时RT_USING_FINSH已使能因此启动后可以看到msh shell。三、快速上手MDK5 编译、下载与运行1. 编译与下载本 BSP 目前仅提供 MDK5 工程操作步骤为编译双击打开bsp/renesas/ra6m3-hmi-board/project.uvprojx文件在 MDK5 中编译程序下载点击 MDK 的 Debug 按钮通过板载仿真器进行下载和在线调试。2. 查看运行结果下载成功后系统自动运行并打印系统信息。将开发板对应的串口连接到 PC在终端工具中打开相应串口波特率 115200数据位 8停止位 1无校验即 115200-8-1-N复位设备后即可看到 RT-Thread 的启动输出。输入help命令可查看系统支持的命令\ | / - RT - Thread Operating System / | \ 5.0.0 build Jan 4 2023 10:14:56 2006 - 2022 Copyright by RT-Thread team Hello RT-Thread! msh msh help help - RT-Thread shell help. ps - List threads in the system. free - Show the memory usage in the system. clear - clear the terminal screen version - show RT-Thread version information list - list objects msh 3. 应用入口函数与调用链应用层入口函数位于 hal_entry.c用户编写的源文件可直接放入src目录SConscript 会将其归入 Applications 编译组#define LED_PIN BSP_IO_PORT_02_PIN_09 /* Onboard LED pins */ void hal_entry(void) { rt_kprintf(\nHello RT-Thread!\n); while (1) { rt_pin_write(LED_PIN, PIN_HIGH); rt_thread_mdelay(500); rt_pin_write(LED_PIN, PIN_LOW); rt_thread_mdelay(500); } }注意README 示例代码中使用的是LED3_PIN宏而当前仓库源码实际使用LED_PIN映射到BSP_IO_PORT_02_PIN_09即 Port02 Pin09以仓库源码为准。调用链上FSP 生成的 main.c 只有一行核心逻辑——直接调用hal_entry()因此 RA 系列 BSP 的约定是所有用户逻辑都写在hal_entry中而非main。堆内存的布局由 board.h 定义RA6M3 的 640 KB SRAM 顶部0x1FFE0000之上作为堆区与 MDK 的Image$$RAM_END$$ZI$$Base符号衔接避免与静态数据冲突。四、进阶使用ENV 工具配置与 FSP 外设使能进阶章节面向需要在 RT-Thread 上使用更多开发板资源的开发者。整个进阶流程建立在两个工具之上env 工具配置内核/组件/软件包驱动menuconfig、pkgs、scons命令和FSP瑞萨 Flexible Software Pack负责生成引脚复用与外设初始化代码。1. ENV 工具配置流程默认配置只开启了 UART9。要启用组件、软件包或其他外设步骤为在bsp/renesas/ra6m3-hmi-board/目录下打开 env 工具即运行该目录下的rtconfig.py输入menuconfig命令配置工程配置完成后保存退出输入pkgs --update命令更新/下载所选软件包输入scons --targetmdk5命令重新生成 MDK 工程再回到 MDK 中编译下载。menuconfig中板级选项来自 board/Kconfig主要分类与典型选项如下均可按引脚编号自定义Onboard Peripheral Drivers板载外设BSP_USING_ARDUINO兼容 Arduino 生态RTduino会自动连带使能 UART4、GPIO、ADC0、PWM0/2/8、软件 I2C0、软件 SPI1 等BSP_USING_FS文件系统下设BSP_USING_SDCARD_FSSDHI1 FatFs与BSP_USING_SPICARD_FSSPI Flash走 SCI7 SPI 模式 SPI MSD FatFsBSP_USING_LCD/BSP_USING_SPI_LCDRGB565 的 LCD 或 SPI 屏BSP_USING_LCD_PWM_BACKLIGHT可用 PWM5 驱动背光BSP_USING_TOUCH使能 GT911 触摸走软件 I2C1BSP_USING_LVGL/BSP_USING_LVGL_DEMO使能 LVGL 图形库及其 demo音乐 demo / stress demo对应 board/lvgl/ 下的移植层lv_port_disp.c、lv_port_indev.c。On-chip Peripheral Drivers片上外设BSP_USING_UART默认 y下含 UART4 / UART9各自可配 RX/TX DMA 与缓冲区大小RX 默认 256范围 64~65535BSP_USING_SCISCI 控制器可配置 SCI0~SCI9且每个 SCI 可在 SPI / I2C / UART 三种模式间选择——这正是 RW007 WiFi 走 SCI3 SPI 模式的底层支撑BSP_USING_SPISPI0/SPI1、BSP_USING_SOFT_SPI软件 SPI默认引脚 516/1291/1292、BSP_USING_SOFT_I2C软件 I2C默认 SCL/SDA 引脚 514/515BSP_USING_ADC、BSP_USING_DAC、BSP_USING_PWMGPT0/2/5/8BSP_USING_SDHITF 卡可选 1-bit/4-bit 位宽模式自动连带 DFS、ELM 文件 IO 与 POSIX 设备 IOBSP_USING_CANCAN0、BSP_USING_ETH自动连带 lwIP/SAL/netdev、BSP_USING_G2D、BSP_USING_JPEG配合板载 2D 加速器与 JPEG 硬件解码器驱动代码在 drv_g2d.c 与 drv_jpeg.c。Board extended module Drivers板载扩展模块BSP_USING_RW007RW007 WiFi 模块自动选择 SCI3 SPI 总线默认总线名sci3s并提供RA_RW007_CS_PIN、RA_RW007_INT_BUSY_PIN、RA_RW007_RST_PIN等引脚级配置项驱动位于 drv_rw007.c。提示由于引脚复用关系某些功能之间可能存在引脚冲突配置时以 FSP 生成的pin_data.c与ra_cfg/fsp_cfg/bsp/bsp_pin_cfg.h中的实际引脚分配为准。2. FSP 配置流程外设驱动的“源头”RA 系列 BSP 的外设初始化代码由 FSP 生成仓库中的最小配置对应ra_gen/下最简文件集。要使能更多外设步骤为在 BSP 目录下打开 env 工具先使用scons --targetmdk5命令生成 MDK 工程打开project.uvprojx选择顶部导航栏的Software Components配置找到Flex Software下的RA Configuration点击其旁的配置按钮。该操作会自动检测当前电脑已安装的 FSP 版本选择指定版本后进入 FSP进入 FSP 后可看到仓库中已预先配置好的外设即 configuration.xml 所描述的配置UART9、GPIO 等。在此添加/修改外设引脚后点击Generate Project Content按钮生成所需驱动文件ra_gen/、ra_cfg/目录及ra/fsp/源文件会被更新回到 env使能所需的外设配置项即上节menuconfig中的BSP_USING_*选项保存退出再次scons --targetmdk5重生成工程即可。从 ra/SConscript 与各目录 SConscript 可以看出构建系统会把ra/fsp、ra_cfg、ra_gen的源文件与头文件自动纳入编译因此 FSP 每生成一次重新生成 MDK 工程即可拿到对应代码无需手工维护文件列表。五、注意事项与延伸阅读最小系统前提仓库默认配置为“最小体量”仅 UART9 GPIO所有“支持”的外设都需要走 ENV FSP 流程使能直接编译默认工程不会包含 LVGL、SD 卡、WiFi 等功能工程目标本 BSP 当前仅提供 MDK5 工程SConscript 中明确 IAR 平台直接退出GCC/IAR 构建路径在脚本中有所保留但未作为官方支持目标请以 MDK5 为准示例工程仓库中文文档指出主仓库只维护最新的驱动相关代码包含完整外设驱动示例的独立 SDK 仓库为sdk-bsp-ra6m3-hmi-board如需体验社区/官网的开源示例工程应到该 SDK 仓库中开发贡献代码如有基于该开发板的项目可参考 RT-Thread 官方贡献指南向仓库提交代码官方资料开发板官网主页、用户手册、RA MCU 基础知识与 RA6 快速设计指南等可在瑞萨Renesas官网按板卡型号检索获取本文不重复外部链接。参考文件索引内容仓库路径BSP 说明文档英/中README.md、README_ZH.md应用入口src/hal_entry.cFSP 生成的 mainra_gen/main.c堆/内存布局board/board.h板级 Kconfig 选项board/Kconfig当前生效配置rtconfig.hFSP 配置configuration.xml、ra_cfg/链接脚本script/fsp.scat、script/memory_regions.ld板级外设驱动board/ports/WiFi、G2D、JPEG、触摸、音频、AVI、SD 挂载赞分享操作系统嵌入式物联网嵌入式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 EK-RA6M3 开发板 BSP 实战MDK 快速编译烧录、FSP 与 ENV 外设配置详解RT Thread EK RA6M3 开发板 BSP 实战MDK 快速编译烧录、FSP 与 ENV 外设配置详解 本文以 RT Thread 仓库中瑞萨 EK操作系统嵌入式物联网嵌入式OSRTOSEnvoy 本地限流全解基于 Token Bucket 的 L4 连接与 HTTP 请求限流机制Envoy 本地限流全解基于 Token Bucket 的 L4 连接与 HTTP 请求限流机制 Envoy 在本地非分布式限流方面提供了三层实现面向操作系统嵌入式物联网嵌入式OSRTOSRT-Thread BSP 实战指南GD32103C-EVAL 开发板GD32F103VCT6快速上手与进阶配置RT Thread BSP 实战指南GD32103C EVAL 开发板GD32F103VCT6快速上手与进阶配置 本指南以 RT Thread 仓库中 b操作系统嵌入式物联网嵌入式OSRTOS上一篇types.GenericAlias 迭代器数据竞争修复CPython 自由线程free-threaded构建下的并发安全剖析下一篇Hugging Face Diffusers 生成控制技术全景指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

react-native-code-push 完全指南:为 React Native 应用接入 CodePush 动态更新

react-native-code-push 完全指南:为 React Native 应用接入 CodePush 动态更新

移动开发 【免费下载链接】react-native-code-push React Native module for CodePush 项目地址: https://gitcode.com/gh_mirrors/re/react-native-code-push 点击查看 免费下载 本指南以仓库根目录 README.md 为主体脉络,系统讲解 react-native-code-…

2026/9/25 16:56:21 阅读更多 →
Flecs 层级系统(Hierarchies)完全指南:ChildOf 与 Parent 两种存储、递归遍历与查询优化

Flecs 层级系统(Hierarchies)完全指南:ChildOf 与 Parent 两种存储、递归遍历与查询优化

游戏开发 【免费下载链接】flecs A fast entity component system (ECS) for C & C 项目地址: https://gitcode.com/gh_mirrors/fl/flecs 点击查看 免费下载 层级结构是 Flecs 这个 C/C ECS(Entity Component System)引擎中最常用的组织…

2026/9/25 16:56:21 阅读更多 →
VoltAgent Working Memory 实战指南:跨会话持久化 Agent 上下文的三格式配置与源码解析

VoltAgent Working Memory 实战指南:跨会话持久化 Agent 上下文的三格式配置与源码解析

人工智能AI AgentAgent 框架后端多智能体RAG工具调用Agent 记忆 【免费下载链接】voltagent AI Agent Engineering Platform built on an Open Source TypeScript AI Agent Framework 项目地址: https://gitcode.com/gh_mirrors/vo/voltagent 点击查看 免费下载 Wo…

2026/9/25 16:56:20 阅读更多 →

最新新闻

PromptX Runtime架构剖析:Docker式Agent生命周期与事件驱动SystemBus设计

PromptX Runtime架构剖析:Docker式Agent生命周期与事件驱动SystemBus设计

PromptX Runtime架构剖析:Docker式Agent生命周期与事件驱动SystemBus设计 【免费下载链接】PromptX PromptX 领先的AI 智能体上下文平台 | PromptX Leading AI Agent Context Platform 项目地址: https://gitcode.com/Deepractice/PromptX Prom…

2026/9/25 17:39:49 阅读更多 →
Ubuntu 22.04 LTS开发环境实战配置指南

Ubuntu 22.04 LTS开发环境实战配置指南

1. 这不是“又一篇Ubuntu安装教程”,而是一份我亲手踩过27次坑、重装过14台机器后整理的22.04 LTS实战手册你搜“Ubuntu 22.04 LTS安装配置”时,看到的大多是截图堆砌、命令复制粘贴、步骤编号到5就戛然而止的“半成品”。有人装完连中文输入法都打不出字…

2026/9/25 17:39:49 阅读更多 →
Lottery 抽奖系统部署实战:Docker 安装 Nacos 注册中心并接入 Dubbo 服务注册

Lottery 抽奖系统部署实战:Docker 安装 Nacos 注册中心并接入 Dubbo 服务注册

文档教程后端 【免费下载链接】CodeGuide :books: 本代码库是作者小傅哥多年从事一线互联网 Java 开发的学习历程技术汇总,旨在为大家提供一个清晰详细的学习教程,侧重点更倾向编写Java核心内容。如果本仓库能为您提供帮助,请给予支持(关注、…

2026/9/25 17:39:49 阅读更多 →
使用 GDB 与 SWD 调试探针对 PX4 固件进行交互式调试:从连接到实战

使用 GDB 与 SWD 调试探针对 PX4 固件进行交互式调试:从连接到实战

嵌入式物联网机器人自动驾驶智能硬件 【免费下载链接】PX4-Autopilot PX4 Autopilot Software 项目地址: https://gitcode.com/gh_mirrors/px/PX4-Autopilot 点击查看 免费下载 本指南以 PX4-Autopilot 官方调试文档(gdb_debugging.md)为核心…

2026/9/25 17:39:49 阅读更多 →
RisingWave 自定义 Lint 体系实战:基于 cargo dylint 的 Rust 代码规范与 Clippy 扩展

RisingWave 自定义 Lint 体系实战:基于 cargo dylint 的 Rust 代码规范与 Clippy 扩展

数据库流处理后端数据工程 【免费下载链接】risingwave Event streaming platform for agentic AI. Continuously ingest, transform, and serve event streams in real time, at scale. 项目地址: https://gitcode.com/gh_mirrors/ri/risingwave 点击查看 免费下载…

2026/9/25 17:39:48 阅读更多 →
AI提示词帮你搞定任务优先级排序,告别决策瘫痪

AI提示词帮你搞定任务优先级排序,告别决策瘫痪

1. 为什么“事情太多先做什么”是个真问题你有没有过这种早晨:闹钟响了第三遍才爬起来,手机一解锁,微信未读99,邮箱里躺着三封标红的“紧急”,待办清单上密密麻麻列了二十多条,脑子里同时转着“下午要交周报…

2026/9/25 17:38:48 阅读更多 →

日新闻

AI元人文:从工具使用到思维重构的深度探索

AI元人文:从工具使用到思维重构的深度探索

最近半年我一直在琢磨一件事:AI元人文到底是什么?说白了,就是“用元视角重新审视人与AI的关系”,也在“探索AI如何反向逼着我们发现自己的思考边界”。标题里的“元探索”,在我看就是一层套一层的追问——当你用AI解决…

2026/9/25 0:00:41 阅读更多 →
Python+CNN车牌识别实战:从数据预处理到模型训练与部署

Python+CNN车牌识别实战:从数据预处理到模型训练与部署

简介:基于Python与卷积神经网络的车牌识别项目,面向计算机视觉初学者及智能交通开发者,目标是帮助用户掌握从数据预处理、模型构建到实际部署的完整流程。压缩包共25个文件,包含jpg/png图像样本、py训练脚本、md说明文档、dat数据…

2026/9/25 0:00:41 阅读更多 →
Vim基础操作全攻略:保存退出、模式切换与高频命令实战

Vim基础操作全攻略:保存退出、模式切换与高频命令实战

1. 项目概述1.1 核心需求解析今天聊聊Vim。写这个题目的原因是:几乎每个后端开发者、运维人员、数据工程师某天都会遇到一个场景——深夜加班,服务器登录界面只有黑底白字,编辑器只有vi/vim,你必须在五分钟内完成一次配置修改并保…

2026/9/25 0:00:41 阅读更多 →

周新闻

Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化

Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化

直接铺开项目本身吧。这几个月我一直在折腾一件事:用Flutter给OpenHarmony做一款游戏集合类的App,说白了就是把若干小游戏塞进一个壳里,用统一入口分发。这个方向本身不算新鲜,真正让我花了不少心思的,是首页那堆游戏卡…

2026/9/24 14:34:13 阅读更多 →
Word表格编号全攻略:从列表编号到题注交叉引用

Word表格编号全攻略:从列表编号到题注交叉引用

写Word文档,最让人头疼的往往是那些“看起来不起眼”的小问题。比如表格编号这事:今天在表后面多加了两个空白行,明天给客户交稿前发现整个章节的编号全部错位,光是挨个改序号就能耗掉大半个下午。我前阵子帮人整理一份上百页的技…

2026/9/25 11:15:26 阅读更多 →
从第一个站到第二个站:独立开发者的静态网站选型与落地实践

从第一个站到第二个站:独立开发者的静态网站选型与落地实践

1. 项目概述1.1 核心需求解析做独立开发者这几年,说实话,第一个网站上线的那天晚上我兴奋得没睡着。但等它跑了半年,流量惨淡、功能臃肿、代码自己都懒得看第二遍之后,我才慢慢琢磨明白一个道理:第一个网站是练手&…

2026/9/24 14:33:56 阅读更多 →

月新闻

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能分类:[AI/大模型]细分主题:AI 增强型 CI/CD 流水线自动化与 GitOps 实践:Agent 工作流、工具调用与任务拆解:从原型到生产的验收清单很多团队在尝试用大…

2026/9/24 12:50:34 阅读更多 →
容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场分类:[工程技术]细分主题:Kubernetes 生产环境运维与排障实战:可复制的项目复盘模板与决策记录大部分团队的事故复盘报告,最后都变成了躺在 Confluence 或钉…

2026/9/24 14:33:48 阅读更多 →
容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步分类:[工程技术]细分主题:Docker 容器化技术与镜像安全管理:核心链路的逐步实现与关键代码取舍面对一个积累了五六年历史包袱的单体架构应用(包含 Web 接口、后台…

2026/9/24 12:49:17 阅读更多 →