PN_API_IOD_asyncReqDoneCbf

typedef void(* PN_API_IOD_asyncReqDoneCbf) (PN_API_IOD_Handle_t *const pnHandle, const uint32_t arNum, const PN_API_IOD_AlarmType_t alarmType, const uint32_t api, PN_API_IOD_DevAddr_t *const addr, const uint32_t status, const uint16_t diagnosisTag)

Callback function prototype to acknowledge an asynchronous request issued by the user application to the Profinet stack. Currently, only alarms are implemented as asynchronous requests.

If the submodule to which the alarm has been assigned, is not included in a running AR, then arNum is set to 0 by the stack to refer to a dummy acknowledgement.

Parameters

[in]	pnHandle	Profinet API Handle.
[in]	arNum	AR number.
[in]	alarmType	Alarm type (see PN_API_IOD_AlarmType_t).
[in]	api	Application Process Identifier.
[in]	addr	Geographical address (slot/subslot) of the module/submodule.
[in]	status	PN_API_OK or PN_API_NOT_OK.
[in]	diagnosisTag	Diagnosis tag which distinguishes different alarms on one subslot (can not be 0).

Example

#include "pn_api_iod_alarm.h"
#include "pn_api_iod_callbacks.h"
#include "pn_api_iod_startup.h"
 
//Implement the callback function in the user application
PN_API_IOD_IOXS PN_APP_IOD_cbAsyncReqDone(
    PN_API_IOD_Handle_t *const pnHandle,
    uint32_t arNum, PN_API_IOD_AlarmType_t alarmType,
    uint32_t api, PN_API_IOD_DevAddr_t *addr,
    uint32_t status, uint16_t diagnosisTag)
{...}
 
PN_API_IOD_Handle_t* pnHandle = NULL;
uint32_t status;
 
pnHandle = PN_API_IOD_new();
 
//Store callback functions implemented by the user application
PN_API_IOD_Callbacks_t callbacks = {
    .asyncReqDone = PN_APP_IOD_cbAsyncReqDone,
    ...}
 
//Register callback function
status = PN_API_IOD_registerCallbacks(pnHandle, &callbacks);