Skip to content

Update CAST-1 docs for the unified firmware - #1123

Merged
bharvey88 merged 1 commit into
devfrom
cast1-unified-firmware
Aug 28, 2026
Merged

Update CAST-1 docs for the unified firmware#1123
bharvey88 merged 1 commit into
devfrom
cast1-unified-firmware

Conversation

@bharvey88

@bharvey88 bharvey88 commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

CAST-1 PR #72 combined the WiFi and Ethernet firmware into one image, released as 26.8.26.7. The wiki still told people to pick a variant and reflash to move between them, and pointed at entities that no longer exist.

What changed

  • Getting Started: the Ethernet tab loses the "flash yours over to Ethernet first" step. Fit the module, plug the cable in, confirm with the new Network Connection sensor.
  • Switch Firmware page deleted, along with its nav entry. There is nothing left to switch between. The CAST-1 is not on sale yet, so no redirect is needed.
  • Ethernet Module: no firmware step after fitting the board.
  • FAQ: the Ethernet answer now explains dual-homing (Ethernet and WiFi up at once so Home Assistant keeps the device), the fallback to WiFi when the cable comes out, and the hotspot staying off while wired.
  • Sensor Definitions: the Firmware Type select is gone from the firmware, so its row goes too. IP Address is replaced by Network Connection, Ethernet IP Address and WiFi IP Address.
  • Reflash: no Variant to select. The installer already collapsed CAST-1 to one firmware in installer PR #31.
  • Reset WiFi Credentials: the "WiFi firmware only" note becomes "unplug the Ethernet cable first", which is what the firmware actually does now.
  • WizMote: the channel-scan note still applies, but keys off a CAST-1 running Ethernet with no WiFi network rather than a firmware variant.

Verified against a local mkdocs serve: annotations render as real markers, the Ethernet Module front matter parses, and the deleted page 404s with its nav entry gone.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated CAST-1 Ethernet setup instructions to explain automatic wired-connection detection without firmware switching.
    • Clarified Ethernet and Wi-Fi behavior, including simultaneous connectivity, automatic fallback, and hotspot availability.
    • Added guidance for using the Network Connection, Ethernet IP Address, and Wi-Fi IP Address sensors.
    • Updated pairing and troubleshooting guidance for Ethernet-only setups.
    • Removed obsolete firmware-switching instructions and navigation links.

CAST-1 PR #72 combined the WiFi and Ethernet firmware into one image
(26.8.26.7), so the wiki no longer needs to tell people to reflash or
pick a variant.

- Getting Started: the Ethernet tab drops the reflash step and confirms
  the wired connection with the new Network Connection sensor
- Delete the Switch Firmware page and its nav entry; there is nothing
  left to switch between
- Ethernet Module: no firmware step after fitting the board
- FAQ: the Ethernet answer now covers dual-homing, the fallback to WiFi
  when the cable comes out, and the hotspot staying off while wired
- Sensor Definitions: drop the removed Firmware Type select, replace
  IP Address with Network Connection, Ethernet IP Address and WiFi IP
  Address
- Reflash: no Variant to select, the installer serves one firmware
- Reset WiFi Credentials: unplug Ethernet first rather than a note
  about the WiFi-only firmware
- WizMote: the channel scan note now keys off running Ethernet-only
  instead of a firmware variant

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@bharvey88
bharvey88 merged commit 9ab67b2 into dev Aug 28, 2026
@bharvey88
bharvey88 deleted the cast1-unified-firmware branch August 28, 2026 15:19
@coderabbitai

coderabbitai Bot commented Aug 28, 2026

Copy link
Copy Markdown

Review Change Stack

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: ee82a9a3-d75d-4e67-a25f-8664d7d80aa0

📥 Commits

Reviewing files that changed from the base of the PR and between 5f98b96 and 51097ba.

📒 Files selected for processing (9)
  • docs/products/cast1/addons/ethernet-module.md
  • docs/products/cast1/examples/wizmote-blueprint.md
  • docs/products/cast1/faq.md
  • docs/products/cast1/setup/cast1-switch-firmware.md
  • docs/products/cast1/setup/getting-started.md
  • docs/products/cast1/setup/sensor-definitions.md
  • docs/products/cast1/troubleshooting/cast1-reflash.md
  • docs/products/cast1/troubleshooting/cast1-reset-wi-fi-credentials.md
  • mkdocs.yml

Walkthrough

CAST-1 documentation now describes automatic Ethernet detection, simultaneous Ethernet and Wi-Fi states, updated network sensors, cable-dependent hotspot behavior, and setup without firmware switching.

Changes

CAST-1 Ethernet behavior

Layer / File(s) Summary
Document automatic Ethernet behavior
docs/products/cast1/addons/ethernet-module.md, docs/products/cast1/faq.md, docs/products/cast1/examples/wizmote-blueprint.md
The documentation describes automatic wired connection detection, Network Connection states, Ethernet-only pairing behavior, and support contact information.

|Update setup and sensor references
docs/products/cast1/setup/getting-started.md, docs/products/cast1/setup/sensor-definitions.md|Ethernet setup no longer includes firmware flashing. Verification uses the Network Connection sensor. Diagnostic entities now include separate Ethernet and Wi-Fi IP addresses.|

|Remove legacy firmware guidance
docs/products/cast1/setup/cast1-switch-firmware.md, docs/products/cast1/troubleshooting/cast1-reflash.md, docs/products/cast1/troubleshooting/cast1-reset-wi-fi-credentials.md, mkdocs.yml|The firmware-switch page and navigation entry were removed. Reflash and Wi-Fi credential instructions no longer reference separate firmware variants.|

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

Poem

I’m a rabbit with cables neatly spun,
Ethernet joins Wi-Fi in the sun.
No firmware dance, no flashing fright,
Network sensors name the path just right.
Unplug the cord for hotspot light!

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch cast1-unified-firmware

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.

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