Document CO2 automatic self-calibration across SCD40 products

[bharvey88]

What does this implement/fix?

Documents the CO2 automatic self-calibration rollout across all four SCD40 products. Firmware PRs:

• AIR-1: Enable CO2 auto calibration by default with toggle to disable AIR-1#97
• MSR-2: Enable CO2 auto calibration by default with toggle to disable MSR-2#72
• MTR-1: Enable CO2 auto calibration by default with toggle to disable MTR-1#93
• R_PRO-1: Make CO2 auto calibration toggle work at runtime R_PRO-1#58

Changes (13 files, HA tree + Homey mirrors):

• The shared CO2 calibration guide and quick guide now lead with "your sensor calibrates itself" (weekly fresh-air requirement, when to turn it off), and reframe the manual outdoor calibration as the fallback for devices with auto calibration turned off. The manual steps themselves are unchanged.
• Product calibration pages (R-PRO-1, MSR-2 + Homey copy) get the same message per product.
• Sensor definitions for AIR-1, MTR-1, MSR-2, and R-PRO-1 gain an identical CO2 Auto Calibration Configuration row; the Calibrate SCD40 To 420ppm rows note it is only needed when auto calibration is off. R-PRO-1's row documenting the old hidden "SCD40 Automatic Self Calibration" switch is replaced.
• AIR-1 FAQ and general tips (+ Homey mirror) updated to "you usually don't need to calibrate."

Timing note: this describes firmware behavior that ships with the PRs above, so dev → main publication should be timed with the firmware releases.

Types of changes

• Typo / wording fix
• Content update (correcting outdated info, adding missing steps, clarifications)
• New page or new product section
• Page move / rename (redirect added in mkdocs.yml)
• Image / screenshot update
• Nav / structure change
• Site config or theme change
• CI / workflows / dependencies — Does not publish

Checklist:

• This PR targets the dev branch (not main)
• Changes previewed locally with mkdocs serve
• If pages were moved or renamed, redirects were added to mkdocs.yml
• If new pages were added, nav was updated in mkdocs.yml

🤖 Generated with Claude Code

[coderabbitai]

Warning

Review limit reached

@bharvey88, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 59 minutes and 14 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: efa3174a-3457-4f90-aca1-046454f2ad21

📥 Commits

Reviewing files that changed from the base of the PR and between 4ca0332 and 7df398b.

📒 Files selected for processing (13)

• docs/homey/products/air1/setup/general-tips.md
• docs/homey/products/general/calibrating-and-updating/co2-calibration.md
• docs/homey/products/msr2/calibrating-co2.md
• docs/products/air1/faq.md
• docs/products/air1/setup/general-tips.md
• docs/products/air1/setup/sensor-definitions.md
• docs/products/general/calibrating-and-updating/co2-calibration-quick.md
• docs/products/general/calibrating-and-updating/co2-calibration.md
• docs/products/msr2/calibrating-co2.md
• docs/products/msr2/setup/msr2-sensor-definitions.md
• docs/products/mtr1/setup/sensor-definitions.md
• docs/products/rpro1/calibrating-co2.md
• docs/products/rpro1/setup/rpro1-sensor-definitions.md

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch air1-co2-auto-calibration

---

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 and usage tips.}