EI_API_CIP_createRoutingCfgAssembly()

uint32_t EI_API_CIP_createRoutingCfgAssembly	(	T *	pCipNode_p,
		uint16_t	assemblyInstanceId_p,
		EI_API_CIP_CBCfgAssembly	fuCfgAssemblyCb_p,
		uint8_t	linkAddress_p
	)

Creates routed configuration assembly instance under Assembly Object class.

Creates routed configuration assembly instance and registers callback if configuration assembly callback parameter is not equal NULL. Target instance is encoded by instance ID and link address.

Remarks

For details about encoding please see EI_API_CIP_createRoutableInstance.

Parameters

[in]	pCipNode_p	Pointer to the CIP node.
[in]	assemblyInstanceId_p	Configuration assembly instance identifier.
[in]	fuCfgAssemblyCb_p	Configuration assembly callback function pointer.
[in]	linkAddress_p	Link address used to encode the target instance ID.

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	Callback function pointer set to NULL.
EI_API_CIP_eERR_INSTANCE_DOES_NOT_EXIST	The assembly with the given ID could not be found.
EI_API_CIP_eERR_ASSEMBLY_ALREADY_EXISTS	The assembly with the given ID already exists.
EI_API_CIP_eERR_MEMALLOC	Memory allocation error.

Example

#include "EI_API.h"
 
uint32_t EI_APP_cfgAssemblyCb (EI_API_CIP_NODE_T*   pCipNode_p,
                               uint16_t             o2t_p,
                               uint16_t             t2o_p,
                               uint16_t             cfg_inst_p,
                               const uint8_t* const cfg_data_p,
                               uint16_t             cfg_data_size_p,
                               uint16_t             linkaddr_p)
{
    return EI_API_eERR_CB_NO_ERROR;
}
 
void EI_APP_cipInit (void)
{
    EI_API_ADP_T*      pEI_API_ADP      = NULL;
    EI_API_CIP_NODE_T* pEI_API_CIP_NODE = NULL;
    uint32_t errCode;
 
    uint16_t cfgAssemblyInstanceId = 0x67;
    uint8_t  numInterfaces         = 1;
    uint8_t  linkAddr              = 1;
 
    // 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);
 
    ...
 
    // Under pEI_API_CIP_NODE, create assembly instance with ID = 103, with read-write access
    errCode = EI_API_CIP_createRoutingCfgAssembly(pEI_API_CIP_NODE, cfgAssemblyInstanceId, EI_APP_cfgAssemblyCb, linkAddr);
 
    ...
}

See also

EI_API_CIP_createRoutingAssembly EI_API_CIP_getRoutingAssemblySize EI_API_CIP_getRoutingAssemblyData EI_API_CIP_setRoutingAssemblyData EI_API_CIP_addRoutingAssemblyMember EI_API_CIP_EError_t