PN_API_IOD_plugSubmodList()

uint32_t PN_API_IOD_plugSubmodList	(	PN_API_IOD_Handle_t *const	pnHandle,
		const PN_API_IOD_SubmodListEntry_t *	ioSubmodList,
		uint32_t	ioSubmodListSize,
		const PN_API_IOD_Im0ListEntry_t *	im0List,
		uint32_t	im0ListSize,
		uint32_t *	statusList
	)

Inserts a list of submodules into subslots.

During operation, this function can be utilized to add a list of new submodules or re- install a previously failed or removed list of submodules.

Warning

PN_API_IOD_startup() must be called first during startup to insert the DAP and PDev data at least. Only then may additional modules be plugged in.

Parameters

[in]	pnHandle	Profinet API Handle.
[in]	ioSubmodList	IO Submodule list.
[in]	ioSubmodListSize	Number of elements in IO Submodule list.
[in]	im0List	IM0 list.
[in]	im0ListSize	Number of elements in IM0 list.
[out]	statusList	List of return-Statuses with a size equals to ioSubmodListSize.

Returns

result of the operation as uint32_t.

Return values

PN_API_OK	Success.
PN_API_NOT_OK	Something went wrong.
PN_API_ERR_PARAM	Invalid parameter.

Example

#include "pn_api_iod_device.h"
#include "pn_api_iod_startup.h"
 
PN_API_IOD_Handle_t* pnHandle = NULL;
uint32_t status;
 
pnHandle = PN_API_IOD_new();
 
//Prepare and call PN_API_IOD_startup()
...
 
PN_API_IOD_SubmodListEntry_t* ioSubmodList = NULL;
PN_API_IOD_Im0ListEntry_t* im0List = NULL;
uint32_t ioSubmodListSize = 0;
uint32_t im0ListSize = 0;
uint32_t statusList [ioSubmodListSize];
 
//Fill up info and sizes of ioSubmodList and im0List
...
 
status = PN_API_IOD_plugSubmodList(pnHandle, ioSubmodList,
   ioSubmodListSize, im0List, im0ListSize, statusList);