Network AT 命令集

Network AT 命令集提供 DNS、SNTP、Ping 包,iperf 吞吐量测试等常用网络服务

备注

  • Network AT 命令集默认启用。

  • 参考 配置 SDK (menuconfig) 进入 CONFIG AT CMD 配置,取消勾选 Enable Network 来关闭 Network AT 命令集。

AT+PING

功能说明

对域名或 IP 地址进行 Ping 测试

命令格式

AT+PING=<host>[,<-t>,<interval>,<-n>,<count>,<-l>,<size>]
AT+PING=<stop>

响应格式

成功响应:

OK

错误响应:

ERROR:<error_no>

参数

<host>:

目标主机地址

  • 支持 IPv4 地址或域名

<-t>:

设置间隔时间

  • 后跟 <interval> 参数

  • <interval>:间隔时间(秒)

    • 正整数

    • 默认值:1

<-n>:

设置 Ping 包数量

  • 后跟 <count> 参数

  • <count>:Ping 包数量

    • 正整数

    • 默认值:4

<-l>:

设置数据包大小

  • 后跟 <size> 参数

  • <size>:数据包大小(字节)

    • 正整数

    • 默认值:32

<stop>:

终止当前 Ping 任务

  • 特殊参数值:Stop

备注

<-t>、<-l>、<-n> 参数顺序可任意排列。

错误代码

  • 1: 输入空参数

  • 2: 参数数量错误

示例

  • 默认参数测试:

    AT+PING=192.168.31.200
    
    OK
    [$][ping_test] 32 bytes from 192.168.31.1: icmp_seq=1 time=135 ms
    [$][ping_test] 32 bytes from 192.168.31.1: icmp_seq=2 time=5 ms
    [$][ping_test] 32 bytes from 192.168.31.1: icmp_seq=3 time=102 ms
    [$][ping_test] 32 bytes from 192.168.31.1: icmp_seq=4 time=3 ms
    [$][ping_test] 4 packets transmitted, 4 received, 0% packet loss, average 60 ms
    [$][ping_test] min: 3 ms, max: 135 ms
    
  • 自定义参数测试:

    AT+PING=www.sohu.com,-n,3,-l,128
    
    OK
    [$][ping_test] 128 bytes from 192.168.31.1: icmp_seq=1 time=40 ms
    [$][ping_test] 128 bytes from 192.168.31.1: icmp_seq=2 time=9 ms
    [$][ping_test] 128 bytes from 192.168.31.1: icmp_seq=3 time=21 ms
    [$][ping_test] 3 packets transmitted, 3 received, 0% packet loss, average 23 ms
    [$][ping_test] min: 9 ms, max: 40 ms
    

AT+IPERF

功能说明

TCP/UDP 网络带宽测试

备注

该命令仅支持在 手动测试模式 下使用。

命令格式

服务端模式:

AT+IPERF=<-s>[,<-p>,<port>,<-u>]

客户端模式:

AT+IPERF=<-c>,<host|stop>[,<-i>,<periodic>,<-l>,<size>,<-u>,<-b>,<bandwidth>,<-d>,<-t>,<transtime>,<-n>,<count>,<-S>,<tos>]

响应格式

成功响应:

OK

错误响应:

ERROR:<error_no>

参数

<-s>:

服务端模式

<-c>:

客户端模式

  • 后跟 <host|stop> 参数

  • <host|stop>:目标主机或停止指令

    • <stop>:终止指定/全部测试流

    • <host>:服务端主机 IPv4 地址

<-p>:

设置端口号

  • 后跟 <port> 参数

  • <port>:服务端端口

    • 范围为[1,65535]

    • 默认值:5001

<-u>:

使用 UDP 协议

  • 缺省时默认使用 TCP

<-i>:

设置报告间隔

  • 后跟 <periodic> 参数

  • <periodic>:带宽报告间隔(秒)(正整数)

<-l>:

设置数据包大小

  • 后跟 <size> 参数

  • <size>:数据包大小(字节)

    • 正整数

    • 默认值:1460

<-b>:

设置 UDP 带宽

  • 后跟 <bandwidth> 参数

  • <bandwidth>:带宽(比特/秒)

    • 默认值:1

<-d>:

启用双向测试

<-t>:

设置测试时长

  • 后跟 <transtime> 参数

  • <transtime>:传输时长(秒)

    • 默认值:10

<-n>:

设置传输字节数

  • 后跟 <count> 参数

  • <count>:传输字节数(正整数)

<-S>:

设置 IP 报文的 TOS 字段

  • 后跟 <tos> 参数

  • <tos>:TOS 值

    • 范围为[0,255]

错误代码

  • 1: 输入空参数

  • 3: 参数数量错误

备注

<-t>、<-l>、<-i>等参数顺序可任意排列。

示例

  • TCP测试:

    AT+IPERF=-s,-p,5002
    AT+IPERF=-c,192.168.1.2,-t,100,-p,5002
    
  • UDP测试:

    AT+IPERF=-c,192.168.1.2,-t,100,-p,5002,-u
    

AT+IPERF3

功能说明

TCP 网络带宽测试(IPERF3 协议)

备注

该命令仅支持在 手动测试模式 下使用。

命令格式

服务端模式:

AT+IPERF3=<-s>[,<-p>,<port>]

客户端模式:

AT+IPERF3=<-c>,<host|stop>[,<-i>,<periodic>,<-l>,<size>,<-d>,<-t>,<transtime>,<-n>,<count>]

响应格式

成功响应:

OK

错误响应:

ERROR:<error_no>

参数

<-s>:

服务端模式

<-c>:

客户端模式

  • 后跟 <host|stop> 参数

  • <host|stop>:目标主机或停止指令

    • <stop>:终止指定/全部测试流

    • <host>:服务端主机 IPv4 地址

<-p>:

设置端口号

  • 后跟 <port> 参数

  • <port>:服务端端口

    • 范围为[1,65535]

    • 默认值:5001

<-i>:

设置报告间隔

  • 后跟 <periodic> 参数

  • <periodic>:带宽报告间隔(秒)(正整数)

<-l>:

设置数据包大小

  • 后跟 <size> 参数

  • <size>:数据包大小(字节)

    • 正整数

    • 默认值:1460

<-d>:

启用双向测试

<-t>:

设置测试时长

  • 后跟 <transtime> 参数

  • <transtime>:传输时长(秒)

    • 默认值:10

<-n>:

设置传输字节数

  • 后跟 <count> 参数

  • <count>:传输字节数(正整数)

错误代码

  • 1: 输入空参数

  • 2: 参数数量错误

备注

<-t>、<-l>、<-i>等参数顺序可任意排列。

示例

AT+IPERF3=-s,-p,5002
AT+IPERF3=-c,192.168.1.2,-t,100,-p,5002