CO2 浓度测量 Cluster（CarbonDioxideConcentrationMeasurement）

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

CarbonDioxideConcentrationMeasurement 用于报告空气中 CO2（二氧化碳）浓度，是室内空气质量监测的核心 Cluster。 这是一个纯只读的 Server Cluster —— 没有任何命令，设备被动采集数据，App 端读取或订阅即可。

Feature 位图

浓度测量 Cluster 通过 FeatureMap（0xFFFC）声明设备支持哪些测量能力。 Feature 直接决定了哪些属性可用 —— 必须先读取 FeatureMap，再决定 UI 展示哪些数据。

属性总览

所有属性都是只读的，分为四组。Feature 列标注了该属性需要哪个 Feature 才会存在。 点击属性 ID 可跳转到详细说明。

数值测量（MEA Feature）

峰值与均值测量

等级指示（LEV Feature）

属性详解

MeasuredValue（当前浓度）

传感器最近一次测量到的 CO2 浓度值。这是整个 Cluster 最核心的属性。 与温度 Cluster 不同，浓度 Cluster 使用 float 类型，值就是实际浓度，不需要换算。

• 类型: float（单精度浮点数）
• 单位: 由 MeasurementUnit 属性决定（通常是 PPM）
• Nullable: 为 null 时表示传感器数据无效或尚未完成首次测量
• Feature: MEA

↑ 返回属性列表

MinMeasuredValue（可测最低浓度）

传感器能够测量的最低浓度值。App 可以用它来设置显示范围的下限。 对于 CO2 传感器，通常是 400 ppm（大气本底浓度）。

• 类型: float，Nullable
• Feature: MEA

↑ 返回属性列表

MaxMeasuredValue（可测最高浓度）

传感器能够测量的最高浓度值。当 MeasuredValue 接近此上限时， 可能意味着传感器已超出正常工作范围。对于 CO2 传感器，常见上限是 5000 或 10000 ppm。

• 类型: float，Nullable
• Feature: MEA

↑ 返回属性列表

PeakMeasuredValue（峰值浓度）

在 PeakMeasuredValueWindow 指定的时间窗口内，传感器记录到的最高浓度值。 用于追踪「最近 24 小时内最差的空气质量发生在什么浓度」。

• 类型: float，Nullable
• Feature: PEA（依赖 MEA）

↑ 返回属性列表

PeakMeasuredValueWindow（峰值统计窗口）

PeakMeasuredValue 的统计时间窗口，单位秒。例如 86400 表示峰值是过去 24 小时内的最大值。 窗口到期后，PeakMeasuredValue 会重置并重新统计。

• 类型: elapsed-s（uint32，经过的秒数）
• Feature: PEA

↑ 返回属性列表

AverageMeasuredValue（平均浓度）

在 AverageMeasuredValueWindow 指定的时间窗口内，浓度的算术平均值。 均值比实时值更稳定，适合用于趋势分析和空气质量评分。

• 类型: float，Nullable
• Feature: AVG（依赖 MEA）

↑ 返回属性列表

AverageMeasuredValueWindow（均值统计窗口）

AverageMeasuredValue 的统计时间窗口，单位秒。例如 3600 表示平均值是过去 1 小时的均值。

• 类型: elapsed-s（uint32，经过的秒数）
• Feature: AVG

↑ 返回属性列表

Uncertainty（测量不确定度）

传感器的测量精度，单位与 MeasurementUnit 一致。 例如值为 15.0 且单位是 PPM，表示测量精度为 ±15 ppm。 做浓度阈值触发自动化时，应将不确定度纳入考量。

• 类型: float
• Feature: MEA

↑ 返回属性列表

MeasurementUnit（测量单位）

声明 MeasuredValue 等数值属性使用的计量单位。 对于 CO2 传感器，绝大多数使用 PPM（百万分之一）。 详细枚举值见下方 MeasurementUnitEnum。

• 类型: enum8
• Feature: MEA

↑ 返回属性列表

MeasurementMedium（测量介质）

声明传感器测量的是哪种介质中的浓度。CO2 传感器几乎都是 Air（空气）， 但浓度测量 Cluster 家族还涵盖水质监测（Water）和土壤监测（Soil）等场景。 详细枚举值见下方 MeasurementMediumEnum。

• 类型: enum8
• Feature: MEA

↑ 返回属性列表

LevelValue（浓度等级）

设备自行判定的当前浓度等级。适用于不需要精确数值的场景 —— 比如简单的红绿灯指示。 注意：如果设备没有 MED Feature，LevelValue 不会返回 Medium； 没有 CRI Feature，不会返回 Critical。 详细枚举值见下方 LevelValueEnum。

• 类型: enum8
• Feature: LEV

↑ 返回属性列表

命令

CarbonDioxideConcentrationMeasurement 是一个纯只读的 Server Cluster，没有任何命令。 设备负责采集 CO2 浓度并更新属性，App 端只需读取（Read）或订阅（Subscribe）即可获取数据。

枚举值速查

MeasurementUnitEnum（测量单位）

MeasurementMediumEnum（测量介质）

LevelValueEnum（浓度等级）

示例数据

读取一个室内 CO2 传感器的全部属性（典型室内环境，约 800 ppm）：

{
  // --- CarbonDioxideConcentrationMeasurement Cluster（Endpoint 1）---

  // 数值测量（MEA Feature）
  "0x00": 823.5,          // MeasuredValue = 823.5 ppm（当前 CO2 浓度）
  "0x01": 400.0,          // MinMeasuredValue = 400 ppm（传感器下限）
  "0x02": 5000.0,         // MaxMeasuredValue = 5000 ppm（传感器上限）
  "0x07": 15.0,           // Uncertainty = ±15 ppm

  // 测量单位与介质（MEA Feature）
  "0x08": 0,              // MeasurementUnit = PPM
  "0x09": 0,              // MeasurementMedium = Air（空气）

  // 峰值测量（PEA Feature）
  "0x03": 1250.0,         // PeakMeasuredValue = 1250 ppm（历史峰值）
  "0x04": 86400,          // PeakMeasuredValueWindow = 86400 秒（24 小时窗口）

  // 均值测量（AVG Feature）
  "0x05": 680.5,          // AverageMeasuredValue = 680.5 ppm（平均值）
  "0x06": 3600,           // AverageMeasuredValueWindow = 3600 秒（1 小时窗口）

  // 等级指示（LEV Feature）
  "0x0A": 2               // LevelValue = Medium（中等）
}

读取请求示例 —— 一次性获取 Cluster 全部属性：

{
  // 一次性读取 CO2 Cluster 全部属性
  "readRequests": [{
    "attributePath": {
      "endpointId": 1,
      "clusterId": "0x040D"
      // 不指定 attributeId → 读取全部属性
    }
  }]
}

订阅 CO2 浓度变化 —— 实时跟踪空气质量：

{
  // 订阅 CO2 浓度变化（每 30 秒~5 分钟上报一次）
  "subscribeRequests": [{
    "attributePath": {
      "endpointId": 1,
      "clusterId": "0x040D",
      "attributeId": "0x00"        // MeasuredValue
    },
    "minIntervalFloor": 30,
    "maxIntervalCeiling": 300
  }]
}

常见场景