PROFINET Device  v1.04.03

◆ PN_API_DEV_applyEquipmentConfiguration()

uint32_t PN_API_DEV_applyEquipmentConfiguration ( void  )

Apply equipment configuration.

Equipment of the device has to correspond some requirements to be able to provide services on PROFINET. Here the fulfilment of following requirements will be checked:

  • Device must be equipped with a DAP module
  • Device must be equipped with a submodule, that is nominated as a I&M device representative
  • Every module must contain at least one submodule

This function must be called to finalize equipment configuration after pulling / plugging of modules / submodules

Returns
PN_API_DEV_EError_t as uint32_t value.
Return values
PN_API_DEV_eOKEquipment configuration is correct
PN_API_DEV_eERROR_CONFIG_DAP_MISSINGDAP Module is missing.
PN_API_DEV_eERROR_CONFIG_IM_DEVICE_REPRESENTATIVE_MISSINGNo submodule was nominated as I&M device representative.
PN_API_DEV_eERROR_CONFIG_IM_DEVICE_REPRESENTATIVE_INVALIDSubmodule which is nominated as I&M device representative was configured wrongly .
Example
#include <PN_API_DEV.h>
// Start equipment configuration
// Register some equipment
// Unregister some equipment
// Finish equipment configuration
PN_API_DEV_plugModule
uint32_t PN_API_DEV_plugModule(uint16_t slotNumber_p, PN_API_DEV_SModuleDescriptor_t *pModuleDescriptor_p)
Plug a module.
Definition: PN_API_main.c:1118
PN_API_DEV_pullSubmodule
uint32_t PN_API_DEV_pullSubmodule(uint16_t slotNumber_p, uint16_t subslotNumber_p)
Pull submodule.
Definition: PN_API_main.c:1333
PN_API_DEV_pullModule
uint32_t PN_API_DEV_pullModule(uint16_t slotNumber_p)
Pull module.
Definition: PN_API_main.c:1270
PN_API_DEV_plugSubmodule
uint32_t PN_API_DEV_plugSubmodule(uint16_t slotNumber_p, uint16_t subslotNumber_p, PN_API_DEV_SSubmoduleDescriptor_t *pSubmoduleDescriptor_p)
Plug a submodule.
Definition: PN_API_main.c:1207
PN_API_DEV_applyEquipmentConfiguration
uint32_t PN_API_DEV_applyEquipmentConfiguration(void)
Apply equipment configuration.
Definition: PN_API_main.c:1062