Beginner’s guide to patch DSDT in Hackintosh

After installing macOS the first thing you need to do is patching dsdt because patching dsdt eliminates so many errors. But patching dsdt is not an easy task and the guides available on the internet are so difficult to understand even I was unable to understand after 4-5 times. So I decided to write a noob friendly guide which will help the beginners which are unable to understand the tutorials and confused about what to do. This guide is not for specific problem solving but after reading this you will have a clear idea about dsdt patching and will be able to patch them according to your needs. So let gets started!

1. Extracting the ACPI files.

There are 3 methods of extracting ACPI files of your pc but here I have only used 1 method because it is very easy and has less chance of corruption

Extracting ACPI files through this method is very simple, all you have to do is press F4 while in clover after startup. The ACPI files will be available in EFI/clover/ origin/.

“Diskutil list” in terminal to see the EFI drive

After you log in to your Hackintosh open the terminal and type ‘diskutil mount diskXsXX’ then head over to the EFI partition you just mounted. (Note: replace all the X in diskXsXX with your EFI disk number, as you can see in the above image mine is disk0s4).

Or you can mount the EFI partition in just one click using clover configurator.

2. Preparing tools.

The ACPI files that you have extracted through clover cannot be patched directly so we have to first disassemble it and then patch it. So to patch them you will IASL which can be downloaded from here.

After downloading IASL, copy and paste these command in terminal:-

cd ~/Downloads unzip 
sudo cp iasl /usr/bin

3. Disassembling the ACPI files.

Now the time has come to disassemble the files. We will disassemble the ACPI using refs.txt, it can be also done without using refs.txt but it removes some error from the disassembled ACPI files. Now open TextEdit and copy paste the following:-

External(MDBG, MethodObj, 1)
External(_GPE.MMTB, MethodObj,0)
External(_SB.PCI0.LPCB.H_EC.ECWT, MethodObj, 2)
External(_SB.PCI0.LPCB.H_EC.ECRD, MethodObj, 1)
External(_SB.PCI0.LPCB.H_EC.ECMD, MethodObj, 1)
External(_SB.PCI0.PEG0.PEGP.SGPO, MethodObj, 2)
External(_SB.PCI0.GFX0.DD02._BCM, MethodObj, 1)
External(_SB.PCI0.SAT0.SDSM, MethodObj, 4)
External(_GPE.VHOV, MethodObj, 3)
External(_SB.PCI0.XHC.RHUB.TPLD, MethodObj, 2)

And save it as refs.txt then move the file to origins folder Or just copy the above code and execute the following code in terminal:-

Cd desktop

a refs.txt file will be created on your desktop.

Now run the command in terminal:-

iasl -da -dl -fe refs.txt DSDT.aml SSDT*.aml
Disassembled ACPI files

The DSDT and all the SSDT files will be disassembled

Also read: How to upgrade Hackintosh to macOS Mojave

Head over to the folder containing ACPI files and delete those SSDT files in which there is x in the end, example- SSDT-5x.dsl. These are dynamic files and we don’t need them.

4. Error fixing.

After the extracted ACPI files have been dissembled the files are not error-free. DSDT and some SSDTs contain some error which will cause instability and even may prevent the OS from loading, So fixing those errors is very important and very easy.

Download patchmatic from here and open downloads folder then launch terminal and type:

cp patchmatic /usr/local/bin/patchmatic

After done download the latest version of maciASL from here and open it then head over to preferences of maciASL and add this :

adding patches to maciASL

to sources and name it patches. Then open your DSDT.dsl and press compile, it will give you some error see the line of error and click patch then find the suitable patch for the error. If you are unable to identify the error then comment below here.

5. Applying some common patch.

There are some patch that you should apply to your DSDT, these patches are not compulsory to apply but can be applied for better stability. However, if any unusual patches are applied without needing, it may cause problems or kernel panic. The patches are:

"Fix _WAK Arg0 v2"
"HPET Fix"
"IRQ Fix"
"RTC Fix"
"OS Check Fix"
"Fix Mutex with non-zero SyncLevel".

(Note: The above patches will not resolve any specific problem of your Hackintosh)

After the patching is done don’t forget to place the patched dsdt into EFI/clover/patched/ otherwise it will not load.

Your basic DSDT patching is now done if you face any problem comment down below.

This guide is just a simplified version of this guide for better understanding.

9 thoughts on “Beginner’s guide to patch DSDT in Hackintosh”

  1. Easy to read and excellent guide for us noobs. Questions

    Can we extract the files after we have already installed osx?

    Irq is for audio, right?


  2. Hi there, thank for this post! I am half way through this. First, I think there is a mistake in the address for the patches. Should be :

    Then I got 7 error, and none of them are recognize (after press ion patch the before and after are empty). Any advice? This is the report:

    iASLRtXxxg.dsl(48) : error 6126 – syntax error, unexpected PARSEOP_EXP_MULTIPLY
    iASLRtXxxg.dsl(66) : error 6126 – Invalid character (.), expecting ASL keyword or name
    iASLRtXxxg.dsl(66) : error 6126 – syntax error, unexpected PARSEOP_EXP_MULTIPLY, expecting PARSEOP_CLOSE_PAREN
    iASLRtXxxg.dsl(6948) : error 6126 – syntax error, unexpected PARSEOP_SCOPE
    iASLRtXxxg.dsl(6953) : error 6126 – syntax error, unexpected PARSEOP_CLOSE_PAREN
    iASLRtXxxg.dsl(6956) : error 6126 – syntax error, unexpected PARSEOP_CLOSE_PAREN
    iASLRtXxxg.dsl(6967) : error 6126 – syntax error, unexpected PARSEOP_OPERATIONREGION, expecting $end and premature End-Of-File

Leave a Comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.