您的位置首页 >科技要闻 >

Ubuntu 环境开发先楫 MCU RT-Thread 应用完整指南

在 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 Envscons、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

完整操作步骤

  1. 安装系统基础依赖,执行 apt 安装 git、python3、pip、scons、openocd、picocom
  2. 一键安装 RT-Thread Env,执行官方 install_ubuntu.sh 脚本,在~/.bashrc 追加 source ~/.env/env.sh,重启终端生效
  3. 下载对应版本的 RISC-V GCC 工具链,解压到本地目录,配置 GNURISCV_TOOLCHAIN_PATH 环境变量
  4. 拉取先楫 MCU RT-Thread BSP 源码,进入对应开发板目录(例如 hpm6750evkmini)
  5. 执行menuconfig,裁剪 RT-Thread 内核、开启串口、FPU、lwIP 等组件,保存配置
  6. 执行scons -j4编译,生成 rtthread.elf、rtthread.bin 固件
  7. 调试烧录:OpenOCD+GDB 在线调试,或者使用 HPMicro Manufacturing Tool 烧录 bin 固件
  8. 打开 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、串口烧录,图形界面,上手简单

容易踩坑的问题清单

  1. kconfiglib 冲突:如果 pip 安装过全局 kconfiglib,Env 自带的会冲突,执行 pip uninstall kconfiglib
  2. 环境变量不生效:新开终端才会加载 bashrc,或者手动 source ~/.bashrc
  3. 串口无输出:检查开发板 BOOT 拨码、串口引脚、波特率、是否开启 RT-Thread 控制台
  4. 编译提示找不到工具链:核对 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 版本、开发板硬件版本存在适配差异,固件烧录错误存在板卡风险,本文不用于量产交付指导。

今日大家都在搜的词: