PNS Diagnostics Example

1. Example project

In this example, the application activates the PROFINET indications. For that, the application needs to call the request "Register Application".

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

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://kb.hilscher.com/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

The Diagnostic functions are:

void AppPNS_HandleAppAddChannelDiagnosisReq( uint16_t usSlot , uint16_t usSubslot, APP_DATA_T* ptAppData)

  /* use global packet buffer */
  PNS_IF_ADD_CHANNEL_DIAG_REQ_T *ptReq = ( PNS_IF_ADD_CHANNEL_DIAG_REQ_T*) &(ptAppData->tPacket);
  memset(ptReq, 0x00, sizeof(*ptReq));
  ptReq->tHead.ulDest = 0x20;
  ptReq->tHead.ulCmd = PNS_IF_ADD_CHANNEL_DIAG_REQ;
  ptReq->tHead.ulLen = sizeof(ptReq->tData);

  ptReq->tData.ulApi          = 0;
  ptReq->tData.ulSlot         = usSlot;
  ptReq->tData.ulSubslot      = usSubslot;

  ptReq->tData.usChannelNum     = 0x8000;
  ptReq->tData.usChannelProp    = 0x0000;
  ptReq->tData.usChannelErrType = 2;

  (void)Pkt_SendPacket(ptAppData->hChannel[0], &ptAppData->tPacket, TX_TIMEOUT);
}

void AppPNS_HandleAddChannelDiagnosisCnf( APP_DATA_T* ptAppData)
{
  PNS_IF_ADD_CHANNEL_DIAG_CNF_T* ptAddChannelDiagCnf=( PNS_IF_ADD_CHANNEL_DIAG_CNF_T*) &(ptAppData->tPacket);
  s_abDiagHandle = ptAddChannelDiagCnf->tData.hDiagHandle;
  return;
}

void AppPNS_HandleRemoveDiagnosisReq( APP_DATA_T* ptAppData)
{
  /* use global packet buffer */
  PNS_IF_REMOVE_DIAG_REQ_T *ptReq = ( PNS_IF_REMOVE_DIAG_REQ_T*) &(ptAppData->tPacket);

  memset(ptReq, 0x00, sizeof(*ptReq));

  ptReq->tHead.ulDest = 0x20;
  ptReq->tHead.ulCmd = PNS_IF_REMOVE_DIAG_REQ;
  ptReq->tHead.ulLen = 4;  //sizeof(ptReq->tData);

  ptReq->tData.hDiagHandle=s_abDiagHandle;

  (void)Pkt_SendPacket(ptAppData->hChannel[0], &ptAppData->tPacket, TX_TIMEOUT);
}

4. Values from GSDML file

Please add the following colored keywords in the GSDML file:

Note: The diagnostic functions and diagnostic texts can be adapted and changed as required.