先说结论:在 Windows 上开发基于先楫半导体(HPMicro)HPM 系列 RISC-V MCU 的 RT-Thread 应用,主线流程是 "装好 ENV 工具和先楫 SDK / 工具链 → 拿到对应开发板的 RT-Thread BSP → 在 ENV 终端里用 menuconfig 裁剪配置 → pkgs --update 同步软件包 → scons 编译出固件 → 烧录调试"。ENV 是 RT-Thread 官方自带的命令行开发环境,内置 Python 和 SCons,Windows 下不需要单独再装这两样;先楫这边则需要 HPM SDK、RISC-V GCC 工具链,以及对应 EVK 开发板的 BSP 仓库,并把 SDK 根目录和工具链根目录配成环境变量(HPM_SDK_BASE、GNURISCV_TOOLCHAIN_PATH)。整条链路里最容易踩坑的是路径带中文或空格、工具链环境变量没配对、软件包索引过期这三类问题,下面按准备工作、配置、编译、产物和排障逐层拆开讲。
一、先分清三个概念:ENV 工具、先楫 BSP、HPM SDK
| 名称 | 是什么 | 在开发中的角色 |
|---|---|---|
| ENV 工具 | RT-Thread 官方开发工具,提供构建环境、图形化配置(menuconfig)和软件包管理(pkgs) | 负责配置工程、同步软件包、调用 SCons 编译 |
| 先楫 RT-Thread BSP | 针对先楫各 EVK 板级写的板级支持包,含启动代码、外设驱动、链接脚本和构建脚本 | 编译先楫 MCU 工程的入口,一个开发板对应一个 BSP 仓库 |
| HPM SDK + RISC-V 工具链 | 先楫官方 SDK(hpm_sdk)和 GCC 交叉编译链 | BSP 编译时依赖 SDK 源码和工具链生成可执行文件 |
补充背景:HPM 系列是先楫半导体的高性能实时 RISC-V 微控制器,面向工业自动化和边缘计算;先楫已与 RT-Thread 生态合作,发布了对应开发板的 RT-Thread BSP。
二、准备工作:Windows 下需要装齐的内容
1. 软件与物料清单
- 操作系统:Windows 7 及以上版本(先楫官方指南建议)。
- Git:安装 Git 并加入系统环境变量,软件包管理依赖它。
- ENV 工具:从 RT-Thread 官方渠道下载 Env 压缩包解压即可,目录下有 env.exe;ENV 自带 Python 和 SCons,Windows 下无需另装。
- 先楫 HPM SDK:下载 hpm_sdk 并解压到本地固定目录。
- RISC-V GCC 工具链:下载对应架构的 Windows 版工具链(如 rv32imac-ilp32-multilib-win、rv32imafdc-ilp32d-x86_64-w64-mingw32 等)。
- 对应 BSP:从先楫 GitHub 仓库拉取目标开发板的 rtt-bsp 工程。
- 调试与下载:J-Link、OpenOCD 或板载 FT2232 调试器,串口工具查看运行日志。
2. 路径要求(硬性约束)
- 工程、SDK、工具链、ENV 的存放路径中不能出现中文和空格,否则容易出现编译找不到文件、脚本路径解析失败等问题。
3. 支持的开发板(以 BSP v1.5.0 为准)
| 类别 | 开发板 |
|---|---|
| HPM6700 系列 | HPM6750EVK、HPM6750EVK2、HPM6750EVKMINI |
| 其他系列 | HPM6300EVK、HPM6200EVK、HPM5300EVK、HPM5301EVKLITE、HPM6800EVK |
每个开发板对应独立 BSP 仓库(仓库名形如 rtt-bsp-hpm6750evk、rtt-bsp-hpm6750evkmini 等),选型时先确认自己手上的板子型号再拉对应仓库。
三、环境变量配置:先楫 SDK 和工具链怎么挂到系统里
在开始菜单搜索 "环境变量",打开系统环境变量设置,新增两个系统变量:
| 变量名 | 指向内容 | 示例 |
|---|---|---|
| HPM_SDK_BASE | HPM SDK(hpm_sdk)解压后的根目录 | F:\HPM_SDK\sdk_env\hpm_sdk |
| GNURISCV_TOOLCHAIN_PATH | RISC-V GCC 工具链解压后的根目录(bin 所在目录的上一级) | F:\HPM_SDK\sdk_env\toolchains\rv32imac-ilp32-multilib-win |
配置要点:
- 变量值填到根目录即可,不要手动拼到 bin 子目录,构建脚本会按约定路径找编译器。
- 工具链架构要和芯片架构匹配(带不带浮点、ilp32 还是 ilp32d),选错会在链接阶段报浮点指令或 ABI 相关错误。
- 修改环境变量后,已打开的命令行窗口要关掉重开,新变量才会生效。
四、开发流程:从打开 ENV 到生成固件
步骤 1:进入 BSP 目录并打开 ENV 终端
- 方式一:进入 ENV 目录,双击 env.exe 打开 ENV 控制台,用cd命令切换到目标 BSP 根目录。
- 方式二:如果用 RT-Thread Studio 建工程,可在工程上右键选择 "打开 ENV 终端",终端会直接定位到当前工程目录。
步骤 2:menuconfig 裁剪系统配置
在 BSP 根目录输入:
menuconfig
进入图形配置界面后:
- 上下方向键移动条目,回车进入子菜单,空格勾选 / 取消 bool 选项,Esc 返回上一级。
- 可裁剪 RT-Thread 内核参数(线程栈大小、主线程优先级等)、启用组件(DFS 文件系统、设备虚拟文件系统、POSIX 层、网络等)、勾选需要的软件包。
- 配置完成后保存退出,配置结果写回工程的 rtconfig.h。
步骤 3:同步软件包
pkgs --update
按 menuconfig 里勾选的内容下载 / 同步对应软件包到工程 packages 目录。如果包列表本身过期,先执行:
pkgs --upgrade
更新 ENV 运行脚本和软件包索引;网络不好时,可在 menuconfig 相关配置里开启镜像源下载。
步骤 4:scons 编译固件
scons
SCons 会调用先楫工具链编译整个工程。编译成功后,BSP 目录下会生成目标文件,常见产物包括:
| 产物 | 用途 |
|---|---|
| rtthread.elf | 带调试信息的可执行文件,供 J-Link/OpenOCD 下载和在线调试 |
| rtthread.bin | 纯二进制固件,用于烧录量产或离线下载 |
步骤 5:按需生成其他 IDE 工程(可选)
如果不想一直在命令行开发,可以用 scons 把工程导出为其他 IDE 格式:
scons --target=cmake
scons --target=mdk5
scons --target=ses
分别对应 CMake 工程、Keil MDK5 工程、Segger Embedded Studio 工程;生成后刷新工程目录即可看到对应的工程文件。
步骤 6:烧录与运行
- 用 J-Link 或 OpenOCD 连接调试器(接口常见为 JTAG),选择 rtthread.elf 启动调试。
- 打开串口终端查看 RT-Thread 启动日志和 shell 输出,确认系统跑起来。
- 先楫板卡如需 FT2232 调试驱动,可在 SDK 的 sdk_env\tools 目录下运行 FTDI_InstallDriver.exe 安装。
五、常用 ENV 命令速查
| 命令 | 作用 |
|---|---|
| menuconfig | 打开图形化配置界面,裁剪内核、组件和软件包 |
| pkgs --update | 按当前配置同步 / 更新软件包 |
| pkgs --upgrade | 更新 ENV 运行脚本和软件包索引 |
| scons | 编译当前工程 |
| scons --target=cmake / mdk5 / ses | 导出对应 IDE 格式工程 |
| webui | 打开本机浏览器管理界面(查看状态、工具链、插件) |
六、常见问题与排查方向
- 提示 scons 不是可运行程序 / 找不到 scons:多为 RT-Thread 源码或 ENV 版本过旧,更新到最新源码和 ENV 版本后重试。
- 编译结果文件很少:这通常不是错误,SCons 只编译发生改动的文件,未改动的不会重复编译。
- 软件包在 menuconfig 里看不到或选不上:先执行pkgs --upgrade更新包索引,确认该选项已按空格开启,再回车进入子配置。
- 网络差导致包下载失败:在 menuconfig 中开启镜像源下载,或手动放置软件包到 local_pkgs 目录。
- CMD 提示命令无法找到:检查系统环境变量中是否包含C:\Windows\System32。
- RT-Thread 5.0.2 下编译报兼容性错误:可在 RT-Thread Settings 中勾选旧版本兼容性支持(对应 RT_USING_LEGACY)后重新编译。
- 链接阶段报浮点 / ABI 错误:核对工具链架构与芯片是否匹配,环境变量 GNURISCV_TOOLCHAIN_PATH 指向的目录是否正确。
【相关 FAQ】
问题 1:在 Windows 上用 ENV 工具开发先楫 MCU 的 RT-Thread 应用,需要准备哪些东西?
回答 1:需要准备 Windows 7 以上系统、Git、RT-Thread ENV 工具、先楫 HPM SDK、对应芯片的 RISC-V GCC 工具链,以及目标开发板的先楫 RT-Thread BSP;另外还要配好 HPM_SDK_BASE 和 GNURISCV_TOOLCHAIN_PATH 两个环境变量,工程路径不能有中文和空格。
问题 2:ENV 工具里的 menuconfig 和 scons 分别起什么作用?
回答 2:menuconfig 是 ENV 工具的图形化配置入口,用来裁剪 RT-Thread 内核、组件和软件包;scons 是 ENV 内置的构建命令,负责调用先楫 MCU 对应的 RISC-V 工具链编译 RT-Thread 应用,编译成功后生成 rtthread.elf 和 rtthread.bin 等固件产物。
问题 3:先楫 MCU 的 RT-Thread BSP 支持哪些开发板?SDK 和工具链环境变量怎么配?
回答 3:以先楫 RT-Thread BSP v1.5.0 为准,支持 HPM6750EVK、HPM6750EVK2、HPM6750EVKMINI、HPM6300EVK、HPM6200EVK、HPM5300EVK、HPM5301EVKLITE、HPM6800EVK。环境变量 HPM_SDK_BASE 指向 hpm_sdk 根目录,GNURISCV_TOOLCHAIN_PATH 指向 RISC-V 工具链根目录,配置后重开命令行窗口生效。
问题 4:编译先楫 MCU 的 RT-Thread 应用时,scons 报错或软件包拉不下来怎么办?
回答 4:先核对路径有无中文空格、工具链环境变量是否正确、工具链架构是否匹配芯片;scons 命令找不到就更新源码和 ENV 版本;软件包拉不下来先执行 pkgs --upgrade 更新索引,再用 pkgs --update 同步,网络差时开启镜像源;RT-Thread 5.0.2 兼容性报错可勾选旧版本兼容性支持后重新编译。
【参考资料】
- [2026-10-17](RT-Thread Env v2.0.3:让工具,长成你的样子)电子工程专辑
- [2024-06-06](开发者分享 | 基于先楫 RT-Thread BSP,使用 CLion 开发应用)先楫半导体
- [2024-04-30](RT-Thread BSP v1.5.0 发布 | 优化生态)先楫半导体
- [2022-05-20](800M 主频 RISC-V MCU HPM6750EVKMINI RT-Thread Studio 和 WIFI 例程体验)电子工程专辑
- [日期未标注](User Manual of Env - RT-Thread Document Center)RT-Thread 官网
- [日期未标注](SCons - RT-Thread Document Center)RT-Thread 官网
- [日期未标注](HPM6750EVKMINI 用户使用手册)先楫半导体
【免责声明】
本文基于 RT-Thread 官方文档、先楫半导体公开技术文章与用户手册整理,ENV 版本、BSP 支持板型、工具链名称、环境变量命名和编译产物可能随版本更新发生变化;文中命令、路径和配置项请以对应版本的官方文档、BSP 仓库说明为准。实际开发中如遇编译器、调试器或板级驱动问题,建议优先查阅先楫 SDK 文档与 RT-Thread ENV 手册,本文不构成对特定工具链或商业 IDE 的推荐。
本文来自作者[Hugo42]投稿,不代表诚邦网立场,如若转载,请注明出处:https://www.cbpmc.com.cn/qyzx/202611/1483.html
评论列表(4条)
我是诚邦网的签约作者“Hugo42”!
希望本篇文章《Windows 下用 ENV 工具开发先楫 HPM MCU 的 RT-Thread 应用环境搭建、menuconfig 配置到 scons 编译全流程》能对你有所帮助!
本站[诚邦网]内容主要涵盖:互联网行业的追踪与探索
本文概览:先说结论:在 Windows 上开发基于先楫半导体(HPMicro)HPM 系列 RISC-V MCU 的 RT-Thread 应用,主线流程是 "装好 ENV 工具和先楫 SDK 工具链 → 拿到对应开发板的 RT-Thread BSP → 在 ENV 终端里用 menuconfig 裁剪配置 → pkgs --update 同步软件包 → scons 编译出固件 → 烧录调试 "。ENV 是 RT-Thread 官方自带的命令行开发环境,内置 Python 和 SCons,Windows 下不需要单独再装这两样;先楫这边则需要 HPM SDK、RISC-V GCC 工具链,以及对应 EVK 开发板的 BSP 仓库,并把 SDK 根目录和工具链根目录配成环境变量(HPM_SDK_BASE、GNURISCV_TOOLCHAIN_PATH)。整条链路里最容易踩坑的是路径带中文或空格、工具链环境变量没配对、软件包索引过期这三类问题,下面按准备工作、配置、编译、产物和排障逐层拆开讲。