ASUS X299 Hackintosh

Introduction

The ASUS X299 Hackintosh repository contains OpenCore EFI distributions and related files that can be used as a reference when setting up your X299 Hackintosh with the OpenCore bootloader. While the EFIs can be used as a starting point for all ASUS X299 boards, it is still highly recommended to review the OpenCore Vanilla Desktop Guide and Skylake-X section for a proper guide.

Repository Folders

Folder	Description
BASE-EFI	OpenCore EFI precompiled with the OpenCanary GUI enabled that should be valid for all ASUS X299 boards.
Custom BIOS Collection	Contains modified BIOS files that have custom boot logos
Personal EFI Collection	Contains personal custom EFIs for various boards.

Personal Build

Personal EFI and USB mapping can be found here.

Specifications

Components

Component	Model	Notes
Motherboard	ASUS WS X299 Sage/10G	BIOS 3302
Processor	Intel i9-10980XE
CPU Cooler	Corsair H150i Pro RGB
RAM	4x16 Corsair Vengeance LPX 3200 Mhz
Boot Drive	Samsung 970 EVO 1 TB
Graphics Card	AMD Radeon Pro W5500
Wifi/Bluetooth Card	Broadcom BCM943602CDP
Power Supply	Corsair RM 850x
Case	Lian Li PC 011 Dynamic

PCIe Slot Layout

Slot	Speed	Device	Notes
1	x16
2	x8
3	x8
4	x8
5	x8	AMD Radeon Pro W5500
6	x8
7	x8

M.2/U.2 Layout

Slot	Device	Notes
U.2_1
M.2_1	Broadcom BCM943602CDP	Vertical slot connected via adapter
M.2_2	Samsung 970 EVO 1 TB	Lower slot

What Works / What Doesn't Work

• Sleep / Wake
  • Wake from Bluetooth does not work with Wifi/BT adapter in M.2 slot. If Wifi/BT Adapter is connected to a PCIe slot, sleep/wake works properly.
• Wifi and Bluetooth
• Handoff, Continuity, AirDrop, Continuity Camera, and Unlock with Apple Watch
• iMessage, FaceTime, App Store, iTunes Store
• 10G Ethernet
  • Modified EEPROM to work with SmallTree drivers. Refer to section Intel 10 Gigabit NICs with Small Tree macOS Drivers for more info.
• HEVC, H.264
• Onboard audio
• TRIM
• USB 2.0
• USB 3.2 Gen 1
• USB 3.2 Gen 2
• DRM
• Native NVRAM
• CPU Power Management
• USB Power
• SideCar
  • Due to some T2 chip dependancies on MacPro7,1 and iMacPro1,1 SMBIOS

Screenshots

System Report

USB Mapping

USBMap-WS X299 Sage 10G.zip contains a full USB Mapping kext for the XHCI controller and both ASMedia USB 3.2 Gen 2 Controllers.

Optional USB Peripherals for Internal USB 2.0 Devices

• 1. USB 3.0 20 Pin Female to USB 2.0 Pin Male Adapter
  • This adapter converts the internal USB 3.0 19 pin header to a USB 2.0 9 pin.
• 2. USB 2.0 9 Pin Header 1 to 4 Extension Hub Splitter to connect Bluetooth.
• 3. USB 2.0 IDC 5 Male to USB A Male adapter
  • Uses one of the USB ports on the back of the motherboard to connect internal devices in the case. You can get two of these and remove 1 of the pins to make a "9 pin internal adapter". If the cable is too short from the back to inside the case, you can get some regular USB A extension cables.
• 4. PCIe USB 3.0 Card with Internal USB Connector
  • Inateck USB 3.0 Card
  • StarTech USB 3.1 PCIe Card
  • Can use the internal header on the card for the case USB ports or to connect internal devices.
  • NOTE: Wake from Bluetooth devices does not work with this so it's best to connect Bluetooth to one of the motherboard ports.

Intel 10 Gigabit NICs with Small Tree macOS Drivers

Intel 10 gigabit NICs such as the X540 or X550 (found on the WS X299 Sage/10G) do not have official support in macOS. However with modding the EEPROM, we can modify the Subsystem ID to 000a to be compatible with the SmallTree macOS Drivers. Original method by Squuiid outlined in this MacRumors thread.

