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 开发板。

开发环境依赖清单

依赖项说明
操作系统Ubuntu 20.04 / 22.04 LTS(推荐)
RT-Thread EnvLinux 版本 Env,用来管理工程、menuconfig、scons 构建
工具链RISC-V GCC 交叉编译工具链,适配先楫 RISC-V 内核
调试工具OpenOCD(搭配 J-Link、FT2232 等调试器)
PythonPython3,scons、kconfiglib 依赖
其他系统包git、scons、libusb、screen 串口工具

分步开发操作流程

  1. 安装 Ubuntu 系统基础依赖包
  2. 部署 RT-Thread Env 环境
  3. 下载 RISC-V GCC 工具链,配置环境变量
  4. 获取先楫 MCU RT-Thread BSP 源码
  5. 工程配置裁剪
  6. 编译工程
  7. 烧录与调试
  8. 串口验证

执行 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

赞 (1)

今日大家都在搜的词:

发表回复

本站作者后才能评论

评论列表(4条)

  • 尘波计时官
    尘波计时官 2026年11月17日

    我是乌兰科技网的签约作者“尘波计时官”!

  • 尘波计时官
    尘波计时官 2026年11月17日

    希望本篇文章《Ubuntu 环境下先楫 MCU RT-Thread 应用开发实操指南》能对你有所帮助!

  • 尘波计时官
    尘波计时官 2026年11月17日

    本站[乌兰科技网]内容主要涵盖:互联网行业的追踪与探索

  • 尘波计时官
    尘波计时官 2026年11月17日

    本文概览:这份文档介绍在 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 开发板。

联系我们

联系:143 0457 151

工作时间:周一至周五,9:30-18:30,节假日休息

关注我们