/ryzen-hackintosh

OpenCore EFI for AMD Ryzen Hackintosh

Primary LanguageShell

OpenCore EFI for AMD Ryzen Hackintosh

Verified Specification

Component Model
CPU AMD Ryzen 7 1700 @ 3.8GHz
Motherboard ASUS B350 Plus
RAM 16GB (2 x 8GB) Corsair Vengeance @ 3000MHz
GPU MSI RX Vega 64
Audio Chipset ALC-887
Ethernet Realtek RTL8111
WiFi & Bluetooth Fenvi T919 (BCM94360CD)
OS Disk (NVMe) ADATA SX8200 Pro 1TB

macOS version: 12.0 Beta 6 (21A5506j)
OpenCore version: 0.7.3

Table of contents

Software Compatibility

  • Monterey (12.x)
  • Big Sur (11.x)
  • Catalina (10.15.x)
  • Mojave (10.14.x)
  • High Sierra (10.13.x)

There were some reports about issues that occur while using MSI motherboards on Monterey Beta 3. The only possible solution to this problem as of right now is to downgrade to Monterey Beta 2 and wait for a confirmed workaround.

Hardware Compatibility

Central Processing Unit (CPU)

This EFI is compatible with all Ryzen and Athlon 2xxGE processors with macOS-compatible peripherals.

Support for 15h (FX series), 16h (A series) and Threadripper CPUs is not covered here.

Graphical Processing Unit (GPU)

Model Compatible?
Integrated No
Nvidia Partially 1
AMD Yes 2 3

1 Kepler series under correct PAT Patch. Others require WebDrivers which work only in High Sierra or are not supported. More details on Dortania.

2 Some R7 and R9 GPUs require FakeID. More details here

3 Lexa series GPUs are not supported. Older than 7000 series are supported up to High Sierra (10.13), their support is not covered here.

For AMD Navi 10 Series GPUs (RX 5500, RX 5600, RX 5700) you need to add agdpmod=pikera to boot-args to fix the black screen issue.

PAT Patch made by Shaneee is used by default. It improves GPU performance but it has a few caveats. Audio passed by HDMI or DisplayPort won't work or will be unstable. It also may not work with Nvidia GPUs.

If you want to control monitor's brightness or HDMI/DP audio volume you need to use MonitorControl for that.

Laptops

All laptops with AMD CPUs are not supported due to integrated GPUs incompatbility.

Motherboards

Chipset Details
B550, A520 Requires SSDT-CPUR to boot. Details here.
B550, A520, B450, X470, X570 SetupVirtualMap has to be disabled.
Other Should be compatible out of the box.

SSDT-CPUR

Follow these steps to properly install SSDT-CPUR.

  • Download from here.
  • Install it to your OC/ACPI directory.
  • Add it to your configuration file. Use ProperTree for simplicity.

Disabling SetupVirtualMap

To disable SetupVirtualMap simply go to Booter -> Quirks -> SetupVirtualMap in your configuration file and disable it. (Should be false).

Audio

Follow these steps if your audio chipset is different than the one specified in the Specification.

  • Go here to find your audio chipset codec. (Under Codec)
    • If you can't find your codec on the list, then you probably have to use VoodooHDA. This repository does not cover or support the use of VoodooHDA.
  • Under Revisions and layouts you'll see bunch of numbers and layout ids.
  • Find your boot-args settings and look for alcid=11.
  • Try every layout id (except 0x values) one by one until it works.
    • Example: alcid=10 if layout 10

