Skip to content

docs(guides/postinstall): add troubleshooting reference for persistent suspend freezes - #756

Closed
v1ad3k wants to merge 1 commit into
t2linux:masterfrom
v1ad3k:add-suspend-fix-troubleshooting
Closed

v1ad3k wants to merge 1 commit into
t2linux:masterfrom
v1ad3k:add-suspend-fix-troubleshooting

Conversation

@v1ad3k

@v1ad3k v1ad3k commented Sep 14, 2026

Copy link
Copy Markdown

Summary

While modern kernels handle BCE/VHCI sleep transitions through t2bce, several hardware models and configurations (notably multi-core MacBookPro16,1, 15,1, and setups with Touch Bar DRM / dGPU) still experience post-wake kernel panics, unresponsive Touch Bar/keyboard (t2bce_vhci desync), and Wi-Fi interface hangs.

This PR adds a brief troubleshooting reference in docs/guides/postinstall.md under the Suspend section pointing to apple-t2-suspend-fix, a community systemd mitigation suite tailored for Linux 7.1+ / t2bce_* setups that orchestrates CPU 0 IRQ pinning, safe pre-sleep driver teardown, and post-resume bus stabilization.

This provides an immediate reference for users experiencing persistent sleep crashes without altering the existing core recommendation.

@AdityaGarg8

Copy link
Copy Markdown
Member

No, pls, no more scripts. They never work for more than 2 people.

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.

2 participants