ITADN
bobanilic/X570-AORUS-MASTER-3900XT-Tahoe-EFI
bobanilic/X570-AORUS-MASTER-3900XT-Tahoe-EFI · 文件
文件最后提交记录最后更新时间
README.md

X570 AORUS MASTER + Ryzen 9 3900XT — macOS Tahoe OpenCore EFI

A tested OpenCore EFI for the Gigabyte X570 AORUS MASTER and AMD Ryzen 9 3900XT, validated on macOS Tahoe 26.6.1 (25G76).

The system uses an AMD Radeon RX 580 for macOS while an NVIDIA GeForce RTX 3080 remains installed for Windows and is disabled only in macOS.

[!CAUTION] This EFI is hardware-specific. The public configuration is intentionally sanitized and does not contain usable Apple identifiers. Generate your own MacPro7,1 SMBIOS values before booting, test from removable media first, and keep a known-good EFI backup.

Validated configuration

ComponentConfiguration
MotherboardGigabyte X570 AORUS MASTER
CPUAMD Ryzen 9 3900XT — 12 cores / 24 threads
macOS GPUAMD Radeon RX 580 8 GB
Windows GPUNVIDIA GeForce RTX 3080
Wi-Fi / BluetoothIntel Wi-Fi 6 AX200
EthernetRealtek RTL8125 2.5 GbE; Intel I211 also present
AudioRealtek ALC1220
StorageWD_BLACK SN850X 1 TB + Samsung 970 EVO Plus 500 GB
Case / front I/OCooler Master H500M — 4× front USB-A 3.x + front USB-C
SMBIOSMacPro7,1
macOSTahoe 26.6.1 (25G76)

Feature status

FeatureStatusNotes
macOS boot✅ WorkingStable on Tahoe 26.6.1 / 25G76
CPU topology✅ Working12 physical / 24 logical threads confirmed
RX 580 acceleration✅ WorkingEllesmere graphics stack and Metal acceleration confirmed
RTX 3080 retained✅ WorkingDisabled only in macOS through PCI device properties
Intel AX200 Wi-Fi✅ WorkingNative macOS Wi-Fi UI via AirportItlwm + OCLP Modern Wireless root patch
Bluetooth✅ WorkingIntelBluetoothFirmware + IntelBTPatcher + BlueToolFixup
Ethernet✅ WorkingRealtek RTL8125 via RTL812xLucy.kext; 1 Gbps link confirmed
ALC1220 audio✅ WorkingAppleALC layout 5 + OCLP Modern Audio root patch
USB-A✅ WorkingCustom USBToolBox map
H500M front USB-C✅ WorkingiPhone enumeration, pairing and data communication confirmed
Rear USB-C✅ WorkingVerified during physical USB mapping
iCloud / iMessage / FaceTime✅ WorkingAPNs client identity and IDS registration confirmed
iPhone camera over USB✅ WorkingAvailable to QuickTime when connected by cable
Wireless Continuity Camera❌ UnavailableCurrent Intel Wi-Fi stack does not create awdl0
AirDrop / AWDL-dependent features❌ UnavailableLimited by the same missing-AWDL path
iPhone Mirroring❌ Unsupported on this buildNo physical Apple T2 / Apple silicon security hardware
iOS 27 DeviceSupport package⚠️ PendingUSB pairing works; Apple currently provides no matching DEVICESUPPORT product to this system

Before you boot

1. Generate your own Apple identifiers

The repository contains placeholders under PlatformInfo -> Generic:

KeyRepository value
SystemSerialNumberCHANGEME
MLBCHANGEME
SystemUUID00000000-0000-0000-0000-000000000000
ROMEmpty

Generate one internally consistent identity set and use it only for your machine. Do not copy identifiers from another public EFI.

If you intend to use config-heliport-working.plist, place the same identity set there as well.

2. Keep UpdateSMBIOSMode = Create

The validated configuration uses:

PlatformInfo -> UpdateSMBIOSMode = Create

On this board, Custom allowed the underlying Gigabyte firmware identity to appear at runtime. Both repository configs therefore use Create.

Do not regenerate a working SMBIOS, change ROM/UUID values, or reset NVRAM as a generic troubleshooting step.

3. Use the tested firmware / OpenCore settings

SettingValue
UEFI bootEnabled
CSMDisabled
Secure BootDisabled
Above 4G DecodingEnabled
Resizable BAREnabled
ResizeAppleGpuBars0
ResizeGpuBars-1
SetupVirtualMaptrue
DisableIoMappertrue
XhciPortLimitfalse
SecureBootModelDisabled
csr-active-config03080000

[!NOTE] BIOS updates can change PCI paths. Revalidate GPU, network and USB paths after firmware changes.

