faraoman / amd_vanilla

Native AMD macOS via Clover & OpenCore

AMD Vanilla OpenCore

Languages: English (current), Ukrainian, Russian, Traditional Chinese, Spanish, Simplified Chinese, Vietnamese

Kernel binary patches to enable almost native AMD CPU support on macOS.

Features

• Enables macOS to run on AMD CPUs on the fly.
• Enables iMessage, Siri, FaceTime, Continuity etc.
• Stable compared to custom XNU kernel.

Disadvantages

• No 32-bit support (OPEMU) in 10.14 and lower

Supported AMD CPU's

Family	Codename	Example
15h	Bulldozer	FX Series
16h	Jaguar	A Series (including AM4 A-Series)
17h and 19h	Zen	Ryzen, 1st, 2nd + 3rd Gen Threadripper, Athlon 2xxGE

Information on the PAT fix patch

The default enabled patch is Algrey's original patch. This will work for all GPUs and doesn't affect audio but doesn't improve the performance. The other choice is Shaneee's patch which will increase GPU performance on AMD GPUs but can stop Nvidia GPUs booting. It also causes audio issues when using HDMI and DP audio. The choice is yours on which patch to use. Please don't try to use them both at the same time.

Note on TRX40 Systems

Disabling the mtrr_update_action - fix PAT patch has shown an improvement in GPU performance on some systems that have tested. If you wish to test this it is recommended to do so on a USB with OpenCore to ensure it works first. There may be issues with different motherboard/GPU combos that we aren't aware of. Proceed at your own risk.

Supported macOS versions

• High Sierra 10.13.x
• Mojave 10.14.x
• Catalina 10.15.x

Instructions

• Download macOS High Sierra, Mojave or Catalina from the App Store.
• Plug in an empty USB drive.
• Run one of the below commands in your Terminal to prepare the bootable macOS USB.

NOTE: Make sure to replace 'MyVolumeName' with your actual USB volume name in the below commands.

## High Sierra
sudo /Applications/Install\ macOS\ High\ Sierra.app/Contents/Resources/createinstallmedia --volume /Volumes/MyVolumeName

## Mojave
sudo /Applications/Install\ macOS\ Mojave.app/Contents/Resources/createinstallmedia --volume /Volumes/MyVolumeName

## Catalina
sudo /Applications/Install\ macOS\ Catalina.app/Contents/Resources/createinstallmedia --volume /Volumes/MyVolumeName

## Big Sur
sudo /Applications/Install\ macOS\ Big\ Sur.app/Contents/Resources/createinstallmedia --volume /Volumes/MyVolumeName

• Install OpenCore on your USB drive. (For OpenCore releases see: https://github.com/acidanthera/OpenCorePkg/releases)
• Read the OpenCore Documentaion for config.plist setup. A default config will not be provided.
• Merge the patches provided, according to your CPU family (i.e 15h_16h or 17h) into your OpenCore config.plist and edit it as per your needs.

Special Notes

• These patches require OpenCore 0.6.1 and above.
• For support creating OpenCore config read the docs and visit this guide or the Discord server.
• For 15h_16h CPU family users on macOS Mojave:
  • Upon booting to macOS Mojave for first time, the system will reboot after the Data & Privacy screen. To fix this issue follow the procedure mentioned here under UPDATE-2 heading.
  • On macOS Mojave certain webpages will crash upon loading (eg. brew.sh, facebook.com). To fix this issue follow the procedure mentioned here under the UPDATE-5 heading.
• To boot 10.15 two things needs to be taken care of:
  • If you have an EC device with ID PNP0C09 in your DSDT then macOS might get stuck while booting at the initial stage. To fix that you need to make sure your EC device is disabled by making it return status Zero. You can use a custom SSDT-EC0.aml to do that and if you want to see how it works you can refer to here.
    -or-
    You can change the ID of the EC device. Using this ACPI patch:

        Comment             Find        Replace
    PNP0C09 to PNPFFFF    41D00C09     41D0FFFF
    

  • When using the SMBIOSes MacPro6,1, MacPro7,1, or iMacPro1,1, AppleIntelMCEReporter.kext macOS might panic. To prevent this you need to either use a different SMBIOS or use a disabler kext from here.

Credits

• AlGrey for the idea and creating the patches.
• XLNC for maintaining patches to various macOS versions.
• Sinetek, Andy Vandijck, spakk, Bronya, Tora Chi Yo, Shaneee and many others for sharing their AMD/XNU kernel knowledge
• 0xD81CF, doesprintfwork and erikjara for readme translations.