From cb7d62f2eec1b1875f38b78f337fa5cadb26fdda Mon Sep 17 00:00:00 2001 From: Mykola Grymalyuk <48863253+khronokernel@users.noreply.github.com> Date: Sat, 31 Jul 2021 22:27:40 -0600 Subject: [PATCH] Update docs to better reflect current state --- docs/ACCEL.md | 58 ++++++++++++++++++++++++++++++++++++++----- docs/MODELS.md | 3 +++ docs/MONTEREY-DROP.md | 24 ++++++++++++++++++ 3 files changed, 79 insertions(+), 6 deletions(-) diff --git a/docs/ACCEL.md b/docs/ACCEL.md index e90177d7f..8979f0207 100644 --- a/docs/ACCEL.md +++ b/docs/ACCEL.md @@ -7,13 +7,48 @@ * [Photos and Maps Apps Heavily Distorted](#photos-and-maps-apps-heavily-distorted) * [Cannot press "Done" when editing a Sidebar Widget](#cannot-press-done-when-editing-a-sidebar-widget) * [Wake from sleep heavily distorted on AMD/ATI in macOS 11.3 and newer](#wake-from-sleep-heavily-distorted-on-amd-ati-in-macos-11-3-and-newer) -* [Unable to achieve GPU Acceleration on 2011 15" and 17" MacBook Pros](#unable-to-achieve-gpu-acceleration-on-2011-15-and-17-macbook-pros) +* [Unable to switch GPUs on 2011 15" and 17" MacBook Pros](#unable-to-switch-gpus-on-2011-15-and-17-macbook-pros) +* [Erratic Colours on ATI TeraScale 2 GPUs (HD5000/HD6000)](#erratic-colours-on-ati-terascale-2-gpus-hd5000-hd6000) The below page is for users experiencing issues with their overall usage of macOS Big Sur and the Legacy Graphics Acceleration patches. Note that the following GPUs currently do not have acceleration support in Big Sur: -* AMD/ATI TeraScale 2 - HD5/6000 series * Intel 3rd and 4th Gen - GMA series +For those unfamiliar with what is considered a non-Metal GPU, see below chart: + +::: details macOS GPU Chart + +| 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 | +| ^^ | Iron Lake | HD series | ^^ | +| ^^ | Sandy Bridge | HD3000 | ^^ | +| ^^ | Ivy Bridge (and newer) | HD4000 | Yes | + +::: + +Additionally we currently do not have macOS Monterey acceleration patches for non-Metal Macs. We recommend users either upgrade their Macs with a Metal GPU or remain on Big Sur until further development + +::: details Why there's no non-Metal patches for Monterey + +With macOS Monterey, please understand our current legacy acceleration patch sets are no longer functional. As of right now, only basic framebuffer and brightness control may be achieved, however proper animations and hardware acceleration is not available. + +This is due to numerous changes with Skylight and other macOS frameworks relying more and more on Metal functions and thus making it even more difficult to re-add legacy OpenGL support. + +> When can we expect acceleration support + +For the time being, please understand we cannot predict when there will be patch sets ready. Note that it took over 300 days from Big Sur's unveiling to achieve public acceleration for non-Metal GPUs. And with TeraScale 2 acceleration, this took almost 3 years to achieve public acceleration. + +So please be patient as developers are hard at work, however please expect no acceleration support in Monterey until next year at the minimum if not even later. + +::: + ## Downloading older non-Metal Apps Many Apple apps now have direct reliance on Metal for proper functioning, however legacy builds of these apps still do work in Big Sur. See below for archive of many apps such as Pages, iMovie, GarageBand. @@ -67,15 +102,17 @@ To work around this, simply press Tab to hover over and press spacebar to simula ## Wake from sleep heavily distorted on AMD/ATI in macOS 11.3 and newer -Unfortunately a very well known issue the community is investigating, current known solution is to simply downgrade to 11.2.3 or older until a proper fix can be found. +Unfortunately a very well known issue the community is investigating, current known solution is to simply downgrade to 11.2.3 or older until a proper fix can be found. Additionally logging out and logging in can resolve the issue without requiring a reboot + +* Note, this issue should be exclusive to TeraScale 1 GPUs (ie. HD2000-4000). TeraScale 2 GPUs should not exhibit this issue In the event Apple removes 11.2.3 from their catalogue, we've provided a mirror below: * [Install macOS 11.2.3 20D91](https://archive.org/details/install-mac-os-11.2.3-20-d-91) -## Unable to achieve GPU Acceleration on 2011 15" and 17" MacBook Pros +## Unable to switch GPUs on 2011 15" and 17" MacBook Pros -Currently OpenCore Legacy Patcher doesn't have support for the TeraScale 2 series dGPUs found in the 15" and 17" models. Currently the best way to achieve graphics acceleration is to simply disable the dGPU and force the iGPU always. +Currently OpenCore Legacy Patcher, GPU switching between the iGPU and dGPU is broken. The simplest way to set a specific GPU is to disable the dGPU when you wish to remain on the more power efficient iGPU. The best way to achieve this is to boot Recovery (or Single User Mode if the dGPU refuses to function at all) and run the following command: @@ -83,4 +120,13 @@ The best way to achieve this is to boot Recovery (or Single User Mode if the dGP nvram FA4CE28D-B62F-4C99-9CC3-6815686E30F9:gpu-power-prefs=%01%00%00%00 ``` -This will disable the dGPU and allow graphics acceleration in Big Sur. Note that external display outputs are directly routed to the dGPU and therefore can no longer be used. Solutions such as a [DisplayLink Adapters](https://www.displaylink.com/products/usb-adapters) can work around this limitation in theory. However, currently the proprietary DisplayLink driver refuses to function on legacy-patched systems, either resulting in a windowserver crash loop or no output at all. +This will disable the dGPU and allow the iGPU to function in Big Sur. Note that external display outputs are directly routed to the dGPU and therefore can no longer be used. Solutions such as a [DisplayLink Adapters](https://www.displaylink.com/products/usb-adapters) can work around this limitation in theory. However, currently the proprietary DisplayLink driver refuses to function on legacy-patched systems, either resulting in a windowserver crash loop or no output at all. + +## Erratic Colours on ATI TeraScale 2 GPUs (HD5000/HD6000) + +Due to an odd bug with ATI's TeraScale 2 GPUs, many users will experience erratic/strobing colours once finished installing and rebooting into the accelerated patches. The issue stems from an incorrect assumption in the GPU drivers where it will enforce the Billion Colour space on your display. To fix, simply force your Display into a lower color depth such as a Million Colours. + +Applications that can set color depth are: + +* [SwitchResX](https://www.madrau.com) +* [ResXtreme](https://macdownload.informer.com/resxtreme/) \ No newline at end of file diff --git a/docs/MODELS.md b/docs/MODELS.md index 8303c62ea..e52911e95 100644 --- a/docs/MODELS.md +++ b/docs/MODELS.md @@ -23,6 +23,9 @@ Regarding OS support, see below: | HostOS | macOS 10.9 - macOS 11 | 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.command` located in the repo | | TargetOS | macOS 11 | 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 Monterey support is currently in beta and is not recommended for everyday users. The below page is meant to represent macOS Big Sur support and may not correctly reflect Monterey's support on each model + * Recommend looking at the [macOS Monterey Support page](./MONTEREY-DROP.md) for a better idea of Monterey's current status + ### MacBook | SMBIOS | Year | Supported | Comment | diff --git a/docs/MONTEREY-DROP.md b/docs/MONTEREY-DROP.md index 776493191..fd56c53c8 100644 --- a/docs/MONTEREY-DROP.md +++ b/docs/MONTEREY-DROP.md @@ -5,6 +5,7 @@ With OpenCore Legacy Patcher v0.1.7 and newer, we've implemented beta macOS Mont Current models with full, unhindered support in OpenCore Legacy Patcher are the following: * iMac13,x and newer + * iMac13,x series must have a Nvidia dGPU for best support * iMac10,1-12,x included if Wireless Card and Bluetooth upgraded as well as Metal GPU * Macmini7,1 and newer * MacBook8,1 and newer @@ -12,6 +13,22 @@ Current models with full, unhindered support in OpenCore Legacy Patcher are the * MacBookPro11,x and newer * MacPro3,1 and newer * Requires Wireless Card and Bluetooth upgrade for 3,1-5,1 as well as Metal GPU + + +## Newly dropped hardware + +With Monterey, Apple continues their their somewhat ruthless march of dropping Intel hardware. This release saw the removal, and thus addition into OpenCore Legacy Patcher, of the following models: + +* iMac14,4 +* iMac15,1 +* MacBook8,1 +* MacBookAir6,1 +* MacBookAir6,2 +* MacBookPro11,1 +* MacBookPro11,2 +* MacBookPro11,3 + +All of these models now have support in OpenCore Legacy Patcher. Note iMac15,1 does have [an unfortunate firmware bug preventing resolutions above 4k](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/359) with OpenCore Legacy Patcher ## Current Hardware Drawbacks: @@ -92,6 +109,13 @@ Here are the firmwares macOS Monterey Dropped (previously located within IOBluet Note: Native BRCM20702 and BRCM20703 are still fully support by OpenCore Legacy Patcher +### macOS 12.0 Beta 4 issue on 2011 to early 2013 machines + +Currently in macOS 12.0 Beta 4, many Sandy and Ivy Bridge Macs have experienced Bluetooth issues relating to their BCM94331 chipset. Currently the exact issue is unknown however is assumed to be a bug on Apple's end. Recommend downgrading to macOS 12.0 Beta 3 till resolved: + +* [12.0 Beta 3 (21A5284e) InstallAssistant (Direct)](http://swcdn.apple.com/content/downloads/02/08/071-63739-A_G5RYVW5JHT/dfz5gp3s0jm9vl7m30oewq141zkpv8edr8/InstallAssistant.pkg) +* [12.0 Beta 3 (21A5284e) InstallAssistant (archive.org)](https://archive.org/details/12.0-21a5284e-beta-3) + ## Wireless Support Dropped * Broadcom BCM94328, BCM94322 and Atheros Wireless Chipsets lost support