Network AT 命令集
Network AT 命令集提供 DNS、SNTP、Ping 包，iperf 吞吐量测试等常用网络服务
备注
Network AT 命令集默认启用。
参考 配置工程（menuconfig） 进入
CONFIG AT CMD配置，取消勾选Enable Network来关闭 Network AT 命令集。
AT+PING
功能说明
对域名或 IP 地址进行 Ping 测试
命令格式
AT+PING=<host>[,<-t>,<-n>,<count>,<-l>,<size>]
AT+PING=<stop>
响应格式
成功响应：
OK
错误响应：
ERROR:<error_no>
参数
- <host>:
目标主机地址
支持 IPv4 地址或域名
- <-t>:
Ping 指定的主机，直到停止
- <-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
AT+DNS
功能说明
解析域名到 IP 地址
备注
DNS AT 命令集默认未启用。
参考 配置工程（menuconfig） 进入
CONFIG AT CMD配置，勾选Enable DNS来启用 DNS AT 命令集。
命令格式
AT+DNS=<host>
响应格式
成功响应：
+DNS:<ip_address>
OK
错误响应：
ERROR:<error_no>
参数
- <host>:
目标主机域名
错误代码
1: 输入空参数
2: 域名解析失败
应用示例
解析域名 www.baidu.com：
AT+DNS=www.baidu.com
+DNS:103.235.46.102
OK
AT+QUERYDNSSRV
功能说明
查询当前配置的 DNS 服务器地址
备注
DNS AT 命令集默认未启用。
参考 配置工程（menuconfig） 进入
CONFIG AT CMD配置，勾选Enable DNS来启用 DNS AT 命令集。
命令格式
AT+QUERYDNSSRV
响应格式
成功响应：
+QUERYDNSSRV:[<primary_dns>,<secondary_dns>]
OK
错误响应：
ERROR:<error_no>
错误代码
1: 输入参数不为空
应用示例
查询 DNS 服务器：
AT+QUERYDNSSRV
+QUERYDNSSRV:8.8.8.8, 8.8.4.4
OK
AT+SETDNSSRV
功能说明
设置 DNS 服务器地址
备注
DNS AT 命令集默认未启用。
参考 配置工程（menuconfig） 进入
CONFIG AT CMD配置，勾选Enable DNS来启用 DNS AT 命令集。
命令格式
AT+SETDNSSRV=<primary_dns>[,<secondary_dns>]
响应格式
成功响应：
OK
错误响应：
ERROR:<error_no>
参数
- <primary_dns>:
第一个 DNS 服务器地址
- <secondary_dns>:
第二个 DNS 服务器地址（可选）
错误代码
1: 参数数量错误
2: DNS 服务器地址格式无效
应用示例
设置一个 DNS 服务器 8.8.8.8：
AT+SETDNSSRV=8.8.8.8
OK
设置两个 DNS 服务器 8.8.8.8 和 8.8.4.4：
AT+SETDNSSRV=8.8.8.8,8.8.4.4
OK
AT+SNTPCFG
功能说明
配置 SNTP 服务的启用状态、时区、同步间隔和服务器列表
备注
SNTP AT 命令集默认未启用。
参考 配置工程（menuconfig） 进入
CONFIG AT CMD配置，勾选Enable SNTP来启用 SNTP AT 命令集。
命令格式
AT+SNTPCFG=<enable>[,<timezone>][,<interval>][,<server1>][,<server2>][,<server3>]
响应格式
成功响应：
OK
错误响应：
ERROR:<error_no>
参数
- <enable>:
是否启用 SNTP 服务
0：禁用
1：启用
- <timezone>:
时区偏移量，支持以下两种格式：
格式一：以小时为单位，范围：[-12,14]
格式二：UTC 偏移量，格式为 [+|-][hh]mm，小时 (hh) 范围：[-12,14]，分钟 (mm) 范围：[00,59]
默认值：8，即中国时区 (UTC+08:00)
- <interval>:
同步间隔时间（秒）
范围：[15,1073741]
默认值：15
- <server1>:
第一个 SNTP 服务器地址
- <server2>:
第二个 SNTP 服务器地址
- <server3>:
第三个 SNTP 服务器地址
最多支持 3 个服务器
若未填写服务器参数，则默认使用
pool.ntp.org
错误代码
1: 参数数量错误
2: 参数格式错误
应用示例
启用 SNTP 服务，设置中国时区 (UTC+08:00)，同步间隔 15 秒，配置 SNTP 服务器地址 pool.ntp.org 、 ntp.sjtu.edu.cn 和 ntp.aliyun.com
AT+SNTPCFG=1,8,15,pool.ntp.org,ntp.sjtu.edu.cn,ntp.aliyun.com
OK
启用 SNTP 服务，设置美国纽约的时区 (UTC−05:00)，同步间隔 60 秒，配置 SNTP 服务器地址 time.google.com
AT+SNTPCFG=1,-500,60,time.google.com
OK
启用 SNTP 服务，设置新西兰时区查塔姆群岛的时区 (Chatham Islands, UTC+12:45)，同步间隔默认，配置 SNTP 服务器地址 time.google.com
AT+SNTPCFG=1,1245,,time.google.com
OK
AT+SNTPQUERY
功能说明
查询当前 SNTP 服务的配置信息
备注
SNTP AT 命令集默认未启用。
参考 配置工程（menuconfig） 进入
CONFIG AT CMD配置，勾选Enable SNTP来启用 SNTP AT 命令集。
命令格式
AT+SNTPQUERY
响应格式
成功响应：
enable: <SNTP 服务启用状态，0：禁用，1：启用>
timezone: <时区>
interval: <同步间隔时间（秒）>
server_count: <配置服务器数量>
server0: <SNTP 服务器地址 1>
server1: <SNTP 服务器地址 2>
server2: <SNTP 服务器地址 3>
OK
错误响应：
ERROR:<error_no>
错误代码
1: 参数错误
应用示例
AT+SNTPQUERY
enable: 1
timezone: 800
interval: 60
server_count: 2
server0: pool.ntp.org
server1: ntp.sjtu.edu.cn
OK
AT+SNTPTIME
功能说明
查询当前 SNTP 时间
备注
SNTP AT 命令集默认未启用。
参考 配置工程（menuconfig） 进入
CONFIG AT CMD配置，勾选Enable SNTP来启用 SNTP AT 命令集。
命令格式
AT+SNTPTIME
响应格式
成功响应：
+SNTPTIME:<current_time> <timezone>
OK
错误响应：
ERROR:<error_no>
应用示例
AT+SNTPTIME
+SNTPTIME:2025-10-20 18:30:30 UTC+08:00
OK
