EI_API_CIP_setRoutingRoutablePorts()

uint32_t EI_API_CIP_setRoutingRoutablePorts	(	T *	pCipNode_p,
		const uint8_t *	pRoutablePortTable_p,
		uint8_t	mapSize_p
	)

Provides setup of routable ports.

Function can be called just once in time of initialization. On next attempt a new setup will be ignored.

Parameters

[in]	pCipNode_p	Pointer to the CIP node.
[in]	pRoutablePortTable_p	Routable port array of uint8_t values. Each value in array represents one port number.
[in]	mapSize_p	Size of routable port array.

Returns

EI_API_CIP_EError_t as uint32_t value.

Return values

EI_API_CIP_eERR_OK	Success.
EI_API_CIP_eERR_NODE_INVALID	CIP node is invalid, possibly EI_API_CIP_NODE_new() was not called.
EI_API_CIP_eERR_NOT_IMPLEMENTED	Parameter pRoutablePortTable_p set to NULL.

Example

#include "EI_API.h"
 
EI_API_ADP_T* pEI_API_ADP = NULL;
EI_API_CIP_NODE_T* pEI_API_CIP_NODE = NULL;
uint32_t errCode;
 
uint8_t       numInterfaces   = 1;
uint16_t      classId         = 0x10D;
uint8_t       maxLinkAddr     = 8,
const uint8_t routablePorts[] = {11, 7, 3};
 
// Create a new adapter first
pEI_API_ADP = EI_API_ADP_new(numInterfaces);
 
// Create a CIP node next
EI_API_CIP_NODE_InitParams_t initParams;
initParams.maxInstanceNum = 256;
 
pEI_API_CIP_NODE = EI_API_CIP_NODE_new(&initParams);
 
// Create a class
errCode = EI_API_CIP_createClass(pEI_API_CIP_NODE, classId);
 
errCode = EI_API_CIP_setRoutingMaxLinkAddr(pEI_API_CIP_NODE, maxLinkAddr);
 
errCode = EI_API_CIP_setRoutingRoutablePorts(pEI_API_CIP_NODE, routablePorts, sizeof(routablePorts)/sizeof(uint8_t));

See also

EI_API_CIP_createClass EI_API_CIP_setRoutingMaxLinkAddr EI_API_CIP_EError_t