前言米联客 LS03 是搭载龙芯 2K301 处理器的国产 LoongArch 架构嵌入式开发板在工业控制、智能终端等领域应用广泛。在系统定制开发中Buildroot 凭借轻量、高效的特性成为构建嵌入式根文件系统的首选工具。本文基于米联客 LS03 开发板从零讲解 Buildroot 环境搭建、板级配置、软件包裁剪到 U 盘启动验证的完整流程所有命令均可直接复制执行。一、环境与材料准备1. 宿主机环境操作系统Ubuntu 22.04 / 20.04必备依赖编译工具链、基础开发库sudo apt update sudo apt install -y build-essential g git wget cpio unzip python3 libncurses5-dev rsync bc2. 核心文件Buildroot 源码包buildroot-2405.tar.bz22024.05 版本板级配置文件config_2k301米联客 LS03 官方适配配置交叉编译工具链loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu安装路径/opt/官方配套启动 U 盘已烧录龙芯 2K301 启动引导固件包含内核与根分区二、Buildroot 配置全步骤1. 源码解压与文件准备# 解压Buildroot源码 tar -xjf buildroot-2405.tar.bz2 cd buildroot-2405 # 拷贝LS03板级配置文件到源码根目录 cp /path/to/config_2k301 ./2. 加载板级默认配置# 加载LS03专用2K301配置 make defconfig BR2_DEFCONFIG./config_2k3013. 交叉编译环境修正板级配置中默认的工具链版本可能与本地安装不一致需手动修正路径# 将配置中的rc1.4替换为实际工具链版本rc1.5 sed -i s/rc1.4/rc1.5/g .config # 验证工具链路径 grep BR2_TOOLCHAIN_EXTERNAL_PATH .config确保输出路径与本地/opt/下的工具链目录完全一致。4. 图形化配置与软件包裁剪执行make menuconfig进入配置界面可按需添加第三方软件包make menuconfig添加常用网络工具示例iperf3、lrzsz进入Target packages → Networking applications按空格选中iperf3、lrzsz若 iperf3 无法选中需先进入Toolchain开启C support文件系统镜像配置进入Filesystem images确认勾选cpio the root filesystem进入Compression method选择gzip压缩方式配置完成后保存退出。三、编译构建确保宿主机联网编译过程需自动下载源码包执行多线程编译make -j$(nproc)编译时长取决于宿主机性能首次编译约 30-60 分钟。编译完成后镜像输出路径为output/images/rootfs.cpio.gz四、U 盘启动部署米联客 LS03 开发板支持通过 U 盘挂载根文件系统启动操作步骤如下1. 镜像重命名Buildroot 生成的镜像需重命名为系统启动默认识别的文件名cd output/images mv rootfs.cpio.gz update.cpio.gz2. 拷贝到启动 U 盘将官方启动 U 盘插入宿主机挂载后将镜像拷贝到 U 盘根文件系统分区的根目录sudo cp update.cpio.gz /media/uisrc/root/ sync执行sync确保数据完全写入避免缓存导致文件损坏。3. 开发板启动验证将 U 盘插入 LS03 开发板 USB 接口上电启动通过串口终端查看启动日志系统正常进入命令行即代表 Buildroot 根文件系统挂载成功五、常见问题排查编译时报工具链路径错误检查BR2_TOOLCHAIN_EXTERNAL_PATH路径是否与本地工具链完全匹配注意版本号后缀软件包下载失败手动下载对应源码包放到dl/目录或配置清华 Buildroot 镜像源加速启动卡挂载根文件系统确认 U 盘分区格式正确镜像文件名是否为update.cpio.gz启动后命令缺失重新进入 menuconfig 勾选对应软件包重新编译镜像总结基于 Buildroot 定制米联客 LS03 的根文件系统核心在于板级配置加载、工具链路径匹配和镜像格式适配。掌握这套流程后可根据项目需求灵活增减软件包快速产出定制化的嵌入式 Linux 系统。