Skip to content

docs: add CM5 eMMC boot issue workaround#4

Merged
mairas merged 1 commit into
mainfrom
docs/cm5-emmc-boot-issue
Feb 18, 2026
Merged

docs: add CM5 eMMC boot issue workaround#4
mairas merged 1 commit into
mainfrom
docs/cm5-emmc-boot-issue

Conversation

@mairas

@mairas mairas commented Feb 18, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add troubleshooting entry explaining why HALPI2 images fail to boot on CM5 eMMC (dtparam=sd=off disables the eMMC controller)
  • Add warning admonition in the Quick Start flashing section linking to the workaround

Test plan

  • Verify the troubleshooting anchor link from quick-start works correctly
  • Confirm the admonition renders properly in mkdocs

🤖 Generated with Claude Code

HALPI2 images disable the SD card interface (dtparam=sd=off) to avoid
a shutdown delay, but on CM5 the eMMC shares the same controller. This
causes the system to drop to initramfs. Document the workaround
(commenting out dtparam=sd=off in config.txt) in both the
troubleshooting guide and the quick-start flashing section.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@mairas mairas merged commit d88da80 into main Feb 18, 2026
@mairas mairas deleted the docs/cm5-emmc-boot-issue branch May 27, 2026 14:49
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