Installation

  1. Back up the existing EFI and create a bootable recovery path.
  2. Apply the BIOS settings above.
  3. Insert your own SMBIOS identifiers into EFI/OC/config.plist.
  4. Test the EFI from removable media before replacing the system EFI.
  5. Boot macOS and verify graphics, networking, audio and USB before applying additional changes.
  6. Apply the required OCLP post-install root patches described below.

Tahoe Wi-Fi and audio root patches

The primary configuration uses the AirportItlwm / legacy wireless path with:

  • Lilu 1.7.3
  • AMFIPass 1.4.1 with -amfipassbeta
  • IOSkywalkFamily 1.0
  • IO80211FamilyLegacy 12.0
  • AirportItlwm 2.3.0
  • IntelBluetoothFirmware / IntelBTPatcher 2.5.1
  • BlueToolFixup 2.7.3
  • the required IOSkywalkFamily block entry
  • AX200 device-property injection

After installing or updating macOS, use OpenCore Legacy Patcher only for Post-Install Root Patch and apply:

  • Networking: Modern Wireless
  • Miscellaneous: Modern Audio

[!WARNING] Do not use OCLP's Build and Install OpenCore function with this EFI. OCLP is used here only for the required root patches.

Graphics

The Radeon RX 580 is the active macOS GPU and has verified Ellesmere acceleration and Metal support.

The RTX 3080 remains physically installed for Windows and is disabled only in macOS through PCI device properties. This avoids requiring the card to be removed or disabled in firmware.

Ethernet

The primary configuration uses:

RTL812xLucy.kext 1.1.1 = enabled
LucyRTL8125Ethernet.kext 1.2.3 = disabled

The configured AppleEthernetRL block is retained for the Tahoe / legacy-IOSkywalk configuration. The Realtek RTL8125 interface has been validated at 1 Gbps full duplex.

USB

The USB map was rebuilt with USBToolBox in Windows so ports missing from the previous macOS map could be discovered independently.

The current UTBMap.kext contains three controller personalities and includes:

  • H500M front USB-C USB2 path verified with an iPhone in macOS
  • mapped front and rear USB-A paths
  • mapped SuperSpeed paths
  • internal-device paths

UTBDefault.kext and USBInjectAll.kext are not used. Keep XhciPortLimit = false.

HeliPort fallback

EFI/OC/config-heliport-working.plist is retained as an itlwm + HeliPort fallback configuration.

Do not enable AirportItlwm.kext and itlwm.kext simultaneously.

Kext snapshot

KextVersion / state
Lilu1.7.3
WhateverGreen1.7.1
VirtualSMC1.3.8
AppleALC1.9.8
AMFIPass1.4.1
RestrictEvents1.1.7
USBToolBox1.2.0
UTBMapCustom 1.1
NVMeFix1.1.4
AirportItlwm2.3.0
itlwm2.3.0 — disabled in primary config
IntelBluetoothFirmware / IntelBTPatcher2.5.1
BlueToolFixup2.7.3
RTL812xLucy1.1.1 — enabled
LucyRTL8125Ethernet1.2.3 — disabled in primary config

Known limitations

  • AWDL is unavailable with the current Intel AX200 stack, so wireless Continuity Camera, AirDrop and other AWDL-dependent features are not available.
  • iPhone Mirroring is unsupported on this build because the PC does not provide the physical Apple T2 / Apple silicon security hardware required by that feature.
  • iOS 27 USB pairing works, but MobileDeviceUpdater currently finds no matching Apple DEVICESUPPORT product for this system.
  • OCLP root patches may need to be reapplied after macOS updates.

These limitations are independent of the core boot, graphics, USB, Ethernet, iServices and wired iPhone functionality listed as working above.

Repository integrity

SHA256SUMS.txt contains checksums for the sanitized release files used to verify the repository snapshot.

The public config.plist is intentionally different from the private machine-specific configuration because all Apple identity values are removed before publication.

Privacy and security

Never commit or publish:

  • real SMBIOS serial / MLB / SystemUUID / ROM values
  • iPhone UDIDs or other device identifiers
  • APNs certificates, tokens or private keys
  • diagnostic dumps containing account or hardware identity data

Project principles

This EFI is maintained conservatively:

  • make one isolated change at a time
  • verify runtime behavior before keeping a change
  • preserve a known-good EFI backup
  • avoid unnecessary NVRAM resets or SMBIOS regeneration
  • treat BIOS updates and macOS updates as changes that may require revalidation

Credits

This configuration depends on the work of the following projects and communities:

Disclaimer

This repository is provided as-is for a specific hardware configuration. Hackintosh behavior can change with BIOS revisions, macOS updates, PCI layout changes and different component revisions.

Do not treat this EFI as a universal configuration for other X570 systems. Test from removable media, keep backups and understand every change before deploying it to a working installation.