air-Q

air-Q 集成允许将您的 air-Q 设备提供的传感器集成到 Home Assistant 中。

配置

此集成可通过 UI 配置。前往 设置 > 设备与服务 添加。

在初始配置期间,系统会提示用户输入设备的 IP 地址或序列号的前 5 个字符,以及设备密码。

要使此集成与设备通信,两者必须连接到同一个 Wi-Fi 网络。

设置完成后,将为您的设备中发现的每个传感器创建单独的实体。

传感器

目前,集成支持以下传感器:

传感器名称测量单位
Acetaldehydeµg/m³
Ammoniaµg/m³
Arsineµg/m³
Bromineµg/m³
CH4Sµg/m³
Chlorineµg/m³
ClO2µg/m³
COmg/m³
CO2ppm
CS2µg/m³
Dew Point°C
Ethanolµg/m³
Ethyleneµg/m³
Formaldehydeµg/m³
F2µg/m³
H2Sµg/m³
HClµg/m³
HCNµg/m³
HFµg/m³
Health Index%
Humidity (relative)%
Absolute Humidityg/m³
Hydrogenµg/m³
Hydrogen Peroxideµg/m³
Methane%
Mold Index%
N2Oµg/m³
NOµg/m³
NO2µg/m³
Organic Acidppb
Oxygenµg/m³
Ozoneµg/m³
Performance Index%
PH3µg/m³
PM1, PM25, PM10µg/m³
PressurehPa
Relative PressurehPa
Propane%
Refrigerant R-32%
Refrigerant R-454B%
Refrigerant R-454C%
SiH4µg/m³
SO2µg/m³
NoisedBa
Noise (Maximum)dBa
RadonBq/m³
Temperature°C
Virus Index%
VOCppb
VOC (Industrial)ppb

PM1、PM25 和 PM10 分别对应直径小于 1µm、2.5µm 和 10µm 的颗粒物浓度

虚拟传感器和指数

所有四个支持的指数——健康、性能、霉菌和病毒——都在一致的范围内运行:0%(高风险)100%(无风险/最佳)。

  • 病毒指数:使用 CO2 作为气溶胶负荷的代理指标。它评估房间通风是否充分,以最大限度地减少空气传播病原体传播的风险。
  • 霉菌指数:通过分析温度和相对湿度趋势来评估霉菌形成的长期风险。
  • 激活:虚拟传感器如"相对气压"、"病毒指数"和"霉菌指数"默认处于停用状态。您可以在 air-Q 移动应用程序的 设置 > 传感器 中启用它们。

附加配置

集成初始化完成后,用户可以配置以下两个参数:

  • 显示设备平均值。默认值:on。在默认配置中,air-Q 会对传感器值流进行平均。此平均强度可在设备端配置(不通过 HA 暴露)。但是,此集成允许在从设备轮询平均数据和原始数据之间切换。要从设备轮询有噪声的传感器读数,请将显示设备平均值设置为 off

  • 裁剪负值。默认值:on。出于基线校准目的,某些传感器值可能会短暂变为负值。默认行为是将此类值裁剪为 0。

LED 控制

除了传感器读数外,此集成还将设备 LED 灯带的亮度公开为名为 number.<device_name>_led_brightnessnumber 实体。您可以从概览面板或自动化中手动设置亮度(0–100)。将其设置为 0 将关闭 LED。

故障排除

在排除故障或报告问题时,请启用调试日志并重新启动集成。问题再次出现后,停止调试日志,这将触发调试日志文件的下载。 启用调试日志会对系统性能产生轻微影响,不建议长期使用。