GA-Z77X-D3H Hackintosh 🍎

🖥 Hardware Details

⚠️⚠️ Warning ⚠️⚠️

This is the EFI configuration for my very specific combination of hardware. It comes with absolutely no guarantees whatsoever.

It is extremely unlikely that this configuration will even work for you, even if your hardware combination is very similar. Please use it as a learning/reference resource only.

EFI, in git?

For my sanity, I have revisioned my /Volumes/EFI/EFI directory under git. This allows me to easily diff any changes I have made and easily roll back at any point in time.

However, typically the EFI partition is a tiny, around 200MB in size. This does not work well when there is a .git directory living inside, as every revision of binary files will be stored in here, easily filling up the space.

As a workaround, it is possible to place the .git directory across different mount-points by instead creating a file, .git and pointing it to the real .git location with the following directive:

gitdir: /Users/nickw/repos/opencore-efi/.git

Secret Management

With this repository being publicly shared on GitHub, there are going to be things I do not wish to share, such as SystemUUID, SystemSerialNumber, and MLB.

I have implemented a simple shell script, oc-private.sh to implement git clean and smudge filters to transparently remove and re-add secrets when staging and unstaging files.

The hooks can be installed by running

./resources/bin/oc-private.sh install

❓ Guides

• https://dortania.github.io/OpenCore-Desktop-Guide/
• https://usb-map.gitbook.io/project/
• https://github.com/corpnewt/USBMap

✅ Past Success for similar board

• https://www.reddit.com/r/hackintosh/comments/7cuccm/gaz77xd3h_high_sierra_success/
• https://www.reddit.com/r/hackintosh/comments/g3b9mn/gaz77xd3h_catalina_success/
• https://www.tonymacx86.com/threads/near-perfect-high-sierra-setup-on-z77x-ud5h-ivy-bridge-i5-rx-560.252663/

💤 Sleep/Wake

• Disable hibernate
  • sudo pmset -a autopoweroff 0
  • sudo pmset -a hibernatemode 0
• Wake causes: https://www.cnet.com/news/how-to-find-system-wake-causes-in-os-x/
• syslog | grep Wake
• log show –style syslog | fgrep “Wake reason”
• sudo pmset -g log
• Turns out random wakes during the night was due to power nap. Disabled power nap in system preferences and appears to have solved the issue
• Serial Port must be disabled in the BIOS Source, without this a KP when resuming from sleep will occur.
• Even with serial port disabled, after longer periods of sleep, a KP is experienced during wake. It appears the boot arg agdpmod=vit9696 has solved this (source)

jq -r 'map(.timestamp | match("\\d+\\-\\d+\\-\\d+\\s+\\d+:\\d+") | .string ) | .[]' | uniq

log show --start "2019-05-02 12:00:00" --end "2019-05-02 18:00:00"  --style json | jq -r 'map(.timestamp | match("\\d+\\-\\d+\\-\\d+\\s+\\d+:\\d+") | .string ) | .[]' | uniq

✔️ Post Setup Checks

Things to check post-setup/upgrade

• Check TRIM is enabled on all drives
• Ensure CPU power management is working correctly
• Check USB Mapping is correct in IOReg/IORegistryExplorer

🥾 Bootloader

OpenCore used as boot loader (Clover replacement). Bootloader config is revisioned via git: https://gitlab.com/nickw444/opencore-efi (this repo)

🖥 Hardware

BIOS Settings

Saved configurations can be found in resources/bios-config/

Diffable Settings:

• Defaults as base

BIOS Features

• Fast Boot: Disabled
• limit CPUID Max: Disabled
• Execute Disable Bit: Enabled
• Intel Virtualization Technology Enabled
• OS Type: Windows 8 WHQL
• CSM Support: Always
  • UEFI Only
  • LAN PXE Boot Option ROM: Disabled
  • Storage Boot Option Control: Disabled
• Other PCI Device ROM priority: UEFI OpROM
• Network Stack: Disabled
• Secure Boot: Enabled
• Secure Boot Mode: Standard

Peripherals

• Sata Controllers: Enabled
• Sata Mode Selection: AHCI
• XHCI Pre Boot Driver: Enabled
• xHCI Mode: AUTO
  • HS Port 1 Switchable: Enabled
  • HS Port 2 Switchable: Enabled
  • HS Port 3 Switchable: Enabled
  • HS Port 4 Switchable: Enabled
  • xHCI Streams: Enabled
• USB2.0 Controller: Enabled
• Audio Controller: Enabled
• Init Display First: Auto
• Internal Graphics: Enabled
• Internal Graphics Memory Size: 32M
• DVMT Total Memory Size: MAX
• Intel Rapid Start Technology: Disabled
• Legacy USB Support: Enabled
• XHCI Hand-off: Enabled
• EHCI Hand-off Disabled
• Port 60/64 Emulation: Disabled
• USB Storage Devices:
  • 1.00: Auto
  • Onboard USB3 Controller #1: Enabled
  • Onboard LAN Controller #1: Enabled
  • PCIE Slot Configuration: AUTO
