PN_API_IOD_arConnectCbf

typedef void(* PN_API_IOD_arConnectCbf) (PN_API_IOD_Handle_t *const pnHandle, PN_API_IOD_ArType_t arType, uint32_t arNum, uint16_t sessionKey, uint16_t sendClock, uint16_t redRatioIoCrIn, uint16_t redRatioIoCrOut, uint32_t hostIpAddr)

Callback function prototype to notify the user application that a new connection to an IO controller has been established.

The user application must save the AR information that it received from the stack within the implementation of this callback.

Parameters

[in]	pnHandle	Profinet API Handle.
[in]	arType	AR type.
[in]	arNum	AR number.
[in]	sessionKey	Session key.
[in]	sendClock	Send clock parameter.
[in]	redRatioIoCrIn	Reduction ratio of input IOCR.
[in]	redRatioIoCrOut	Reduction ratio of output IOCR.
[in]	hostIpAddr	IP address of the host (IO controller).

Example

#include "pn_api_iod_callbacks.h"
#include "pn_api_iod_communication.h"
#include "pn_api_iod_startup.h"
 
//Implement the callback function in the user application
void PN_APP_IOD_cbArConnectInd(PN_API_IOD_Handle_t *const pnHandle,
PN_API_IOD_ArType_t arType, uint32_t arNum, uint16_t sessionKey,
uint16_t sendClock, uint16_t redRatioIoCrIn, uint16_t redRatioIoCrOut,
uint32_t hostIpAddr)
{...}
 
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 = {
    .arConnect = PN_APP_IOD_cbArConnectInd,
    ...}
 
//Register callback function
status = PN_API_IOD_registerCallbacks(pnHandle, &callbacks);