PNS Check Indication Example

Owned by Stefan Neumann
Last updated: 2020-05-13 by Enis Hassad

1. Example project

In this example, the application shall handle Check Indication on application side.

Check Indication comes, if the configuration between IO Controller and IO Device is not the same. Here is shown the situation what to do if an old device gets a stack update.


The extendedConfig example can be found in the Knowledge Base on the following website:

netX 90: https://kb.hilscher.com/display/NXLFWHST/netX+90+-+PROFINET+IO+Device+-+Examples (from V3.0.0.0)



This can alternatively be found under:

kb.hilscher.com → Software → LFW Host Examples → Profinet IO-Device → netX 90 APP / netX 51 → PROFINET IO Device - extendedConfig Vx.x.x.x

The extendedConfig project can be opened by double-clicking the ".solproject" file. This requires the latest version of netXStudio (https://hilscher.atlassian.net/wiki/display/NDT/).


2. PROFINET Sources

A GSDML file is required for this example. The GSDML file can be found in the netXStudio project in Project Explorer at:

netXxx_PNSVx_extendedConfig → Components → cifXApplicationDemoPNS → DeviceDescription → GSDML-V2.3x-HILSCHER-NETX xx-RE PNS-20xxxxxx.xml


The PacketHandler describes the acyclic packages and can be found in the Project Explorer under:

netXxx_PNSVx_extendedConfig → Components → cifXApplicationDemoPNS → Sources → AppPNS_DemoApplicationFunctions.c


The IO Data Handler describes the IO data that is exchanged between the application and the stack and can be found in the Project Explorer under:

    long SetModulConfig( void* pvPck )


The terminal handler uses the interface used by UART to display debug messages and is located in Project Explorer under:

netXxx_PNSVx_extendedConfig → Components → cifXApplicationDemo → Sources → App_TerminalHandler.c


The event handler shows the diagnoses and alarms, which can be found in the Project Explorer under:

netXxx_PNSVx_extendedConfig → Components → cifXApplicationDemo → Sources → App_EventHandler.c


3. Configuration packet

Because of the change from PNS Stack V5.1 to PNS Stack V5.3 a new DeviceAccessPoint (DAP) in the GSDML is necessary. The new DAP (for the new stack) supports new PROFINET features.

(for example: PNS Stack V5.1 (netload Class 1 or 2) and PNS Stack V5.3 (netload Class 3))

The configuration packet has been changed to new ModuleIdentNumber and SubmoduleIdentNumber for the new DAP.


old DAP:

Slot 0                → ModuleIdentNumber: 0x00003011

Subslot 1          → SubmoduleIdentNumber: 0x00003010

Subslot 0x8000 → SubmoduleIdentNumber: 0x00003011

Subslot 0x8001 → SubmoduleIdentNumber: 0x00003012

Subslot 0x8002 → SubmoduleIdentNumber: 0x00003013


new DAP:

Slot 0                → ModuleIdentNumber: 0x00003021

Subslot 1          → SubmoduleIdentNumber: 0x00003020

Subslot 0x8000 → SubmoduleIdentNumber: 0x00003021

Subslot 0x8001 → SubmoduleIdentNumber: 0x00003022

Subslot 0x8002 → SubmoduleIdentNumber: 0x00003023


4. Check Indication

If a PLC is configured with the DAP from the old GSDML or with the old DAP from new GSDML and it is used with a device with new Module- and SubmoduleIdentNumbers, the stack sends a check indication to the application for all submodules with a configuration differences between IO Controller and IO Device in the connection establishment.

The application has meanwhile to decide whether the new software version of the new DAP is compatible to the old DAP or not.

If the DAP is compatible, the application has to return "Substitute".

In the most cases, this will be the case, because no one wants to update the running PLC program. The new device software should always be compatible to the old device software.


5. Wireshark trace

SUBSTITUDTE.pcap