OpenCore-Legacy-Patcher/PATCHEXPLAIN.html

<!DOCTYPE html>
<html lang="en-US">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width,initial-scale=1">
    <title>Explaining the patches in OpenCore Legacy Patcher | OpenCore Legacy Patcher</title>
    <meta name="generator" content="VuePress 1.7.1">
    <link rel="&#39;stylesheet" href="/OpenCore-Legacy-Patcher/styles/website.css">
    <meta name="description" content="">
    <meta name="theme-color" content="#3eaf7c">
    <meta name="apple-mobile-web-app-capable" content="yes">
    <meta name="apple-mobile-web-app-status-bar-style" content="black">

    <link rel="preload" href="/OpenCore-Legacy-Patcher/assets/css/0.styles.1c47b1bb.css" as="style"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/app.cad9deb6.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/2.d13a5aaf.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/24.398f3072.js" as="script"><link rel="preload" href="/OpenCore-Legacy-Patcher/assets/js/16.bd966d9c.js" as="script"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/10.57e373cf.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/11.40e642c6.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/12.b1f670fd.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/13.dde76279.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/14.1e7135f7.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/15.726eb6a0.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/17.146c03f3.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/18.d72d7dd7.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/19.6741b85e.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/20.858354a8.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/21.58682558.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/22.2804c343.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/23.6213fb6f.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/25.b94f95c9.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/26.8fb73cee.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/27.48d42dbf.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/28.b9f81099.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/29.1580bab9.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/3.c1760334.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/30.e3c4bb01.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/4.bebfc1e7.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/5.02952c10.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/6.5b781700.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/7.9f421cf7.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/8.0e86f38a.js"><link rel="prefetch" href="/OpenCore-Legacy-Patcher/assets/js/9.312d45b7.js">
    <link rel="stylesheet" href="/OpenCore-Legacy-Patcher/assets/css/0.styles.1c47b1bb.css">
  </head>
  <body>
    <div id="app" data-server-rendered="true"><div class="theme-container"><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <a href="/OpenCore-Legacy-Patcher/" class="home-link router-link-active"><img src="homepage.png" alt="OpenCore Legacy Patcher" class="logo"> <span class="site-name can-hide">OpenCore Legacy Patcher</span></a> <div class="links"><div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links can-hide"> <div class="nav-item"><a role="button" aria-label="Switch to light mode" class="nav-link"><span>Switch theme</span></a></div> <a href="https://github.com/dortania/OpenCore-Legacy-Patcher/" target="_blank" rel="noopener noreferrer" class="repo-link">
    GitHub
    <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></nav></div></header> <div class="sidebar-mask"></div> <aside class="sidebar"><nav class="nav-links"> <div class="nav-item"><a role="button" aria-label="Switch to light mode" class="nav-link"><span>Switch theme</span></a></div> <a href="https://github.com/dortania/OpenCore-Legacy-Patcher/" target="_blank" rel="noopener noreferrer" class="repo-link">
    GitHub
    <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></nav>  <ul class="sidebar-links"><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Introduction</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/START.html" class="sidebar-link">What is OpenCore?</a></li><li><a href="/OpenCore-Legacy-Patcher/MODELS.html" class="sidebar-link">Supported Models</a></li><li><a href="/OpenCore-Legacy-Patcher/BENIFITS.html" class="sidebar-link">Benefits and drawbacks</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Setting up</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/INSTALLER.html" class="sidebar-link">Download and build macOS Installers</a></li><li><a href="/OpenCore-Legacy-Patcher/BUILD.html" class="sidebar-link">Building and installing OpenCore</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Installation</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/BOOT.html" class="sidebar-link">Booting OpenCore and macOS</a></li><li><a href="/OpenCore-Legacy-Patcher/POST-INSTALL.html" class="sidebar-link">Post-Installation</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>macOS Monterey</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/MONTEREY-DROP.html" class="sidebar-link">macOS Monterey Support</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Misc</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/ACCEL.html" class="sidebar-link">Working Around Legacy Acceleration Issues</a></li><li><a href="/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html" class="sidebar-link">Troubleshooting</a></li><li><a href="/OpenCore-Legacy-Patcher/DEBUG.html" class="sidebar-link">How to debug with OpenCore</a></li><li><a href="/OpenCore-Legacy-Patcher/UPDATE.html" class="sidebar-link">Updating OpenCore and Co</a></li><li><a href="/OpenCore-Legacy-Patcher/UNINSTALL.html" class="sidebar-link">Uninstalling OpenCore</a></li><li><a href="/OpenCore-Legacy-Patcher/ICNS.html" class="sidebar-link">Creating custom icons for OpenCore and Mac Boot Picker</a></li><li><a href="/OpenCore-Legacy-Patcher/WINDOWS.html" class="sidebar-link">Installing UEFI Windows 10</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Credit</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/DONATE.html" class="sidebar-link">Supporting the patcher</a></li><li><a href="/OpenCore-Legacy-Patcher/LICENSE.html" class="sidebar-link">OpenCore Legacy Patcher Licence</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading open"><span>Documentation</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/OpenCore-Legacy-Patcher/TESTED.html" class="sidebar-link">Tested Models on OpenCore Legacy Patcher</a></li><li><a href="/OpenCore-Legacy-Patcher/TERMS.html" class="sidebar-link">OpenCore Patcher Terminology</a></li><li><a href="/OpenCore-Legacy-Patcher/HOW.html" class="sidebar-link">Boot Process with OpenCore Legacy Patcher</a></li><li><a href="/OpenCore-Legacy-Patcher/PATCHEXPLAIN.html" aria-current="page" class="active sidebar-link">Explaining the patches in OpenCore Legacy Patcher</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/PATCHEXPLAIN.html#opencore-settings" class="sidebar-link">OpenCore Settings</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/PATCHEXPLAIN.html#injected-kext" class="sidebar-link">Injected Kext</a></li><li class="sidebar-sub-header"><a href="/OpenCore-Legacy-Patcher/PATCHEXPLAIN.html#on-disk-patches" class="sidebar-link">On-Disk Patches</a></li></ul></li></ul></section></li></ul> </aside> <main class="page"> <div class="theme-succinct-content content__default"><h1 id="explaining-the-patches-in-opencore-legacy-patcher"><a href="#explaining-the-patches-in-opencore-legacy-patcher" class="header-anchor">#</a> Explaining the patches in OpenCore Legacy Patcher</h1> <p>In our patcher, there are numerous patches used to ensure a stable system. Here we're going to go over what patches are used and why we recommend or even require them.</p> <ul><li><a href="#opencore-settings">OpenCore Settings</a></li> <li><a href="#injected-kexts">Injected Kexts</a></li> <li><a href="#on-disk-patches">On-Disk Patches</a></li></ul> <h2 id="opencore-settings"><a href="#opencore-settings" class="header-anchor">#</a> OpenCore Settings</h2> <p>Below is a run down of the main logic OpenCore Legacy Patcher uses to gain native support in macOS. Note OpenCore's configuration is documented within <a href="https://github.com/acidanthera/OpenCorePkg" target="_blank" rel="noopener noreferrer">OpenCorePkg<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a> as well as an online version provided by us:</p> <ul><li><a href="https://dortania.github.io/docs/latest/Configuration.html" target="_blank" rel="noopener noreferrer">OpenCorePkg Online Docs<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></li></ul> <details class="custom-block details"><summary>Configuration Explanation</summary> <h3 id="acpi-patch"><a href="#acpi-patch" class="header-anchor">#</a> ACPI -&gt; Patch</h3> <ul><li>EHCx and XHC1 Patches
