在 Ubuntu 系统上做先楫 HPM 系列 MCU 的 RT-Thread 开发,全程依靠 RT-Thread Env、RISC-V GCC 工具链、先楫官方 BSP,不需要依赖 Windows 端 RT-Thread Studio,命令行就能完成工程配置、编译、烧录调试,适合习惯 Linux 开发、服务器编译、CI 自动构建的开发者。先楫 MCU 是 RISC-V 架构,BSP 配套 RT-Thread 5.0.2 版本,Env 工具版本要匹配,版本不对很容易出现 menuconfig、scons 编译报错,硬件上一般搭配 HPM6750EVKMINI 这类开发板,调试可以选 OpenOCD、JLink,烧录也可以用 HPMicro Manufacturing Tool Linux 版,串口终端直接用 minicom、picocom 查看 RT-Thread 的 msh 控制台输出。这套流程的核心就是先装好系统依赖、Env 环境、RISC-V 工具链,拉取先楫 BSP,menuconfig 裁剪内核,scons 编译,最后烧录调试,相比 Windows,Ubuntu 更适合批量编译、自动化脚本,缺点是图形化调试工具没有 Windows 丰富,大部分操作以命令行为主。
硬件准备清单
- 先楫 HPM 开发板:HPM6750EVKMINI / HPM6750EVK2
- 调试器:JLink、FT2232 或者使用 OpenOCD 支持的调试器
- 数据线:USB Type-C(供电 + 板载调试串口)
- Ubuntu 系统:推荐 Ubuntu 20.04 / 22.04 / 24.04 LTS
软件环境依赖清单
| 依赖项 | 作用 | 安装命令 |
|---|---|---|
| RT-Thread Env | scons、menuconfig、包管理 | 官方一键脚本安装 |
| riscv32 GCC 工具链 | RISC-V 代码编译 | 解压配置环境变量 |
| OpenOCD | 调试、烧录 | sudo apt install openocd |
| picocom/minicom | 串口查看日志 | sudo apt install picocom |
| git、python3、scons | 源码拉取、构建基础 | sudo apt install git python3 scons |
完整操作步骤
- 安装系统基础依赖,执行 apt 安装 git、python3、pip、scons、openocd、picocom
- 一键安装 RT-Thread Env,执行官方 install_ubuntu.sh 脚本,在~/.bashrc 追加 source ~/.env/env.sh,重启终端生效
- 下载对应版本的 RISC-V GCC 工具链,解压到本地目录,配置 GNURISCV_TOOLCHAIN_PATH 环境变量
- 拉取先楫 MCU RT-Thread BSP 源码,进入对应开发板目录(例如 hpm6750evkmini)
- 执行menuconfig,裁剪 RT-Thread 内核、开启串口、FPU、lwIP 等组件,保存配置
- 执行scons -j4编译,生成 rtthread.elf、rtthread.bin 固件
- 调试烧录:OpenOCD+GDB 在线调试,或者使用 HPMicro Manufacturing Tool 烧录 bin 固件
- 打开 picocom 串口,波特率 115200,查看 RT-Thread 启动日志、使用 msh 命令交互
常见编译配置要点
- 版本匹配:先楫 RT-Thread BSP v1.10 配套 RT-Thread 5.0.2,Env 使用 v1.5.2,版本错配大概率报错
- FPU 开启:开启 rv32imafc 浮点扩展,开启后任务栈需要额外增加 512 字节,避免浮点任务崩溃
- 权限问题:USB 调试、串口需要配置 udev 规则,或者把用户加入 dialout、plugdev 组,避免 sudo 频繁提权
- 生成 CMake 工程:需要用 VSCode、CLion 开发时,执行scons --target=cmake生成 CMakeLists.txt
- 软件包管理:使用pkgs --update拉取 lwip、fatfs 等组件包
调试与烧录方式对比
✅ OpenOCD+GDB:免费开源,命令行调试,适合 Ubuntu 自动化,配置稍复杂
✅ JLink:稳定性好,支持 Ozone 远程调试,需要 JLink 驱动
✅ HPMicro Manufacturing Tool:官方 Linux 烧录工具,支持 HID、串口烧录,图形界面,上手简单
容易踩坑的问题清单
- kconfiglib 冲突:如果 pip 安装过全局 kconfiglib,Env 自带的会冲突,执行 pip uninstall kconfiglib
- 环境变量不生效:新开终端才会加载 bashrc,或者手动 source ~/.bashrc
- 串口无输出:检查开发板 BOOT 拨码、串口引脚、波特率、是否开启 RT-Thread 控制台
- 编译提示找不到工具链:核对 GNURISCV_TOOLCHAIN_PATH 路径,路径不要带中文、空格
【常见问题】
问题 1:Ubuntu 开发先楫 MCU RT-Thread 应用,Env 工具版本有什么要求?
回答 1:Ubuntu 开发先楫 MCU RT-Thread 应用,先楫 RT-Thread BSP v1.10 基于 RT-Thread5.0.2,要求 Env 使用 v1.5.2,版本不匹配会出现 menuconfig、scons 异常报错。
问题 2:Ubuntu 开发先楫 MCU RT-Thread 应用,在 Ubuntu 上怎么编译工程?
回答 2:Ubuntu 开发先楫 MCU RT-Thread 应用,进入 BSP 开发板目录,先执行 menuconfig 完成配置,再运行scons -j线程数命令,直接编译生成 rtthread.bin 和 rtthread.elf 固件。
问题 3:Ubuntu 开发先楫 MCU RT-Thread 应用,Ubuntu 下可以用什么方式烧录调试?
回答 3:Ubuntu 开发先楫 MCU RT-Thread 应用,可以使用 OpenOCD+GDB 命令行调试,JLink 调试,也可以使用官方 HPMicro Manufacturing Tool Linux 版做串口、HID 烧录。
问题 4:Ubuntu 开发先楫 MCU RT-Thread 应用,想要用 VSCode 开发,怎么生成 CMake 工程?
回答 4:Ubuntu 开发先楫 MCU RT-Thread 应用,在 BSP 目录下执行scons --target=cmake,即可生成 CMake 工程,之后用 VSCode 或者 CLion 打开开发。
问题 5:Ubuntu 开发先楫 MCU RT-Thread 应用,打开 FPU 浮点功能需要注意什么?
回答 5:Ubuntu 开发先楫 MCU RT-Thread 应用,开启 FPU 之后要修改编译参数为 rv32imafc,并且所有浮点任务的栈空间要额外增加 512 字节,防止栈溢出死机。
【参考资料】
[2025-08-29](在 Ubuntu 上开发基于先楫 MCU 的 RT-Thread 应用指南)先楫半导体官网
[2025-08-29](在 Ubuntu 上开发基于先楫 MCU 的 RT-Thread 应用指南)MCU 加油站
[2024-09-03](HPMicro Manufacturing Tool v0.4.1 发布,新增 Linux 平台支持)先楫半导体
[2024-06-06](开发者分享 | 基于先楫 RT-Thread BSP,使用 CLion 开发应用)先楫半导体
【免责声明】
本文仅为先楫 MCU RT-Thread 在 Ubuntu 环境的开发流程科普,BSP 版本、工具链版本、调试适配以先楫半导体、RT-Thread 官方文档为准;不同 Ubuntu 版本、开发板硬件版本存在适配差异,固件烧录错误存在板卡风险,本文不用于量产交付指导。
