diff --git a/docs/ACCEL.md b/docs/ACCEL.md index 971cab872..357c5465e 100644 --- a/docs/ACCEL.md +++ b/docs/ACCEL.md @@ -27,16 +27,18 @@ Metal is Apple's in-house graphics API that acts as a replacement for OpenGL/Ope | Graphics Vendor | Architecture | Series | Supports Metal | | :--- | :--- | :--- | :--- | -| ATI | TeraScale 1 | HD2000 - HD4000 | No | -| ^^ | TeraScale 2 | HD5000 - HD6000 | ^^ | -| AMD | GCN (and newer) | HD7000+ | Yes | -| NVIDIA | Tesla | 8000GT - GT300 | No | -| ^^ | Fermi | GT400 - GT500 | ^^ | -| ^^ | Kepler | GT600 - GT700 | Yes | -| Intel | GMA | GMA900 - GMA3000 | No | +| ATI | TeraScale 1 | HD 2XXX - HD 4XXX | No | +| ^^ | TeraScale 2 | HD 5XXX - HD 6XXX | ^^ | +| AMD | GCN (and newer) | HD 7XXX+ | Yes | +| NVIDIA | Tesla | 8XXX - 3XX | No | +| ^^ | Fermi | 4XX - 5XX | ^^ | +| ^^ | Kepler | 6XX - 7XX | Yes | +| ^^ | Maxwell | 8XX - 9XX | No (on 10.14 and newer) | +| ^^ | Pascal | 10XX | ^^ | +| Intel | GMA | GMA 900 - GMA X3000 | No | | ^^ | Iron Lake | HD series | ^^ | -| ^^ | Sandy Bridge | HD3000 | ^^ | -| ^^ | Ivy Bridge (and newer) | HD4000 | Yes | +| ^^ | Sandy Bridge | HD 3000 | ^^ | +| ^^ | Ivy Bridge (and newer) | HD 4000 | Yes | ::: diff --git a/docs/MODELS.md b/docs/MODELS.md index 4e78001c9..2693ffcb2 100644 --- a/docs/MODELS.md +++ b/docs/MODELS.md @@ -20,7 +20,7 @@ Regarding OS support, see below: | Support Entry | Supported OSes | Description | Comment | | :--- | :--- | :--- | :--- | -| HostOS | macOS 10.10 - macOS 13 | Refers to OSes where running OpenCore-Patcher.app are supported | Supports 10.7+ if [Python 3.9 or higher](https://www.python.org/downloads/) is manually installed, simply run the `OpenCore-Patcher-GUI.command` located in the repo | +| HostOS | macOS 10.10 - macOS 13 | Refers to OSes where running OpenCore-Patcher.app are supported | Users running 10.9 or older are advised to upgrade to a newer operating system before using OCLP. | | TargetOS | macOS 11 - macOS 13 | Refers to OSes that can be patched to run with OpenCore | May support 10.4 and newer (in a potentially broken state). No support provided. | * macOS Ventura installer creation requires 10.11 or later @@ -29,15 +29,15 @@ Regarding OS support, see below: | SMBIOS | Year | Supported | Comment | | :--- | :--- | :--- | :--- | -| MacBook1,1 | Mid-2006 | NO | 32-Bit CPU limitation | +| MacBook1,1 | Mid 2006 | NO | 32-Bit CPU limitation | | MacBook2,1 | Late 2006 | ^^ | 32-Bit Firmware limitation | | MacBook3,1 | Late 2007 | ^^ | ^^ | | MacBook4,1 | Early 2008 | ^^ | - No GPU Acceleration in Mavericks and newer
- No Keyboard and Trackpad
- No USB | | MacBook5,1 | Late 2008 | YES | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))
- UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))| -| MacBook5,2 | Early 2009 | ^^ | ^^ | -| MacBook6,1 | Late 2009 | ^^ | ^^ | -| MacBook7,1 | Mid-2010 | ^^ | ^^ | -| MacBook8,1 | Mid-2015 | ^^ | Everything is supported | +| MacBook5,2 | Early 2009, Mid 2009 | ^^ | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))
- UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))
- Trackpad gestures are partially broken | +| MacBook6,1 | Late 2009 | ^^ | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))
- UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021)) | +| MacBook7,1 | Mid 2010 | ^^ | ^^ | +| MacBook8,1 | Mid 2015 | ^^ | Everything is supported | | MacBook9,1 | Early 2016 | ^^ | ^^ | ### MacBook Air @@ -48,13 +48,13 @@ Regarding OS support, see below: | MacBookAir2,1 | Late 2008 | YES | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))
- UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))| | MacBookAir3,1 | Late 2010 | ^^ | ^^ | | MacBookAir3,2 | ^^ | ^^ | ^^ | -| MacBookAir4,1 | Mid-2011 | ^^ | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))| +| MacBookAir4,1 | Mid 2011 | ^^ | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))| | MacBookAir4,2 | ^^ | ^^ | ^^ | -| MacBookAir5,1 | Mid-2012 | ^^ | Everything is supported | +| MacBookAir5,1 | Mid 2012 | ^^ | Everything is supported | | MacBookAir5,2 | ^^ | ^^ | ^^ | -| MacBookAir6,1 | Mid-2013, Early 2014 | ^^ | ^^ | +| MacBookAir6,1 | Mid 2013, Early 2014 | ^^ | ^^ | | MacBookAir6,2 | ^^ | ^^ | ^^ | -| MacBookAir7,1 | Early-2015, 2017 | ^^ | ^^ | +| MacBookAir7,1 | Early 2015, 2017 | ^^ | ^^ | | MacBookAir7,2 | ^^ | ^^ | ^^ | ### MacBook Pro @@ -65,24 +65,24 @@ Regarding OS support, see below: | MacBookPro1,2 | ^^ | ^^ | ^^ | | MacBookPro2,1 | Late 2006 | ^^ | 32-Bit Firmware limitation | | MacBookPro2,2 | Late 2006 | ^^ | ^^ | -| MacBookPro3,1 | Mid-2007 | ^^ | Requires SSE4.1 CPU | +| MacBookPro3,1 | Mid 2007 | ^^ | Requires SSE4.1 CPU | | MacBookPro4,1 | Early 2008 | YES | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))
- UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))| | MacBookPro5,1 | Late 2008 | ^^ | ^^ | | MacBookPro5,2 | Early 2009 | ^^ | ^^ | -| MacBookPro5,3 | Mid-2009 | ^^ | ^^ | +| MacBookPro5,3 | Mid 2009 | ^^ | ^^ | | MacBookPro5,4 | ^^ | ^^ | ^^ | | MacBookPro5,5 | ^^ | ^^ | ^^ | -| MacBookPro6,1 | Mid-2010 | ^^ | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))| +| MacBookPro6,1 | Mid 2010 | ^^ | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))| | MacBookPro6,2 | ^^ | ^^ | ^^ | | MacBookPro7,1 | ^^ | ^^ | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))
- UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))| | MacBookPro8,1 | Early 2011 | ^^ | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))| | MacBookPro8,2 | ^^ | ^^ | ^^ | | MacBookPro8,3 | ^^ | ^^ | ^^ | -| MacBookPro9,1 | Mid-2012 | ^^ | Everything is supported | +| MacBookPro9,1 | Mid 2012 | ^^ | Everything is supported | | MacBookPro9,2 | ^^ | ^^ | ^^ | -| MacBookPro10,1 | Mid-2012, Early 2013 | ^^ | ^^ | +| MacBookPro10,1 | Mid 2012, Early 2013 | ^^ | ^^ | | MacBookPro10,2 | Late 2012, Early 2013 | ^^ | ^^ | -| MacBookPro11,1 | Late 2013, Mid-2014 | ^^ | ^^ | +| MacBookPro11,1 | Late 2013, Mid 2014 | ^^ | ^^ | | MacBookPro11,2 | ^^ | ^^ | ^^ | | MacBookPro11,3 | ^^ | ^^ | ^^ | | MacBookPro11,4 | Mid 2015 | ^^ | ^^ | @@ -97,33 +97,33 @@ Regarding OS support, see below: | SMBIOS | Year | Supported | Comment | | :--- | :--- | :--- | :--- | | Macmini1,1 | Early 2006 | NO | 32-Bit CPU limitation | -| Macmini2,1 | Mid-2007 | ^^ | 32-Bit Firmware limitation | +| Macmini2,1 | Mid 2007 | ^^ | 32-Bit Firmware limitation | | Macmini3,1 | Early 2009 | YES | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))
- UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))| -| Macmini4,1 | Mid-2010 | ^^ | ^^ | -| Macmini5,1 | Mid-2011 | ^^ | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))| +| Macmini4,1 | Mid 2010 | ^^ | ^^ | +| Macmini5,1 | Mid 2011 | ^^ | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))| | Macmini5,2 | ^^ | ^^ | ^^ | | Macmini5,3 | ^^ | ^^ | ^^ | | Macmini6,1 | Late 2012 | ^^ | Everything is supported | | Macmini6,2 | ^^ | ^^ | ^^ | -| Macmini7,1 | Mid-2014 | ^^ | ^^ | +| Macmini7,1 | Mid 2014 | ^^ | ^^ | ### iMac | SMBIOS | Year | Supported | Comment | | :--- | :--- | :--- | :--- | | iMac4,1 | Early 2006 | NO | 32-Bit CPU limitation | -| iMac4,2 | Mid-2006 | ^^ | ^^ | +| iMac4,2 | Mid 2006 | ^^ | ^^ | | iMac5,1 | Late 2006 | ^^ | 32-Bit Firmware limitation | | iMac5,2 | ^^ | ^^ | ^^ | | iMac6,1 | ^^ | ^^ | ^^ | -| iMac7,1 | Mid-2007 | YES | - Requires an [SSE4.1 CPU Upgrade](https://lowendmac.com/2018/penryn-t9300-9500-cpu-upgrades-for-the-2007-imac/)
- GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))
- Stock Bluetooth 2.0 card non-functional
- UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))| +| iMac7,1 | Mid 2007 | YES | - Requires an [SSE4.1 CPU Upgrade](https://lowendmac.com/2018/penryn-t9300-9500-cpu-upgrades-for-the-2007-imac/)
- GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))
- Stock Bluetooth 2.0 card non-functional
- UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))| | iMac8,1 | Early 2008 | ^^ | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))
- UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))| | iMac9,1 | Early 2009 | ^^ | ^^ | | iMac10,1 | Late 2009 | ^^ | - GPU is socketed, [recommend upgrading to Metal GPU](https://forums.macrumors.com/threads/2011-imac-graphics-card-upgrade.1596614/?post=17425857#post-17425857)
- GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))
- UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))| | iMac11,1 | ^^ | ^^ | - GPU Acceleration in Public Beta, see current issues ([#108](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/108))| -| iMac11,2 | Mid-2010 | ^^ | ^^ | +| iMac11,2 | Mid 2010 | ^^ | ^^ | | iMac11,3 | ^^ | ^^ | ^^ | -| iMac12,1 | Mid-2011 | ^^ | ^^ | +| iMac12,1 | Mid 2011 | ^^ | ^^ | | iMac12,2 | ^^ | ^^ | ^^ | | iMac13,1 | Late 2012 | ^^ | Everything is supported | | iMac13,2 | ^^ | ^^ | ^^ | @@ -131,11 +131,11 @@ Regarding OS support, see below: | iMac14,1 | Late 2013 | ^^ | ^^ | | iMac14,2 | ^^ | ^^ | ^^ | | iMac14,3 | ^^ | ^^ | ^^ | -| iMac14,4 | Mid-2014 | ^^ | ^^ | -| iMac15,1 | Late 2014, Mid-2015 | ^^ | ^^ | -| iMac16,1 | Late 2014, Mid-2015 | ^^ | ^^ | -| iMac16,2 | Late 2014, Mid-2015 | ^^ | ^^ | -| iMac17,1 | Late 2015, Early-2016 | ^^ | ^^ | +| iMac14,4 | Mid 2014 | ^^ | ^^ | +| iMac15,1 | Late 2014, Mid 2015 | ^^ | ^^ | +| iMac16,1 | Late 2014, Mid 2015 | ^^ | ^^ | +| iMac16,2 | Late 2014, Mid 2015 | ^^ | ^^ | +| iMac17,1 | Late 2015, Early 2016 | ^^ | ^^ | * For iMac10,1 through iMac12,x, we highly recommend users upgrade the GPU to a Metal supported model. See here for more information: [iMac late 2009 to mid-2011 Graphics Card Upgrade Guide](https://forums.macrumors.com/threads/2011-imac-graphics-card-upgrade.1596614/?post=17425857#post-17425857) @@ -143,19 +143,19 @@ Regarding OS support, see below: | SMBIOS | Year | Supported | Comment | | :--- | :--- | :--- | :--- | -| MacPro1,1 | Mid-2006 | NO | 32-Bit Firmware limitation | -| MacPro2,1 | Mid-2007 | ^^ | ^^ | +| MacPro1,1 | Mid 2006 | NO | 32-Bit Firmware limitation | +| MacPro2,1 | Mid 2007 | ^^ | ^^ | | MacPro3,1 | Early 2008 | YES | - UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))
- Potential boot issues with stock Bluetooth card, recommend removing to avoid kernel panics | | MacPro4,1 | Early 2009 | ^^ | - Everything is supported as long as GPU is Metal capable
- UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))| -| MacPro5,1 | Mid-2010, Mid-2012 | ^^ | ^^ | +| MacPro5,1 | Mid 2010, Mid 2012 | ^^ | ^^ | | MacPro6,1 | Late 2013 | ^^ | - CPU Power Management currently unsupported
- No DRM support | ### Xserve | SMBIOS | Year | Supported | Comment | | :--- | :--- | :--- | :--- | -| Xserve1,1 | Mid-2006 | NO | 32-Bit Firmware limitation | -| Xserve2,1 | Early 2008 | YES | - UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))| +| Xserve1,1 | Mid 2006 | NO | 32-Bit Firmware limitation | +| Xserve2,1 | Early 2008 | YES | - Everything is supported as long as GPU is Metal capable
- UHCI/OHCI support in Public Beta, see current issues ([#1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021))| | Xserve3,1 | Early 2009 | ^^ | ^^ | # Once you've verified your hardware is supported, head to [Download and build macOS Installers](./INSTALLER.md) diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md index 8a15d165a..3f1d281fe 100644 --- a/docs/TROUBLESHOOTING.md +++ b/docs/TROUBLESHOOTING.md @@ -7,7 +7,6 @@ Here are some common errors that users may experience while using this patcher: * [Cannot boot macOS without the USB](#cannot-boot-macos-without-the-usb) * [Infinite Recovery OS Booting](#infinite-recovery-os-reboot) * [Reboot when entering Hibernation (`Sleep Wake Failure`)](#reboot-when-entering-hibernation-sleep-wake-failure) -* [Booting with a non-flashed GPU](#booting-with-a-non-flashed-gpu) * [How to Boot Big Sur Recovery](#how-to-boot-big-sur-recovery) * [Stuck on "Your Mac needs a firmware update"](#stuck-on-your-mac-needs-a-firmware-update) * [No Brightness Control](#no-brightness-control) @@ -56,20 +55,6 @@ With OpenCore Legacy Patcher, we rely on Apple Secure Boot to ensure OS updates sudo pmset -a hibernatemode 0 ``` -## Booting with a non-flashed GPU - -For Mac Pro, Xserve and iMac users with non-flashed GPUs, you can still easily boot OpenCore and view the entire boot process. To do so, make sure SIP is disabled (to allow NVRAM write access) and run the following: - -```sh -sudo bless --verbose --file /Volumes/VOLNAME/EFI/OC/OpenCore.efi --folder /Volumes/VOLNAME/EFI/OC --setBoot -``` - -* Note 1: You will need to replace `VOLNAME` with the Volume name of your USB or hard drive with OpenCore. -* Note 2: Once done, you can re-enable SIP. -* Note 3: The EFI partition OpenCore was installed on must be mounted. If it's unmounted, simply rerun "Install OpenCore to drive." - -Once you boot OpenCore for the first time, LauncherOption will install itself as the top boot priority, making OpenCore always launch. Combined with `RequestBootVar`, all boot options must go through OpenCore, ensuring seamless usage even with OS installation and updates. - ## How to Boot Big Sur Recovery By default, the patcher will try to hide extra boot options such as recovery from the user. To make them appear, simply press the `Spacebar` key while inside OpenCore's Picker to list all boot options. diff --git a/docs/UNIVERSALCONTROL.md b/docs/UNIVERSALCONTROL.md index 3ce06e3b7..d9aa34a54 100644 --- a/docs/UNIVERSALCONTROL.md +++ b/docs/UNIVERSALCONTROL.md @@ -52,7 +52,7 @@ Note: For AirPort upgrades, only the best/newest cards are listed. | SMBIOS | WiFi/BT version | UC OOB | Comment | |------------|-----------------|------------|---------| | MacBook4,1 | Wi-Fi 4 / BT 2.0 EDR | NO | Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card | -| MacBook5,1 | ^^ | ^^ | Use a Broadcom USB Bluetooth 4.0+ Dongle | +| MacBook5,1 | ^^ | ^^ | Use a Broadcom USB Bluetooth 4.0+ Dongle | | MacBook5,2 | WiFi 4 / BT 2.1 EDR | ^^ | Replace stock AirPort card with an mPCIE + USB Connector Adapter board with a BCM94360CS2 card | | MacBook6,1 | ^^ | ^^ | Replace stock AirPort card with a BCM94331PCIEBT4CAX/BCM94331PCIEBT4 card | | MacBook7,1 | ^^ | ^^ | ^^ |