PM2.5 浓度测量 Cluster（Pm25ConcentrationMeasurement）

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

Pm25ConcentrationMeasurement 用于测量空气中 PM2.5（细颗粒物）的浓度。 PM2.5 是直径小于或等于 2.5 微米的颗粒物，能深入肺泡，是衡量空气质量最关键的指标之一。 常见于空气质量传感器、空气净化器、新风系统、智能环境面板等设备。 设备作为 Server 角色被动上报浓度数据，App（Client）读取或订阅即可。

Feature 位图

Pm25ConcentrationMeasurement 通过 FeatureMap（0xFFFC）声明设备支持哪些能力。 Feature 决定了哪些属性可用 —— 比如没有 PEA Feature 的设备不会上报峰值数据。 所有浓度测量 Cluster 的 Feature 定义完全相同。

属性总览

浓度测量 Cluster 的属性较多，但大部分受 Feature 控制。核心属性是 MeasuredValue（需要 MEA）和 LevelValue（需要 LEV）。 点击属性 ID 可跳转到详细说明。

属性详解

MeasuredValue（当前 PM2.5 浓度）

传感器最近一次测量到的 PM2.5 浓度值。这是整个 Cluster 最核心的属性，App 端展示空气质量主要依赖它。

• 类型: float（单精度浮点数）
• 单位: 由 MeasurementUnit 决定，PM2.5 传感器通常使用 UGM3（微克每立方米，μg/m³）
• Nullable: 为 null 时表示传感器数据无效或尚未完成测量
• Feature: 需要 MEA

↑ 返回属性列表

MinMeasuredValue（可测最低浓度）

传感器能够测量的最低浓度值。大多数 PM2.5 传感器的下限为 0.0。

• 类型: float，Nullable
• Feature: 需要 MEA
• Nullable: 为 null 时表示设备未定义下限

↑ 返回属性列表

MaxMeasuredValue（可测最高浓度）

传感器能够测量的最高浓度值。常见的消费级 PM2.5 传感器上限通常在 500 ~ 1000 μg/m³ 之间。 当 MeasuredValue 接近此上限时，说明空气质量极差，传感器可能也接近饱和。

• 类型: float，Nullable
• Feature: 需要 MEA
• Nullable: 为 null 时表示设备未定义上限

↑ 返回属性列表

PeakMeasuredValue（峰值浓度）

在 PeakMeasuredValueWindow 指定的时间窗口内，传感器测量到的最高浓度值。 有助于发现短时间内的空气质量恶化事件（如做饭、吸烟产生的瞬时高浓度）。

• 类型: float，Nullable
• Feature: 需要 PEA

↑ 返回属性列表

PeakMeasuredValueWindow（峰值窗口）

峰值统计的时间窗口，单位为秒。例如值为 3600，表示 PeakMeasuredValue 是最近 1 小时内的最高值。

• 类型: uint32（elapsed-s，经过秒数）
• Feature: 需要 PEA
• 默认: 由设备厂商决定

↑ 返回属性列表

AverageMeasuredValue（平均浓度）

在 AverageMeasuredValueWindow 指定的时间窗口内的平均浓度值。 适合用于判断长时间的空气质量趋势，比瞬时值更稳定。

• 类型: float，Nullable
• Feature: 需要 AVG

↑ 返回属性列表

AverageMeasuredValueWindow（均值窗口）

均值统计的时间窗口，单位为秒。例如值为 86400，表示 AverageMeasuredValue 是最近 24 小时的平均值。

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

↑ 返回属性列表

Uncertainty（测量不确定度）

传感器的测量不确定度，与 MeasuredValue 使用相同单位。 例如值为 2.0，表示实际浓度在 MeasuredValue ± 2.0 μg/m³ 范围内。 做阈值判断时应将不确定度纳入考量。

• 类型: float
• Feature: 需要 MEA（可选属性）

↑ 返回属性列表

MeasurementUnit（测量单位）

表示 MeasuredValue 及相关浓度属性使用的单位。PM2.5 传感器几乎都使用 UGM3（μg/m³）。 该属性在设备整个生命周期中固定不变。

• 类型: MeasurementUnitEnum（见下方枚举）
• Feature: 需要 MEA

