米联客 LS03 实战：基于龙芯 2K301 的 Buildroot 根文件系统构建与 U 盘启动全流程

前言

米联客 LS03 是搭载龙芯 2K301 处理器的国产 LoongArch 架构嵌入式开发板，广泛用于工业控制、小型智能终端等国产化场景。在嵌入式 Linux 系统定制工作中，Buildroot 凭借轻量化、编译速度快、配置简单的优势，是构建根文件系统的主流工具。

本文全程基于米联客 LS03 开发板实操，完整覆盖环境搭建、Buildroot 板级适配、软件包自定义、镜像编译、U 盘启动部署全流程，所有命令可直接复制运行。

一、环境与材料准备

1.1 宿主机编译环境

推荐 Ubuntu 20.04/22.04，执行以下命令安装全套编译依赖：

sudo apt update
sudo apt install -y build-essential g++ git wget cpio unzip python3 libncurses5-dev rsync bc

1.2 所需资源文件

• Buildroot 源码包：buildroot-2405.tar.bz2（2024.05 稳定版本）
• 板级配置文件：config_2k301（米联客 LS03 专属适配配置）
• 龙芯交叉工具链：loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu，安装路径 /opt/
• 米联客配套启动 U 盘：预烧录 LS03 引导固件，划分好内核分区与 root 数据分区

二、Buildroot 基础配置步骤

1. 解压源码并导入板级配置

# 解压Buildroot源码
tar -xjf buildroot-2405.tar.bz2
cd buildroot-2405

# 将LS03板级配置复制到源码根目录
cp /你的文件路径/config_2k301 ./

2. 加载 LS03 默认配置

make defconfig BR2_DEFCONFIG=./config_2k301

3. 修正交叉工具链版本路径

原厂配置内工具链版本后缀为 rc1.4，本地工具链为 rc1.5，一键替换：

sed -i 's/rc1.4/rc1.5/g' .config
# 校验修改是否生效
grep BR2_TOOLCHAIN_EXTERNAL_PATH .config

注意：输出路径必须和 /opt下工具链文件夹完全一致，否则编译会报工具链缺失。

4. menuconfig 图形化自定义配置

make menuconfig

（1）添加网络工具 iperf3、lrzsz

路径：Target packages → Networking applications

空格勾选 iperf3、lrzsz；若 iperf3 置灰无法选中，进入 Toolchain开启 C++ support。

（2）配置根文件系统镜像压缩

路径：Filesystem images

1. 勾选 cpio the root filesystem
2. 进入 Compression method，选择 gzip压缩格式

配置完成保存退出。

三、编译生成根文件系统镜像

编译需要联网自动下载各类源码包，多线程编译命令：

make -j$(nproc)

首次编译耗时 30~60 分钟，取决于宿主机 CPU 性能。编译完成后镜像输出目录：

output/images/rootfs.cpio.gz

四、U 盘部署，LS03 开发板启动

1. 镜像重命名（LS03 固件识别固定文件名）

cd output/images
mv rootfs.cpio.gz update.cpio.gz

2. 写入启动 U 盘

将配套启动 U 盘插入 Ubuntu 宿主机，挂载后拷贝镜像至 U 盘 root 分区根目录：

sudo cp update.cpio.gz /media/uisrc/root/
# 强制同步缓存，防止文件损坏
sync

3. 开发板上电验证

1. U 盘插入 LS03 板载 USB 接口
2. 开发板上电，串口终端打印启动日志
3. 成功进入 Linux 命令行，代表 U 盘根文件系统挂载完成

五、高频问题排查

表格

总结

米联客 LS03（龙芯 2K301）使用 Buildroot 定制系统，核心流程分为：加载板级配置→修正交叉工具链→按需增减软件包→编译 cpio 镜像→U 盘替换启动。该方案适配国产化工业项目，可根据业务需求裁剪系统、增加自定义应用，快速产出专属嵌入式 Linux 固件。