以太网诊断 Cluster（EthernetNetworkDiagnostics）

Cluster ID: 0x0037  |  所在 Endpoint: Endpoint 0（Root Node）

EthernetNetworkDiagnostics 提供以太网接口的运行状态和统计信息 —— 链路速率、双工模式、收发包计数、错误计数等。 这个 Cluster 只有 1 个命令和 9 个属性，结构简单，主要用于网络健康监控和故障排查。

Feature 位图

EthernetNetworkDiagnostics 通过 FeatureMap（0xFFFC）声明设备支持哪些诊断能力：

属性总览

点击属性 ID 可跳转到详细说明。带 Feature 标记的属性仅在设备支持对应特性时才存在。

PHYRate（物理层速率）

只读属性，表示当前以太网接口协商到的物理层链路速率。值为 null 时表示速率未知或接口未连接。

PHYRateEnum 枚举值

↑ 返回属性列表

FullDuplex（全双工模式）

只读属性，表示当前以太网链路是否工作在全双工模式。true 为全双工，false 为半双工， null 表示无法确定。现代以太网设备几乎都是全双工，半双工通常意味着协商异常。

↑ 返回属性列表

PacketRxCount（接收包计数）

只读属性，自上次重置以来接收到的数据包总数。需要设备支持 PKTCNT 特性。 该计数器在调用 ResetCounts 命令或设备重启后归零。

↑ 返回属性列表

PacketTxCount（发送包计数）

只读属性，自上次重置以来发送的数据包总数。需要设备支持 PKTCNT 特性。

↑ 返回属性列表

TxErrCount（发送错误计数）

只读属性，自上次重置以来发送失败的次数。需要设备支持 ERRCNT 特性。 持续增长通常说明线缆质量差或交换机端口有问题。

↑ 返回属性列表

CollisionCount（碰撞计数）

只读属性，自上次重置以来的碰撞次数。需要设备支持 ERRCNT 特性。 在全双工链路上此值应始终为 0；如果持续增长，说明链路可能降级到了半双工。

↑ 返回属性列表

OverrunCount（溢出计数）

只读属性，自上次重置以来接收缓冲区溢出的次数。需要设备支持 ERRCNT 特性。 溢出意味着设备来不及处理收到的数据，可能是设备负载过高或网络流量过大。

↑ 返回属性列表

CarrierDetect（载波检测）

只读属性，表示以太网接口是否检测到载波信号。true 表示网线已连接且对端设备正常， false 表示网线断开或对端无响应，null 表示无法确定。 这是判断物理连接状态最直接的指标。

↑ 返回属性列表

TimeSinceReset（计数器重置后经过时间）

只读属性，自上次计数器重置（ResetCounts 命令或设备重启）以来经过的秒数。 结合包计数和错误计数，可以计算出平均每秒的收发速率和错误率。

↑ 返回属性列表

命令（Commands）

EthernetNetworkDiagnostics 只有一个命令。需要设备支持 PKTCNT 或 ERRCNT 特性才有实际意义。

ResetCounts —— 重置计数器（0x00）

将 PacketRxCount、PacketTxCount、TxErrCount、CollisionCount、OverrunCount 全部归零， 同时 TimeSinceReset 也会重置为 0 并重新开始计时。无需任何参数，直接发送即可。

请求示例：

{
  "invokeRequests": [{
    "commandPath": {
      "endpointId": 0,
      "clusterId": "0x0037",
      "commandId": "0x00"       // ResetCounts
    },
    "commandFields": {}
  }]
}

↑ 返回命令列表

示例数据

读取一个以太网 Hub 设备的 EthernetNetworkDiagnostics Cluster 属性：

{
  // --- 属性 ---
  "0x0": 2,           // PHYRate = Rate1G（千兆以太网）
  "0x1": true,        // FullDuplex = true（全双工）
  "0x2": 1048576,     // PacketRxCount = 1048576（已接收约 100 万包）
  "0x3": 524288,      // PacketTxCount = 524288（已发送约 50 万包）
  "0x4": 3,           // TxErrCount = 3（发送错误 3 次）
  "0x5": 0,           // CollisionCount = 0（无碰撞）
  "0x6": 0,           // OverrunCount = 0（无溢出）
  "0x7": true,        // CarrierDetect = true（载波检测正常）
  "0x8": 86400        // TimeSinceReset = 86400（距上次重置 24 小时）
}

常见场景