iPerf以其高效、開源、跨平臺的特性，成為網絡性能測試的標配工具。無論你是系統管理員、網絡工程師還是開發人員，掌握iPerf都將極大提升故障排查效率。本文將系統梳理iPerf的安裝、配置與常用命令，幫助初學者在最短時間內獨立完成測試任務。

perf作為經典的網絡性能測試工具，被廣泛用于測量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地址；

將客戶端核心板燒錄客戶端模式代碼，并連接到路由器；

同時觀察兩臺設備的日志輸出。

測試完成后，可以在日志中看到最終的帶寬測試結果：

今天的內容就分享到這里了~

審核編輯 黃宇