HEPA 滤芯监测 Cluster（HepaFilterMonitoring）

Cluster ID: 0x0071  |  所在 Endpoint: 功能端点（通常 Endpoint 1）

HepaFilterMonitoring 用于监测空气净化器中 HEPA 滤芯的生命周期状态，包括剩余寿命百分比、劣化程度、是否需要更换， 以及推荐的替换产品信息。当用户更换滤芯后，可以通过命令重置状态，开始新一轮监测周期。

Feature Map（功能特性）

HepaFilterMonitoring 通过 Feature Map 控制可选功能的启用。设备可以根据硬件能力声明支持哪些特性。

属性总览

HepaFilterMonitoring 的属性分为必选和可选两部分，可选属性取决于设备声明的 Feature。

Condition（滤芯剩余寿命）

表示滤芯剩余寿命的百分比，范围 0 到 100。 100 表示全新滤芯，0 表示滤芯已完全耗尽。 需要设备声明 CON Feature 才会出现此属性。

↑ 返回属性列表

DegradationDirection（劣化方向）

指示 Condition 值的劣化方向 —— 即数值变大还是变小代表滤芯状态变差。 需要设备声明 WAR Feature 才会出现此属性。

DegradationDirectionEnum 枚举值

↑ 返回属性列表

ChangeIndication（更换指示）

滤芯当前的更换状态。这是一个必选属性，即使设备不支持 Condition 百分比，也必须报告更换指示。

ChangeIndicationEnum 枚举值

↑ 返回属性列表

InPlaceIndicator（滤芯安装状态）

布尔值，表示滤芯是否已物理安装到设备中。true 表示滤芯在位，false 表示滤芯未安装或已取出。 这是一个可选属性，取决于设备是否有物理检测传感器。

↑ 返回属性列表

LastChangedTime（上次更换时间）

上次更换滤芯的 UTC 时间戳（epoch 秒数）。可以为 null，表示设备未记录过更换时间。 当用户发送 ResetCondition 命令后，设备会将此属性更新为当前时间。

↑ 返回属性列表

ReplacementProductList（替换产品列表）

推荐的替换产品列表，每个条目包含产品标识类型和标识值。 需要设备声明 REP Feature 才会出现此属性。 列表可以包含多个条目，用不同的编码体系标识同一款替换滤芯。

ReplacementProductStruct 结构

ProductIdentifierTypeEnum 枚举值

↑ 返回属性列表

命令（Commands）

HepaFilterMonitoring 只有一个命令，由 Client 发给 Server（即 App 发给设备）。 用于在用户更换滤芯后重置监测状态。

ResetCondition —— 重置滤芯状态（0x00）

用户更换完 HEPA 滤芯后，发送此命令通知设备重新开始生命周期监测。 设备收到后会将 Condition 重置为 100，ChangeIndication 重置为 OK， 并更新 LastChangedTime 为当前时间。

此命令没有参数，直接发送即可。

请求示例：

{
  "invokeRequests": [{
    "commandPath": {
      "endpointId": 1,
      "clusterId": "0x0071",
      "commandId": "0x00"       // ResetCondition
    },
    "commandFields": {}
  }]
}

↑ 返回命令列表

示例数据

读取一台空气净化器的 HepaFilterMonitoring Cluster 全部属性：

{
  // --- 属性 ---
  "0x0": 72,          // Condition = 72%（滤芯剩余寿命）
  "0x1": 1,           // DegradationDirection = Down（数值越低越差）
  "0x2": 0,           // ChangeIndication = OK（状态正常）
  "0x3": true,        // InPlaceIndicator = true（滤芯已安装）
  "0x4": 1695206400,  // LastChangedTime = 2023-09-20T16:00:00Z
  "0x5": [            // ReplacementProductList
    {
      "0": 0,         // ProductIdentifierType = UPC
      "1": "012345678905"  // ProductIdentifierValue
    }
  ]
}

场景一：滤芯生命周期追踪

一台空气净化器从安装新滤芯到滤芯耗尽再到更换的完整流程。 App 通过订阅属性变化来实时更新 UI，在关键节点推送通知。

{
  // 场景：空气净化器运行 6 个月后，滤芯开始老化
  // 第一次读取 —— 滤芯状态良好
  "readAttributes": {
    "0x0": 72,         // Condition = 72%
    "0x2": 0           // ChangeIndication = OK
  },

  // 两个月后 —— 滤芯进入警告区间
  "readAttributes_later": {
    "0x0": 18,         // Condition = 18%
    "0x2": 1           // ChangeIndication = Warning
  },

  // 继续使用 —— 滤芯进入临界状态
  "readAttributes_critical": {
    "0x0": 3,          // Condition = 3%
    "0x2": 2           // ChangeIndication = Critical
  },

  // 用户更换滤芯后，发送 ResetCondition 命令
  "resetCommand": {
    "endpointId": 1,
    "clusterId": "0x0071",
    "commandId": "0x00"
  },

  // 重置后的状态
  "readAttributes_after_reset": {
    "0x0": 100,        // Condition = 100%（已重置）
    "0x2": 0           // ChangeIndication = OK
  }
}

场景二：替换产品购买引导

当滤芯需要更换时，App 读取设备中的替换产品列表，帮助用户快速找到正确的替换滤芯并完成购买。

{
  // 场景：App 读取替换产品信息，引导用户购买
  "readAttributes": {
    "0x2": 2,          // ChangeIndication = Critical（需要更换）
    "0x5": [           // ReplacementProductList
      {
        "0": 0,        // ProductIdentifierType = UPC
        "1": "012345678905"
      },
      {
        "0": 4,        // ProductIdentifierType = OEM
        "1": "HEPA-H13-PRO-2024"
      }
    ]
  }
  // App 可以用 UPC 码跳转电商搜索，或用 OEM 编号跳转厂商官网
}