System diagnosis

SINUMERIK Connector

Portfolio
Industrial Edge
Product
SINUMERIK Connector
Software version
1.1.0
Language
en-US

If an Industrial Edge App does not operate as expected, the application log file can be a useful source for troubleshooting.

SINUMERIK Connector Logs

To get access to the logs of the SINUMERIK Connector application, you can download them either via the IED user interface using the "Apps" overview, or via IEM user interface accessing them via the "Edge devices" overview.

SINUMERIK Connector diagnosis view

The SINUMERIK Connector application provides a simple diagnosis view.

This diagnostic view provides an overview of the status and configuration of your SINUMERIK Connector, as well as the data acquisition from your SINUMERIK control.

To open this view simply click on the application icon on the “Apps” overview on your IED.

For this version of the SINUMERIK Connector, the diagnosis data is shown as a JSON structure.

The following overview helps you to better understand the displayed information.

1. connector - SINUMERIK Connector information

This section contains details about the installed SINUMERIK Connector application.

  • "configuration" - configuration settings of the Connector:

    • "control_type": indicates the configured type of the connected SINUMERIK control (e.g., "840Dsl" for SINUMERIK 840D sl).

    • "serial": the configured serial number of the SINUMERIK control to which the Connector is connected.

  • "state" - current operational status of the Connector:

    • "connection": status of the connection to the SINUMERIK control ("GOOD" means the connection is stable).

    • "driver": status of the Connector's internal data driver ("GOOD" means the driver is functioning correctly).

    • "last_heartbeat": timestamp of the last successful communication signal between the Connector and the control.

    • "licensed": indicates whether the Connector is licensed ("true" for licensed, "false" for not licensed).

  • "subscriptions" - overview of the Connector's active data subscriptions (streams).

    • Each numeric key (e.g., "1", "2") represents a specific subscription.

      - "active": indicates whether this subscription is currently active ("true" for active).

      - "datapoints": a comma-separated list of IDs of the data points included in this subscription.

      - "messages per second": the current rate of messages the connector is publishing for this specific subscription.

  • "version" - the version number of the SINUMERIK Connector application.

2. "datasource" - Data Source Information (SINUMERIK Control)

This section provides details about the SINUMERIK control itself and the data the SINUMERIK Connector collects from the control.

  • "data acquisition" - details on data acquisition from the control, categorized by frequency.

    • "data event" - data points acquired based on events.

      - "datapoints": a list of objects describing each acquired data point:

      -- "address": the path or address of the data point on the control (e.g., an NC parameter).

      -- "available": indicates whether the data point is available ("true" for available).

      -- "error": an error message, if the data point cannot be read (empty if no error).

      -- "id": a unique identification number for the data point.

      - "dropped samples per second": number of data samples dropped per second (ideally 0).

      - "dropped samples since start": total number of data samples dropped since the start of data acquisition (ideally 0).

      - "samples per second": the current rate of data samples acquired per second.

    • "high frequency" - data points acquired at a high frequency (position control cycle).

      - "datapoints": a list of objects describing the high-frequency data points (structure as under data event).

      - "dropped samples per second": number of data samples dropped per second (ideally 0).

      - "dropped samples since start": total number of data samples dropped since the start of data acquisition (ideally 0).

      - "last_heartbeat": timestamp of the last high-frequency data heartbeat. (the value shall change every two seconds)

      - "samples per second": the current rate of data samples acquired per second.

    • "low frequency" - data points acquired at a low frequency.

      - "datapoints": a list of objects describing the low-frequency data points (structure as under data event).

      - "dropped samples per second": number of data samples dropped per second (ideally 0).

      - "dropped samples since start": total number of data samples dropped since the start of data acquisition (ideally 0).

      - "samples per second": the current rate of data samples acquired per second.

  • "edgefs" - the version number of the Edge File System (if applicable).

  • "hfprobe" - the version number of the High Frequency Probe Tool.

  • "nck" - the version or identification number of the Numeric Control Kernel (NCK) of the control.

  • "serial" - the serial number of the SINUMERIK control (shall be identical to connector.configuration.serial).

  • "state" - detailed status of the data source.

    • "control_type": the type of the control (shall be identical to connector.configuration.control_type).

    • "hfprobe": detailed status of the High Frequency Probe Tool.

      - "HF_Probe.fileErrorState[X]": various counters and status information regarding operations of the HF-Probe. Each entry has a comment for explanation and a value.

      - "HF_Probe.infoState": the general status of the HF-Probe (0 for inactive, 1 for recording).

      - "config_id": the ID of the current HF-Probe configuration.

    • "nc_connected": indicates whether the Numerical Control (NC) is connected ("true" or "false").

    • "plc_connected": indicates whether the Programmable Logic Controller (PLC) is connected ("true" or "false").