快速上手iPerf的关键，在于高效搭建网络测试环境。这款工具的环境搭建流程简洁明了：先在服务端运行监听命令，再在客户端指定目标地址发起测试，即可获取网络带宽、延迟等数据。本文针对新手需求，详细拆解iPerf环境搭建的每个环节，包括系统适配、端口配置及常见问题排查，让你快速完成环境部署，避免在搭建阶段耗费过多时间。

iperf作为经典的网络性能测试工具，被广泛用于测量TCP和UDP带宽性能，可在客户端与服务器之间进行数据传输测试。

现在，通过LuatOS的集成支持，开发者可以直接在诸如Air780EPM等低功耗模组上运行iperf功能，轻松对设备的网络性能进行评估与验证。

LuatOS提供的iperf核心库：

支持server模式和client模式；

支持LuatOS开发的所有产品都支持iperf核心库；

需要注意的是，当前版本仅支持iperf2协议。

本文将以Air780EPM系列核心板/开发板为例，分享如何在LuatOS环境中利用iperf库进行网络测试。

一、iperf库相关API简介

LuatOS已将iperf功能封装为简洁的API，在嵌入式设备上使用极为简单。

本文示例所使用的API如下：

• iperf.server(netType)

启动iperf服务器模式

• iperf.client(netType, serverIp, serverPort)

启动iperf客户端模式并连接到指定服务器

• iperf.abort()

中止正在进行的iperf测试

• netdrv.setup(type, drv, param)

设置网络驱动参数

• netdrv.dhcp(type, enable)

配置DHCP客户端

• netdrv.ipv4(type, ip, mask, gw)

获取或设置IPv4地址信息

• netdrv.link(type)

获取网络连接状态

二、iperf功能示例demo

本示例使用Air780EPM系列核心板/开发板进行网络性能测试，通过服务器模式和客户端模式的配合使用，可以有效地测量网络的实际带宽和稳定性，为评估设备的网络通信能力提供重要参考。

功能特性：

支持DHCP客户端模式，自动从路由器获取IP地址；

服务器模式和客户端模式分离，可在不同设备上运行；

增强的错误处理和超时机制；

清晰的日志输出，便于调试和监控；

带宽自动计算并以Mbps显示。

注意事项：

本示例可准备两套Air780EPM 开发板；如使用核心板，需搭配AirETH_1000配件板（搭载CH390H芯片的以太网小板，支持标准RJ45网口接入路由器）使用，详见中心实操教程软硬件环境说明。

以下是iperf网络性能测试各种功能的实现方法和核心代码逻辑，完整demo详见源码仓库最新文件。

2.1 iperf服务器模式

iperf服务器模式允许设备作为服务器等待客户端连接，用于测量网络下行方向的带宽性能。

1）功能定义：iperf_server.lua：iperf服务器模块，用于初始化以太网接口，配置网络参数，启动iperf服务器，并处理客户端连接和测试报告。

2）代码示例：

3）烧录运行：

使用Luatools将服务器模式代码烧录到核心板/开发板中：

烧录完毕后，将核心板外挂AirETH_1000配件板连接到路由器的LAN口。设备启动后会初始化网络并启动iperf服务器，等待客户端连接。

日志中会显示服务器IP地址和启动状态：

当有客户端连接后会自动开始iperf测试，测试完毕后会在测试报告中打印数据量、持续时间和带宽等参数：

2.2 iperf客户端模式

iperf客户端模式允许设备作为客户端主动连接到服务器，用于测量网络上行方向的带宽性能。

1）功能定义：iperf_client.lua：iperf客户端模块，用于初始化以太网接口，配置网络参数，连接到指定的iperf服务器，进行带宽测试，并处理测试报告。

2）代码示例：

3）烧录运行：

在烧录前，需要修改iperf_client.lua文件中的服务器IP地址为服务器核心板的实际IP地址：

使用Luatools将客户端模式代码烧录到另一块核心板/开发板中：

烧录完成后，将客户端核心板外挂AirETH_1000配件板也连接到路由器的LAN口。设备启动后会初始化网络并尝试连接到服务器：

连接成功后，客户端会开始进行带宽测试，测试完毕后会在测试报告中打印数据量、持续时间和带宽等参数：

2.3 完整测试场景演示

完整的测试场景需要将两块Air780EPM开发板，或核心板外挂AirETH_1000配件板，通过路由器连接。

测试步骤：

将服务器核心板烧录服务器模式代码，并连接到路由器；

记录服务器核心板的IP地址；

修改客户端代码中的服务器IP地址；

将客户端核心板烧录客户端模式代码，并连接到路由器；

同时观察两台设备的日志输出。

测试完成后，可以在日志中看到最终的带宽测试结果：

今天的内容就分享到这里了~