LuatOS下iPerf网络性能测试实战指南

1. iPerf网络测试环境搭建指南

作为一名嵌入式开发工程师，我经常需要评估设备的网络性能。iPerf作为一款经典的网络性能测试工具，因其跨平台特性和简单易用，成为我的首选方案。今天我将分享如何在LuatOS环境下，利用iPerf库对Air780EPM等嵌入式设备进行网络性能测试。

2. 环境准备与工具选型

2.1 硬件设备清单

• Air780EPM开发板/核心板 ×2
• AirETH_1000以太网配件板（含CH390H芯片）
• 千兆路由器（建议使用企业级设备以获得稳定测试结果）
• 网线（Cat5e及以上规格）
• 电源适配器（5V/2A）

注意：如果使用核心板，必须搭配AirETH_1000配件板才能实现以太网功能。该配件板采用工业级CH390H芯片，支持10/100M自适应。

2.2 软件环境配置

1. LuatOS开发环境：

   • 下载最新版Luatools（建议v2.1.8+）
   • 安装USB转串口驱动（CH340/CP2102等）
   • 准备VSCode+LuatOS插件（可选）

2. 网络参数规划：

   • 服务器IP：建议设置为静态IP（如192.168.1.100）
   • 客户端IP：可配置为DHCP自动获取
   • 测试端口：默认5001（可自定义）

3. iPerf核心原理与实现

3.1 TCP/UDP带宽测试机制

iPerf通过建立客户端-服务器模型进行测试：

• TCP模式：测量可靠传输的最大吞吐量

  • 通过滑动窗口机制动态调整数据包大小
  • 结果反映网络实际可用带宽

• UDP模式：测量极限吞吐量和丢包率

  • 固定速率发送数据包
  • 计算抖动(Jitter)和丢包率(Packet Loss)

技术细节：LuatOS当前版本仅支持iPerf2协议，其默认TCP窗口大小为85.3KB，在嵌入式设备上需根据内存情况调整。

3.2 LuatOS的API封装设计

LuatOS将iPerf功能抽象为三个核心API：

lua复制-- 服务器模式（阻塞式）
iperf.server(netType, [port], [timeout])

-- 客户端模式（异步回调）
iperf.client(netType, serverIp, serverPort, [duration], [callback])

-- 中断测试
iperf.abort()

其中netType支持：

• "eth"：有线以太网
• "wifi"：无线网络（需额外配置）

4. 实战操作步骤

4.1 服务器模式配置

1. 创建iperf_server.lua：

lua复制local function networkReady()
    log.info("NET", "IP:", netdrv.ipv4("eth"))
    iperf.server("eth", 5001, 60) -- 60秒超时
end

sys.taskInit(function()
    netdrv.setup("eth", "eth0", {phy=0, rst=12})
    netdrv.dhcp("eth", true)
    netdrv.on("eth", "link", networkReady)
end)

2. 烧录注意事项：

• 使用Luatools的"差分下载"模式加快烧录速度
• 首次烧录建议勾选"擦除整个Flash"
• 波特率设置为921600以获得最佳传输速度

4.2 客户端模式配置

1. 修改iperf_client.lua：

lua复制local serverIP = "192.168.1.100" -- 改为实际服务器IP

sys.taskInit(function()
    netdrv.setup("eth", "eth0", {phy=0, rst=12})
    netdrv.dhcp("eth", true)
    
    sys.waitUntil("NET_READY", 30000) -- 等待网络就绪
    
    iperf.client("eth", serverIP, 5001, 30, function(result)
        log.info("IPERF", "Bandwidth:", result.bandwidth.."Mbps")
    end)
end)

2. 关键参数说明：

• phy=0：指定PHY芯片地址
• rst=12：复位引脚配置（根据硬件设计调整）
• 30：测试时长（秒）

5. 测试结果分析与优化

5.1 典型测试数据

在100Mbps局域网环境下，Air780EPM的测试结果通常为：

5.2 性能优化技巧

1. TCP窗口调整：

lua复制-- 在server和client代码中添加：
sys.setGlobal("IPERF_TCP_WINDOW", 16384) -- 16KB窗口

2. 提高优先级：

lua复制sys.taskInit(function()
    sys.setPriority(1) -- 设置高任务优先级
    -- iperf代码...
end)

3. PHY寄存器优化：

lua复制netdrv.setup("eth", "eth0", {
    phy = 0,
    rst = 12,
    phy_reg = {
        {0x1f, 0x0100}, -- 开启全双工
        {0x10, 0x786f}  -- 广告100M能力
    }
})

6. 常见问题排查

6.1 连接失败处理

1. 现象：客户端报"Connection refused"

   • 检查服务器IP是否正确
   • 确认服务器端口监听状态：

     lua复制log.info("NETSTAT", json.encode(netdrv.status("eth")))
     

2. 现象：带宽测试结果异常低

   • 检查网线质量（建议更换Cat6线）
   • 确认路由器端口速率（应显示100M全双工）
   • 排查背景流量干扰

6.2 高级调试技巧

1. 抓取网络报文：

lua复制netdrv.setPromisc("eth", true)
netdrv.on("eth", "raw", function(data)
    -- 分析原始数据包
end)

2. 实时监控CPU负载：

lua复制sys.timerLoopStart(function()
    log.info("CPU", "Usage:", sys.cpuUsage())
end, 1000)

7. 扩展应用场景

7.1 无线网络测试

对于WiFi模组（如Air724UG），只需修改netType：

lua复制-- 配置WiFi连接
netdrv.setup("wifi", "uart1", {ssid="Your_SSID", password="Your_Pass"})
iperf.client("wifi", serverIP, 5001)

7.2 自动化测试系统

结合LuatOS的定时任务功能，可实现：

lua复制sys.timerLoopStart(function()
    local result = iperf.client("eth", serverIP, 5001, 10)
    -- 上传结果到云平台
    http.request("POST", "http://api.example.com/log", json.encode(result))
end, 3600000) -- 每小时测试一次

在实际项目中，我发现通过合理设置TCP窗口大小和任务优先级，可以使Air780EPM的TCP带宽稳定性提升15%以上。建议首次测试时先用短时长（10秒）验证基本功能，再逐步延长测试时间获取更准确结果。