Keep Bluetooth Proxy on for legacy BLE builds

[bharvey88]

Version: 26.7.29.1

What does this implement/fix?

The Bluetooth Proxy switch does restore from flash, but the _OFF half of
RESTORE_DEFAULT_OFF only decides the boot where nothing is stored yet, which is
the first boot after the switch shipped. AIR-1_BLE.yaml inherited that mode from
Core, so a legacy BLE device that had always proxied comes up with the proxy off
after updating and stays that way until the user finds the switch. Reported in ApolloAutomation/MSR-2#92.

Core now reads the mode from a bluetooth_proxy_restore_mode substitution
defaulting to RESTORE_DEFAULT_OFF, and AIR-1_BLE.yaml overrides it to
RESTORE_DEFAULT_ON, the same override pattern that file already uses for its OTA
manifest URLs. The unified image is unchanged, and a user's saved choice still wins
on every later boot.

Validated with esphome config on 2026.7.2 across AIR-1.yaml, AIR-1_BLE.yaml
and AIR-1_Factory.yaml. Rendered switch: standard RESTORE_DEFAULT_OFF, BLE
RESTORE_DEFAULT_ON.

Matching PRs go to MSR-1, MSR-2 and MTR-1, which carry the identical switch and BLE variant.

Types of changes

• Bugfix (fixed change that fixes an issue)
• New feature (thanks!)
• Breaking change (repair/feature that breaks existing functionality)
• Dependency Update - Does not publish
• Other - Does not publish
• Website of github readme file update - Does not publish
• Github workflows - Does not publish

Checklist / Checklijst:

• The code change has been tested and works locally
• The code change has not yet been tested

If user-visible functionality or configuration variables are added/modified:

• Added/updated documentation for the web page

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features

  • Added configurable Bluetooth Proxy restore behavior for different device variants.
  • Legacy BLE devices now continue Bluetooth Proxy updates after firmware updates.

• Bug Fixes

  • Improved Bluetooth scanning consistency by matching the restored proxy switch state.

• Chores

  • Updated the device firmware configuration version.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: d2df9d29-3436-4037-8295-32cd891644d7

📥 Commits

Reviewing files that changed from the base of the PR and between 5fdf480 and e0dbeb6.

📒 Files selected for processing (2)

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

---

Walkthrough

The ESPHome core configuration now uses a configurable Bluetooth Proxy restore mode. The BLE variant sets this mode to restore on, while the core default remains restore off. Related documentation and the AIR-1 version are updated.

Changes

Bluetooth Proxy restore configuration

Layer / File(s)	Summary
Core restore-mode configuration Integrations/ESPHome/Core.yaml	Adds the bluetooth_proxy_restore_mode substitution, uses it for the Bluetooth Proxy switch, updates boot comments, and bumps the version.
Legacy BLE restore override Integrations/ESPHome/AIR-1_BLE.yaml	Overrides the restore mode to RESTORE_DEFAULT_ON for legacy BLE devices.

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

Possibly related PRs

• ApolloAutomation/AIR-1#111: Introduced the unified Bluetooth Proxy switch and persisted on/off state used by this configuration.

Suggested reviewers: gdt

Poem

I’m a bunny by the proxy light,
Restoring BLE through the night.
Core keeps the default low,
Legacy friends now wake aglow.
Hop, hop—updates flow just right!

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: preserving Bluetooth Proxy state for legacy BLE builds.
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.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/ble-proxy-restore-on

---

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