• SuperIO Configuration
  • Serial Port A: Disabled
• Intel SMart Connect Technology:
  • ISCT Configuration: Disabled
• Marvel ATA Controller Configuration
  • GSATA Controller: AHCI Mode

Power Management

• Resume by Alarm: Disabled
• ERP: Disabled
• High Precision Event Timer: Enabled
• Soft off by PWR BUTTON: Instanced Off
• Internal Graphics Standby Mode: Enabled
• Internal Graphics Deep Standby Mode: Enabled
• AC Back: Always Off
• Power On By Keyboard: Disabled
• Power On By Mouse: Disabled

🔊 Audio

Works OOB with AppleALC using inject=5

⌨️ USB

USBInjectAll (UIA) was previously used to inject ports using custom SSDT. However it is now possible to inject ports using a simple injector kext instead of using UIA.

By using an injector kext, we eliminate the need to remap EHC1 and EHC2 to EH01 and EH02. (This is unnecessary when using iMac13,2 anyway as it natively injects EHC{1,2}). Injected ports for different SMBIOS’s can be found at /System/Library/Extensions/IOUSBHostFamily.kext/Contents/PlugIns/AppleUSBHostPlatformProperties.kext/Contents/Info.plist.

The injector kext can be found in OC/Kexts/USBMap.kext. This injector kext was created with USBMap, and then further modified by hand to reflect the vanilla ACPI layout of this board.

The injector kext being used has a few different entries:

• iMac13,2-EHC1: EHC1 root controller. Exposes a single, internal hub port
• iMac13,2-EHC2: EHC2 root controller. Exposes a single, internal hub port
• iMac13,2-InternalHub-EHC1: EHC1 controller’s root level hub
• iMac13,2-InternalHub-EHC2: EHC2 controller’s root level hub
• iMac13,2-XHC: XHC root controller

Quirks:

• The GA-Z77X-D3H is notorious for having power delivery issues on the internal front-panel header. After a fair bit of research this is found to be a common issue and is the reason for random USB3 disconnection during use. This issue is reproducable in both Windows and OSX
• The 7-series USB chipset has top level hubs on the EHC{1,2} busses. These need to be injected with a special AppleUSB20InternalIntelHub record, as opposed to the top level controllers registered with AppleUSBEHCIPCI.
• iMac13,2 SMBIOS already has an iMac13,2-InternalHub-EHC1 registered at location 487587840, causing the hub port properties to be merged. This results in extraneous, unusable PRT1 and PRT3 injected ports. I have not yet found a way to stop injection of these ports.
• XHCI/EHCI routing on this board is very weird. Regardless of selected BIOS settings for XHCI/EHCI, both rear panel USB3 ports are routed via the EHC controller when a USB2 device is connected. This is observed in both Windows and MacOS.
• Due to the above routing weirdness, and the requirement for the Bluetooth controller to sit on the XHC bus as an “internal port”, it’s necessary for one of the front panel USB3 ports to be re-purposed as an internal port.

Other Resources:

• (deleted) USB guide from dortania
• USBMap guide

Port Mapping

PCI/ACPI Map

├── EHC1 (Bus servicing internal USB2 headers)
│   └── PRT1 (Internal Hub, location 0x1d100000)
│       ├── PRT5 (Front Panel P3)
│       ├── PRT6 (Front Panel P4)
│       ├── PRT7 (Front Panel P5 - Card Reader)
│       └── PRT8 (Front Panel P6 - Card Reader USB)
├── EHC2 (Bus servicing back panel USB2)
│   └── PRT1 (Internal Hub, location 0x1a100000)
│       ├── PRT3 (Back Panel P4)
│       ├── PRT4 (Back Panel P3)
│       ├── PRT5 (Back Panel P2)
│       └── PRT6 (Back Panel P1)
└── XHC
    ├── HS01 (Front Panel P1 USB2 - Spliced internally, for BT Controller - see below)
    ├── HS02 (Front Panel P2 USB2)
    ├── SS01 (Front Panel P1 USB3)
    ├── SS02 (Front Panel P2 USB3)
    ├── SS03 (Back Panel P3 USB3)
    └── SS04 (Back Panel P4 USB3)

The above listed ports/locations are found by temporarily using USBInjectAll (with EHCX -> EH0X remap) to inject all ports to find their location IDs. These IDs can then be worked into the aformentioned injector kext.

🕸 Ethernet

Card is Atheros AR8151 v2.0. Compiled my own version of AtherosL1cEthernet.kext against High Sierra frameworks. Works in Mojave.