<ul><li>Reason: Required for proper USB operation</li> <li>Logic: Avoids USB maps of newer models attaching and breaking USB port functionality</li> <li>Models: All models require when spoofing with Moderate or Advanced SMBIOS</li></ul></li></ul> <h3 id="booter-quirks"><a href="#booter-quirks" class="header-anchor">#</a> Booter -&gt; Quirks</h3> <ul><li>ForceBooterSignature
<ul><li>Reason: Required to ensure Hibernation support</li> <li>Logic: Tricks boot.efi into thinking OpenCore is Apple's firmware</li> <li>Models: All models require</li></ul></li></ul> <h3 id="deviceproperties-add"><a href="#deviceproperties-add" class="header-anchor">#</a> DeviceProperties -&gt; Add</h3> <ul><li><code>PciRoot(0x0)/Pci(0x15,0x0)/Pci(0x0,0x0)</code></li> <li><code>PciRoot(0x0)/Pci(0x1C,0x4)/Pci(0x0,0x0)</code></li> <li><code>PciRoot(0x0)/Pci(0x1C,0x3)/Pci(0x0,0x0)</code></li> <li><code>PciRoot(0x0)/Pci(0x1C,0x5)/Pci(0x0,0x0)</code></li> <li><code>PciRoot(0x0)/Pci(0x1C,0x1)/Pci(0x0,0x0)</code> <ul><li>Reason: Required to ensure Wifi works with full, native support</li> <li>Logic: Tricks AirPortBrcmNIC.kext into thinking our device is a BCM94360 (<code>14e4,43ba</code>)</li> <li>Models: Machines with BCM943224 and BCM94331 chipsets</li></ul></li> <li><code>PciRoot(0x0)/Pci(0x3,0x0)/Pci(0x0,0x0)</code></li> <li><code>PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x0)</code> <ul><li>Reason: Required to ensure Brightness Control works on upgraded iMacs</li> <li>Logic: Sets AppleBackLight properties</li> <li>Models: iMac11,x and iMac12,x with upgraded Nvidia Metal GPUs</li></ul></li> <li><code>PciRoot(0x0)/Pci(0x2,0x0)</code> <ul><li>Reason: Disables internal GPU to fix sleep issues on upgrades iMacs</li> <li>Logic: Tricks macOS into thinking iGPU is a generic PCI device</li> <li>Models: iMac12,x with upgraded Metal GPUs</li></ul></li></ul> <h3 id="kernel-patch"><a href="#kernel-patch" class="header-anchor">#</a> Kernel -&gt; Patch</h3> <ul><li>SMC Patch
<ul><li>Reason: Required to avoid SMC Firmware updates</li> <li>Logic: Patches out <code>smc-version</code> in AppleSMC.kext, requires SMC-Spoof.kext for full functionality</li> <li>Models: All models require when spoofing SMBIOS</li></ul></li> <li>IOHIDFamily Patch
<ul><li>Reason: Required for HID peripheral support in macOS on older hardware</li> <li>Logic: Tricks IOHIDFamily into thinking it's always booting recovery</li> <li>Models: Penryn CPUs (Core2 series)</li></ul></li></ul> <h3 id="kernel-quirks"><a href="#kernel-quirks" class="header-anchor">#</a> Kernel -&gt; Quirks</h3> <ul><li>ThridPartyDrives
<ul><li>Reason: Required to avoid Hibernation wake issues on 3rd party drives</li> <li>Logic: Patches AppleAHCIPort.kext into support</li> <li>Models: All models with standard SATA ports</li></ul></li> <li>PanicNoKextDump
<ul><li>Reason: Avoids kext dump on kernel panics, easier kernel debugging</li> <li>Logic: Patches Kernel to not dump dump unnecessary info</li> <li>Models: Only set when Verbose Boot is enabled by the user</li></ul></li></ul> <h3 id="misc-security"><a href="#misc-security" class="header-anchor">#</a> Misc -&gt; Security</h3> <ul><li>SecureBootModel
<ul><li>Reason: Required to ensure seamless OS updates with Big Sur</li> <li>Logic: Sets iMacPro1,1's Secure Enclave Identifier (j137)</li> <li>Models: All models require</li></ul></li></ul> <h3 id="nvram-add"><a href="#nvram-add" class="header-anchor">#</a> NVRAM -&gt; Add</h3> <ul><li><code>-v debug=0x100</code> <ul><li>Reason: Used to see debug info of macOS's kernel and kexts, and avoids reboots on panic</li> <li>Logic: Adds args to NVRAM</li> <li>Models: Only set when Verbose Boot is enabled by the user</li></ul></li> <li><code>-liludbgall</code> <ul><li>Reason: Enables Lilu and plugin debug logging</li> <li>Logic: Adds args to NVRAM</li> <li>Models: Only set when Kext DEBUG is enabled by the user</li></ul></li> <li><code>msgbuf=1048576</code> <ul><li>Reason: Sets message buffer size to 1MB, ensures boot logs are retained</li> <li>Logic: Adds args to NVRAM</li> <li>Models: Only set when Kext DEBUG is enabled by the user</li></ul></li> <li><code>agdpmod=pikera</code> <ul><li>Reason: Fixes GPU switching on MacBookPro9,x</li> <li>Logic: Adds args to NVRAM</li> <li>Models: MacBookPro9,x</li></ul></li> <li><code>shikigva=80 unfairgva=1</code></li> <li><code>shikigva=128 unfairgva=1 -wegtree</code> <ul><li>Reason: Fixes DRM support on models with upgraded AMD Metal GPUs</li> <li>Logic: Adds args to NVRAM</li> <li>Models: Models with upgraded AMD Metal GPUs</li></ul></li></ul> <h3 id="uefi-protocoloverrides"><a href="#uefi-protocoloverrides" class="header-anchor">#</a> UEFI -&gt; ProtocolOverrides</h3> <ul><li>GopPassThrough
<ul><li>Reason: Used for proper output on machines with UGA firmware but GOP GPU</li> <li>Logic: Provide GOP protocol instances on top of UGA protocol instances</li> <li>Models: MacPro3,1, MacBook4,1 iMac7,1-8,1</li></ul></li></ul></details> <h2 id="injected-kext"><a href="#injected-kext" class="header-anchor">#</a> Injected Kext</h2> <p>Below is an explanation of what Kexts OpenCore Legacy Patcher will inject into memory on boot-up.</p> <details class="custom-block details"><summary>Injected Kext Explanation</summary> <h3 id="acidanthera"><a href="#acidanthera" class="header-anchor">#</a> Acidanthera</h3> <ul><li>Lilu
<ul><li>Reason: Patching engine for other kexts</li> <li>Models: All models require</li></ul></li> <li>WhateverGreen
<ul><li>Reason: Patches GPU Frameworks and kext to ensure proper support</li> <li>Models: All models require</li></ul></li> <li>CPUFriend
<ul><li>Reason: Patches IOx86PlatformPlugin to restore previous CPU profiles</li> <li>Models: 2012 and newer models</li></ul></li> <li>AirportBrcmFixup
<ul><li>Reason: Patches IO80211 and co to fix networking support for unsupported cards</li> <li>Models: BCM943224 and BCM94331</li></ul></li> <li>RestrictEvents
<ul><li>Reason: Disables memory errors on MacPro7,1</li> <li>Models: Mac Pros and Xserves</li></ul></li></ul> <h3 id="ethernet"><a href="#ethernet" class="header-anchor">#</a> Ethernet</h3> <ul><li>nForceEthernet
<ul><li>Reason: Inject old Nvidia Ethernet kext to resolve networking in Catalina and newer</li> <li>Models: 2010 and older Nvidia Ethernet require</li></ul></li> <li>MarvelYukonEthernet
<ul><li>Reason: Inject old Marvel Ethernet kext to resolve networking in Catalina and newer</li> <li>Models: 2008 and older Marvel Ethernet require</li></ul></li> <li>CatalinaBCM5701Ethernet
<ul><li>Reason: Inject old Broadcom Ethernet kext to resolve networking in Big Sur</li> <li>Logic: Patch out conflicting symbols to not colide existing BCM5701Ethernet</li> <li>Models: 2011 and older Broadcom Ethernet require</li></ul></li></ul> <h3 id="maps"><a href="#maps" class="header-anchor">#</a> Maps</h3> <ul><li>USBMap
<ul><li>Reason: Inject old USB map profiles to fix USB</li> <li>Models: All models require</li></ul></li></ul> <h3 id="sse"><a href="#sse" class="header-anchor">#</a> SSE</h3> <ul><li>AAMouSSE
<ul><li>Reason: Translates SSE4.2 instructions to compatible code for SSE4,1 CPUs, required for AMD Metal drives</li> <li>Models: MacPro3,1</li></ul></li> <li>telemetrap
<ul><li>Reason: Ensures temelemtry.plugin doesn't run, required for SSE4,1 CPUs</li> <li>Models: Penryn CPUs</li></ul></li></ul> <h3 id="wifi"><a href="#wifi" class="header-anchor">#</a> Wifi</h3> <ul><li>IO80211HighSierra
<ul><li>Reason: Re-inject Atheros wifi drivers from High Sierra</li> <li>Logic: Patch out conflicting symbols to not colide existing IO80211Family</li> <li>Models: Atheros cards</li></ul></li> <li>IO80211Mojave
<ul><li>Reason: Re-inject Broadcom wifi drivers from Mojave</li> <li>Logic: Patch out conflicting symbols to not colide existing IO80211Family</li> <li>Models: BCM94322</li></ul></li></ul> <h3 id="misc"><a href="#misc" class="header-anchor">#</a> Misc</h3> <ul><li>AppleBackLightFixup
<ul><li>Reason: Patch AppleBacklight for iMacs with Nvidia Metal GPU upgrades</li> <li>Models: iMac11,x, iMac12,x with upgraded Nvidia Metal GPUs</li></ul></li> <li>AppleIntelPIIXATA
<ul><li>Reason: Fix IDE support on MacPro3,1</li> <li>Models: MacPro3,1</li></ul></li> <li>AppleIntelMCEDisabler
<ul><li>Reason: Fix dual socket support in Catalina and newer</li> <li>Models: Mac Pros and Xserves</li></ul></li> <li>NightShiftEnabler
<ul><li>Reason: Enables NightShift support on unsupported models</li> <li>Models: 2011 and older, MacBookPro9,x included</li></ul></li> <li>SMC-Spoof
<ul><li>Reason: Spoofs SMC version to 9.9999</li> <li>Models: All models require</li></ul></li></ul></details> <h2 id="on-disk-patches"><a href="#on-disk-patches" class="header-anchor">#</a> On-Disk Patches</h2> <p>Unfortunately certain on-disk patches are required to achieve full functionality. Below is a breakdown of patches supported</p> <details class="custom-block details"><summary>Audio Patches</summary> <h3 id="extensions"><a href="#extensions" class="header-anchor">#</a> Extensions</h3> <ul><li>AppleHDA
<ul><li>Reason: Re-add El Capitan's AppleHDA to achieve audio support</li> <li>Models: iMac7,1 and iMac8,1</li></ul></li></ul></details> <details class="custom-block details"><summary>Acceleration Patches</summary> <h3 id="extensions-2"><a href="#extensions-2" class="header-anchor">#</a> Extensions</h3> <h4 id="general-patches"><a href="#general-patches" class="header-anchor">#</a> General Patches</h4> <ul><li>IOSurface.kext
<ul><li>Reason: Fixes immediate logout on login</li> <li>Logic: Downgrade to Catalina IOSurface</li> <li>Note: For AMD and Intel, additional <code>addMemoryRegion/removeMemoryRegion</code> patch added changing the first conditional jump to non conditional jump
<ul><li>At Offset <code>0xdb52</code> and <code>0xdbc6</code>, replace following bytes with <code>0xeb</code></li></ul></li></ul></li></ul> <h4 id="dropped-acceleration-binaries"><a href="#dropped-acceleration-binaries" class="header-anchor">#</a> Dropped Acceleration Binaries</h4> <ul><li><p>Nvidia Binaries</p> <ul><li>GeForceGA.bundle</li> <li>GeForceTesla.kext
<ul><li>Skip IOFree Panic - Mojave+
<ul><li>At Offset <code>0x5CF9A</code> replace following bytes with <code>0xEB</code></li></ul></li> <li>Avoids <code>addMemoryRegion/removeMemoryRegion</code> calls
<ul><li>At Offset <code>0x5527</code> and <code>0x77993</code>, replace following bytes with <code>0x909090909090</code></li></ul></li></ul></li> <li>GeForceTeslaGLDriver.bundle</li> <li>GeForceTeslaVADriver.bundle</li> <li>NVDANV50HalTesla.kext</li> <li>NVDAResmanTesla.kext
<ul><li>0x1ea59a - 0x1ea5b3: nop</li> <li>Replace VSLGestalt to IOLockLock or any other known symbol of the same length.</li></ul></li></ul></li> <li><p>AMD/ATI Binaries</p> <ul><li>AMD2400Controller.kext</li> <li>AMD2600Controller.kext</li> <li>AMD3800Controller.kext</li> <li>AMD4600Controller.kext</li> <li>AMD4800Controller.kext</li> <li>AMD5000Controller.kext</li> <li>AMD6000Controller.kext</li> <li>AMDFramebuffer.kext</li> <li>AMDLegacyFramebuffer.kext</li> <li>AMDLegacySupport.kext</li> <li>AMDRadeonVADriver.bundle</li> <li>AMDRadeonVADriver2.bundle</li> <li>AMDRadeonX3000.kext</li> <li>AMDRadeonX3000GLDriver.bundle</li> <li>AMDShared.bundle</li> <li>AMDSupport.kext</li> <li>ATIRadeonX2000.kext</li> <li>ATIRadeonX2000GA.plugin</li> <li>ATIRadeonX2000GLDriver.bundle</li> <li>ATIRadeonX2000VADriver.bundle</li></ul></li> <li><p>Intel 5th Gen Binaries</p> <ul><li>AppleIntelFramebufferAzul.kext</li> <li>AppleIntelFramebufferCapri.kext</li> <li>AppleIntelHDGraphics.kext</li> <li>AppleIntelHDGraphicsFB.kext</li> <li>AppleIntelHDGraphicsGA.plugin</li> <li>AppleIntelHDGraphicsGLDriver.bundle</li> <li>AppleIntelHDGraphicsVADriver.bundle</li></ul></li> <li><p>Intel 6th Gen Binaries</p> <ul><li>AppleIntelHD3000Graphics.kext</li> <li>AppleIntelHD3000GraphicsGA.plugin</li> <li>AppleIntelHD3000GraphicsGLDriver.bundle</li> <li>AppleIntelHD3000GraphicsVADriver.bundle</li> <li>AppleIntelSNBGraphicsFB.kext
<ul><li>Board ID Patch
<ul><li>Replace original Board ID with updated model</li></ul></li></ul></li> <li>AppleIntelSNBVA.bundle</li></ul></li></ul> <h3 id="frameworks"><a href="#frameworks" class="header-anchor">#</a> Frameworks</h3> <ul><li>CoreDisplay.framework
<ul><li>Logic: Copied from Mojave, heavy modifications/shims</li></ul></li> <li>IOSurface.framework</li> <li>OpenGL.framework
<ul><li>Logic: Copied from Mojave</li></ul></li></ul> <h3 id="privateframeworks"><a href="#privateframeworks" class="header-anchor">#</a> PrivateFrameworks</h3> <ul><li>GPUSupport.framework
<ul><li>Logic: Copied from Mojave</li></ul></li> <li>SkyLight.framework
<ul><li>Logic: Copied from Mojave, heavy modifications/shims</li></ul></li></ul> <h3 id="launchdaemons"><a href="#launchdaemons" class="header-anchor">#</a> LaunchDaemons</h3> <ul><li>HiddHack.plist
<ul><li>Reason: Fixes unresponsive input when patching Skylight</li> <li>Logic: Forces <code>hidd</code> to register events, as Skylight handles them by default in Big Sur</li></ul></li></ul></details></div> <footer class="page-edit"><div class="edit-link"><a href="https://github.com/dortania/OpenCore-Legacy-Patcher/edit/main/docs/PATCHEXPLAIN.md" target="_blank" rel="noopener noreferrer">Help us improve this page!</a> <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></div> <div class="last-updated"><span class="prefix">Last Updated:</span> <span class="time">10/7/2021, 12:08:11 AM</span></div></footer> <div class="page-nav"><p class="inner"><span class="prev">
      ⟵
      <a href="/OpenCore-Legacy-Patcher/HOW.html" class="prev">
        Boot Process with OpenCore Legacy Patcher
      </a></span> <!----></p></div> </main></div><div class="global-ui"><div style="visibility:hidden;display:none;"></div><!----></div></div>
    <script src="/OpenCore-Legacy-Patcher/assets/js/app.cad9deb6.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/2.d13a5aaf.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/24.398f3072.js" defer></script><script src="/OpenCore-Legacy-Patcher/assets/js/16.bd966d9c.js" defer></script>
  </body>
</html>