PN_API_PDEV_applyConfiguration()

uint32_t PN_API_PDEV_applyConfiguration

(

const PN_API_PDEV_SConfiguration_t *

pConfiguration_p

)

Apply configuration of physical device.

Physical device must be configured after initialization but before getting started.

Parameters

[in]

pConfiguration_p

Configuration of physical device.

Returns

PN_API_PDEV_EError_t as uint32_t

Return values

PN_API_PDEV_eOK
PN_API_PDEV_eERROR_MISSING_PARAMETER_POINTER
PN_API_PDEV_eERROR_EXCEEDING_MAX_DEVICE_DESCRIPTION_LENGTH
PN_API_PDEV_eERROR_EXCEEDING_MAX_ORDER_ID_LENGTH
PN_API_PDEV_eERROR_EXCEEDING_MAX_SERIAL_NUMBER_LENGTH
PN_API_PDEV_eERROR_EXCEEDING_MAX_HW_REVISION_LENGTH
PN_API_PDEV_eERROR_EXCEEDING_MAX_SW_REVISION_SUBSTRING_LENGTH
PN_API_PDEV_eERROR_WRONG_STATE

Example

#include <PN_API_PDEV.h>
 
uint32_t result;
PN_API_PDEV_SConfiguration_t configuration = {0};
uint8_t aSerialNumber[PN_API_PDEV_MAX_SERIAL_NUMBER_LENGTH];
uint8_t aHwRevision[PN_API_PDEV_MAX_HW_REVISION_LENGTH];
uint8_t aSwRevisionFunctionalEnhancement[PN_API_PDEV_MAX_SW_REVISION_SUBSTRING_LENGTH];
uint8_t aSwRevisionBugFix[PN_API_PDEV_MAX_SW_REVISION_SUBSTRING_LENGTH];
uint8_t aSwRevisionInternalChange[PN_API_PDEV_MAX_SW_REVISION_SUBSTRING_LENGTH];
 
APPL_UI_getSerialNumberString (aSerialNumber, PN_API_PDEV_MAX_SERIAL_NUMBER_LENGTH);
APPL_UI_getHardwareRevisionString (aHwRevision, PN_API_PDEV_MAX_HW_REVISION_LENGTH);
APPL_UI_getSwRevFuncEnhancementString (aSwRevisionFunctionalEnhancement, PN_API_PDEV_MAX_SW_REVISION_SUBSTRING_LENGTH);
APPL_UI_getSwRevBugFixString (aSwRevisionBugFix, PN_API_PDEV_MAX_SW_REVISION_SUBSTRING_LENGTH);
APPL_UI_getSwRevInternalChangeString (aSwRevisionInternalChange, PN_API_PDEV_MAX_SW_REVISION_SUBSTRING_LENGTH);
 
configuration.pMacAddress = APPL_UI_getMacAddr ();
configuration.vendorId = PNC_VENDOR_ID;
configuration.deviceId = PNC_DEVICE_ID;
 
configuration.chassisId.deviceDescriptionLength = sizeof (PNC_DEVICE_DESCRIPTION) - 1;
configuration.chassisId.pDeviceDescription = PNC_DEVICE_DESCRIPTION;
configuration.chassisId.orderIdLength = sizeof (PNC_DEVICE_ORDER_ID) - 1;
configuration.chassisId.pOrderId = PNC_DEVICE_ORDER_ID;
configuration.chassisId.serialNumberLength = PN_API_PDEV_MAX_SERIAL_NUMBER_LENGTH;
configuration.chassisId.pSerialNumber = aSerialNumber;
configuration.chassisId.hwRevisionLength = PN_API_PDEV_MAX_HW_REVISION_LENGTH;
configuration.chassisId.pHwRevision = aHwRevision;
configuration.chassisId.swRevisionPrefix = PNC_DEVICE_SW_REV_PREFIX;
configuration.chassisId.swRevisionFunctionalEnhancementLength = PN_API_PDEV_MAX_SW_REVISION_SUBSTRING_LENGTH;
configuration.chassisId.pSwRevisionFunctionalEnhancement = aSwRevisionFunctionalEnhancement;
configuration.chassisId.swRevisionBugFixLength = PN_API_PDEV_MAX_SW_REVISION_SUBSTRING_LENGTH;
configuration.chassisId.pSwRevisionBugFix = aSwRevisionBugFix;
configuration.chassisId.swRevisionInternalChangeLength = PN_API_PDEV_MAX_SW_REVISION_SUBSTRING_LENGTH;
configuration.chassisId.pSwRevisionInternalChange = aSwRevisionInternalChange;
 
configuration.callbacks.cbHandleInternalError = &APPL_UI_cbErrorHandler;
configuration.callbacks.cbGetLocalTime = &APPL_UI_cbGetLocalTime;
configuration.callbacks.cbGetServerBootTime = &APPL_UI_cbGetServerBootTime;
configuration.callbacks.cbSavePermanentData = &APPL_UI_cbSavePermanentData;
 
result = PN_API_PDEV_applyConfiguration (&configuration);

See also

PN_API_PDEV_init PN_API_PDEV_start PN_API_PDEV_run