Skip to content

Latest commit

 

History

History
163 lines (133 loc) · 9.1 KB

Force-enable_Root-Patches.md

File metadata and controls

163 lines (133 loc) · 9.1 KB

Force-enable root-patches in OpenCore Legacy Patcher

System Requirements: macOS 12 or newer
OCLP: 0.6.9 or newer

TABLE of CONTENTS

About

Note

The following instructions stem from a time where OCLP did not support device-ids that were not used in Apple Macs. Nowadays this guide is pretty much obsolete and just kept for reference.

In some cases, GPUs and Wi-Fi cards might not be detected by OpenCore Legacy Patcher because their device-id or IOName is not in the list of supported devices used in real Macs. In this case, you need to force-enable GPU patching in the configuration file of the OpenCore Legacy Patcher Source Code since the GUI of the app does not include settings to enable specific root patches manually (probably for good reasons).

Force-enable GPU patches

Caution

If your system does not have any of the GPUs supported by OCLP installed on your system but you apply any of the GPU patches in this section anyways, you will brick your macOS installation and have to revert root patches in order to recover macOS!

NVIDIA Kepler Patching

Config Preparations

  • Mount your EFI and open your config.plist
  • Adjust the following Settings:
    • Change Misc/Security/SecureBootModel to: Disabled
    • Change csr-active-config to 03080000
    • Optional: add boot-arg amfi=0x80
  • Save your config and reboot
  • Continue with the guide

Note

Other security features and config requirements might prohibit applying root patches – OCLP will notify you about issues that need to be resolved first. In this case, refer to the corresponding configuration guide for your CPU family to find the correct settings to prepare your config.plist for applying root patches with OCLP.

OCLP Preparations

To force enable patching of NVIDIA Kepler Cards (GT(X) 7xx Series) in OCLP, do the following:

  • Download the OCLP Source Code and unzip it
  • Run Terminal and enter the following commands (line by line): 
    cd ~/Downloads/OpenCore-Legacy-Patcher-main
pip3 install -r requirements.txt
  • Wait until the download of the pip3 stuff has finished
  • In Finder, navigate to "Downloads/OpenCore-Legacy-Patcher-main"
  • Double-click on Build-Binary.command → It will open another Terminal window and download payloads.dmg (≈46 MB) and Universal-Binaries.dmg(≈522 MB). These are required so patching won't fail.
  • Once the download is complete, navigate to /Downloads/OpenCore-Legacy-Patcher-main/resources/sys_patch/
  • Open sys_patch_detect.py with IDLE, TextEdit, Visual Studio Code or Xcode
  • Under "# GPU Patch Detection", change the following setting from False to True:
    • self.kepler_gpu = True
    • Leave the other option in this section at False
    • Save and close the .py file
  • Back in Finder, double-click on OpenCore-Patcher-GUI.command to run the Patcher App.
  • Click on "Post-Install Root Patch". The option "Graphics: Nvidia Kepler" should now appear in the list of applicable patches:
    PatchKepler
  • Start Patching.
  • Once it's done, reboot

Enjoy working GPU Acceleration again!

Caution

Beware when using an Nvidia GT 730 because it comes in 2 variants: Fermi (GF108) and Kepler (GK208B). But only the Kepler variant is compatible with macOS!

NVIDIA Tesla Patching

Config Preparations

  • Mount your EFI and open your config.plist
  • Adjust the following Settings:
    • Change Misc/Security/SecureBootModel to: Disabled
    • Change csr-active-config to 03080000
    • Add the following boot-args:
      • nvda_drv_vrl=1 (Enables NVIDIA Web Drivers)
      • ngfxcompat=1 (Ignores compatibility check in NVDAStartupWeb)
      • ngfxgl=1 (Disables Metal support on NVIDIA cards)
      • amfi=0x80 (Optional: disables AMFI)
      • ngfxsubmit=0 (Optional: disables interface stuttering fix on macOS 10.13)
  • Save your config and reboot
  • Continue with the guide

