Jump to content

### **Tahoe 26.0 Z790 Hackintosh Setup Guide**

nmano

By nmano,
in OpenCore Guides

 Share
7 posts in this topic

Recommended Posts

nmano
nmano
Posted
Posted

### **Tahoe 26.0 Z790 Hackintosh Setup Guide**

 

 

 

**System Specifications:**
*   **Motherboard:** Gigabyte Z790 Gaming X AX
*   **CPU:** Intel Core i9-13900K (Raptor Lake)
*   **GPU:** AMD Radeon RX Vega 64
*   **SMBIOS:** MacPro7,1
*   **OpenCore:** Version 0.9.5 or newer
*   **macOS:** Tahoe 26.0

 

### **1. SSDT Explanation and Breakdown**

An SSDT (Secondary System Description Table) is a piece of ACPI code loaded at boot to modify your system's hardware description, making your PC's components behave like Apple hardware.

 

#### **SSDT Summary Table**

| SSDT Name | Status | Purpose | Category |
| :--- | :--- | :--- | :--- |
| **SSDT-PLUG** | Enabled | CPU Power Management | Essential |
| **SSDT-EC** | Enabled | Fake Embedded Controller | Essential |
| **SSDT-USBX** | Enabled | USB Power Properties | Essential |
| **SSDT-RTC0-Z790** | Enabled | RTC/AWAC Fix for Z790 | Platform |
| **SSDT-RTCAWAC** | Enabled | RTC/AWAC Fix for Z790 | Platform |
| **SSDT-PMC** | Enabled | Native NVRAM Support | Platform |
| **SSDT-IGPU-1** | Enabled | Disable Intel iGPU | GPU/PCIe |
| **SSDT-IGPU** | Disabled | (Redundant) Disable iGPU | GPU/PCIe |
| **SSDT-PEG0-SSD970-SSD0** | Enabled | NVMe SSD Patch | GPU/PCIe |
| **SSDT-PEG1, RP01, etc.** | Enabled | PCIe Root Port Management | GPU/PCIe |
| **SSDT-RP09-TB3** | Enabled | Thunderbolt 3 Enable | GPU/PCIe |
| **SSDT-XHC-25Ports** | Enabled | **Custom USB Map** | USB |
| **SSDT-UIAC** | Disabled | (Template) Create USB Map | USB |
| **SSDT-HPET** | Enabled | IRQ Conflict Fix | System |
| **SSDT-XOSI** | Enabled | OS Compatibility Fix | System |
| **SSDT-SBUS-MCHC** | Enabled | SMBus & Sensor Support | System |
| **SSDT-RHUB-Reset** | Enabled | Fix USB after Wake | System |
| **SSDT-MacPro7-1** | Enabled | Tailor ACPI for Mac Pro | SMBIOS |
| **SSDT-iMac20-1** | Disabled | (Leftover) For iMac | SMBIOS |

 

 

#### **Category 1: Absolutely Essential**

 

*   **`SSDT-PLUG.aml`**: Enables CPU Power Management (XCPM). Without it, your CPU will overheat and sleep will not work.

SSDT-PLUG.aml

 

*   **`SSDT-EC.aml`**: Creates a fake Embedded Controller. macOS will kernel panic on boot without it.

SSDT-EC.aml

 

*   **`SSDT-USBX.aml`**: Injects correct USB power properties for USB 2.0/3.0 ports.

SSDT-USBX.aml

 

#### **Category 2: Z790 Platform Specific**

 

*   **`SSDT-RTC0-Z790.aml` & `SSDT-RTCAWAC.aml`**: Fix the Real Time Clock (RTC) for Z790. **Crucial for sleep/wake.**
*   **`SSDT-PMC.aml`**: Enables native NVRAM support on Z790.

SSDT-RTC0-Z790.aml

SSDT-RTCAWAC.aml

SSDT-PMC.aml

 

#### **Category 3: GPU and PCIe Management**

 

*   **`SSDT-IGPU-1.aml`**: Enable the Intel UHD 770 iGPU. Correct for `MacPro7,1`.

