ICMP AT commands

This page describes ICMP-related AT commands.

ICMP echo request #XPING

The #XPING command sends an ICMP Echo Request, also known as Ping.

Only one ping request can be active at a time.

Set command

The set command allows you to send an ICMP Echo Request.

Syntax

AT#XPING=<url>,<length>,<timeout>[,<count>[,<interval>[,<pdn>]]]

The parameters and their defined values are the following:

<url>

String. The hostname, the IPv4, or the IPv6 address of the target host.

<length>

Integer. The length of the ICMP payload, in bytes. The value range is 0 to 1472 for IPv4 and 0 to 1452 for IPv6. These limits come from the MTU of 1500 bytes minus the IP and ICMP headers.

<timeout>

Integer. The time to wait for each reply, in milliseconds. The value range is 0 to 4294967295.

<count>

Integer. The number of echo requests to send. The default value is 1. The value range is 1 to 65535.

<interval>

Integer. The time to wait for sending the next echo request, in milliseconds. The default value is 1000. The value range is 0 to 4294967295.

<pdn>

Integer. Represents cid in the +CGDCONT command. The default value is 0.

Note

Other sockets cannot use the same PDN connection. See Socket AT commands for more information.

Unsolicited notification

#XPING: <response time> seconds

The parameters and their defined values are the following:

<response time>

Float. The elapsed time, in seconds, between the echo requests and the echo replies.

Example

AT#XPING="5.189.130.26",45,5000,5,1000
OK
#XPING: 0.386 seconds
#XPING: 0.341 seconds
#XPING: 0.353 seconds
#XPING: 0.313 seconds
#XPING: 0.313 seconds
#XPING: average 0.341 seconds
AT#XGETADDRINFO="ipv6.google.com"
#XGETADDRINFO: "2404:6800:4006:80e::200e"
OK
AT#XPING="ipv6.google.com",45,5000,5,1000
OK
#XPING: 0.286 seconds
#XPING: 0.077 seconds
#XPING: 0.110 seconds
#XPING: 0.037 seconds
#XPING: 0.106 seconds
#XPING: average 0.123 seconds
AT#XPING="5.189.130.26",45,5000,5,1000,1
OK
#XPING: 1.612 seconds
#XPING: 0.349 seconds
#XPING: 0.334 seconds
#XPING: 0.278 seconds
#XPING: 0.278 seconds
#XPING: average 0.570 seconds

Read command

The read command is not supported.

Test command

The test command is not supported.