Binary kernel patches to enable almost native AMD CPU support on OS X.
Support Chart
| Release Name | Status | Notes |
|---|---|---|
| Sierra | Complete | Boots in a VM, untested on baremetal. |
| El Capitan | Complete | Boots in a VM, untested on baremetal. |
| Yosemite | Work-In-Progress | Research Phase: Does not reach Kernel-Space. |
| Mavericks | Incomplete | None |
| Mountain Lion | Incomplete | None |
| Lion | Incomplete | None |
| Snow Leopard | Work-In-Progress | Research Phase: Does not reach Kernel-Space. |
| Leopard | Work-In-Progress | Research Phase: Currently Kernel Panics. |
| Tiger | Work-In-Progress | Research Phase: Currently Kernel Panics. |
Ensure FixupAppleEfiImages quirk is enabled to ensure W^R errors on older OS X doesn't have issues.
Ensure the Kernel Quirk ProvideCurrentCpuInfo is enabled. OpenCore 0.7.1 or newer is required. You should NOT be using an outdated copy of OpenCore, this requirement has long been deprecated. Make sure to enable this quirk or the system won't boot. You're only warned once.
We do not have any people on Zen 4 available for testing at this moment, no official support is provided at this time. Zen 3 FTW (not really, give us time).
Depending on the specific property list you use for your target OS X installation, you can get any of the following 12 patches that are backported from High Sierra:
| Base | Patch Name | Comment |
|---|---|---|
| _cpuid_set_info | cpuid_cores_per_package set to const | (user-specified) |
| _cpuid_set_info | GenuineIntel to AuthenticAMD | None |
| _commpage_populate | Remove rdmsr | None |
| _cpuid_set_cache_info | CPUID 0x8000001d instead of 4 | None |
| _cpuid_set_generic_info | Remove wrmsr(0x8B) | None |
| _cpuid_set_generic_info | Replace rdmsr(0x8B) with constant 186 | None |
| _cpuid_set_generic_info | Set flag=1 | None |
| _cpuid_set_generic_info | Disable check to allow leaf7 | None |
| _cpuid_set_cpufamily | Force CPUFAMILY_INTEL_PENRYN | None |
| _mtrr_update_action | Fix PAT on AMD CPUs | None |
| _i386_init | Remove 3 rdmsr calls | None |
| None | Remove version check and panic | None |
The Core Count per Package patch needs to be modified to boot your system. The first kernel patch is the required to be updated no matter what property list you choose. Update the Replace value only.
| OS X Version | Default Value | Example Value |
|---|---|---|
| 10.12 | BA 00 00 00 00 00 | BA 04 00 00 00 00 |
| 10.11 | BA 00 00 00 00 89 | BA 04 00 00 00 89 |
| 10.10 | TBD | TBD |
| 10.9 | TBD | TBD |
| 10.8 | TBD | TBD |
| 10.7 | TBD | TBD |
| 10.6 | B8 00 00 00 00 89 | B8 04 00 00 00 89 |
| 10.5 | TBD | TBD |
| 10.4 | B8 00 00 00 | B8 04 00 00 |
From the table above, replace <BX XX> with the hexadecimal value matching your physical core count. Do not use your CPU's thread count. 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 |
- Leverages OpenCore to run OS X on AMD CPUs without a custom built kernel.
- No 32-bit support (OPEMU)
As of right now, these are all theoretically supported AMD CPUs. Bare metal testing is greatly appreciated, and opening an Issue on the repo with DEBUG logs is equally appreciated.
| Family | Codename | Product Name |
|---|---|---|
| 17h and 19h | Zen | Ryzen, Threadripper, Athlon 2xxGE |
| 16h | Jaguar | A Series (including AM4 A-Series) |
| 15h | Bulldozer | FX Series |
If any credits are missing, they are to be added in future commits.
-
RoyalGraphX for the idea to add support for older OS X releases, updating PAT for Sierra, updating _cpuid_set_cache_info, _cpuid_set_cpufamily, researching cpuid_cores_per_package on older OS X.
-
Zormeister for the idea to add support for older OS X releases, initial patch matching confirmations for High Sierra -> Sierra backporting effort, cpuid_cores_per_package effort
-
Dhinak G, helping reverse-engineer functions for new Find/Replace values in Tiger, for CPUID 4 and Cores Per Package patches
-
Shaneee, helping tackle Snow Leopard Kernel Patches, and assisting in building XNU releases for binary diffing, updating Force PENRYN patches with Masks for wider support
-
AlGrey for the idea and creating the patches.
-
XLNC for maintaining patches for various macOS versions.
-
Acidanthera for OpenCore.
-
CaseySJ for Zen 4 IOPCIFamily patches.
-
Sinetek, Andy Vandijck, spakk, Bronya, Tora Chi Yo, Shaneee and many others for sharing their AMD/XNU kernel knowledge.