Radeon Compatibility Guide

ATI/AMD Graphics Cards



Last Change: December 2nd, 2017







The "boot to black screen" issue as well as the broken sleep/wake have been fixed! Read below for details.

​

0. Introduction

Note

1. General Information

AMD Kernel Extensions

Initialization Process

EFI-Init: On a genuine Mac, the graphic card carries a EFI ROM right next to the legacy vBIOS on the EEPROM chip. On startup, this EFI binary will be executed by the machines EFI, which will introduce the card to the system thus initializing the driver. On a Hack, this can be mimicked by the bootloaders Graphics Injection functionality. This way you can tell the system which Framebuffer to use (see next section) or how the card shall be called in the System Profiler. Some of you will also remember tools like ATY_Init.kext which can basically do the same. Those are not relevant any longer.

On a genuine Mac, the graphic card carries a EFI ROM right next to the legacy vBIOS on the EEPROM chip. On startup, this EFI binary will be executed by the machines EFI, which will introduce the card to the system thus initializing the driver. On a Hack, this can be mimicked by the bootloaders Graphics Injection functionality. This way you can tell the system which to use (see next section) or how the card shall be called in the System Profiler. Some of you will also remember tools like which can basically do the same. Those are not relevant any longer. Auto-Init: With Lion, a new feature has been added: Automatic initialization of the drivers. Apple gave the system the ability to initialize a PCI graphics card just by its legacy vBIOS, without the need for any (faked) EFI stuff. At the beginning this had some compatibility issues, but as of Yosemite one can say that in most cases this works as good as the classic EFI-based injection method.

Framebuffers

2. Compatibility Chart

AMD product naming convention

Definition of the term 'Reference Design / Layout'

Note on Radeon HD 7000 / R7 / R9 cards

Graphics Card OOB min. OSX DevID Reference Port Layout Framebuffer Known Issues HD 5770 Yes 10.6.8 0x68B8 2x DVI, HDMI, DP Vervet none HD 5770 Mac Edition Yes 10.6.8 0x68B8 2x mDP, DVI Hoolock none HD 5850 Yes 10.6.8 0x6899 2x DVI, HDMI, DP Uakari none HD 5870 Yes 10.6.8 0x6898 2x DVI, HDMI, DP Uakari none HD 5870 Mac Edition Yes 10.6.8 0x6898 2x mDP, DVI Langur none HD 5870 Eyefinity 6 Yes 10.6.8 0x6898 6x mDP, DVI Zonalis unconfirmed

​

Graphics Card OOB min. OSX DevID Reference Port Layout Framebuffer Known Issues HD 6790 No ? 0x673E ? ? DevID missing HD 6850 No ? 0x6739 ? ? DevID missing HD 6870 Yes ? 0x6738 2x mDP, HDMI, 2x DVI Duckweed 2nd DVI non-functional HD 69x0 No ? - - - very buggy, not usable at all

​

Graphics Card OOB min. OSX DevID Reference Port Layout Framebuffer Known Issues HD 7750 Yes 10.8.3 0x683F ? ? Black screen issue since 10.10.3 HD 7770 / R7 250X Yes 10.8.3 0x683D 2x mDP, HDMI, DVI Dashimaki Black screen issue since 10.10.3 HD 7850 Yes 10.8.3 0x6819 ? ? none HD 7870 / R9 270X Yes 10.8.3 0x6810 2x mDP, HDMI, DVI Futomaki none R9 270 / R7 370 No 10.8.3 0x6811 ? ? DevID missing HD 7950 / R9 280 Yes 10.8.3 0x679A 2x mDP, HDMI, DVI Hamachi none HD 7970 / R9 280X Yes 10.8.3 0x6798 2x mDP, HDMI, DVI Hamachi none

​

