PN_API_IOD_dataReadIOxSOnlyCbf

typedef PN_API_IOD_IOXS(* PN_API_IOD_dataReadIOxSOnlyCbf) (PN_API_IOD_Handle_t *const pnHandle, PN_API_IOD_DevAddr_t *const addr, const PN_API_IOD_IOXS remoteIops)

Callback function prototype to update only IOxS for read.

This function is called by Profinet stack to notify the user application to set the IOPS status of the IO controller of a specific submodule to a specific value.

Parameters

[in]	pnHandle	Profinet API Handle.
[in]	addr	Geographical address (slot/subslot) of the module/submodule.
[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	IOCS from the IO device is good.
PN_API_IOD_STATUS_BAD	IOCS from the IO device 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_cbDataReadIOxSOnly(
   PN_API_IOD_Handle_t *const pnHandle,
   PN_API_IOD_DevAddr_t *const addr,
   const PN_API_IOD_IOXS iops)
{...}
 
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 = {
    .readIOxSDataOnly = PN_APP_IOD_cbDataReadIOxSOnly,
    ...}
 
//Register callback function
status = PN_API_IOD_registerCallbacks(pnHandle, &callbacks);