[The instructions below are outlined for the X550-AT2 found in the WS X299 Sage/10G]. Other Intel NICs may have different commands and/or offsets. [Proceed at your own risk!]

[Before EEPROM modding: No Driver Installed]

[After EEPROM modding and SmallTree drivers: Driver Installed]

Requirements

1. Ubuntu 16.04 LTS
   • Download the 64-bit PC (AMD64) desktop image
   • Newer versions of Ubuntu do not work.
2. USB Flash drive 8GB+
3. Windows install for installing Ubuntu to USB drive using Rufus
4. Ethernet Drivers (SmallTree is recommended but Sonnet also works)
   • SmallTree macOS drivers
     • Download the macOS Catalina drivers for macOS Big Sur
   • Sonnet macOS drivers

Instructions

1. Install the Ubuntu 16.04 LTS ISO image to a flash drive using Rufus.
2. Boot Ubuntu and click "Try Ubuntu without Installing".
   • Once Ubuntu is loaded, make sure that you have an Internet connection.
3. Open Terminal and enter in the following commands to install "net-tools" and "ethtool"
   • sudo apt-get install net-tools
   • sudo apt-get install ethtool
4. To locate the address of your ethernet devices, enter in command: ifconfig. In my case my X550 ports were enp180s0f0 and enp180s0f1.
5. To locate the current Vendor/Device-ID of your ethernet devices, enter in command lspci -nn -vvv | grep Ethernet.
6. Using command sudo ethtool -e enp180s0f0 | less , we can search for the offset of the Subsytem Vendor/Subsystem ID (X550 is offset 0x240 - 0x243).
7. For SmallTree driver support, we will modify the Subsytem-ID from 8712 to 000a.
   For the X550-AT2, the commands are:

   • sudo ethtool -E enp180s0f0 magic 0x15638086 offset 0x242 value 0x0a

   • sudo ethtool -E enp180s0f0 magic 0x15638086 offset 0x243 value 0x00

   • sudo ethtool -E enp180s0f1 magic 0x15638086 offset 0x242 value 0x0a

   • sudo ethtool -E enp180s0f1 magic 0x15638086 offset 0x243 value 0x00

8. For Sonnet driver support, we will modify the Subsystem-Vendor-ID from 1043 to 16b8 and the Subsystem ID from 8712 to 7212.
   For the X550-AT2, the commands are:

   • sudo ethtool -E enp26s0f0 magic 0x15638086 offset 0x240 value 0xb8

   • sudo ethtool -E enp26s0f0 magic 0x15638086 offset 0x241 value 0x16

   • sudo ethtool -E enp26s0f0 magic 0x15638086 offset 0x242 value 0x12

   • sudo ethtool -E enp26s0f0 magic 0x15638086 offset 0x243 value 0x72

   • sudo ethtool -E enp26s0f1 magic 0x15638086 offset 0x240 value 0xb8

   • sudo ethtool -E enp26s0f1 magic 0x15638086 offset 0x241 value 0x16

   • sudo ethtool -E enp26s0f1 magic 0x15638086 offset 0x242 value 0x12

   • sudo ethtool -E enp26s0f1 magic 0x15638086 offset 0x243 value 0x72

   • Note if you want to revert back to SmallTree or Intel drivers, we will modify the Subsystem-Vendor-ID back to 1043. For the X550-AT2, the commands are:

     • sudo ethtool -E enp180s0f0 magic 0x15638086 offset 0x240 value 0x43

     • sudo ethtool -E enp180s0f0 magic 0x15638086 offset 0x241 value 0x10

     • sudo ethtool -E enp180s0f1 magic 0x15638086 offset 0x240 value 0x43

     • sudo ethtool -E enp180s0f1 magic 0x15638086 offset 0x241 value 0x10

9. Reboot back into macOS and install the appropriate drivers and your ethernet ports should be enabled!

Additional Kexts

• SmallTreeIntel82576
  • Enables ethernet for I211 NICs
  • Version 1.3 is for macOS Catalina, Version 1.2.5 is for macOS 10.13 and 10.14
• AGPMInjector
  • Apple Graphics Power Management injector

Credits

• Apple : macOS
• Acidanthera : OpencorePkg, kexts, etc.
• Dortania : Opencore guide
• Pavo : AGPMInjector