• https://github.com/al3xtjames/AtherosL1cEthernet
• https://www.tonymacx86.com/threads/i-need-kext-for-ethernet-with-mojave-with-ga-z77-ds3h.270126/
• https://www.tonymacx86.com/threads/atherosl1cethernet-tweaked-for-high-sierra.236867/

🖥 Intel GPU HD4000

Current ig-platform-id: 0x01620007. iGPU is being used as secondary with dGPU as primary.

Known IDs

Official Docs

• https://github.com/acidanthera/WhateverGreen/blob/master/Manual/FAQ.IntelHD.en.md

Other Docs

• https://gist.github.com/al3xtjames/c46e368c3227cdc58e900f7117f34571
• http://blog.stuffedcow.net/2012/07/intel-hd4000-qeci-acceleration/
• https://www.reddit.com/r/hackintosh/comments/7m8uah/enabling_igpu_gpu/
• https://www.tonymacx86.com/threads/dual-graphics-headless-igpu-amd-hardware-acceleration-on-mojave.267554/

🔌 CPU Power Management

• ssdtprGen.sh https://github.com/Piker-Alpha/ssdtPRGen.sh
• Confirm with https://github.com/Piker-Alpha/AppleIntelInfo
• https://www.insanelymac.com/forum/topic/304369-how-to-check-your-states-%E2%80%93-using-aicpminfo-msrdumper-or-appleintelinfo/

📶 Bluetooth / WiFi w/ Broadcom Card

BCM943602CS: 802.11ac 3×3, (1.3Gbps / 5GHz) + Bluetooth 4.1. The module will be applied in MacBook Pro computers (2015)

• BCM43602 14e4:43ba supported in 3.17+ (brcmfmac)
• BCM43602 14e4:43bb 2.4GHz device, supported in 3.19+
• BCM43602 14e4:43bc 5GHz device, supported in 3.19+

Bluetooth USB connection must be connected to XHC bus and marked as internal (DSDT type 255), otherwise this will cause random wake as soon as machine goes to sleep. Recall all USB ports on the back panel are routed via EH02 via a hub, so we cannot use that, and instead must splice the internal USB (source)

What worked for me in the same fenvi is making sure that the connector type for the internal usb header is set to internal port. I used fbpatcher to do it. 1

Previously used a USB3 20 pin splitter to splice, but this caused issue with USB detection from the FP ports. Instead a splice was made directly in the cable from the case. May need to “unsplice” if a replacement mobo has better internal USB support.

Bluetooth Firmware Issues

This didn’t seem necessary for getting BT support for Catalina, however I recall that once the firmware is loaded once the issue goes away. The issue may re-appear when returning back from Windows (which clobbers the firmware), and therefore BrcmPatchRAM might need to be re-introduced.

Add device ID so the firmware is loaded at boot (Source):

        <key>0a5c_21ff</key>
        <dict>
            <key>CFBundleIdentifier</key>
            <string>com.no-one.BrcmPatchRAM2</string>
            <key>DisplayName</key>
            <string>Broadcom BCM20702 Bluetooth 4.0 +HS USB Device</string>
            <key>FirmwareKey</key>
            <string>BCM20702A1_001.002.014.1443.1463_v5559</string>
            <key>IOClass</key>
            <string>BrcmPatchRAM2</string>
            <key>IOMatchCategory</key>
            <string>BrcmPatchRAM2</string>
            <key>IOProviderClass</key>
            <string>IOUSBHostDevice</string>
            <key>idProduct</key>
            <integer>8703</integer>
            <key>idVendor</key>
            <integer>2652</integer>
        </dict>

The thing I’d check is the Vendor and drvice IDs to ensure they’re exactly right. For the BCM94360CD (the three-antenna for WiFi, one antenna for BT4.0 design), the Bluetooth controller needs to be 05ac:828d and the WiFi needs to be 106b:0111 (those are technically sub vendor and device IDs, I guess because the main vendor and device IDs of 14e4:43a0 refer to the underlying Broadcom chip itself). Apparently there are other Broadcom 4360 chipset-based cards with different sub product IDs like 0136 that get sold and aren’t the exact right models and thus don’t wind up unlocking every feature properly.

Source

Fenvi T-919 is the easy answer, it’s a Broadcom BCM94360-based card that should support native functionality in macOS. You will need a driver for it for Windows. You could also get an adapter and an Apple official BCM94360 card (a 2-antenna -CS or -CS2 from a MacBook Air, or a 4-antenna -CD from an iMac) and just use the Bootcamp drivers in Windows (not sure about Linux, sorry).

Source

Handoff Stopped Working

Log in and out of icloud on all your devices. After that, wait a couple hours / days and literally do nothing, it’ll start working out of thin air. Happened to countless users including me with a native Fenvi t919.

Source