Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README.md after various lessons learned. #11

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

3405691582
Copy link

@3405691582 3405691582 commented Jun 14, 2024

Namely:

  • AppleSerialShim must be disabled not just for Monterey but any older macOS version; emphasize that point,

  • SIP must be disabled; while the user is there, you might as well have them run through the startup security downgrade steps while they are there,

  • the list of "except" ports on https://support.apple.com/en-us/111336 seems to be a hint to which are the DFU ports, add the link for reference in case this is true,

  • cu on macOS doesn't work well for the debug console port; this slightly adjusted picocom invocation found from the IRC archives works much better.

  • you likely need to install a corresponding KDK; you may need to upgrade
    macOS to do that.

The commit also makes some other light wording tweaks. This doc could be further improved still, but it's a start.

Namely:

* `AppleSerialShim` must be disabled not just for Monterey but any older
  macOS version; emphasize that point,

* SIP must be disabled; while the user is there, you might as well have
  them run through the startup security downgrade steps while they are
  there,

* the list of "except" ports on https://support.apple.com/en-us/111336
  seems to be a hint to which are the DFU ports, add the link for
  reference in case this is true,

* `cu` on macOS doesn't work well for the debug console port; this
  slightly adjusted `picocom` invocation found from the IRC archives
  works much better.

* you likely need to install a corresponding KDK; you may need to upgrade
  macOS to do that.

The commit also makes some other light wording tweaks. This doc could be
further improved still, but it's a start.

Signed-off-by: 3405691582 <[email protected]>
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