空气质量指数 (AQI)

aqi 传感器平台允许您从 PM2.5 和 PM10 颗粒物传感器读数计算空气质量指数。此传感器可与任何 PM 传感器源配合使用，例如 Pmsx003、Hm3301、Sds011 或 Sps30。

NOTE

此组件生成的值是仅 PM 的 AQI 估算值，而非完整的美国 EPA 空气质量指数。官方 EPA AQI 是跨五个污染物类别计算的 — 地面臭氧 (O₃)、颗粒物污染 (PM2.5 和 PM10)、一氧化碳 (CO)、二氧化硫 (SO₂) 和二氧化氮 (NO₂) — 并报告最差的子指数作为整体 AQI。没有臭氧、CO、SO₂ 和 NO₂ 的传感器，此组件无法生成真正的综合 AQI；输出仅反映颗粒物状况，当其他污染物升高时可能会严重低估实际空气质量风险。

此外，官方 EPA PM2.5 AQI 使用24小时平均浓度定义（或用于实时每小时估算的 EPA NowCast 算法）。此组件将 AQI 断点公式应用于瞬时传感器读数，这会产生更波动的值，与官方报告中使用的日 AQI 或 NowCast AQI 不对应。有关完整的方法详情，请参阅 EPA 技术辅助文档。

NOTE

此平台取代了 HM3301 组件中之前可用的已弃用 aqi 选项。独立平台更灵活，因为它可与任何 PM 传感器配合使用。

支持两种计算类型：

AQI: 美国 EPA 空气质量指数（0-500 刻度）
CAQI: 欧洲通用空气质量指数（0-100+ 刻度）

# 示例配置条目
sensor:
  - platform: pmsx003
    type: PMSX003
    pm_2_5:
      id: pm25_sensor
      name: "PM2.5"
    pm_10_0:
      id: pm10_sensor
      name: "PM10"

  - platform: aqi
    name: "空气质量指数"
    pm_2_5: pm25_sensor
    pm_10_0: pm10_sensor
    calculation_type: AQI

配置变量

pm_2_5 (必需, 传感器的 ID): 提供 PM2.5 浓度读数的传感器，单位 µg/m³。
pm_10_0 (必需, 传感器的 ID): 提供 PM10 浓度读数的传感器，单位 µg/m³。
calculation_type (必需, enum): 要使用的 AQI 计算标准。必须是以下之一：
- AQI: 应用于 PM2.5 和 PM10 的美国 EPA 空气质量指数断点公式。返回 0-500 的值，值越高表示空气质量越差。这不是完整的 EPA AQI — 官方标准涵盖五种污染物类别，还需要臭氧、CO、SO₂ 和 NO₂ 测量值。基于 EPA 技术辅助文档。
- CAQI: 欧洲通用空气质量指数。返回从 0 开始的值，值越高表示空气质量越差。通常 0-25 为很低，25-50 为低，50-75 为中等，75-100 为高，>100 为很高。
来自 Sensor 的所有其他选项。

CAQI 示例

sensor:
  - platform: hm3301
    pm_2_5:
      id: pm25
      name: "PM2.5"
    pm_10_0:
      id: pm10
      name: "PM10"

  - platform: aqi
    name: "欧洲空气质量指数"
    pm_2_5: pm25
    pm_10_0: pm10
    calculation_type: CAQI

空气质量指数 (AQI)

配置变量

CAQI 示例

另见