/BASE-EFI-INTEL-HEDT-5THGEN-X99-BROADWELL-E

Basic EFI with Opencore for Intel X99 (5st Gen)

Primary LanguageC++

BASE EFI Intel Broadwell-E (HEDT)

Note Description
Initial macOS Support OS X 10.11, El Capitan.
  • Opencore version: 0.8.0
  • Release date: 04/04/2022, late - 18/04/2022

Basic Steps

  1. Download the latest release;
  2. Includes additional kexts (for ethernet, audio, etc);
  3. Include the necessary ACPI patches (.aml);
  4. Review the special notes;
  5. Generate and complete your SMBIOS infos - ALWAYS;
  6. Adjust your BIOS;
  7. Install macOS and enjoy :)

Features

  • Very light, very clean, basic files for your Hackintosh.
  • Made with latest OpenCore versions.
  • Two editions - Release and Debug Edition.
  • Updated montly with refresh versions of Opencore.

Kexts included (Required)

Kext Description
Lilu.kext Patch many processes, required for AppleALC, WhateverGreen, VirtualSMC and many other kexts.
SMCProcessor.kext Used for monitoring CPU temperature, doesn't work on AMD CPU based systems.
SMCSuperIO.kext Used for monitoring fan speed, doesn't work on AMD CPU based systems.
VirtualSMC.kext Emulates the SMC chip found on real macs, without this macOS will not boot.
Alternative is FakeSMC which can have better or worse support, most commonly used on legacy hardware.
WhateverGreen.kext Used for graphics patching, DRM fixes, board ID checks, framebuffer fixes, etc; all GPUs benefit from this kext.
CpuTscSync.kext Needed for syncing TSC on some of Intel's HEDT and server motherboards, without this macOS may be extremely slow or even unbootable.

Other Kexts (not included)

Kexts for support Audio, Wifi, Ethernets and other devices.

Audio

Kext Description
AppleALC.kext Used for AppleHDA patching, allowing support for the majority of on-board sound controllers.
AMD 15h/16h may have issues with this and Ryzen/Threadripper systems rarely have mic support.
VoodooHDA.kext Audio for FX systems and front panel Mic+Audio support for Ryzen system, do not mix with AppleALC.
Audio quality is noticeably worse than AppleALC on Zen CPUs.

Ethernet

Kext Description
IntelMausi.kext Intel's 82578, 82579, I217, I218 and I219 NICs are officially supported.
AtherosE2200Ethernet.kext Required for Atheros and Killer NICs.
Note: Atheros Killer E2500 models are actually Realtek based, for these systems please use RealtekRTL8111 instead.
RealtekRTL8111.kext For Realtek's Gigabit Ethernet.
Sometimes the latest version of the kext might not work properly with your Ethernet. If you see this issue, try older versions.
LucyRTL8125Ethernet.kext For Realtek's 2.5Gb Ethernet.
SmallTreeIntel82576.kext Required for I211 NICs, based off of the SmallTree kext but patched to support I211.
Required for most AMD boards running Intel NICs.

WiFi and Bluetooth

Kext Description
AirportItlwm Adds support for a large variety of Intel wireless cards and works natively in recovery thanks to IO80211Family integration.
IntelBluetoothFirmware Adds Bluetooth support to macOS when paired with an Intel wireless card.
AirportBrcmFixup Used for patching non-Apple/non-Fenvi Broadcom cards, will not work on Intel, Killer, Realtek, etc.
For Big Sur see Big Sur Known Issues for extra steps regarding AirPortBrcm4360 drivers.
BrcmPatchRAM Used for uploading firmware on Broadcom Bluetooth chipset, required for all non-Apple/non-Fenvi Airport cards.

USB

Kext Description
USBInjectAll Used for injecting Intel USB controllers on systems without defined USB ports in ACPI.
All Intel chipset series.
Requires OS X 10.11 or newer.
XHCI-unsupported Needed for non-native USB controllers.
Common chipsets needing this: H370, B360, H310, Z390(Not needed on Mojave and newer), X79, X99, AsRock boards(On Intel motherboards specifically, B460/Z490+ boards do not need it however).

Others

Kext Description
NVMeFix Used for fixing power management and initialization on non-Apple NVMe.
SATA-Unsupported Adds support for a large variety of SATA controllers, mainly relevant for laptops which have issues seeing the SATA drive in macOS.
We recommend testing without this first.
AppleMCEReporterDisabler Useful starting with Catalina to disable the AppleMCEReporter kext which will cause kernel panics on AMD CPUs.
Recommended for dual-socket systems (ie. Intel Xeons).
RestrictEvents Better experience with unsupported processors like AMD, Disable MacPro7,1 memory warnings and provide upgrade to macOS Monterey via Software Updates when available.

