diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js index f1ee4bb0f..aa73aa941 100644 --- a/docs/.vuepress/config.js +++ b/docs/.vuepress/config.js @@ -93,6 +93,15 @@ module.exports = { }, { + title: 'macOS Sonoma', + collapsable: false, + sidebarDepth: 1, + children: [ + ['SONOMA-DROP', 'macOS Sonoma Support'], + ] + }, + + { title: 'macOS Ventura', collapsable: false, sidebarDepth: 1, diff --git a/docs/SONOMA-DROP.md b/docs/SONOMA-DROP.md new file mode 100644 index 000000000..85c39f891 --- /dev/null +++ b/docs/SONOMA-DROP.md @@ -0,0 +1,84 @@ +![](../images/sonoma.png) + +*Well here we are again, it's always such a pleasure~* + +Apple has yet again dropped a bunch of models, continuing their journey on discontinuing Intel Macs. With the release of OpenCore Legacy Patcher v1.0.0, early support for macOS Sonoma has been implemented. + +## Versioning + +With v1.0.0, we'll be switching to a proper major, minor and bug fix system ([Semantic Versioning](https://semver.org/)). This means the coming release will be version 1.0.0, and future releases plan to follow this scheme: + +- First digit: Major changes, including new OS support, API changes, and significant patch set changes, etc +- Second digit: Minor changes, including incoming OS update fixes, minor patch set changes, etc +- Third digit: Bug fixes, primarily hot fixes either due to a regression in prior release or resolving issues in already released OS updates + + +## Newly dropped hardware + +* MacBook10,1: MacBook (Retina, 12-inch, 2017) +* MacBookPro14,1: MacBook Pro (13-inch, 2017, Two Thunderbolt 3 ports) +* MacBookPro14,2: MacBook Pro (13-inch, 2017, Four Thunderbolt 3 Ports) +* MacBookPro14,3: MacBook Pro (15-inch, 2017) +* iMac18,1: iMac (21.5-inch, 2017) +* iMac18,2: iMac (Retina 4K, 21.5-inch, 2017) +* iMac18,3: iMac (Retina 5K, 27-inch, 2017) + +## Current status + +OpenCore Legacy Patcher v1.0.0 will support Sonoma for all models normally supported by the Patcher, however some challenges remain. You can find information about them below. + +## Issues + +* [T1 Security chip](t1-security-chip) +* [USB 1.1 (OHCI/UHCI) Support](#usb-11-ohciuhci-support) +* [Graphics support and issues](#graphics-support-and-issues) + + +### T1 Security chip + +Sonoma has removed support for T1 chips found in most 2016 and 2017 Macs. Therefore on these systems, the following will not function: + +* Enable or disable FileVault +* Open the Password Settings window +* Add fingerprints (if upgrading, existing fingerprints will be deleted) +* Add cards to Apple Pay + +:::warning +Additionally, due to Sonoma no longer caring about T1, erasing the entire drive will remove the T1 firmware and it won't be reinstalled. +::: + +No known solution to resolve supporting, a significant amount of time will be required to understand how both the T1 stack works, as well as where the core issue lies for support. + +[More information here](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1103) + +### USB 1.1 (OHCI/UHCI) Support + +For Penryn systems, pre-2013 Mac Pros and Xserve, USB 1.1 support was outright removed in macOS Ventura and naturally this continues in Sonoma. +While USB 1.1 may seem unimportant, it handles many important devices on your system. These include: + +* Keyboard and Trackpad for laptops +* IR Receivers +* Bluetooth + +With OpenCore Legacy Patcher v0.6.0+, basic support has been implemented via Root Volume patching. However due to this, users will need to use a USB hub for installation and post-OS updates when patches are cleaned: + +![](../images/usb11-chart.png) + +::: warning The following systems rely on USB 1.1 + +* iMac10,x and older +* Macmini3,1 and older +* MacBook7,1 and older +* MacBookAir3,1 and older +* MacPro5,1 and older +* Xserve 3,1 and older +::: + +[More information here](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021) + +### Graphics support and issues +This build includes both Legacy Metal and non-Metal patches for macOS Sonoma. Refer to the following links for more information about Legacy Metal and non-Metal support and their respective issues. + +* [Legacy Metal](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1008) +* [Non-Metal](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108) + diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md index 02b74ed0c..2d53d1f7c 100644 --- a/docs/TROUBLESHOOTING.md +++ b/docs/TROUBLESHOOTING.md @@ -6,6 +6,7 @@ Here are some common errors that users may experience while using this patcher: * [Stuck on `This version of Mac OS X is not supported on this platform` or (🚫) Prohibited Symbol](#stuck-on-this-version-of-mac-os-x-is-not-supported-on-this-platform-or-(🚫)-prohibited-symbol) * [Cannot boot macOS without the USB](#cannot-boot-macos-without-the-usb) * [Infinite Recovery OS Booting](#infinite-recovery-os-reboot) +* [Stuck on boot after root patching](#stuck-on-boot-after-root-patching) * [Reboot when entering Hibernation (`Sleep Wake Failure`)](#reboot-when-entering-hibernation-sleep-wake-failure) * [How to Boot Recovery through OpenCore Legacy Patcher](#how-to-boot-recovery-through-opencore-legacy-patcher) * [Stuck on "Your Mac needs a firmware update"](#stuck-on-your-mac-needs-a-firmware-update) @@ -51,6 +52,21 @@ With OpenCore Legacy Patcher, we rely on Apple Secure Boot to ensure OS updates * Note: Machines with modified root volumes will also result in an infinite recovery loop until integrity is restored. +## Stuck on boot after root patching + +Boot into recovery by pressing space when your disk is selected on the OCLP bootpicker (if you have it hidden, hold ESC while starting up) + +Go into terminal and first mount the disk by typing +```sh +mount -uw "/Volumes/Macintosh HD" +``` +Then revert the snapshot (if your disk name is something else than "Macintosh HD", make sure to change the path accordingly) +```sh +bless --mount "/Volumes/Macintosh HD" --bootefi -last-sealed-snapshot +``` + +Then restart and now your system should be restored to the unpatched snapshot and should be able to boot again. + ## Reboot when entering Hibernation (`Sleep Wake Failure`) [Known issue on some models](https://github.com/dortania/Opencore-Legacy-Patcher/issues/72), a temporary fix is to disable Hibernation by executing the following command in the terminal: @@ -172,4 +188,4 @@ Applicable models include: | Mac Pro | Mid 2010 and older | MacPro3,1 - MacPro5,1 | | -![](../images/usb11-chart.png) \ No newline at end of file +![](../images/usb11-chart.png) diff --git a/images/sonoma.png b/images/sonoma.png new file mode 100644 index 000000000..a51b43fb0 Binary files /dev/null and b/images/sonoma.png differ diff --git a/images/usb11-chart.png b/images/usb11-chart.png index c80b3ab29..3938eeb4e 100644 Binary files a/images/usb11-chart.png and b/images/usb11-chart.png differ