EI_API_ADP_setSerialNumber()

uint32_t EI_API_ADP_setSerialNumber	(	T *	pAdp_p,
		uint32_t	serialNumber_p
	)

Set the adapter's unique serial number (Instance Attribute ID: 6).

Function to set a unique serial number of the adapter selected by parameter pAdp_p. This attribute is used in conjunction with the vendor ID to form a unique identifier for each device on any CIP network. It is in the responsibility of the device vendor to guarantee that the serial number is unique across all of the vendor's devices.

The value zero is not a valid serial number and shall not be assigned to a product.

Parameters

[in]	pAdp_p	Pointer to the adapter.
[in]	serialNumber_p	New serial number.

Returns

EI_API_ADP_EError_t as uint32_t value.

Return values

EI_API_ADP_eERR_OK	Success.
EI_API_ADP_eERR_GENERAL	General error.

Example

#include <api/EI_API.h>
 
 
EI_API_ADP_T* pEI_API_ADP = NULL;
uint32_t errCode;
uint8_t numInterfaces = 1;
 
pEI_API_ADP = EI_API_ADP_new(numInterfaces);
 
// Set serial number to 101
errCode = EI_API_ADP_setSerialNumber(pEI_API_ADP, 0x065);

See also

EI_API_ADP_getSerialNumber EI_API_ADP_EError_t