前言在龙芯 LS2K300 开发板的嵌入式 Linux 开发中官方软件源往往缺少 iperf3 这款网络性能测试工具。本文基于米联客 2026 版 LoongArch 课程实践完整记录iperf3.20 源码交叉编译、静态链接、移植到开发板并 Windows 端联调测速全流程一步一命令可直接复现。前置知识交叉编译与 iperf3 原理1. 什么是交叉编译本机编译在 x86 电脑上编译生成 x86 可执行文件只能在电脑运行。交叉编译在 x86 电脑上使用龙芯交叉编译器直接生成LoongArch64 架构的程序拷贝到龙芯 LS2K300 开发板就能运行。核心作用开发机与目标机架构不同必须交叉编译。2. 什么是静态编译动态编译程序运行依赖系统.so动态库换环境容易报错。静态编译把所有依赖库打包进可执行文件不依赖系统库拷贝即用。嵌入式场景优先用静态编译更稳定、免部署。3. iperf3 工作原理采用C/S 架构客户端 / 服务端。一端运行iperf3 -s作为服务端监听。另一端运行iperf3 -c 服务器IP作为客户端发起测速。自动统计传输大小、带宽、重传数、窗口大小等。一、环境与准备开发板龙芯 LS2K300LoongArch64 架构宿主系统Ubuntu x86_64虚拟机交叉工具链loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.4iperf3 版本iperf-3.20.tar.gz编译方式静态编译二、下载 iperf3 源码官方下载地址 http://downloads.es.net/pub/iperf/本文使用稳定版iperf-3.20.tar.gz下载后复制到虚拟机工作目录例如/home/uisrc/三、解压源码把下载的压缩包复制到虚拟机解压tar -xzf iperf-3.20.tar.gz -C /home/uisrc四、交叉编译配置核心步骤执行 configure指定目标架构、交叉编译器、静态编译、安装路径sudo ./configure --hostloongarch64-linux-gnu \ CC/opt/loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.4/bin/loongarch64-linux-gnu-gcc \ CFLAGS-static \ CXXFLAGS-static \ --prefix/home/uisrc/iperf3-3.20参数说明--hostloongarch64-linux-gnu目标板架构不是 Ubuntu 主机CC指定龙芯交叉编译器必须写绝对路径CFLAGS-static/CXXFLAGS-static静态链接不依赖动态库--prefix编译输出目录必须绝对路径五、编译与安装sudo makesudo make install完成后/home/uisrc/iperf3-3.20/生成了六、移植到 LS2K300 开发板将整个iperf3-3.20目录拷贝到开发板文件系统位置任意七、Windows 端测速服务端下载 Windows 版 iperf3 https://files.budman.pw/解压后在目录打开 CMD启动服务端iperf3.exe -s这里192.168.137.1是作为服务器的pc的ip地址八、开发板端测速客户端进入/iperf3-3.20/bin目录下运行chmod x iperf3 ./iperf3 -c 192.168.137.1九、总结
