Download FreeRTOS
 

Quality RTOS & Embedded Software

LIBRARIES
WHAT'S NEW
Simplifying Authenticated Cloud Connectivity for Any Device.
Designing an energy efficient and cloud-connected IoT solution with CoAP.
Introducing FreeRTOS Kernel version 11.0.0:
FreeRTOS Roadmap and Code Contribution process.
OPC-UA over TSN with FreeRTOS.

vApplicationPingReplyHook()

[FreeRTOS-Plus-TCP API Reference]

FreeRTOS_IP.h
void vApplicationPingReplyHook( ePingReplyStatus_t eStatus, uint16_t usIdentifier );
		

vApplicationPingReplyHook() is an application defined hook (or callback) function that is called by the TCP/IP stack when the stack receives a reply to an ICMP echo (ping) request that was generated using the FreeRTOS_SendPingRequest() function.

Callback functions are implemented by the application writer, but called by the TCP/IP stack. The prototype of the callback function must exactly match the prototype above (including the function name).

Parameters:

eStatus   eStatus will be set (by the TCP/IP stack) to one of the following values:

Value Description
eSuccess The echo reply was received correctly.
eInvalidChecksum The data received in the echo reply matched that sent in the echo request, but the reply had an incorrect checksum.
eInvalidData The data received in the echo reply did not match that sent in the echo request.

usIdentifier   The identifier received in the echo reply.

Each echo request has a unique identifier to allow replies to be matched to the requests. The FreeRTOS_SendPingRequest() function returns the identifier of the outgoing echo request it generated.

Example usage:

The example on the FreeRTOS_SendPingRequest() documentation page includes an example implementation of vApplicationPingReplyHook().

Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.