Giter Club home page Giter Club logo

amd_vanilla's Introduction

AMD Vanilla OpenCore

Patches for beta versions are provided, but no support is given until the OS is released.

Try these patches at your own risk, and always keep an EFI backup.

Languages: English (current)

Binary kernel patches to enable almost native AMD CPU support on macOS.

Read me first!

Patches are now universal across 15h, 16h, 17h, and 19h by utilizing the OpenCore kernel Quirk ProvideCurrentCpuInfo. OpenCore 0.7.1 or newer is required.

Make sure to enable this quirk or the system won't boot.

Note for Zen 4: Zen 4 (Ryzen 7000) requires patching for IOPCIFamily.kext.
This patch is enabled by default. Please ensure that you've added it to your current config for Zen 4 stability. This patch also allows MSI A520, B550, and X570 boards to boot macOS Monterey and newer.

Core Count patch needs to be modified to boot your system. Find the three algrey - Force cpuid_cores_per_package patches and alter the Replace value only.

Change B8000000 0000/BA000000 0000/BA000000 0090* to B8 <Core Count> 0000 0000/BA <Core Count> 0000 0000/BA <Core Count> 0000 0090*, substituting <Core Count> with the hexadecimal value matching your physical core count. Do not use your CPU's thread count.

Note: The three different values reflect the patch for different versions of macOS. Be sure to change all three if you boot macOS 10.13 to macOS 12

See the table below for the values matching your CPU core count.

Core Count Hexadecimal
4 Core 04
6 Core 06
8 Core 08
12 Core 0C
16 Core 10
24 Core 18
32 Core 20

So for example, a user with a 6-core processor should use these Replace values: B8 06 0000 0000/BA 06 0000 0000/BA 06 0000 0090


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 CPUs

Family Codename Example
15h Bulldozer FX Series
16h Jaguar A Series (including AM4 A-Series)
17h and 19h Zen Ryzen, Threadripper, Athlon 2xxGE

Information on the fix PAT 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 performance.

The other choice is Shaneee's patch which will increase GPU performance on AMD GPUs but can stop NVIDIA GPUs from booting. It might also causes audio issues when using HDMI or DisplayPort audio.

The choice is yours. Don't try to use them both at the same time.

Note on TRX40 systems

Both mtrr_update_action - fix PAT patches are not required on TRX40 systems. Disabling them will result in GPU performance improvements. Test this configuration on a USB drive first in preparation for the unlikely event that something goes wrong. Proceed at your own risk.

Supported macOS versions

  • macOS High Sierra (10.13)

  • macOS Mojave (10.14)

  • macOS Catalina (10.15)

  • macOS Big Sur (11)

  • macOS Monterey (12)

  • macOS Ventura (13)

Instructions

Follow the Dortania OpenCore Install Guide for instructions on how to create the installer USB and setup the config file with these patches.

Do not ask for support on GitHub.

Special notes

  • Use the latest release of OpenCore to avoid incompatibilities. Find the latest release here.

  • 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.

Credits

  • AlGrey for the idea and creating the patches.

  • XLNC for maintaining patches to various macOS versions.

  • Acidanthera for OpenCore.

  • CaseySJ for Zen 4 IOPCIFamily patch.

  • Sinetek, Andy Vandijck, spakk, Bronya, Tora Chi Yo, Shaneee and many others for sharing their AMD/XNU kernel knowledge

amd_vanilla's People

Contributors

aleckd avatar algreyy avatar aperture147 avatar caseysj avatar dhinakg avatar doesprintfwork avatar erikjara avatar extremext avatar fabiosun avatar freewing-jp avatar ioiiio avatar kumakichi avatar mikigal avatar pavo-im avatar pexcn avatar shaneee avatar sileshn avatar tarbaii avatar xlncs avatar zlingxi avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.