u-blox

15 Diagnostics

Diagnostics Tools

15.1 AT Commands

AT Command
Description
Diagnostics Ping
Stop an ongoing Ping
Diagnostics Iperf

15.1.1 AT+UDGP - Diagnostics Ping

Send a ping command.
Syntax
AT Command
Description
AT+UDGP=<destination>[,<count>]
Sends a ping command to a destination address every second, repeating it (count) times.
Defined values
Parameter
Type
Description
destination
string
Destination host to send a ping call to in the form of an IPv4 address (i.e. 192.168.1.10) or hostname (i.e. www.u-blox.com).

Valid length: 4..80
count
integer
The number of pings (or packets) that will be transmitted. 0 means ping continuously.

Valid values: 0..65535

Default value: 4

15.1.2 AT+UDGSP - Stop an ongoing Ping

Syntax
AT Command
Description
AT+UDGSP
This command will stop any ping in progress.


Notes:
The command is asynchronous, and the ping will not be interrupted immediately, but right after the next ping packet has a response, which might take a few seconds if the packet response times out. This command always returns OK and does nothing if there is no ping in progress.

15.1.3 AT+UDGI - Diagnostics Iperf

Syntax
AT Command
Description
AT+UDGI=<iperf_action>,<protocol_type>[,<role>,<port>,<report_interval>[,<time_boundary>,<ip_addr>[,<length>[,<bandwidth>[,<bidirectional>]]]]]
Start/stop IPERF 2 server/client
Defined values
Parameter
Type
Description
iperf_action
enumerator
Action

Valid values:
1: Start iperf
2: Stop iperf
protocol_type
enumerator
IP protocol

Valid values:
1: TCP
2: UDP
role
enumerator
Role

Valid values:
1: Server
2: Client
port
integer
Port
report_interval
integer
Report interval
time_boundary
integer
Time boundary. Client only. Ignored if role is server
ip_addr
ip_addr
IP address to connect to. Client only. Ignored if role is server
bandwidth
integer
Bandwidth to be used for UDP
length
integer
Size of packets.

Valid values: 1..1460

Default value: 1460
bidirectional
enumerator
Bidirectional flag. Client only. Ignored if role is server

Valid values:
0: Off
1: On
When starting bidirectional TCP test, start a server on both tester and DUT, then start a client with bidirectional flag on the DUT.
If doing bidirectional UDP test, start a server on both DUT and tester and then start a client with a bidirectional flag on both.

15.2 Unsolicited Response Codes

Unsolicited Response Code
Description
Event Ping Complete
Event Ping Response
Event Iperf output

15.2.1 +UEDGPC - Event Ping Complete

Event is sent out with a summary of the ping results after all packets are transmitted.
Syntax
+UEDGPC:<transmitted_packets>,<received_packets>,<packet_loss_rate>,<avg_response_time>
Defined values
Parameter
Type
Description
transmitted_packets
integer
Total number of packets transmitted successfully.
received_packets
integer
Total number of packets received successfully.
packet_loss_rate
integer
Packet loss rate in percentage between transmitted and received packets.
avg_response_time
integer
Average ping response time in milliseconds.

15.2.2 +UEDGP - Event Ping Response

Event is sent out when a single ping has a result.
Syntax
+UEDGP:<ping_response>,<response_time>
Defined values
Parameter
Type
Description
ping_response
enumerator
Ping Response result. 0 - ping failed, 1 - ping successful

Valid values:
0: Ping failed.
1: Ping succeeded.
response_time
integer
Ping response time in milliseconds.

15.2.3 +UEDGI - Event Iperf output

Event is sent out for all output string send by iperf tool
Syntax
+UEDGI:<iperf_output>
Defined values
Parameter
Type
Description
iperf_output
string
Iperf readable output string

Valid length: 0..99
Last updated: 04 March 2025
Need help?Contact Support
Questions?Contact us