Skip to content

Air Quality and CO Safety

Senyo edited this page Jun 16, 2026 · 7 revisions

Humidity Intelligence Wiki

Air Quality and CO Safety

Humidity Intelligence can work with configured air-quality telemetry as a Home Assistant awareness and response layer. Certified health, compliance, and life-safety responsibilities stay with the appropriate dedicated devices and official guidance.

This page explains the public support boundary in plain language.

What AQ Means In HI

Air quality support is telemetry-driven. HI reflects the Home Assistant entities you configure and uses the current release's deterministic logic to decide whether an AQ response is eligible.

Depending on your setup and release, AQ telemetry can include:

  • indoor air quality, often shown as IAQ
  • PM2.5 fine particulate matter
  • VOC volatile organic compounds
  • CO2 carbon dioxide
  • CO carbon monoxide

AQ thresholds, health categories, alert levels, and dashboard wording stay grounded in configured entities and backend output from the current release.

Where AQ Sits In Priority

Normal AQ response sits below emergency and moisture-risk lanes.

That means AQ can be deferred by:

  • carbon-monoxide emergency
  • humidity danger
  • mould danger or risk
  • condensation danger or risk
  • zone demand
  • global gates

When the dashboard shows AQ telemetry and another lane is active, the active reason and lane priority usually explain why AQ is waiting.

IAQ

Indoor air quality values come from the user's configured Home Assistant sensors.

Different vendors use different IAQ scales. HI can display and aggregate configured numeric IAQ values, while the sensor vendor remains the authority for that scale's meaning.

When all configured IAQ inputs are unknown, unavailable, or non-numeric, HI can keep the aggregate honest by leaving it unavailable until numeric input returns.

PM2.5

PM2.5 means fine particulate matter. Common indoor sources include cooking, smoke, candles, dust disturbance, vacuuming, fireplaces, outdoor pollution entering the home, or wildfire/smog ingress.

HI can surface configured PM2.5 telemetry and, where suitable outputs are configured, use available devices to support a response. Medical outcomes and guaranteed particle removal belong to certified equipment, environmental conditions, and professional guidance.

VOC

Volatile organic compounds can come from cleaning products, aerosols, paints, solvents, adhesives, new furniture, scented products, stored fuels, and similar household sources.

HI can surface configured VOC telemetry and help correlate VOC changes with the home's environmental state. Health-risk diagnosis and air-safety certification stay with appropriate sensors, standards, and professional guidance.

CO2

Carbon dioxide can be useful as an occupancy, ventilation, or stale-air signal when a reliable sensor is configured.

CO2 and carbon monoxide are separate telemetry types with different safety meanings. Treating them separately keeps the reason panel clearer.

Carbon Monoxide Safety

Warning

Carbon-monoxide safety deserves primary, certified protection.

HI can reflect configured carbon-monoxide telemetry and can use configured CO readings in its emergency behavior where supported by the current release. Certified CO alarms remain the primary detection hardware.

Use certified carbon-monoxide alarms as the primary carbon-monoxide detection and alerting system. Install and maintain them according to local regulations, manufacturer guidance, and building or fire-safety requirements. If a CO alarm sounds or CO exposure is suspected, follow local emergency guidance.

Support Checklist

For AQ or CO support issues, include:

  • HI version
  • Home Assistant version
  • affected AQ type
  • configured source sensor type
  • whether the source entity is numeric, unknown, unavailable, or non-numeric
  • active HI lane and reason text
  • native Home Assistant diagnostics
  • sanitized screenshots only if useful

Keep private entity IDs, addresses, internal URLs, device IDs, tokens, and personal telemetry out of public issue text.


Previous Next
Why Environmental Stability Matters Troubleshooting Generated UI

Clone this wiki locally