Add air quality LED indicator

[bharvey88]

Version: 26.6.25.1

Adds an air quality LED indicator that drives the onboard RGB LEDs from the AIR-1's own readings. Everything lives in Core.yaml, so AIR-1 / BLE / Factory all get it via the core package.

Adds:

• Air Quality LED Source select (Off / NowCast AQI / CO2 / VOC Index), default Off. A selected source colors the LEDs on a six-step green→maroon severity scale.
• Air Quality LED Brightness slider (5-100%, default 100%).

Color thresholds:

• NowCast AQI: <=50 / <=100 / <=150 / <=200 / <=300 / >300
• CO2 (ppm): <=800 / <=1000 / <=1500 / <=2000 / <=2500 / >2500
• VOC index: <80 / <150 / <250 / <400 / >=400 (matches the VOC Quality text sensor; tops out at purple)

Design notes:

• Event-driven: each source sensor's on_value fires the updater only when it's the selected source, so the LED tracks readings at their real cadence (AQI/VOC ~10s, CO2 60s) with no polling.
• Off clears the LED once, then leaves it alone, so manual RGB Light control still works.
• A millis() guard skips the early-boot window so the select's restore_value publish can't write the light before it's initialized; the updater also defers while statusCheck/testScript own the LED.
• An unavailable source (NaN, e.g. CO2 with no module) clears the LED rather than showing a stale color.

Fixes: N/A

Breaks: Nothing. New entities only, default Off.

Verified on hardware and with a full esphome 2026.6.2 compile.

Docs: ApolloAutomation/docs page updated (Air Quality LED Source / Brightness).

Checks:

• Documentation Updated
• Build Number Incremented In AIR-1.yaml

(Version substitution lives in Core.yaml, which feeds AIR-1.yaml.)

🤖 Generated with Claude Code

[coderabbitai]

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

Walkthrough

Core.yaml bumps the integration version, adds a source select for the air quality LED, defines shared LED update logic keyed to NowCast AQI, CO2, or VOC Index, and runs that logic every 10 seconds.

Changes

Air quality LED control

Layer / File(s)	Summary
LED source select and version bump Integrations/ESPHome/Core.yaml	substitutions.version is updated and air_quality_led_source is added with four options and an on_value trigger to update_air_quality_led.
LED update script and interval refresh Integrations/ESPHome/Core.yaml	update_air_quality_led adds boot/status/test gating, source-based sensor reads, NaN handling, banded RGB output, and a 10-second interval execution.

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant air_quality_led_source
  participant update_air_quality_led
  participant Interval10s as 10-second interval
  participant nowcast_aqi
  participant co2
  participant sen55_voc
  participant rgb_light

  User->>air_quality_led_source: choose Off / NowCast AQI / CO2 / VOC Index
  air_quality_led_source->>update_air_quality_led: on_value executes
  Interval10s->>update_air_quality_led: execute every 10 seconds
  alt Off
    update_air_quality_led->>rgb_light: turn off
  else NowCast AQI
    update_air_quality_led->>nowcast_aqi: read value
    update_air_quality_led->>rgb_light: set fixed RGB color
  else CO2
    update_air_quality_led->>co2: read value
    update_air_quality_led->>rgb_light: set fixed RGB color
  else VOC Index
    update_air_quality_led->>sen55_voc: read value
    update_air_quality_led->>rgb_light: set fixed RGB color
  end

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• ApolloAutomation/AIR-1#89: Adds the nowcast_aqi sensor entity that update_air_quality_led reads when the source is set to NowCast AQI.

Suggested labels

new-feature

Suggested reviewers

• TrevorSchirmer

Poem

I wiggle my ears and blink the light,
AQI, CO2, or VOC at night.
Ten little hops keep colors in view,
Off means off — a tidy thing to do.
🐰✨ My burrow now glows just right.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly matches the main change: adding an air quality LED indicator feature.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@Integrations/ESPHome/Core.yaml`:
- Around line 707-710: The 10-second interval is reapplying air-quality LED
updates unconditionally, which can override `statusCheck` and `testScript` while
they are already controlling `rgb_light`. Update the `interval` block and
`update_air_quality_led` flow so it only runs when no other script owns the LED,
or centralize all `rgb_light` writes through a single arbiter/guard that
`statusCheck`, `testScript`, and the air-quality updater all consult before
changing state.
- Around line 667-693: The source-selection logic in the metric update handler
leaves rgb_light unchanged when the chosen reading is NaN, so stale colors
persist after switching to a warming-up sensor. Update the branch handling in
the lambda that maps src values like "AQI", "CO2", and "VOC Index" to clear or
turn off rgb_light before each early return triggered by isnan(x), so the LED no
longer shows the previous metric until a valid sample arrives.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: c55a1a98-dab8-4d91-9156-b189c0c36143

📥 Commits

Reviewing files that changed from the base of the PR and between 651019a and 4c4cd6d.

📒 Files selected for processing (2)

• Integrations/ESPHome/AIR-1.yaml
• Integrations/ESPHome/Core.yaml

[firstof9]

LGTM!