Trace - Manual - PROFINET Driver

How to port PROFINET Driver

Portfolio
PROFINET Development Kits
Product
PROFINET Driver
Software version
v3.1.0
Edition
03/2024
Language
en-US (original)

Overview

PN Driver has a built-in trace system called PROFINET Trace (PNTRC) that is useful for troubleshooting if there are problems in the configuration or system adaption. However, this trace system is optional.

The trace system can be enabled and configured by the application with the PNIO_DEBUG_SETTINGS_TYPE parameter passed to SERV_CP_Init (refer to the PROFINET IO-Base user programming interface manual). If the trace system is configured a callback function will be called whenever the internal trace buffer is full. The application is responsible for storing the trace data.

Traces are written in a proprietary binary format. Please contact Siemens support to analyze the trace data and to obtain advice on setting the correct trace level.

Integration in different platforms and operating systems

The integration in different platforms and operating systems is done by EPS. The parameters passed to SERV_CP_Init are available in the application abstraction function EPS_APP_INIT. For details, see section Function EPS_APP_INIT. The systems integrator has to configure the trace system according to the particular settings of the application. The systems integrator is also responsible for the configuration of the system for the callback function which is handed over by application.

As an example, see PN Driver application abstraction implementation in section EPS APP (application abstraction).

Note

The systems integrator is responsible for an efficient trace data repository in his system (preferably ring buffer and memory stack). For the sake of convenience, a continuous trace with storage in the file system has been implemented in the application examples. This procedure, however, is not suitable for productive operation.