SSDT-IGPU-1.aml

 

*   **`SSDT-PEG0-SSD970-SSD0.aml`**: A specific patch for your NVMe SSD (likely Samsung 970).

 

SSDT-PEG0-SSD970-SSD0.aml

 

**`SSDT-PEG1.aml`,Its primary purpose is to improve compatibility for a Radeon RX Vega 64 graphics card

Creates a "fake" PCI device to inject crucial properties into the macOS graphics drivers, enabling full functionality and performance for the Vega 64 GPU.

 

SSDT-PEG1.aml

 

Screenshot2025-09-17at3_51_43PM.thumb.png.6c3a5360cc48759e676c61a749253b15.png

##SSDT-RP01.aml##

Creates a "fake" Wi-Fi device and provides macOS with all the specific properties it needs to correctly recognize and use an Intel AX210/AX211/AX411 Wi-Fi card.Disables a native PCIe device (likely the actual Wi-Fi card that macOS doesn't natively support) and applies a workaround for a virtualization technology (VT-d) that can cause issues.Patching the Real Device's _DSM (for VT-d)

 

SSDT-RP01.aml

 

**`SSDT-RP09-TB3-HackinDROM.aml`**: Enables Thunderbolt 3/4 support.

 

SSDT-RP09-TB3-HackinDROM.aml

 

#### **Category 4: USB Mapping**

 

*   **`SSDT-XHC-25Ports.aml`**: This is your **final, custom USB Map**. Essential for stable USB and sleep.

SSDT-XHC-25Ports.aml

 

Screenshot2025-09-17at5_18_50PM.thumb.png.570172522d8342d3aec91a4345f95041.png

 

**`SSDT-XHC-15Ports.aml`**: A simpler map used only for installation and recovery.

 

SSDT-XHC-15Ports.aml

 

##SSDT-HDAS.aml##

 

Screenshot2025-09-17at3_50_44PM.thumb.png.9443c1198ce274dfd37484a82bbe695e.png

  1. Creates a new device called HDEF (High Definition Audio Function) under the PC00 bus and injects a comprehensive set of properties to make the onboard Realtek ALC1220 audio controller work correctly in macOS.

  2. Disables the original device HDAS (which is the standard ACPI name for the audio controller) to prevent a conflict with the newly created HDEF device.

  3.  

SSDT-HDAS.aml

 

### **3. Kexts (Kernel Extensions)**

**Essential:**
*   **`Lilu.kext`**: **Must be first.** The foundation for all other kexts.
*   **`VirtualSMC.kext`**: Emulates the Apple SMC. **Mandatory.**
*   **`WhateverGreen.kext`**: **[CRITICAL] ENABLE THIS.** Required for RX Vega 64.
*   `AppleALC.kext`: For onboard ALC1220 audio (`alcid=12` is correct).
*   `RestrictEvents.kext`: Fixes CPU name and memory errors.
*   `NVMeFix.kext`: Improves NVMe SSD power management.

**Networking:**
*   `LucyRTL8125Ethernet.kext`: For the 2.5G Ethernet port.
*   `itlwm.kext` + `IntelBluetoothFirmware.kext` + `IntelBTPatcher.kext` + `BlueToolFixup.kext`: Enables Intel AX201 WiFi and Bluetooth.

**macOS Sonoma Support:**
*   `AMFIPass.kext`: Bypasses AMFI security for Sonoma.
*   `CryptexFixup.kext`: Auxiliary fix for Sonoma.

---

### **4. Booter & Kernel Quirks**

Your quirks are well-configured. Key points:
*   **`AppleXcpmCfgLock`**: Set to `True`. This assumes you have **disabled `CFG-Lock`** in your BIOS.
*   **`DisableIoMapper`**: Set to `True`. This assumes you have **enabled `VT-d`** in your BIOS.

---

### **5. NVRAM → boot-args**

`-v amfi=0x80 -amfipassbeta -lilubetaall -alcbeta -wegbeta alcid=12 debug=0x100 npci=0x2000 revpatch=sbvmm,cpuname watchdog=0 keepsyms=1 swd_panic=1`

*   **`-v`**: Verbose boot. Remove when stable.
*   **`amfi=0x80` & `-amfipassbeta`**: Required for Sonoma.
*   **`alcid=12`**: Correct layout-id for ALC1220 audio.
*   **`npci=0x2000`**: Often needed for Z790 PCI configuration.
*   The rest are debug flags which can be removed later.

**Other NVRAM Settings:**
*   **`SecureBootModel`: `Disabled`** (Correct for Hackintosh)
*   **`csr-active-config`: `AwgAAA==`** (Correctly disables SIP)

---

### **6. BIOS Settings (Gigabyte Z790 Gaming X AX)**

**Disable:**
*   Fast Boot
*   Secure Boot
*   **CFG Lock** (Find this setting! If unavailable, keep `AppleXcpmCfgLock` quirk enabled)
*   CSM (Compatibility Support Module) **\*Critical\***

**Enable:**
*   Above 4G Decoding
*   **VT-d** (Required for `DisableIoMapper` to work)
*   EHCI/XHCI Hand-off
*   Hyper-Threading
*   Execute Disable Bit

---

### **7. EFI**

 

EFI.zip

 

1.  **Fix Kexts:**  in your `config.plist`.
2.  **Make SSDT for your Devices.
3.  **Verify BIOS:** Reboot into BIOS and confirm `CFG-Lock` is disabled and `VT-d` is enabled.
4.  **Install:** Use your USB installer with the corrected EFI.
5.  **Clean Up:** After installation, 
6.  **Test:** Verify sleep/wake, USB, audio, Ethernet, and Thunderbolt functionality.

 

A Heartfelt Thank You to the OpenCore and Hackintosh Community

To the brilliant developers, dedicated contributors, and the entire Hackintosh community,

We are writing this with immense gratitude for the incredible work you have all done. The journey of creating a Hackintosh has evolved from a complex series of hacks into a remarkably stable and refined experience, and that is almost entirely thanks to you.

To the OpenCore Team:
Thank you for your vision, precision, and relentless pursuit of perfection. OpenCore is a masterpiece of modern software engineering. It’s more than just a bootloader; it’s a testament to clean code, proper implementation, and deep understanding of macOS's core. You've transformed a chaotic process into a methodical, educational, and stable one. Your detailed documentation is a gift to us all, teaching an entire community about the inner workings of Apple's hardware and software.

To the Veteran Developers and Toolmakers:
Thank you to the legends who laid the groundwork. To the developers and to the creators of essential kexts like Lilu, WhateverGreen, VirtualSMC, AppleALC, and countless others—your work is the very foundation that makes any of this possible. You solve the puzzles that Apple creates, tirelessly reverse-engineering and writing the code that bridges the gap between non-Apple hardware and macOS.

A Special Thank You to the OCLP Mod and Legacy Patcher Community.

Screenshot2025-09-17at3_49_44PM.thumb.png.a92b88846294af1710ff6885a029defa.png

  • Like 6
  • Thanks 1
naiclub
naiclub
Posted
Posted (edited)

Your work is very detailed.
Thank you very much.

edit.. UHD 770 is only used for decoding or converting video files. It cannot be used for displaying on the monitor.

 

Edited by naiclub
  • Like 3
nmano
nmano
Posted
  • Author
Posted (edited)

purple/pink artifact spray on boot with a Vega 64

without WhateverGreen.kext

No more purple.Change your PCI Root

Option A agdpmod 

<key>Add</key>
<dict>
    <key>PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x0)</key>
    <dict>
        <key>agdpmod</key>
        <string>pikera</string>
    </dict>
</dict>
<key>Add</key>
<dict>
    <key>PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x0)</key>
    <dict>
        <key>disable-gpu-firmware</key>
        <data>AQAAAA==</data> <!-- This is the base64 encoded representation of 01000000 -->
    </dict>
</dict>

Option B disable-gpu-firmware 

Edited by nmano
  • Like 2
  • 9 months later...
 Share
Go to topic listing
×
×
  • Create New...