ACPI Tables - High End Desktop

These files are MUST be included in your EFI's ACPI directory. We recommend that you use the MANUAL method, but for a first test you can use the prebuild versions.

Table Description
SSDT-PLUG Manual | Prebuilt | Details
SSDT-EC-DESKTOP Manual | Prebuilt | Details
SSDT-RTC0-RANGE Manual | Prebuilt | Details
SSDT-UNC Manual | Prebuilt | Details

Dumping your DSDT in Windows Environment

Download iASL Compiler ACPI Tools

Open the CMD in the directory where the ACPI Tools was extracted. (Command Prompt) in Administrator Mode:

path/to/acpidump.exe -b -n DSDT -z
move dsdt.dat DSDT.aml

Decompile DSDT.aml:

path/to/iasl.exe path/to/DSDT.aml

File DSDT.dsl will generated. Use this for generate YOUR ACPI Patches.

Compile DSDT.dsl:

path/to/iasl.exe path/to/DSDT.dsl

File APCPI_FILE_PATCHED.aml will generated.

Attention

Update config.plist in PlatformInfo > Generic with YOUR informations.

1. MLB (Board Serial)
2. ROM (Mac Address)
3. SystemSerialNumber (Serial)
4. SystemUUID (SmUUID)

Please use genSMBIOS for generate values for above itens.
Please use ProperTree for configure/edit your config.plist.

Compatible SMBIOS

SMBIOS Description
iMacPro1,1 Works for Broadwell-E Processors
MacPro7,1 Works for Broadwell-E Processors

Catalina and older versions of macOS

  • Please configure MinDate and MinVersion in UEFI > APFS to -1;
  • Please configure SecureBootModel in Misc > Security to j137;

* Without above settings, macOS will not be able to boot.

Special notes

  • USB port mapping is REQUIRED.
  • XhciPortLimit - Needed **DISABLE**if you use Big Sur 11.3+.
    • Please Mapping USB in macOS Catalina before install Big Sur or Newer for best results.
    • You can use USBMap.command Utility - USBMap.
  • AppleCpuPmCfgLock - Please **ENABLE** if you cannot disableCFG-Lock in BIOS AND running 10.10 or older macOS.
  • AppleXcpmCfgLock - Please **ENABLE** if you cannot disableCFG-Lock in BIOS.

GPU-Specific boot-args

Parameter Description
agdpmod=pikera Used for disabling board ID checks on Navi GPUs(RX 5000 series & RX 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).
nvda_drv_vrl=1 Used for enabling Nvidia's Web Drivers on Maxwell and Pascal cards in Sierra and High Sierra.

General Purpose boot-args

Parameter Description
npci=0x2000 This disables some PCI debugging related to kIOPCIConfiguratorPFM64, alternative is npci=0x3000 which disables debugging related to gIOPCITunnelledKey in addition.
Required for when getting stuck on PCI Start Configuration as there are IRQ conflicts relating to your PCI lanes. Not needed if Above4GDecoding is enabled.
npci=0x3000 Alternative for npci=0x2000.

BIOS Settings

Disable

  • Fast Boot
  • Secure Boot
  • Serial/COM Port
  • Parallel Port
  • VT-d (can be enabled if you set DisableIoMapper to YES)
  • Compatibility Support Module (CSM).
  • Thunderbolt(For initial install, as Thunderbolt can cause issues if not setup correctly)
  • Intel SGX
  • Intel Platform Trust
  • CFG Lock (MSR 0xE2 write protection)
    • This must be off, if you can't find the option then ENABLE AppleXcpmCfgLock.
    • Your hack will not boot with CFG-Lock enabled.
    • For 10.10 and older, you'll need to ENABLE AppleCpuPmCfgLock as well.

Enable

  • VT-x
  • Above 4G decoding.
    • This must be on, if you can't find the option then add npci=0x2000 to boot-args.
    • Do not have both this option and npci on boot-args enabled at the same time.
  • Hyper-Threading
  • Execute Disable Bit
  • EHCI/XHCI Hand-off
  • OS type: Windows 8.1/10 UEFI Mode
  • SATA Mode: AHCI

References

https://dortania.github.io/OpenCore-Install-Guide/config-HEDT/broadwell-e.html
https://dortania.github.io/Getting-Started-With-ACPI/

Discord - Universo Hackintosh