Caveats:

  • External (USB) audio cards should work out of the box.
  • Microphone input (3.5mm Jack) won't work properly. Use USB/Bluetooth microphones instead.
  • If you have CPU with integrated GPU (even if you don't use it) your audio may be broken or unstable. You can try using SpeedKeeper but it's not guaranteed to fix your problem. The best solution is using external (USB) audio card.

Network

If you experience any issues with your network connection, then your best bet would be to install a different kext, preferably from here.

If you use High Sierra and Realtek 8111 Ethernet Card then you should use older version of kext.

SmallTree kext does not work on Monterey for now. You can try AppleIGB kext, it works on some systems. If it does not work you have to stay on Big Sur and wait for SmallTree's update.

WiFi and Bluetooth

Only Apple Airport and Fenvi cards work out of the box. Here you can list of all supported cards and needed kexts for them.

Rembember that AirDrop, Handoff, etc. works only on cards with Broadcom chip.

Installation

Bootable USB

  1. Follow this guide to create your bootable USB.

  2. Clone this repository and copy "BOOT" & "OC" directories to your "EFI" directory on your bootable USB. The structure should look somewhat like this: EFI -> BOOT, OC.

Modifying kernel patches

  1. Modify Core Count patches to match your CPU's cores amount.

  • Find three algrey - Force cpuid_cores_per_package patches under Kernel -> Patch in your config.

  • Modify these patches for your CPU physical cores. Change first pair of 00 in Replace of these patches to Hex value from below table.

    • e. g. for Ryzen 7 1700 with 8 Cores three modified patches should look like:
      • B8 00 0000 0000 -> B8 08 0000 0000
      • BA 00 0000 0000 -> BA 08 0000 0000
      • BA 00 0000 0090 -> BA 08 0000 0090
Physical CPU cores Hex value
4 Cores 04
6 Cores 06
8 Cores 08
12 Cores 0C
16 Cores 10

SMBIOS

  1. Use this tool to generate your unique SMBIOS info.

  • SMBIOS has to be unique, you cannot use one present in this repository.

  • Run the tool and select Generate SMBIOS.

  • Select the appropriate model for your hardware using the table below.

  • Go to Apple Coverage and paste generated Serial. You need "Invalid Serial" or "Purchase Date not Validated" message. If you get something another you have to generate SMBIOS data and check it again.

  • Open config.plist and search for PlatformInfo -> Generic and replace these values:

    • SystemProductName - Model
    • MLB - Board Serial
    • SystemSerialNumber - Serial
    • SystemUUID - SmUUID

  • ROM entry should be set to your network card's MAC address, without separators (e. g. :, -).

GPU Series Model
AMD Navi Series iMacPro1,1 1
AMD Vega Series iMacPro1,1 1
AMD Polaris Series iMacPro1,1 1
AMD Radeon R5/R7/R9 MacPro6,1
AMD HD 8000 Series MacPro6,1
AMD HD 7000 Series MacPro6,1
Nvidia Kepler Series MacPro7,1 2

1 For Catalina and newer you can also use MacPro7,1 if you have some issues (e. g. unfixable DRMs).

2 For Catalina and older use iMac14,2.

Configuration

  1. You should update your BIOS to the latest version and configure it appropriately. See BIOS Settings for details.
  2. Remember to verify your hardware and apply appropriate changes to your configuration file. See Hardware Compatibility for details.
  3. Map your USB ports with USBToolBox. Guide about it is available here. You have to do it from Windows.
  4. That's it! Now you can boot macOS installer.

Post-Installation

  1. Copy your EFI directory onto your main drive EFI partition, you'll be able to boot the system without your bootable USB.
  2. Apply Ryzen patch script - it solves MKL (Math Kernel Library) issues and sets correct sleep parameters.
  3. If you have Unknown instead of your CPU name in About this Mac go to PlatformInfo -> Generic -> ProcessorType in your configuration file. Set it to 3841 if your CPU has 8 or more physical cores, else set it to 1537.
  4. When everything work you can disable verbose mode - then you will see Apple's logo instead of logs while booting. To do it you have to remove -v debug=0x100 keepsyms=1 from boot-args in your configuration file.

Bootstrap

In general, enabling Bootstrap is not required, but it will protect your OpenCore from being overriden.
Remember to do not enable Bootstrap on pendrive - do it only after copying OpenCore to your disk's EFI.

  1. Go to Misc -> Boot -> LauncherOption in your configuration file and set it to Full.
  2. Reboot your computer.
  3. Reboot PC again and go to your BIOS settings. In boot options you will see new boot entry named OpenCore. Set BIOS to boot from it, instead of your drive.
  4. It's done!

BIOS Settings

Option Status
SATA Mode AHCI
Above 4G Decoding Enabled 1
EHCI/XHCI Hand-off Enabled
SVM Enabled
CSM Disabled
Resizable BAR Support Disabled
Secure Boot Disabled
Serial Port Disabled
Parallel Port Disabled

1 If you have this option in BIOS you must also remove npci=0x2000 from boot-args in your configuration file.

Some of these options may not exist in your firmware, just try to match it as closely as possible.

Before booting macOS remember to update BIOS to the latest version.

PAT Patch

Shaneee's Algrey's
Much better GPU performance Worse GPU performance
May not work with Nvidia GPUs Compatible with all GPUs
HDMI/DP audio may not work HDMI/DP audio works
Enabled by default Disabled by default

To switch to another patch look for mtrr_update_action in config.plist. Then set Enabled to true for the patch you want to use. Remember to set Enabled to false on the other PAT patch. Do not try to enable both at the same time, trust me, it won't work.

MKL and Intel Fast Memset Patch

Some applications for macOS use MKL - Math Kernel Library. Unfortunately, it does not work on AMD CPUs natively - we need to patch it with this script.

There's also intel_fast_memset instruction which, obviously, doesn't exist on AMD systems. It's very common in Adobe software - you can simply fix it by running this script. Older versions of Adobe software (e. g. up to 22.3.1 for Photoshop) need it's legacy version.

If you have problems while running script from file, try to copy and paste it's code to Terminal.

DRMs support

DRMs are fixed by default only for Big Sur and newer versions. For older versions you have to:

  1. Remove unfairgva=1 from boot-args in your configuration file.
  2. Go here to find correct value for your system.
  3. Add parameter from Mode to boot-args in your configuration file.
    • If parameter from chart does not work try shikigva=80 or shikigva=16 - it's common to work even when chart says something another.
  4. Test DRMs with Netflix in Safari or Apple TV+.

Sleep

Firstly, check if your sleep works out of the box. If it works, you can skip reading this section.

The most common reason of broken sleep on AMD systems are USB problems.
You have to map your USB ports. If you have working Windows instance I recommend this tool, otherwise you have to do it manually.
After mapping remember to disable Kernel -> Quriks -> XhciPortLimit in your configuration file.

If map does not fix your issue you can try to patch _STA method of your USB controllers. Go to ACPI -> Add in your configuration file and set Enabled to true under SSTD-SLEEP section. By default this SSDT patches _SB.PCI0.GPP2.PTXH device. In most cases your controller will have another address.
You can find it with Hackintool - go to PCIe tab, then look for devices with USB controller value under Subclass. When you find address of your controller you have to open SSDT-SLEEP.aml with MaciASL and change addresses. If you have more than one controller you can try to patch _STA for every of them.

If USB fixes does not help, probably something another is broken. You can read more detailed guide about it on Dortania.

Virtualization

Prerequisites

  • Make sure you have SVM enabled in your BIOS settings.
Software Compatibility
Parallels Desktop Up to 13.1 unless AppleHV is used.1 2 3
VirtualBox Drastically decreased performance.
VMWare Fusion 10 Only Catalina and older, for Catalina with this patch.
Docker Only Docker in VirtualBox or Docker Toolbox.

1 Parallels will not work by default on Big Sur and newer, you need to use SYSTEM_VERSION_COMPAT=1 environment variable.

2 Use this launcher package to simplify the Parallels usage.

3 Only Windows 10 Anniversary Update (build 1607) or older systems work.

Resource management

You shouldn't add too much resources to your virtual machines, as it causes performance issues regardless of your hardware.

Use the following configuration for best results.

  • Parallels Desktop 13.1
  • 4 CPU cores
  • 4GB - 8GB RAM
  • 1GB VRAM
  • 3D Acceleration: DirectX 9
  • OS: Windows 7 (SP1, build 7601) with Aero theme disabled.

Guides

If you have any other questions or issues, feel free to ask on AMD-OSX Discord or Forum.

Credits

Screenshot