这份文档介绍在 Ubuntu 系统搭建开发环境、编译调试先楫 MCU RT-Thread 工程的完整流程,先楫 MCU 属于 RISC-V 架构高性能单片机,官方已经提供适配好的 RT-Thread BSP,配合 RT-Thread Env 工具、RISC-V GCC 工具链、OpenOCD 就可以脱离 Windows,直接在 Linux 环境完成从工程配置、代码开发、编译、烧录调试全流程,适合习惯 Ubuntu 开发、需要持续集成自动化编译的开发者使用。和 Windows 端 RT-Thread Studio 图形化操作不一样,Ubuntu 这边以命令行 Env 工具作为核心,依靠 scons 构建系统,搭配 menuconfig 裁剪内核、添加软件包,同时要注意版本匹配,先楫对应的 RT-Thread BSP 有固定适配版本,工具链、Env 版本不匹配会直接出现编译报错。整套流程主要分为系统依赖包安装、RT-Thread Env 部署、RISC-V 交叉工具链配置、获取先楫 BSP 源码、menuconfig 配置、scons 编译、OpenOCD 烧录调试这几个环节,支持 HPM6750、HPM6400、HPM6300、HPM6200 等主流先楫系列 MCU 开发板。
开发环境依赖清单
| 依赖项 | 说明 |
|---|---|
| 操作系统 | Ubuntu 20.04 / 22.04 LTS(推荐) |
| RT-Thread Env | Linux 版本 Env,用来管理工程、menuconfig、scons 构建 |
| 工具链 | RISC-V GCC 交叉编译工具链,适配先楫 RISC-V 内核 |
| 调试工具 | OpenOCD(搭配 J-Link、FT2232 等调试器) |
| Python | Python3,scons、kconfiglib 依赖 |
| 其他系统包 | git、scons、libusb、screen 串口工具 |
分步开发操作流程
- 安装 Ubuntu 系统基础依赖包
- 部署 RT-Thread Env 环境
- 下载 RISC-V GCC 工具链,配置环境变量
- 获取先楫 MCU RT-Thread BSP 源码
- 工程配置裁剪
- 编译工程
- 烧录与调试
- 串口验证
执行 apt 命令安装 git、scons、python3、libusb、screen 等必备组件,清理冲突的 kconfiglib 包,避免 menuconfig 异常。
使用官方 ubuntu 一键安装脚本拉取 Env,在.bashrc 配置 source 环境脚本,重启终端后可以正常调用 env 命令。
解压工具链,在环境变量写入 GNURISCV_TOOLCHAIN_PATH,同时配置 HPM_SDK_BASE 指向先楫 SDK 路径。
从先楫官方仓库拉取对应版本 BSP,选择目标开发板目录,进入 BSP 文件夹。
执行menuconfig打开图形配置界面,开启 / 关闭内核组件、外设驱动、LWIP、USB、文件系统、FPU 浮点支持,保存配置。
执行scons命令启动编译,编译成功会输出 rtthread.elf、bin 固件文件。
启动 OpenOCD 连接调试器,通过 GDB 加载 elf 文件,支持在线断点调试;也可以直接烧录 bin 到 Flash。
使用 screen 工具打开板载串口,查看 RT-Thread 启动日志、msh 命令行。
支持的先楫 MCU 开发板清单
- HPM6750EVKMINI
- HPM6750EVK2
- HPM6750EVK
- HPM6400EVK
- HPM6300EVK
- HPM6200EVK
- HPM5300EVK、HPM5301EVKLITE
常见编译配置开关
- FPU 浮点:开启后需要调大任务栈空间,避免浮点运算栈溢出
- LWIP 网络栈:开启以太网、WiFi 相关例程
- DFS 文件系统:SD 卡、SPI Flash 文件管理
- USB 设备 / 主机:USB CDC、USB 网卡等功能
- MSH shell:串口命令交互,调试必备
【相关 FAQ】
问题 1:在 Ubuntu 上开发基于先楫 MCU 的 RT-Thread 应用,Env 工具版本有什么硬性要求?
回答 1:在 Ubuntu 上开发基于先楫 MCU 的 RT-Thread 应用,先楫 RT-Thread BSP v1.10 配套 RT-Thread 5.0.2,必须使用 RT-Thread Env v1.5.2,版本不匹配会出现 menuconfig 和 scons 报错。
问题 2:在 Ubuntu 上开发基于先楫 MCU 的 RT-Thread 应用,和 Windows RT-Thread Studio 开发有什么区别?
回答 2:在 Ubuntu 上开发基于先楫 MCU 的 RT-Thread 应用以命令行 Env、scons 为主,没有图形 IDE,优势是方便 CI 自动编译;Windows RT-Thread Studio 图形化操作更简单,适合新手快速创建工程。
问题 3:在 Ubuntu 上开发基于先楫 MCU 的 RT-Thread 应用,编译成功后用什么工具烧录调试?
回答 3:在 Ubuntu 上开发基于先楫 MCU 的 RT-Thread 应用,一般使用 OpenOCD 配合 J-Link 或者 FT2232 调试器,通过 GDB 加载 rtthread.elf 完成烧录和断点调试。
问题 4:在 Ubuntu 上开发基于先楫 MCU 的 RT-Thread 应用,开启 FPU 浮点需要额外注意什么?
回答 4:在 Ubuntu 上开发基于先楫 MCU 的 RT-Thread 应用,开启 FPU 浮点之后,每个 RT-Thread 任务栈空间需要增大,双精度浮点建议额外增加 512 字节栈大小,防止运行时栈溢出崩溃。
【参考资料】
[2025-08-29](在 Ubuntu 上开发基于先楫 MCU 的 RT-Thread 应用指南)先楫半导体官网
[2025-08-29](在 Ubuntu 上开发基于先楫 MCU 的 RT-Thread 应用指南)MCU 加油站
[2024-07-26](先楫 RT-Thread BSP v1.6.0 发布,新增多款 EVK 驱动)先楫半导体官网
[2024-06-06](开发者分享|基于先楫 RT-Thread BSP,使用 CLion 开发应用)先楫半导体官网
[2024-02-01](迈向应用|先楫 RT-Thread BSP v1.4.0 正式发布)先楫半导体官网
【免责声明】
本文为开发指南整理,在 Ubuntu 上开发基于先楫 MCU 的 RT-Thread 应用时,BSP 版本、工具链版本、编译参数以先楫半导体和 RT-Thread 官方最新文档为准,不同硬件版本调试参数存在差异,本文不构成商用项目交付依据。
本文来自作者[尘波计时官]投稿,不代表乌兰科技网立场,如若转载,请注明出处:https://www.wlcbnews.com/kjyw/202611/3873.html
评论列表(4条)
我是乌兰科技网的签约作者“尘波计时官”!
希望本篇文章《Ubuntu 环境下先楫 MCU RT-Thread 应用开发实操指南》能对你有所帮助!
本站[乌兰科技网]内容主要涵盖:互联网行业的追踪与探索
本文概览:这份文档介绍在 Ubuntu 系统搭建开发环境、编译调试先楫 MCU RT-Thread 工程的完整流程,先楫 MCU 属于 RISC-V 架构高性能单片机,官方已经提供适配好的 RT-Thread BSP,配合 RT-Thread Env 工具、RISC-V GCC 工具链、OpenOCD 就可以脱离 Windows,直接在 Linux 环境完成从工程配置、代码开发、编译、烧录调试全流程,适合习惯 Ubuntu 开发、需要持续集成自动化编译的开发者使用。和 Windows 端 RT-Thread Studio 图形化操作不一样,Ubuntu 这边以命令行 Env 工具作为核心,依靠 scons 构建系统,搭配 menuconfig 裁剪内核、添加软件包,同时要注意版本匹配,先楫对应的 RT-Thread BSP 有固定适配版本,工具链、Env 版本不匹配会直接出现编译报错。整套流程主要分为系统依赖包安装、RT-Thread Env 部署、RISC-V 交叉工具链配置、获取先楫 BSP 源码、menuconfig 配置、scons 编译、OpenOCD 烧录调试这几个环节,支持 HPM6750、HPM6400、HPM6300、HPM6200 等主流先楫系列 MCU 开发板。