Using Alder Lake (or Raptor Lake)
Some prior hackintosh experience is recommended
Last updated
Was this helpful?
Some prior hackintosh experience is recommended
Last updated
Was this helpful?
Most of the topics discussed here should also work for Raptor Lake (13th and 14th Gen Intel) CPUs, as the archtecture is very similar. So far, I merely added a few relevant links. Since this was written, much new experience has been gained using Alder Lake and Raptor Lake CPUs. This is therefore just a starting point which needs to be accompanied by further research.
What can we learn from existing successful OpenCore Alder Lake desktop builds? In 2022, I looked at almost every documented system on the major English and German hackintosh sites. In this article I will share the key points that I noticed when looking at these builds, documentation and configurations. This is just a very preliminary guide, since Dortania does not have an OpenCore Alder Lake Guide yet.
Mostly Z690 and a few B660M and H610, but no Hackintosh seen yet with H670. Gigabyte and Asus have been used in the great majority of observed systems. macOS on Alder Lake laptops is not possible, due to the unsupported iGPU.
Gigabyte Z690i Aorus Ultra DDR4 - Mini-ITX
Gigabyte Z690 UD DDR4 - ATX
Gigabyte Z690 Aorus Elite DDR5 - ATX
Gigabyte Z690 Aorus Elite AX DDR4 - ATX
Gigabyte Z690 Aorus Pro DDR5 - ATX
Gigabyte Z690 AERO G DDR4 (plus Thunderbolt card) - ATX
Gigabyte Z690 Gaming X DDR4 - ATX
ASUS Z690 ProArt Creator WiFi (Thunderbolt 4) DDR5 - ATX
ASUS ROG STRIX Z690-A GAMING WIFI D4 DDR4 - ATX
ASUS ROG STRIX Z690-F GAMING WIFI DDR5 - ATX
ASUS PRIME Z690M-PLUS D4 DDR4 - microATX
ASUS PRIME Z690-P D4 LGA DDR4 - ATX
ASUS TUF GAMING Z690-PLUS D4 DDR4 - ATX
ASUS PRIME B660M-K D4 DDR4 - microATX
ASRock Z690 Pro RS DDR4 - ATX
ASRock Z690 Steel Legend WiFi 6E DDr4 - ATX
ASRock B660M-HDV DDR4 - microATX
MSI PRO Z690-A DDR5 - ATX
MSI PRO H610M-B DDR4 - microATX
i3-12100
i5-12400, i5-12400F, i5-12600K, i5 12600KF
i7-12700K, i7-12700KF
i9-12900K
All currently available Alder Lake Core-i-x-12xxx CPUs should work.
PowerColor Radeon RX 6600
Sapphire VGA Nitro+ RX 6600 XT
ASRock AMD Radeon RX 6600XT
MSI RX 6800 XT Gaming X Trio
Sapphire RX 6900 XT Special Edition
Yeston Radeon RX560 4GB GDDR5
AMD Radeon RX 570
Sapphire Pulse RX 580
Discrete GPUs are supported without any limitations including DRM and digital audio. (Vit, 22-01-09)
In the context of Alder Lake, I have seen primarily recommended: Polaris AMD RX 400 series & RX 500 series, as well as Navi RX 5000 series, RX 6800, RX 6800 XT, RX 6900 XT. AMD RX 6600 and 6600 XT are only supported in Monterey 12.1 and newer. (But the RX 6700 is currently not supported at all.)
WD Black SN850 PCIe 4.0 NVMe SSD 1TB
WD Black SN750 SE NVMe SSD 1TB
WD Black SN750 NVMe SSD 500GB
WD Blue SN550 NVMe SSD 1TB
PNY CS1031 256GB
Fenvi FV-T919 WiFi / Bluetooth Wireless Card
Fenvi M.2 NGFF BCM94360NG Wifi / Bluetooth 4.0 Network Card
Monterey (mostly)
Big Sur
macOS Catalina 10.15.4 and above should work based on Comet Lake support in macOS.
Thermal management works. While Intel Power Gadget is rather buggy and not recommended in production, it mostly works, so do SuperIO and SMCProcessor. (Vit, 22-01-09)
Sidecar requires either an iGPU or an Apple T2 chip for HEVC encoding/decoding so it does not work on this system (iGPU UHD 770 is not supported by macOS). Alternatives to Sidecar: Luna Display and Duet Display.
macOS treats all cores the same and does not schedule tasks optimally between P-cores and E-cores
Intel's Bluetooth 5.2 is not yet supported.
Various USB issues. These may not be specific to Alder Lake, but were reported on some motherboards.
All the BIOS configurations are essentially the same as used for Comet Lake, except for the CPU configuration.
CFG Lock may not be configurable in preferences on ASUS boards. This is an obvious BIOS bug, although it may not cause boot failures. We had to unlock it manually through the Shell method described in OpenCore Reference Manual. (Vit, 22-01-09)
XMP works at least with DDR5 we had at hand, but there were reports of no issues with DDR4 as well. While macOS does not name DDR5 as DDR5 in the profiler, this nuance is purely cosmetic. (Vit, 22-01-09)
Experiment with either of these configurations to see which works best for your workflow:
Option 2:: Only P-cores and Hyper-Threading enabled. The Ring Clock frequency will be 4.7 GHz. Overall multi-threading performance will be less.
Therefore in BIOS > Advanced CPU Settings configure accordingly:
Option 1: All cores, all threads
Hyper Threading → Enabled
All P-Cores and E-Cores → Enabled
Option 2: Only P-cores and Hyper-Threads
Hyper Threading → Enabled
CPU Cores Enabling Mode → Selectable Mode
CPU Cores Enabling Mode → (Enable all P-Cores and Disable all E-Cores)
Most firmware dropped Processor-based CPU definition in ACPI and switched to Device-based definition, which is not recognised by macOS. To workaround this one needs to use the SSDT-PLUG-ALT
ACPI table. (Vit, 22-01-09)
Very similar to Comet Lake, except for the additional SSDT-PLUG-ALT.aml
SSDT-PLUG-ALT.aml
(required)
SSDT-AWAC.aml
(required)
SSDT-EC-USBX.aml
(required)
SSDT-SBUS.aml
(optional)
SSDT-USBW.aml
(optional) Works with USBWakeFixup.kext to enable proper wake from sleep.
SSDT-DMAC.aml
(occasionally used) As on a real MacPro 7,1 : "the DMAC Direct Memory Access Controller provides an interface between the bus and the input-output devices , share the bus with the processor to make the data transfer, speedups the memory operations by bypassing the involvement of the CPU ".
SSDT-DTPG.aml
(occasionally used) - Implements DTGP method that is needed by other SSDTs. Related to Thunderbolt.
I see many configurations with various ACPI patches. Some Alder Lake systems use none of these patches. - Apply as needed:
Enable Change MC__ to MCHC and possibly Change ADBG to XDBG as shown above, if you encounter relevant ACPI Errors:
Change MC__ to MCHC is also used on ASUS Z690 boards.
ResizeAppleGpuBars -1
(or 0, if Re-Sizable BAR Support is enabled in BIOS)
We did not have PCIe 5.0 hardware to ensure optimal performance, but there were no issues with PCIe 4.0 and 3.0 including Resize Bar support handled by the ResizeAppleGpuBars
quirk. (Vit, 22-01-09)
The kexts used are essentially the same as the ones used for Comet Lake:
Lilu.kext
(required)
WhateverGreen.kext
(required)
VirtualSMC.kext
(required)
SMCProcessor.kext
(optional - monitoring CPU temperature)
SMCSuperIO.kext
(optional - monitoring fan speed)
AppleALC.kext
(usually required - enable audio)
NVMeFix.kext
(optional - for fixing power management and initialization on non-Apple NVMe)
Other common kexts used on Alder Lake:
An Ethernet kext. Commonly found on Z690:
This is required for Alder Lake. The configurations universally use these settings:
Emulate a Comet Lake CPU (0x0A0655)
As Alder Lake CPUs are not supported by macOS, the CPU ID has to be faked in the Config.plist
ProvideCurrentCpuInfo Yes
More patches are required for XNU when using the efficiency cores, though handled automatically by the ProvideCurrentCpuInfo
quirk starting with OpenCore 0.7.7. (Vit, 22-01-09)
-wegnoigpu
to disable internal GPU, which is not supported.
A typical boot-args may look like this: -v keepsyms=1 debug=0x100 agdpmod=pikera -wegnoigpu alcid=1
agdpmod=pikera
is used for disabling board ID checks on Navi GPUs (RX 5000 & 6000 series), without this you'll get a black screen. Don't use if you don't have Navi (ie. Polaris and Vega cards shouldn't use this).
4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102
Optionally add your CPU name, for example:
Use one of
MacPro7,1
iMacPro1,1
I have seen iMac20,1
used by some on Alder Lake, but this is the wrong choice, because the iGPU needs to be disabled, since Apple has not created any drivers for 12th Gen iGPUs. You must pay very close attention when selecting a SMBIOS, as macOS assumes the iGPU is present on every iMac
SMBIOS. Features like Quick Look and such will be broken if macOS based on the the SMBIOS expects an iGPU.
MacPro7,1
and iMacPro1,1
are the only two SMBIOS that will allow for dGPU to handle all the workload including background rendering and other tasks that the iGPU would handle.
Note that this requires a Polaris, Vega or Navi GPU to work properly.
ProvideConsoleGop Yes
ASUS boards have a new aggregate GOP instance, which causes black screen during macOS first stage. This is addressed in the ProvideConsoleGop
quirk starting with OpenCore 0.7.6. (Vit, 22-01-09)
This is enabled in OC > Sample.plist and should remain enabled, not just for ASUS boards.
Some of the configurations use Thunderbolt. Therefore these changes are only needed if the motherboard has Thunderbolt or an add-in card is used: AppleVTD allows certain Thunderbolt devices to connect and operate, such as Antelope Audio interfaces and Apple's own Thunderbolt-to-Gigabit Ethernet adapter. - Enabling AppleVTD requires the following:
Kernel --> Quirks --> DisableIoMapper --> No (affects macOS only)
ACPI --> Add --> SSDT-DMAR.aml --> Yes (affects all operating systems)
ACPI --> Delete --> DMAR --> Yes (affects all operating systems)
BIOS Setup --> VT-d --> Enabled
I researched more in-depth about the specifics which might differ from a Comet Lake configuration by looking at many documented successful projects reported on r/hackintosh, TM, Github, hackintosh-forum-de and InsanelyMac.
The Golden Builds are well documented and would help those who buy the same motherboard and CPU. - Yet, I am not satisfied just copying a configuration, since I might buy different hardware and I should be able to understand every part of the Config to maintain it longterm. Also you should use the tools recommended on r/hackintosh.
Alder Lake Z690 Builds:
Raptor Lake Z790 Builds:
Search on Dortania for recent updates:
To see the various successes on r/hackintosh
enter the following in the search box:
On TM search for: (login required to search)
On Github:
Additionally search for Alder Lake or Raptor Lake general info on each of the above hackintosh sites.
Essentially follow the and incorporate the insights listed below. As always, do not just copy an EFI which you might find in other people's documentation. It may not work, is hard to maintain and is against the rules of . Create your own EFI based on the guide.
The only two recommended SMBIOS on Alder Lake - MacPro7,1
and iMacPro1,1
- require a Polaris, Vega or Navi GPU to work properly. Also refer to the Dortania recommendations in and .
Some Samsung NVMe drives may still have problems: .
The recommendations from the continue to apply.
Option 1: All P-cores, all E-cores, and Hyper-Threading enabled. The Ring Clock frequency will be 3.6 GHz with a , due to lesser L3 and memory performance of the P-cores. Overall multi-threading performance will be better.
Both options may be optimised by . The Ring Clock and CPU clock are separate.
Use the latest version of , which is currently at version 1.0.0.
A starter Config.plist for Alder Lake can be found here: (link has changed).
Required to add SSDT-PLUG-ALT.aml
.
SSDT-HPET.aml
(occasionally used) - Patches out IRQ conflicts. Check: (SSDTTime > HPET).
See: .
Change ADBG to XDBG is related to an on Gigabyte Z690 boards.
HPET _CRS to XCRS Rename, RTC IRQ 8 Patch, TIMR IRQ 0 Patch. Check: (SSDTTime > HPET).
Fix RTC _STA bug (seems to be an old fix previously used in Clover which should not be necessary in OpenCore). Try instead: (SSDTTime > AWAC)
- Lilu Kernel extension for blocking unwanted processes causing compatibility issues on different hardware. - Is needed when enabling E-cores due to large core count and makes showing the proper CPU name possible.
- A Lilu plug-in for dynamic power management data injection. Used with CpuFriendDataProvider.kext
which can be created according to the instructions here: . It is important to add this as without is the GeekBench score will be far below the normal performance of the CPU.
Partial XCPM (XNU CPU Power Management) compatibility is available, but frequency vector tuning (through CPUFriend) will be . (Vit, 22-01-09)
related info here:
`` - A macOS driver for Realtek RTL8125 2.5GBit Ethernet Controllers.
is needed to fix keyboard wakeup support, but may cause with Bluetooth. Works with SSDT-USBW.
Kexts for USB mapping, depending on the use of or
See for more details.
CPU ID is set to 0x0A0655 that is found in Comet Lake CPUs such as .
7C436110-AB2A-4BBB-A880-FE41995C9F82 The boot-args
follow the same pattern as described in . The only required additional argument is this:
In case the iGPU is needed for other operating systems, there are other ways to hide the iGPU described here: .
this is working together with the
You'll likely need to fix power management as sleep may break: .
MacPro7,1
is used in the majority of Alder Lake systems and appears to be the recommended choice. Read this for details: .
Also see here:
Discussion about Alder Lake:
Discussion about Raptor Lake:
Golden Build 1:
Golden Build 2:
Golden Build 3:
User Build: nice guide including CPU ID explanation.
User Build:
User Build: Gigabyte Z690I AORUS ULTRA clean, minimal configuration.
User Build:
User Build:
very limited usefulness of these DSDT based configurations, except to see the hardware used.
Alder Lake:
Raptor Lake:
For Alder Lake Z690:
Another example with B660M: -
Also try H610.
For Raptor Lake Z790, use the following search:
Alder Lake or
Raptor Lake:
Alder Lake:
Raptor Lake:
Additional details have been discussed in this essential technical article: ). Vit, 2022-01-09
Raptor Lake CPU definitions have been added to Lilu 1.6.3
Work-in-Progress: Dortania OpenCore Install Guide - Alder Lake: (started February 10, 2022).
A kext for Alder Lake currently in development: an experimental Lilu plugin that optimizes Alder Lake's heterogeneous core configuration:
Discussion and relevant links in the comments:
Using together with OCAuxiliaryTools might provide a useful starting point. The file has not been updated though and the original author has hidden it behind a paywall.
Except where otherwise noted, content on this site is licensed under the license. Attribution by link to .