[FreeRTOS Embedded IP Stack API]
BaseType_t FreeRTOS_SendPingRequest( uint32_t ulIPAddress, size_t xNumberOfBytesToSend, TickType_t xBlockTimeTicks );
Send a ping (ICMP echo) request to a remote computer.
ipconfigSUPPORT_OUTGOING_PINGS must be set to 1 in FreeRTOSIPConfig.h for FreeRTOS_SendPingRequest() to be available.
The IP stack calls the application defined vApplicationPingReplyHook() hook (or callback) function when it receives a reply to an outgoing ping request.
The IP address to which the ping request is sent.
The IP address is expressed as a 32-bit number in network byte order.
The number of data bytes to send in the ping request.
The maximum time the calling task is prepared to wait
for a network buffer if one is not immediately available.
If a network buffer is not available then the calling task will be held in the Blocked state (so other tasks can execute) until either a buffer becomes available and therefore the ping request transmitted, or the block time expires.
The block time is specified in ticks. Milliseconds can be converted to ticks by dividing the time in milliseconds by portTICK_PERIOD_MS.
If a ping request is successfully sent then the sequence number sent in the ping message is returned to allow the application writer to match ping requests transmitted with ping replies received. See the example below.
If a ping request could not be sent then pdFAIL is returned.
This example defines two functions. vSendPing() transmits 8 bytes to a remote IP address. vApplicationPingReplyHook() is the standard FreeRTOS+UDP ping reply callback function. vApplicationPingReplyHook() receives the ping reply, then sends the received sequence number to vSendPing() where it is compared to the sequence number from the ping request.