龙芯2K0300 开发环境搭建7 步跑通 LoongArch 交叉编译的完整路线图【免费下载链接】docs-2k03002k0300 平台板卡的产品规格书用户手册等文档项目地址: https://gitcode.com/open-loongarch/docs-2k0300拿到龙芯2K0300先锋派开发板后别急着上电——龙芯2K0300 开发环境搭建这件事做不对后面 U-Boot 源码编译、内核开发全得返工。接下来带你把环境完整跑通装工具链、拉源码、打通串口和网络再用两条自检命令收口。开发板到手长这样板卡丝印和接口布局都在这张实拍里后面接串口、网线时对照它找位置。搭建路线总览一张表看清全流程步骤预计耗时产出物1. 基础构建工具安装5 分钟git、make 等主机工具可用2. 交叉工具链部署10 分钟含下载/opt 下的 LoongArch 工具链目录3. 环境变量配置3 分钟PATH、CROSS_COMPILE、ARCH 生效4. 源码克隆与依赖安装10 分钟~/ws 工作区与编译依赖库5. 串口调试通道5 分钟能看到 U-Boot 启动日志6. 网络调试通道10 分钟TFTP 同网段可达7. 验证与排错5 分钟工具链版本自检通过整条线一小时内能走完容易卡住的点集中在第 2 步和第 6 步遇到再回头对排错部分。主机侧准备系统依赖与交叉工具链安装环境准备分三小步走每完成一步先确认反馈再继续比一口气全装完再排查省力。安装基础构建工具这一步给主机装上版本管理和编译基础工具后面拉源码、跑 make 都用得上。sudo apt update sudo apt install -y git vim openssh-server build-essential✅ 此时你应该看到git --version正常输出版本号apt 没报依赖冲突。工具链解压到 /opt 并创建软链接基础工具就位后主角登场LoongArch 交叉编译工具链它是龙芯2K0300工具链配置的核心。压缩包 1GB 左右先确认网速和磁盘空间。这条命令负责从官方源下载、解压到 /opt再建一个短软链接后面配环境变量时更清爽。wget http://ftp.loongnix.cn/toolchain/gcc/release/loongarch/gcc8/loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.4.tar.xz sudo tar xf loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.4.tar.xz -C /opt sudo ln -sf /opt/loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.4 /opt/loongson-gnu-toolchain-x86_64-loongarch64-linux-gnu✅ 此时你应该看到 /opt 下多出一个 loongson-gnu-toolchain-x86_64-loongarch64-linux-gnu 目录里面有 bin、lib 等子目录。配置交叉编译器环境变量工具链装好了但 shell 还不认识它需要把交叉编译器环境变量写进 ~/.bashrc让每个新终端都能直接调用。PATH 指向工具链 bin 目录CROSS_COMPILE 固定交叉前缀ARCH 固定目标架构后续所有 make 命令都靠这两个变量。echo export PATH/opt/loongson-gnu-toolchain-x86_64-loongarch64-linux-gnu/bin:$PATH ~/.bashrc echo export CROSS_COMPILEloongarch64-linux-gnu- ~/.bashrc echo export ARCHloongarch ~/.bashrc source ~/.bashrc✅ 此时你应该看到新开一个终端后which loongarch64-linux-gnu-gcc能返回 /opt 下的完整路径。源码与依赖四个仓库加一组依赖库主机侧就绪后把源码落到本地工作目录统一放 ~/ws仓库多也好管理。四个核心仓库各管一段仓库名用途docs-2k0300官方文档仓库产品规格书、用户手册、快速上手指南都在这建议第一个克隆边做边查u-boot引导加载器源码U-Boot 源码编译、定制启动菜单和烧写命令都基于它linux-5.10内核源码驱动开发和内核功能定制的地基buildroot根文件系统构建框架产出开发板能直接用的 rootfs先把工作目录建好把文档仓库拉下来mkdir -p ~/ws cd ~/ws git clone https://gitcode.com/open-loongarch/docs-2k0300u-boot、linux-5.10、buildroot 三个仓库按同样方式克隆到 ~/ws 下即可。配套的快速上手说明见 2K0300先锋派快速上手指南接口细节查 广东龙芯2K0300用户手册V2.1。编译依赖库一次装齐这四个库是编译途中最容易缺的缺一个就报一类错建议直接一次装齐。库名作用安装命令bison语法分析工具U-Boot 和内核构建系统必需sudo apt install -y bisonflex词法分析工具与 bison 配套sudo apt install -y flexlibssl-dev加密相关头文件sudo apt install -y libssl-devlibelf-dev内核模块编译的 ELF 支持sudo apt install -y libelf-devsudo apt install -y bison flex libssl-dev libelf-dev调试通道搭建串口与网络两条链路装完工具链后别急着编译先把调试通道打通——编译出任何异常你都要靠这两条链路第一时间看到现场。串口U-Boot 启动日志的生命线Windows 下用 MobaXterm 打开 Serial 会话关键参数照下面这张参考界面配截图中红框标出的 COM17、115200 波特率与 8N1 参数就是龙芯2K0300 先锋派串口调试波特率的标准组合。关键参数串口号Windows 下按设备管理器实际值如 COM17Linux 下用 /dev/ttyUSB0波特率115200数据位/停止位/校验8 / 1 / None即 8N1流控NoneLinux 主机上更省事的是直接用 minicom端口选 /dev/ttyUSB0参数同样 115200 8N1这张截图展示了 minicom 打开串口后的终端画面上电开发板后这里会持续滚动 U-Boot 的启动日志。网络TFTP 同网段连通网络通道服务 TFTP 下载场景U-Boot 阶段烧 kernel、dtb、rootfs 都走它。PC 端先把网卡 IP 固定到一个独立网段开发板侧【免费下载链接】docs-2k03002k0300 平台板卡的产品规格书用户手册等文档项目地址: https://gitcode.com/open-loongarch/docs-2k0300创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考