Network AT Commands
Provides DNS, SNTP, ping, iperf throughput testing and other common network services.
Note
The Network AT commands are enabled by default.
Refer to Configuring SDK (menuconfig) and navigate to CONFIG AT CMD settings. Uncheck Enable Network to disable this command set.
AT+PING
Functional Description
Perform ping test on domain name or IP address
Command Format
AT+PING=<host>[,<-t>,<interval>,<-n>,<count>,<-l>,<size>]
AT+PING=<stop>
Response Format
Success:
OK
Error:
ERROR:<error_no>
Parameters
- <host>: Target host address
Supports IPv4 address or domain name
- <-t>: Set interval time
Followed by <interval> parameter
<interval>: Interval time (seconds) - Positive integer - Default: 1
- <-n>: Set ping packet count
Followed by <count> parameter
<count>: Number of ping packets - Positive integer - Default: 4
- <-l>: Set packet size
Followed by <size> parameter
<size>: Packet size (bytes) - Positive integer - Default: 32
- <stop>: Terminate current ping task
Special parameter value: stop
Note
<-t>, <-l>, <-n> parameters can be in any order
Error Codes
1: Empty parameters
2: Incorrect number of parameters
Examples
Default parameters test:
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
Custom parameters test:
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
Functional Description
TCP/UDP network bandwidth test
Note
This command is only supported in manual test mode.
Command Format
Server mode:
AT+IPERF=<-s>[,<-p>,<port>,<-u>]
Client mode:
AT+IPERF=<-c>,<host|stop>[,<-i>,<periodic>,<-l>,<size>,<-u>,<-b>,<bandwidth>,<-d>,<-t>,<transtime>,<-n>,<count>,<-S>,<tos>]
Response Format
Success:
OK
Error:
ERROR:<error_no>
Parameters
<-s>: Server mode
<-c>: Client mode
Followed by <host|stop> parameter
<host|stop>: Target host or stop command
<stop>: Terminate specific/all test streams
<host>: Server host IPv4 address
<-p>: Set port number
Followed by <port> parameter
<port>: Server port
Range [1,65535]
Default: 5001
<-u>: Use UDP protocol
Default TCP when omitted
<-i>: Set report interval
Followed by <periodic> parameter
<periodic>: Bandwidth report interval (seconds)
Positive integer
<-l>: Set packet size
Followed by <size> parameter
<size>: Packet size (bytes)
Positive integer
Default: 1460
<-b>: Set UDP bandwidth
Followed by <bandwidth> parameter
<bandwidth>: Bandwidth (bits/sec)
Default: 1
<-d>: Enable bidirectional test
<-t>: Set test duration
Followed by <transtime> parameter
<transtime>: Transmission duration (seconds)
Default: 10
<-n>: Set transmission byte count
Followed by <count> parameter
<count>: Byte count
Positive integer
<-S>: Set IP TOS field
Followed by <tos> parameter
<tos>: TOS value
Range [0,255]
Error Codes
1: Empty parameters
3: Incorrect number of parameters
Note
Parameters like <-t>, <-l>, <-i> can be in any order
Examples
TCP test:
AT+IPERF=-s,-p,5002
AT+IPERF=-c,192.168.1.2,-t,100,-p,5002
UDP test:
AT+IPERF=-c,192.168.1.2,-t,100,-p,5002,-u
AT+IPERF3
Functional Description
TCP network bandwidth test (IPERF3 protocol)
Note
This command is only supported in manual test mode.
Command Format
Server mode:
AT+IPERF3=<-s>[,<-p>,<port>]
Client mode:
AT+IPERF3=<-c>,<host|stop>[,<-i>,<periodic>,<-l>,<size>,<-d>,<-t>,<transtime>,<-n>,<count>]
Response Format
Success:
OK
Error:
ERROR:<error_no>
Parameters
<-s>: Server mode
<-c>: Client mode
Followed by <host|stop> parameter
<host|stop>: Target host or stop command
<stop>: Terminate specific/all test streams
<host>: Server host IPv4 address
<-p>: Set port number
Followed by <port> parameter
<port>: Server port
Range [1,65535]
Default: 5001
<-i>: Set report interval
Followed by <periodic> parameter
<periodic>: Bandwidth report interval (seconds)
Positive integer
<-l>: Set packet size
Followed by <size> parameter
<size>: Packet size (bytes)
Positive integer
Default: 1460
<-d>: Enable bidirectional test
<-t>: Set test duration
Followed by <transtime> parameter
<transtime>: Transmission duration (seconds)
Default: 10
<-n>: Set transmission byte count
Followed by <count> parameter
<count>: Byte count
Positive integer
Error Codes
1: Empty parameters
2: Incorrect number of parameters
Note
Parameters like <-t>, <-l>, <-i> can be in any order
Examples
AT+IPERF3=-s,-p,5002
AT+IPERF3=-c,192.168.1.2,-t,100,-p,5002