Graphics Card OOB min. OSX DevID Reference Port Layout Framebuffer Known Issues HD 7790 / R7 260 Yes 10.10? 0x665C none none Buggy multi screen support, buggy DP, needs RadeonDeInit since 10.12 R7 260X / R7 360 No 10.10? 0x6658 none none “ R9 290 / R9 390 No 10.10? 0x67B1 none none “ R9 290X / R9 390X Yes 10.10? 0x67B0 none none “

​

Graphics Card OOB min. OSX DevID Reference Port Layout Framebuffer Known Issues R9 285 / R9 380 Yes 10.10 0x6939 DP, HDMI, 2x DVI Lagotto Needs RadeonDeInit (since 10.11) R9 380X Yes 10.10 0x6938 DP, HDMI, 2x DVI Lagotto " Fury / Fury X No 10.12 0x7300 none none Needs RadeonDeInit

​

Graphics Card OOB min. OSX DevID Reference Port Layout Framebuffer Known Issues RX 460 / RX 560 Yes 10.12 0x67EF DP, HDMI, DVI Acre Needs RadeonDeInit RX 470 / RX 570 Yes 10.12.6 0x67DF 2x DP, HDMI, 2x DVI Orinoco Needs RadeonDeInit RX 480 / RX 580 Yes 10.12.6 0x67DF 2x DP, HDMI, 2x DVI Orinoco Needs RadeonDeInit

​

Graphics Card OOB min. OSX DevID Reference Port Layout Framebuffer Known Issues RX Vega56 Yes 10.12.6 0x687F 3x DP, HDMI Kamarang / Iriri? Needs RadeonDeInit, early drivers RX Vega64 Yes 10.12.6 0x687F 3x DP, HDMI Kamarang / Iriri? Needs RadeonDeInit, early drivers ​

OOB = No means (unless otherwise stated) you'll have to spoof or add the device ID to enable support

'Framebuffer' is the framebuffer that matches the reference port layout best. Non-reference cards might work better with others.

'min OSX' refers to the initial version which first added driver support for a specific chipset. The device ID might have been added in a later release, so your card might not work OOB at this version.

Code: <key>Graphics</key> <dict> <key>RadeonDeInit</key> <true/>

3. Finding or patching a compatible framebuffer

Finding the best Framebuffer

Dump your vBIOS (e.g. with atiflash.exe in DOS or with Clover). Run redsock_bios_decoder. This will give you the encoder ID and transmitter ID. Run my fork of radeon_bios_decode (attached to this post). This will return the hotplug ID and sense ID. Note: Other tutorials claim that the hotplug ID equals the 'Connector index'. This might be true in special cases, but it's definitely not in general. Using my fork will reveal the real hotplug ID of each port.

Patching the Framebuffer

4. Spoofing the Device ID

5. FAQ

