PN_API_IOD_dataReadCbf

typedef PN_API_IOD_IOXS(* PN_API_IOD_dataReadCbf) (PN_API_IOD_Handle_t *const pnHandle, PN_API_IOD_DevAddr_t *const addr, const uint32_t bufLen, uint8_t *const buffer, const PN_API_IOD_IOXS remoteIops)

Callback function prototype to write output data received from the IO controller to the physical output of a submodule.

This function is called by Profinet stack after the user application calls PN_API_IOD_initiateDataRead(). IOCS must be returned to the stack as a return value. This value is communicated to the IO controller in the next cycle.

Parameters

[in]	pnHandle	Profinet API Handle.
[in]	addr	Geographical address (slot/subslot) of the module/submodule.
[in]	bufLen	Length of data.
[in]	buffer	Pointer to data buffer to read from.
[in]	remoteIops	IOPS from the IO controller, can be: PN_API_IOD_STATUS_BAD or PN_API_IOD_STATUS_GOOD.

Returns

Local IOCS as PN_API_IOD_IOXS.

Return values

PN_API_IOD_STATUS_GOOD	Data received is good.
PN_API_IOD_STATUS_BAD	Data received is bad.

Example

#include "pn_api_iod_callbacks.h"
#include "pn_api_iod_data.h"
#include "pn_api_iod_startup.h"
 
//Implement the callback function in the user application
PN_API_IOD_IOXS PN_APP_IOD_cbDataRead(
   PN_API_IOD_Handle_t *const pnHandle,
   PN_API_IOD_DevAddr_t *const addr,
   const uint32_t bufLen, uint8_t *const buffer,
   const PN_API_IOD_IOXS remoteIops)
{...}
 
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 = {
    .readData = PN_APP_IOD_cbDataRead,
    ...}
 
//Register callback function
status = PN_API_IOD_registerCallbacks(pnHandle, &callbacks);