OpenCore-Asus-X299

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

OpenCore-Asus-X299

★ 57 Open GitHub ↗

OpenCore Asus Strix X299 Hackintosh

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# OpenCore running on Asus X299-E Strix

![](https://raw.githubusercontent.com/khronokernel/OpenCore-Asus-X299/master/images/aboutthismac.png)
 
 What's this for? Not too many X299 hardware running macOS, let alone OpenCore so thought I'd post this ;p 
 Please use this as a base **and not a guide** .For a proper guide, please follow the [OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/)
 
 **Note**: This system was built with the BIOS Version 2002, and I've had reports that Version 3006+ has broken a few things:
 
 * ~~BIOS cannot properly unlock the MSR E2 register~~
   * v3105 resolves this issue
 * AWAC clock has been added
   * This will require [SSDT-RTC0-RANGE.dsl](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-RTC0-RANGE.dsl)
* SetupVirtualMap is broken
  * Can simply disable this quirk, it's not required for booting
 
## What work and what doesn't

### Works:
* macOS High Sierra, Mojave, Catalina and Big Sur
  * See below on note regarding Big Sur support
* Native NVRAM
* Bootcamp
* Sleep
* USB power(Including iPad Pro 12.9 Charging!)
* CPU Power Management
* iTunes, Netflix and all other DRM-based content
* Handoff, AirDrop, Apple Watch Unlock and all other Apple services
* [Display Brightness and Volume with Apple Keyboard](https://github.com/the0neyouseek/MonitorControl/releases)
* Boot Chime to internal speaker(hooked up a genuine PowerMac speaker!)
* OpenCore GUI
  * Above 2 will require the resources folder to be populated with files from here: [OcBinaryData](https://github.com/acidanthera/OcBinaryData)
* Serial Debugging
  * If you do a lot of kernel debugging like I do, this board will be great. Remember to enable serial in the BIOS and have a [Serial header to DB9](https://www.amazon.ca/gp/product/B001Y1F0HW/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1), and another machine to recieve the signal(if the other machine doesn't have serial, this [DB9 to USB  RS 232 adapter](https://www.amazon.ca/gp/product/B075YGKFC1/ref=ppx_yo_dt_b_asin_title_o00_s01?ie=UTF8&psc=1) will work fine). I recommend having [CoolTerm](https://freeware.the-meiers.org) for serial logging, I found it the simplest to use.
  * You'll also need the following added to boot-args for proper output:
  
```
debug=0x8 msgbuf=1048576 serial=5 
```

### Doesn't work:

* Onboard Wifi: Won't work, I removed it and use a genuine Apple Airport BCM94360CD Card with PCIe x1 adapter.
  * For supported card, see here: [Wireless Buyers guide](https://dortania.github.io/Wireless-Buyers-Guide/)
* Onboard Bluetooth: Works inconsistently, replaced with BCM94360CD so didn't look into it, see [this thread](https://github.com/daliansky/XiaoMi-Pro-Hackintosh/issues/262) for some ideas.
* SideCar: Since 10.15.4, I've not been able to get sidecar working, been actively looking for fixes though:  [Sidecar not working on iGPU-less systems reliably](https://github.com/AMD-OSX/bugtracker/issues/1)
 
### Big Sur note:

* To run macOS 11, Big Sur, you'll need the following:
  * Latest releases of all your kexts
  * Build of OpenCore 0.6.0 or newer
  * RTC patch
  
For the last one, this is due to Asus not mapping all the RTC regions for some reason. Specifically skipping regions 0x72 and 0x73. And in Big Sur, AppleRTC gets a lot saltier with this and won't boot. So we force in the extra regions with a simple 0x02 to 0x04 replace, see below patch:

Alternatively you can also use the sample SSDT-RTC0-RANGE, which may be better suited if you plan to dual boot with Linux and Windows often. I documented the process in OpenCorePkg: [SSDT-RTC0-RANGE.dsl](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-RTC0-RANGE.dsl)

## OpenCore Specifics

### Kexts

* [`Lilu`](https://github.com/vit9696/Lilu/releases)
* [`VirtualSMC`](https://github.com/acidanthera/VirtualSMC)
* [`AppleALC`](https://github.com/vit9696/AppleALC/releases)
* [`WhateverGreen`](https://github.com/acidanthera/WhateverGreen/releases)
  * Not needed on MacPro7,1
* [`IntelMausiEthernet`](https://github.com/Mieze/IntelMausiEthernet)
* [`CpuTscSync`](https://github.com/lvs1974/CpuTscSync)
  * Required to resolve TSC sync issues and aid with wake
* [`X299-Map`](/Kexts/X299-Map.kext.zip)
   * Maps USB ports, **please make your own as this is just an example**

### config.plist

#### ACPI

##### Add

* [SSDT-EC-USBX-X299](/ACPI-Compiled/SSDT-EC-USBX-X299.aml)
  * Creates a fake EC and fixes USB power. Note I do not power off the original EC, reason for this is due to a huge mess around sleep and `_GPE`. Turning off this EC makes waking a pain without hacky fixes
* [SSDT-PLUG-X299](/ACPI-Compiled/SSDT-PLUG-X299.aml)
  * Sets `Plugin-type=1` to `SB.SCK0.CP00` allowing for proper CPU power management
* [SSDT-SBUS-MCHC](/ACPI-Compiled/SSDT-SBUS-MCHC.aml)
   * Creates SMBus device allowing AppleSMBus to load
* [SSDT-RTC0-RANGE-v3006](/ACPI-Compiled/SSDT-RTC0-RANGE-v3006.aml)
  * BIOS v2002 and older should use [SSDT-RTC0-RANGE-v2002](/ACPI-Compiled/SSDT-RTC0-RANGE-v2002.aml)
* [SSDT-BRG0-X299](/ACPI-Compiled/SSDT-BRG0-X299.aml)
  * Enforces an ACPI path for the dGPU in the top slot, required for macOS Big Sur if you require DeviceProperty injection
  * Adjust accordingly if the dGPU is in another slot

#### Booter

##### Quirks

#### DeviceProperties

##### PciRoot(0x0)/Pci(0x1F,0x3)

To enable the on-board ALC S1220A

```
layout-id | Data | 01000000
```

##### PciRoot(0x2)/Pci(0x0,0x0)/Pci(0x0,0x0)/Pci(0x0,0x0)/Pci(0x0,0x0)

Used for fixing Navi GPUs when using WhateverGreen and iMacPro1,1, this arg is not required if you don't use WEG(ie. MacPro7,1)

* Note this assumes the Navi GPU is in the top slot, adjust accordingly to your board
* macOS 11, Big Sur, will also require SSDT-BRG0-X299 for this to work correctly

```
agdpmod | String | Pikera 
```

#### Kernel

##### Quirks

#### NVRAM

###### 7C436110-AB2A-4BBB-A880-FE41995C9F82

| arg | value |
| :--- | :--- |
| boot-args | -v debug=0x100 keepsyms=1 |

#### SMBIOS

* iMacPro1,1 or MacPro7,1 SMBIOS
  * Note that MacPro7,1 is Catalina+ only
  * iMacPro1,1 will need WhateverGreen.kext as well

# Hardware Specifics

Hardware:
* i9 7920X
* Noctua NH D15
* Asus Strix X299-E Gaming
* Multiple GPUs tested:
  * Pegatron GT 220 1GB
  * HP GT 710 2GB
  * MSI Armour RX 580 8GB
  * MSI AirBoost Vega 56 8GB
  * Gigabyte RX 5700XT 8GB
    * This guy will need either `agdpmod=pikera` on iMacPro1,1 or remove WhateverGreen entirely for MacPro7,1
* WD Black SN750 1TB NVMe
* 32GB 2666Mhz (4x8GB)
* Apple BCM94360CD(pulled from a genuine iMac14,2)

Main important BIOS settings:

* Asus Multicore: Auto
* CPU Core Ratio: All Core Sync
* MSR Lock: Disabled
   * If can't disable, turn on `AppleCpuPmCfgLock` and `AppleXcpmCfgLock`. Without this, you won't go far for install.
   * Newer BIOS updates do show this option, make sure you're on v3105 for best results
* Legacy USB: Disabled
* Above 4G encoding: Enabled
* CSM: Disabled
* OS Type: Windows UEFI

I've also provided a BIOS-settings.txt here, you can actually load it off a USB so you know you didn't miss any weird settings: [X299_Strix_OpenCore_setting.txt](/X299_Strix_OpenCore_setting.txt)

OpenCore-Asus-X299

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README