Skip to content

Sync dev to main: firmware update docs - #1107

Merged
bharvey88 merged 2 commits into
mainfrom
dev
Aug 23, 2026
Merged

Sync dev to main: firmware update docs#1107
bharvey88 merged 2 commits into
mainfrom
dev

Conversation

@bharvey88

Copy link
Copy Markdown
Contributor

Publishes #1106 to the live wiki.

…1106)

The shared firmware guide only covered building in ESPHome Device Builder.
The managed update system has been the main path since it shipped, and the
Firmware Update entity was not mentioned anywhere on it. Add that route
first, since it needs no computer and no cable, and keep the Device
Builder steps for people who build the YAML themselves.

Explain the Firmware Channel select on the same page. Stable is the tested
release and what a fresh flash uses, Beta gets changes earlier. The
wording is scoped to devices that have the select, because only AIR-1 and
CAST-1 document one so far.

Add a section for the case where no update ever appears. The device
fetches its manifest from apolloautomation.github.io over HTTPS, and a
network that blocks outbound traffic from IoT devices makes that check
fail quietly, leaving the entity reporting that the device is up to date.
Also cover min_version validation failures, which is the other way a
self-built update stalls.

Two AIR-1 FAQ entries for 26.7.23.1: the API connection to Home Assistant
is encrypted with nothing for the owner to do, and building the YAML
yourself now needs ESPHome 2026.7.2.

Fix three copy-paste examples on the CAST-1 TTS page. They still used
media_player.apollo_cast_1_722124_apollo_cast_1_player, which stopped
existing when the device name prefix was dropped from the media player
entity names. Anyone pasting those examples got an automation pointing at
an entity that is not there.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@coderabbitai

coderabbitai Bot commented Aug 23, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (1)
  • beta

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 5f41e7bd-e353-4660-ae8a-016a9c4b5471

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

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

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

@bharvey88
bharvey88 merged commit 1339cca into main Aug 23, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant