netPingS (Function)

This function sends a ICMP-echo (ping) packet to a designated host IP address and returns the reply time.

To get more detailed statistics on NX32L devices, the alternative function netPing can be used.

On NX32 devices this function only supports iface=1 (Mobile network).
 
 

Input:

IP : DINT

The IP address of the host.

iface : SINT

The network interface to use. 1 = Mobile network, 2 = LAN network, etc. (See Network)

timeout : UINT (default 500)

The time to wait for a reply from the host in milliseconds.

Returns: INT

Declaration:

 
FUNCTION netPingS : INT;
VAR_INPUT
  ip             : DINT;
  iface         : SINT := 1;
  timeout       : UINT := 500;
END_VAR;
 

Example:

INCLUDE rtcu.inc
 
VAR
  iface    : SINT := 1;
END_VAR;
 
PROGRAM pingtest;
VAR
  rc : INT;
END_VAR;
 
// Network
rc := netOpen(iface:=iface);
DebugFmt(message:="netOpen (rc=\1)",v1:=rc);
WHILE NOT netConnected(iface:=iface) DO
  Sleep(delay:=2000);
END_WHILE;
 
// Ping host
rc := netPingS(iface:=iface, ip:=sockIPFromName(str:="gw.rtcu.dk"), timeout:=1000);
DebugFmt(message := "netPingS. reply time=\1)", v1 := rc);
END_PROGRAM;