↑ 返回属性列表

MeasurementMedium（测量介质）

表示传感器测量的目标介质。对于 PM2.5 传感器，该值固定为 Air（空气）。 这个属性在浓度测量家族中是通用的 —— 一些水质传感器会使用 Water。

• 类型: MeasurementMediumEnum（见下方枚举）
• Feature: 无要求（所有设备都可有）

↑ 返回属性列表

LevelValue（浓度等级）

设备对当前浓度的分级评估。不同厂商的分级阈值可能不同，但枚举值是统一的。 支持 LEV Feature 时必须提供此属性。 适合在 UI 上用颜色标签展示空气质量（绿 / 黄 / 橙 / 红）。

• 类型: LevelValueEnum（见下方枚举）
• Feature: 需要 LEV

↑ 返回属性列表

命令

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

枚举定义

以下三组枚举是所有浓度测量 Cluster 共享的 —— CO2、PM2.5、PM10、甲醛、TVOC 等 Cluster 使用完全相同的枚举定义。

MeasurementUnitEnum（测量单位）

MeasurementMediumEnum（测量介质）

LevelValueEnum（浓度等级）

PM2.5 与 AQI 对照表

PM2.5 浓度是计算 AQI（空气质量指数） 的核心指标之一。 以下是美国 EPA 标准（24 小时平均）的 PM2.5 浓度与 AQI 等级对照，也是全球最常用的参考标准：

示例数据

读取一个室内空气质量传感器的 Pm25ConcentrationMeasurement Cluster 属性（PM2.5 约 25 μg/m³）：

{
  // --- Pm25ConcentrationMeasurement Cluster（Endpoint 1）---
  // 场景：室内空气质量传感器，当前 PM2.5 约 25 μg/m³

  "0x0000": 25.0,         // MeasuredValue = 25.0 μg/m³（当前浓度）
  "0x0001": 0.0,          // MinMeasuredValue = 0.0 μg/m³
  "0x0002": 500.0,        // MaxMeasuredValue = 500.0 μg/m³
  "0x0003": 28.0,         // PeakMeasuredValue = 28.0 μg/m³（峰值）
  "0x0005": 22.5,         // AverageMeasuredValue = 22.5 μg/m³（均值）
  "0x0007": 2.0,          // Uncertainty = 2.0（测量不确定度 ±2 μg/m³）
  "0x0008": 4,            // MeasurementUnit = UGM3（微克每立方米）
  "0x0009": 0,            // MeasurementMedium = Air（空气）
  "0x000A": 1             // LevelValue = Low（浓度等级：低）
}

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

{
  // 读取 PM2.5 传感器的所有属性
  "readRequests": [{
    "attributePath": {
      "endpointId": 1,
      "clusterId": "0x042A"
      // 不指定 attributeId → 读取该 Cluster 全部属性
    }
  }]
}

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

{
  // 订阅 PM2.5 浓度变化（每 30 秒~5 分钟上报一次）
  "subscribeRequests": [{
    "attributePath": {
      "endpointId": 1,
      "clusterId": "0x042A",
      "attributeId": "0x0000"      // MeasuredValue
    },
    "minIntervalFloor": 30,        // 最少 30 秒上报一次
    "maxIntervalCeiling": 300      // 最多 5 分钟上报一次
  }]
}

{`// 设备返回 MeasuredValue = 25.0 (μg/m³)
val rawValue: Float? = 25.0f    // Nullable，可能为 null
val pm25 = rawValue ?: run {
    // null → 传感器数据无效，展示「--」
    showPlaceholder(); return
}

// 映射到 AQI 等级
val aqiLevel = when {
    pm25 <= 12.0f  -> "优"      // 绿色
    pm25 <= 35.4f  -> "良"      // 黄色
    pm25 <= 55.4f  -> "敏感"    // 橙色
    pm25 <= 150.4f -> "不健康"  // 红色
    pm25 <= 250.4f -> "很差"    // 紫色
    else           -> "危险"    // 褐红色
}

// 也可以直接使用设备的 LevelValue（如果支持 LEV Feature）
val level: Int? = readAttribute(0x000A)  // LevelValueEnum`}

常见场景