Implementation of functions
EPS requires the application to implement some functions since it cannot fully decide how the system is structured. The functions are implemented by the user as EPS output functions.
The following figure shows the interaction between EPS and the application via these output functions.
You can change the behavior of PN Driver by changing the output functions described in this section.
Note
PN Driver interacts with EPS APP interface. The customer-specific application may not interact directly with EPS.
EPS APP output functions provide interfaces to handle system functionality, customer specific Ethernet drivers, system exceptions, LED control and an interface to provide MAC addresses to EPS. These output functions are implemented by PN Driver and may be adapted to a customer specific hardware or OS.
Interfaces
System functionality
Interface for handling of system specific functionality, e.g. driver installation, data transfer between different CPU systems and preparation of firmware files. For more details, see section EPS APP Interface - System functionality.
Driver adaption
Interface to facilitate the integration of customer-specific drivers. For example, EPS provides adaptations for access to Ethernet devices such as eps_wpcapdrv wrapper for Pcap device driver (see section PN Device Driver). The output functions described here are used to manage the application and system specific drivers. The user may modify these output functions to integrate another driver. For more details, see section EPS APP Interface - Driver Adaption.
System exception
Interface for exception handling. The user may modify these output functions according to the OS in order to save detailed debug information for diagnostics.
LED control
The user may use this interface to implement a product-specific handling for DCP show location signaling (the hardware PHY LED handling is already part of the Ethernet Device Driver implementation of the PROFINET stack).
MAC address
If non-Siemens hardware is being used and the NICs do not have assigned MAC addresses, the user has to provide the MAC addresses for the interface.
Output functions
Table: EPS APP interfaces and output functions
| Interface | EPS APP output function |
|---|---|
| System functionality | EPS_APP_INIT |
EPS_APP_UNDO_INIT |
|
EPS_APP_ALLOC_FILE |
|
EPS_APP_FREE_FILE |
|
| _ _ | EPS_APP_GET_DRIVER_PATH |
| Driver adaptation | EPS_APP_INSTALL_DRV_OPEN |
| _ _ | EPS_APP_UNINSTALL_DRV_CLOSE |
| System exception | EPS_APP_KILL_EPS |
EPS_APP_HALT |
|
EPS_APP_FATAL_HOOK |
|
| _ _ | EPS_APP_SAVE_DUMP_FILE |
| LED control | EPS_APP_LL_LED_BACKUP_MODE |
EPS_APP_LL_LED_RESTORE_MODE |
|
EPS_APP_LL_LED_BLINK_SET_MODE |
|
EPS_APP_LL_LED_BLINK_BEGIN |
|
EPS_APP_LL_LED_BLINK_END |
|
| _ _ | EPS_APP_LL_LED_SET_MODE |
| MAC address | EPS_APP_GET_MAC_ADDR |