cancel
Showing results for 
Search instead for 
Did you mean: 

EtherCAT diagnostics

EtherCAT diagnostics

Marc25
New Poster

Hello, on my ctrlX x3 I'm looking into available data useful for network diagnostics from the etherCAT master app. And I have some questions about the statistics.

1. Where does the CtrlX Core get thoses numbers from? Does the control provide it itself or read it from theframe statistics countersframe statistics counters slaves? Because for example in the frame statistic counters, I only see changes in lost frames number when the first slave is down and nothing for the rest of the slaves in the topology. 

 

 

 

2. For the slave statistic counters there's an input parameter apparently, like in some other nodes as well. But what exactly am I supposed to wslave statistics countersslave statistics countersrite there in order to get those informations? Same thing if I want to reset the frame statistic counters too fo example.

 

 

 

3. In the fielbus status there's a parameter for the master status indicating a number that sometimesmaster statusmaster status changes(512, 768, 1672 or something like that). Is there a documentation where i can see what those numbers exactly refer to?

 

 

 

 

    Also in topology status, the state sometimes go pending for a second when a change occurs but always remain "valid" no matter the changes in the topology or if a slave is down for example. I don't understand it.topology statustopology status

 

 

 

 

 

 

However in the "ethercat status" window of the ethercat master app. I can correctly see when something is wrong with the topology. But I plan to get those informations with the REST API. That's why those discrepancies bother me a bit.

I haven't seen anything about it in the ethercat master app documentation. Does anyone knows more about it or redirect me to some helpful documentation ?

1 REPLY 1

CodeShepherd
Community Moderator
Community Moderator
  1. Slave statistics are read out of the slaves EtherCat chip and represented in the data layer. See some more description of the function/interpretation by clicking the link in the slave statistics page:
    ctrlX OS - web UI - EtherCat slave statisticsctrlX OS - web UI - EtherCat slave statistics


  2. When using version 2.6 of the system you will get an example when opening an data layer address including an object:
    ctrlX OS - data layer viewer - access EtherCat slave telegram error counter.pngctrlX OS - data layer viewer - access EtherCat slave telegram error counter.png
    Please always check the data type mentioned in the metadata of a node. There in generell you can see which data is needed.
    1.  fieldbuses/ethercat/master/instances/ethercatmaster/admin/fieldbus_statistic/slave/counters:
      e.g. {"request": {"addressType": "fixedphysical", "address": 1001}}
    2. fieldbuses/ethercat/master/instances/ethercatmaster/admin/fieldbus_statistic/slave/reset:
      an empty PUT is needed
  3. Description about the status word bits can be found in the data type reference:
    1. ctrlX OS - data layer viewer - EtherCat master statusctrlX OS - data layer viewer - EtherCat master status
      {
          "definitions": {
              "comm_ethercat_master_fbs_MasterStatus": {
                  "type": "object",
                  "description": "This node delivers a summary of diagnosis information from the EtherCAT Master.",
                  "properties": {
                      "response": {
                          "$ref": "#/definitions/comm_ethercat_master_fbs_MasterStatusResponse"
                      }
                  },
                  "additionalProperties": false
              },
              "comm_ethercat_master_fbs_MasterStatusResponse": {
                  "type": "object",
                  "description": "EtherCAT status",
                  "properties": {
                      "status": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 4294967295,
                          "description": "Is 0 if master and all slaves are in state \"Operational\" without any errors\nBit 0: No master ethernet link\nBit 1: Master not in state \"Operational\"\nBit 2: Master not in requested state\nBit 3: Reserved\nBit 4: Master in state \"Init\"\nBit 5: Master in state \"Pre-Operational\"\nBit 6: Master in state \"Safe-Operational\"\nBit 7: Reserved\nBit 8: Topology not OK (the configured slaves do not match to the online slaves)\nBit 9: One or more slaves not in master state\nBit 10: One or more slaves indicate error\nBit 11: Reserved\nBit 12: Distributed Clock (DC) is not within configured limits (only when DC is enabled)\nBit 13: Reserved\nBit 14: Invalid or inconsistent settings\nBit 15: Port not found\nBit 16: No license available\nBit 17 - 31: Reserved",
                          "default": 0
                      }
                  },
                  "additionalProperties": false
              }
          },
          "$ref": "#/definitions/comm_ethercat_master_fbs_MasterStatus"
      }
       
    2. In the official online documentation.
  4.  General information about different windows in the ctrlX OS web UI of the EtherCat master can be found in the online documentation.

I hope I could make your points clear. If there are further questions feel free to add them here below.

Icon--AD-black-48x48Icon--address-consumer-data-black-48x48Icon--appointment-black-48x48Icon--back-left-black-48x48Icon--calendar-black-48x48Icon--center-alignedIcon--Checkbox-checkIcon--clock-black-48x48Icon--close-black-48x48Icon--compare-black-48x48Icon--confirmation-black-48x48Icon--dealer-details-black-48x48Icon--delete-black-48x48Icon--delivery-black-48x48Icon--down-black-48x48Icon--download-black-48x48Ic-OverlayAlertIcon--externallink-black-48x48Icon-Filledforward-right_adjustedIcon--grid-view-black-48x48IC_gd_Check-Circle170821_Icons_Community170823_Bosch_Icons170823_Bosch_Icons170821_Icons_CommunityIC-logout170821_Icons_Community170825_Bosch_Icons170821_Icons_CommunityIC-shopping-cart2170821_Icons_CommunityIC-upIC_UserIcon--imageIcon--info-i-black-48x48Icon--left-alignedIcon--Less-minimize-black-48x48Icon-FilledIcon--List-Check-grennIcon--List-Check-blackIcon--List-Cross-blackIcon--list-view-mobile-black-48x48Icon--list-view-black-48x48Icon--More-Maximize-black-48x48Icon--my-product-black-48x48Icon--newsletter-black-48x48Icon--payment-black-48x48Icon--print-black-48x48Icon--promotion-black-48x48Icon--registration-black-48x48Icon--Reset-black-48x48Icon--right-alignedshare-circle1Icon--share-black-48x48Icon--shopping-bag-black-48x48Icon-shopping-cartIcon--start-play-black-48x48Icon--store-locator-black-48x48Ic-OverlayAlertIcon--summary-black-48x48tumblrIcon-FilledvineIc-OverlayAlertwhishlist