Note

Other security features and config requirements might prohibit applying root patches – OCLP will notify you about issues that need to be resolved first. In this case, refer to the corresponding configuration guide for your CPU family to find the correct settings to prepare your config.plist for applying root patches with OCLP.

OCLP Preparations

To force enable patching of NVIDIA Tesler Cards in OCLP, do the following:

  • Download the OCLP Source Code and unzip it
  • Run Terminal and enter the following commands (line by line): 
    cd ~/Downloads/OpenCore-Legacy-Patcher-main
pip3 install -r requirements.txt
  • Wait until the download of the pip3 stuff has finished
  • In Finder, navigate to "Downloads/OpenCore-Legacy-Patcher-main"
  • Double-click on Build-Binary.command → It will open another Terminal window and download payloads.dmg (≈46 MB) and Universal-Binaries.dmg(≈522 MB). These are required so patching won't fail.
  • Once the download is complete, navigate to /Downloads/OpenCore-Legacy-Patcher-main/resources/sys_patch/
  • Open sys_patch_detect.py with IDLE, TextEdit, Visual Studio Code or Xcode
  • Under "# GPU Patch Detection", change the following setting from False to True:
    • self.nvidia_tesla = True
    • self.nvidia_web = True
    • Leave the other option in this section at False
    • Save and close the .py file
  • Back in Finder, double-click on OpenCore-Patcher-GUI.command to run the Patcher App.
  • Click on "Post-Install Root Patch". The option "Graphics: Nvidia Kepler" should now appear in the list of applicable patches:
    Patch_Tesler
  • Start Patching.
  • Once it's done, reboot

Enjoy working GPU Acceleration again!

Other GPUs

→ Todo…

Force-enable Wi-Fi patches

If you have one of the compatible and previously supported Broadcom or Atheros Wi-Fi Cards but it is not detected by OCLP, you need to force-enable Wi-Fi patching in OCLP's Source Code and then build a custom version of the patcher by following the steps below. In my experience this is only an issue in OCLP 0.6.9 and older. Once version 1.0.0 was released, it detected the Broadcom card in my system automatically.

  1. Download the OCLP Source Code and unzip it
  2. Enter in Terminal (line by line): 
    cd ~/Downloads/OpenCore-Legacy-Patcher-main
pip3 install -r requirements.txt
  3. Wait until the downloads and installations for the pip3 stuff have finished
  4. Next, double-click on Build-Binary.command → It will download payloads.dmg and Universal-Bibaries.dmg. These are required files so patching won't fail.
  5. Once the download is complete, navigate to /Downloads/OpenCore-Legacy-Patcher-main/resources/sys_patch/
  6. Open sys_patch_detect.py with IDLE, TextEdit, Visual Studio Code or Xcode
  7. Under "# Misc Patch Detection", change the following setting based on the chipset your Wi-Fi Card uses:
    • For Modern Wi-Fi Cards: set self.modern_wifi = True
    • For Legacy Wi-Fi Cards: set self.legacy_wifi = True
    • ⚠️ Enable either Modern or Legacy, not both! It will break Wi-Fi.
    • Close the .py file and double-click on OpenCore-Patcher-GUI.command to run the Patcher App.
  8. Click on "Post-Install Root Patch". Depending on your Wi-Fi Card the option "Networking Modern Wireless" or "Networking Legacy Wireless" should now appear in the list of applicable patches.
  9. Start Patching.
  10. Once it's done, reboot
  11. Enjoy working Wi-Fi again!

Notes

  • Keep in mind that incremental system updates will no longer work once you apply root patches. Instead, the complete macOS installer will be downloaded (≈ 15 GB). There's a workaround for Haswell+ that allows installing incremental updates.
  • For enabling legacy and modern Wi-Fi on macOS Sonoma or newer during install, you can make use of auto-root-patching.

Further Resources