EI_API_CIP_createCfgAssembly()

uint32_t EI_API_CIP_createCfgAssembly	(	T *	pCipNode_p,
		uint16_t	assemblyInstanceId_p,
		EI_API_CIP_CBCfgAssembly	fuCfgAssemblyCb_p
	)

Creates configuration assembly instance under Assembly Object class.

Creates configuration assembly and registers routed callback if configuration assembly callback parameter is not equal NULL.

Remarks

For standard configuration assembly set callback parameter to NULL and set a callback afterwards by EI_API_CIP_setCfgAssemblyCb function call.

Parameters

[in]	pCipNode_p	Pointer to the CIP node.
[in]	assemblyInstanceId_p	Configuration assembly instance identifier.
[in]	fuCfgAssemblyCb_p	Routed configuration assembly callback function pointer.

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)
{
    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;
 
    uint8_t numInterfaces = 1;
    uint16_t cfgAssemblyInstanceId;
 
    // 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
    cfgAssemblyInstanceId = 0x67;
    errCode = EI_API_CIP_createCfgAssembly(pEI_API_CIP_NODE, cfgAssemblyInstanceId, NULL);
 
    // Set configuration assembly callback
    errCode = EI_API_CIP_setCfgAssemblyCb(pEI_API_CIP_NODE, cfgAssemblyInstanceId, EI_APP_cfgAssemblyCb);
 
    ...
 
}

See also

EI_API_CIP_createCfgAssembly EI_API_CIP_setCfgAssemblyCb EI_API_CIP_EError_t