Most of you might have noticed that the Buyer's Guide doesn't list a single compatible AMD Radeon card at the moment. This would make many people assume that they weren't compatible with OS X at all, but in fact Apple has included driver support for almost every relevant AMD graphics chipset from the last years, so there's a good chance your standard PC card will work out of the box!However, before getting too excited there are a few things to consider to achieve hassle-free long-term compatibility, so I've composed this guide to collect all necessary information and to clarify some urban myths.I'll explain how to find perfectly compatible cards and how to improve the overall experience on not so compatible GPUs. This won't be a super-detailed step-by-step tutorial on every single aspect, but instead an overview on most important topics with links to further information.: I don't want any Nvidia vs. AMD discussions here: Both have their right to exist, and after reading the GPU recommendation section you'll know the pros and cons of Radeons so you can choose yourself.To choose a compatible graphics card it is helpful to know some details about the operation principles of the AMD drivers. Obviously I have never seen the source code of those drivers so my knowledge isn't as deep as it could be, but for the scope of this guide it'll be fine.The AMD drivers consist of a lot of kernel extensions, two of which are particularly interesting for the (possible) OS X compatibility of a specific GPU:(one for each AMD Radeon GPU family) and. The first is responsible of setting up basic 2D operation, correct resolutions, handling the connection ports of your card (rooting the signals to the correct ports, detecting hot plug actions, handling multiple screens) and others while the latter is mainly responsible for the 3D acceleration of your card.Both types of kexts contain a list of PCI device IDs in their Info.plist to detect and properly initialize connected GPUs. Having the device ID of a specific card in both files is necessaryto make it work! Apple will add some device IDs every now and then, and while some of the added cards will actually work, others might have awfully buggy drivers because Apple added the IDs just for testing purpose.There are some cards which are very similar to supported cards but still don't have their device ID in the drivers. They can usually be enabled by either modifying the Info.plist of both kernel extensions (not recommended, because changes will be lost on the next OS X update and you'll violate the kext signing) or by spoofing your GPUs device ID with Clover If the PCIe device ID of the installed card has a match infiles, it can be initialized. There are two ways to make that happen, I'll call themandFor Yosemite this means that the correct driver for your GPU will automatically be launched at startup if the device ID is in there. You don't have to do any setup for this to happen, but please remember that the drivers being loaded might still be crap and only give you a garbled or black screen.Each of thecontain a set of so-calledfor one GPU family. For the scope of this guide you can think of them as set of port mapping tables, which tell the driver how each port of the graphics card is physically linked to the GPU chip. This is important, because a mismatch might result in a black screen, system freezes or a lack of certain features (e.g. no hot-plug detection or no audio).Most of those framebuffers are Apple specific (e.g. 1 LVDS port and 2 DisplayPorts for a MacBook), but in the past they were kind enough to include some framebuffers for generic PC video cards despite they didn't use any themselves. Those framebuffers usually match AMDs(see below), so they won't help you in case of any odd custom design card.When using the graphics injection functionality of your bootloader, you'll tell the system (implicitly or explicitly) to use one of those framebuffers. This is fine if your card has a perfect match, but for non-reference cards usually you won't have much luck.If you don't inject a specific framebuffer but rely on the drivers auto-init feature, the driver will fall back to the generic, so-called RadeonFramebuffer. This framebuffer is dynamically built from the cards vBIOS, so it will match any non-reference card. In the past there have been some issues with this approach, especially on multi-display setups and with certain apps (DVD player, Steam), but as of today most of this seems to have been solved. Note that your card won't show up with its correct name, but instead report something like „Radeon HD 7xxx“ or "Radeon HD 5000 series". This is only cosmetic though and shows that you're currently using the RadeonFramebuffer; usually nothing to worry about.If you want to use graphics injection on a non-reference card, you'll have to patch your framebuffer in the correspondingbinary. This can be either achieved directly on your filesystem (not recommended, see previous section) or on the fly with Clover You can get a full list of AMD framebuffers in your OS using the PHP script provided in this thread In this section I'll list the compatibility of most relevant Radeon chipsets (as of Yosemite, if not stated otherwise). This also covers the best matching framebuffer for each card, the reference port layout and known issues. Please note that I obviously don't have the means to test every single card in every single vendor-specific variant myself, so there is always a chance that you'll encounter any specific card that doesn't behave as described here.I'll focus on new GPUs (HD 7000 and following) leaving out everything older than HD 5000, since most of those cards have already been dropped in OS X due to the lack of 64bit drivers. I also won't cover mobil GPUs, uncommon variants or low-end office computer cards.Before starting, it is noteworthy that AMD has created a lot of confusion in the last years with their rebadging policy: The three latest GPU generation (by name: HD 7000 series, Rx 200 series and Rx 300 series) each contain specific GPUs with different chip architectures, thus using different drivers resulting in totally different OS X compatibility.For example, a seemingly new R7 370 card uses the same, 3 year old GCN 1.0 based "Pitcairn" chip as a HD 7870, while a (by name similar) R9 380 uses the latest GCN 1.2 based "Tonga"-chip. I'll try to list all of those doubles in the following compatibility chart. Additionally, I'll partition the list by GPU family to make clear which kext is in charge of driving which card.To increase the confusion a little further, AMD has introduced HD 8000 cards for the OEM market, which are 1:1 rebrands again. Since they are quite rare, I won't cover them in this guide. If you're unsure about your HD 8xxx chipset, look it up on Wikipedia.The "reference design" is the PCB design AMD publishes when releasing a new card. Vendors like Sapphire or XFX can then decide to use this reference design for their cards or develop their own (somehow improved or cheaper) board layout.In the past Apple has included Framebuffers for AMDs reference layouts which usually provide full functionality for those cards.For the future this is quite unlikely, because Apple has abandoned the classic MacPro, which was the only Mac using standard PCI cards.The physical ports of a card are no sufficient criterion to decide whether it's a reference card or not. It's a good hint though, and the best you can get without dumping the cards vBIOS, so I'll include this information in the compatibility chart.If you need multi screen support (especially Eyefinity = more than 2) and don’t want to risk any trouble, get something as close to the reference layout as possible. If you're happy with one screen, get any variant you'd like to have, in most cases it will do the job just fine.Chameleon/Chimera currently has compatibility issues with those cards. There are some workarounds such as moving the bootloader to the EFI partition and/or using the Intel iGPU for booting. In my opinion using Clover is the best and cleanest way since it will get you also some other benefits.If you still want to stick with Chameleon/Chimera, here are some links to get you started:Many people are reporting problems with XFX cards, especially HD 7xxx / R9 generation. They're using a custom BIOS which can cause a crash upon booting, which can't be fixed in OS X.A common solution is either flashing a alternate VBIOS on your card (only do if you can recover form a bad flash!) or using Clover to load a compatible VBIOS dynamically (without flashing).Many modern AMD GPUs are incorrectly initialized during boot phase, which will can lead to serious issues in OS X (e.g. boot to black screen or crash after sleep/wake). This was first solved by the WhateverGreen Lilu plugin. Extensive research has been done by Mieze , resulting in a DSDT patch. This knowledge has been incorporated into Clover (starting with rev. 4296) and can be enabled from the config.plist like this:We recommend using the Clover solution.OS X still lacks native graphics acceleration for R9 Nano / Fury / Fury X and RX 470 / 480. However, they can use the "Baffin" accelerator (e.g. by spoofing the device ID), which was originally made for Polaris 11 based GPUs (especially the Radeon Pro GPUs in 2016 rMBP).They'll be limited to just 16 Compute Units though, which affects the compute performance notably. It's possible to unlock their full potential with a kext modification (alternate way: using Clover's kext patching feature).As stated before, choosing a card with reference layout should usually give you a 100% matching framebuffer out of the box. And even if your card differs from reference design or you've chosen a GPU without any "reference framebuffers" (e.g. R9 380), RadeonFramebuffer will do the job perfectly fine in most cases. But what to do if it doesn't?A quite common way to find the best matching framebuffer is injecting every available framebuffer of a GPU family and manually testing the compatibility with each port until you find one that suits your needs. While this might work, it’s obviously a very time-consuming way to test compatibility, so I wouldn't recommend blindly testing to anyone. It's way faster to analyze the compatibility of a specific framebuffer directly by having a look in your graphics cards vBIOS.The mapping of a specific port is defined by four different identifiers: Encoder ID, Transmitter ID, Hotplug ID and Sense ID. All of them have to match for perfect compatibility. A mismatch of the hotplug ID will usually just disable the hot plug detection (you might need to put your computer to sleep to activate the port), while a mismatch of the other 3 IDs will result in a black or garbled screen. Getting this mapping from the BIOS is easy:The following screenshot shows the complete port mapping at the example of a Radeon HD 7950 Mac Edition with Hamachi framebuffer:Each line of the framebuffer equals one physical port, and as you can see, Hamachi perfectly matches! You'll certainly have noticed that the framebuffer contains a lot more information than just those 4 identifiers. I won't cover every single aspect here, just one short note one the connector type which most other tutorials neglect: The first two bytes (byte-swapped!) of each line declare the type of the connector, e.g.:0x4 => DualLink-DVI0x200 => SingleLink-DVI0x400 => (mini)DisplayPort0x800 => HDMIDue to the compatibility (some) of those protocols it is way less important to match the connector type than one would think: For example, the DisplayPort specification guarantees backward compatibility to single-link DVI and HDMI. From my experience it's no problem to have a physical DVI port declared as DisplayPort as long as you don't exceed FullHD resolution. Same applies to some other combinations.If OS X doesn't offer a matching framebuffer for your card you'll have to patch a existing one. This is covered in great detail in a separate guide Due to popular demand, here’s a short guide on enabling GPUs with missing device ID in the drivers using Clovers "FakeID" feature. For the scope of this tutorial, let’s assume you want to enable a Radeon R9 270, which isn’t OOB. The device ID of this card is 0x6811.First you have to find a similar graphics card using the same chipset which is supported OOB (have a look in the chart above). In our example this could be a Radeon R9 270X (0x6810).The full ID of this graphics card consists of the device ID and the vendor ID (always 0x1002). So the full R9 270X ID is 0x68101002.In Clover, you have to set:- FakeID / ATI = full ID (here: 0x68101002)- Inject / ATI = true- FBName = framebuffer name (here:Futomaki [enter some random garbage in case you don’t want to use a framebuffer, the driver will default to RadeonFramebuffer])- FixDisplay = trueOn the next boot, you should have full acceleration with your unsupported GPU!If it didn’t work, you can verify the ID by looking in the System Profiler -> Graphics section. If the device ID listed there didn’t change expectedly, you might have a typo somewhere.AMD Radeon drivers areprovided by Apple as part of their regular system updates. You might find some dubious patched kexts in the internet which might be binary compatible to your OS if you’re lucky, but I’d advice against using those. Keep your system up to date and you’ll always have the latest drivers. Understand what your problems are and apply the patches yourself with Clover so they’ll survive system updates.On the one hand this policy is a good thing, because you don’t have any hassle comparable to the Nvidia Web Drivers when a new OS X update arrives. On the other hand, it’s totally up to Apple when they include some new Radeons and which they choose to be supported OOB. Nvidia is usually a lot faster updating their Web Drivers to support new GPUs.First, make sure all ports work with just one screen attached. If you want to use 3 or more displays, remember that you'll need native DisplayPort screens orDisplayPort adaptors (see http://support.amd.com/en-us/recommended/eyefinity-adapters )!If you're using RadeonFramebuffer, try to inject a matching framebuffer (and vice versa).Nope, not at all. Your Hackintosh isn’t able to utilize a MacPro EFI, no matter if your MoBo has a legacy BIOS or a modern UEFI, so it will fall back to the legacy vBIOS on your card either way. It won’t change anything.Most certainly the driver didn't load because the device ID of your card isn't in their (check compatibility chart above). Spoof your device ID with Clover to match a similar, supported card or add your device ID to both kexts (not recommended).This just means that you're not injecting anything GPU related, no need to worry. Read the Framebuffer section in chapter 1 again. Other common placeholder strings are "HD 8xxx" or "R9 xxx".The vBIOS Database from TechPowerUp (Link: http://www.techpowerup.com/vgabios/ ) is always a good start. If you've already installed the card in your machine you might also consult the System Profiler.As of today, there have been no significant driver changes in El Capitan compared to Yosemite.Metal is supported starting with HD 7xxx series. Older cards are still supported, just without Metal.It's necessary to edit AGDP, details are in post #1000 . Thanks @LostVector for finding that out!You have some additional information which you think should be included here? Found a mistake or an unclear explanation? Feel free to leave some feedback here!