docs(air1): document new config controls and NOx fix

[bharvey88]

What

Documents the user-facing controls that shipped to AIR-1 main in firmware 26.7.23.1, plus a troubleshooting entry for the NOx fix.

Sensor Definitions → Configuration tab

Adds four controls that were missing from the table:

• Air Quality LED Source (Off / NowCast AQI / CO2 / VOC Index), links to the LED Indicator guide
• Air Quality LED Brightness (5-100%, default 100%)
• Bluetooth Proxy (runtime toggle, off by default, no reflash)
• Firmware Channel (Stable / Beta)

Also links the CO2 calibration guide from the existing CO2 Auto Calibration entry.

FAQ

Adds an entry for NOx reading unavailable: some units misreport the SEN54 model even though the NOx-capable SEN55 is fitted; firmware 26.7.23.1 forces the correct model so NOx reports again. Includes the note that NOx needs a short conditioning period after boot.

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Clarified that AIR-1 CO₂ and gas sensors are intended for air-quality monitoring, not certified safety detection; dedicated safety monitors are recommended.
  • Added troubleshooting guidance for unavailable NOx Index readings and the firmware update required to restore them.
  • Documented new configuration options for LED source, LED brightness, Bluetooth Proxy, and firmware channel, including defaults and behavior.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0e8a876e-be9b-4f8c-a0c1-1b5143ee87e1

📥 Commits

Reviewing files that changed from the base of the PR and between 4db4811 and 045bae3.

📒 Files selected for processing (2)

• docs/products/air1/faq.md
• docs/products/air1/setup/sensor-definitions.md

---

Walkthrough

AIR-1 documentation now clarifies sensor safety limitations, adds NOx Index troubleshooting guidance, and documents additional configuration settings for LEDs, Bluetooth Proxy, and firmware channels.

Changes

AIR-1 Documentation

Layer / File(s)	Summary
FAQ safety and NOx guidance docs/products/air1/faq.md	The FAQ states that CO2 and gas sensors are not certified for leak detection and adds guidance for restoring unavailable NOx readings caused by incorrect SEN54 model reporting.
Configuration reference updates docs/products/air1/setup/sensor-definitions.md	The configuration table documents Air Quality LED Source, Air Quality LED Brightness, Bluetooth Proxy, and Firmware Channel settings.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

• ApolloAutomation/docs#900: Rebuilds AIR-1 sensor-definition documentation, including safety warnings.
• ApolloAutomation/docs#976: Updates documentation for AIR-1 LED indicator controls.

Poem

A rabbit reads the sensors bright,
With safer notes and settings right.
When NOx goes missing from the view,
SEN55 wakes with firmware new.
Hop, hop—clear docs guide the way!

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch air1-config-controls-nox-faq

---

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.}