-Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Disabling unsupported GPUs(Desktops)
So this is mainly needed for GPUs that are not supported in macOS, mainly this will be Nvidia users who wish to pair an AMD GPU for macOS use. While WhateverGreen does support the boot-arg -wegnoegpu, this only works when running on iGPU so for the rest of us we'll need to make an SSDT.
Finding the ACPI Path of the GPU
-To find the PCI path of a GPU is fairly simple, best way to find it is running Windows:
+To find the PCI path of a GPU is fairly simple, best way to find it is running Windows:
- Open Device Manager
- Select Display Adapters, then right click your GPU and select Properties @@ -448,8 +481,8 @@
The second "ACPI" is what we care about:
ACPI(_SB_)#ACPI(PC02)#ACPI(BR2A)#ACPI(PEGP)#PCI(0000)#PCI(0000)
Now converting this to an ACPI path is quite simple, remove the #ACPI and #PCI(0000):
-Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Fixing Embedded Controller (Desktop)
What we'll be doing is hiding our actual EC and creating a fake Embedded Comtroller for macOS to play with.
To find out what EC you have, open your decompiled DSDT and search for PNP0C09. This should give you a result like this:
As you can see our PNP0C09 is found within the Device (EC0) meaning this is the device we want to hide from macOS(others may find H_EC, ECDV, etc, everyone's systems will be different). Now grab our SSDT-EC and uncomment the EC0 function(remove the /* and */ around it):
- SSDT-EC-USBX
-
@@ -450,7 +483,7 @@
External (_SB_.PCI0.LPCB.EC0, DeviceObj) <- Rename this
Scope (\_SB.PCI0.LPCB.EC0) <- Rename this
- {
+ {
Method (_STA, 0, NotSerialized) // _STA: Status
{
If (_OSI ("Darwin")) // Darwin = macOS
@@ -467,12 +500,12 @@ External (_SB_.PCI0.LPCB.EC0, DeviceObj) <- Rename this
- Finding the LowPinCount path:
-
+
- Finding the LowPinCount path:
- Intel: Search
Name (_ADR, 0x001F0000) - AMD: Search
Name (_ADR, 0x00140003)
- - Intel: Search
- Finding the PCI path:
-
+
- Finding the PCI path:
- Intel: Search
PNP0A08(If multiple show up, use the first one) - AMD: Assume
PCI0(most AMD DSDTs don't declare the PCI path directly)
-What happens if no
PNP0C09show up?So what this means: EC faking is not mandatory for booting, instead only recommended for proper USB power.
+So what this means: EC faking is not mandatory for booting, instead only recommended for proper USB power.
So how do I make an SSDT without an EC? Well we'll only create a Fake EC for macOS to play with, this allows for AppleBusPowerController to load and handle our USB properly. To make the actual SSDT, its almost plug and play as no uncommenting needed. The main thing that needs to be changed:
- LowPinCount path @@ -500,18 +533,18 @@ External (_SB_.PCI0.LPCB.EC0, DeviceObj) <- Rename this
We want to make sure the SSDT hooks into our DSDT correctly so we need to make sure the ACPI path is correct:
-
-
- Finding the LowPinCount path:
-
+
- Finding the LowPinCount path:
- Intel: Search
Name (_ADR, 0x001F0000) - AMD: Search
Name (_ADR, 0x00140003)
- - Intel: Search
- Finding the PCI path:
-
+
- Finding the PCI path:
- Intel: Search
PNP0A08(If multiple show up, use the first one) - AMD: Assume
PCI0(most AMD DSDTs don't declare the PCI path directly)
- Intel: Search
+
Once you find out, change
PCI0.LPCBto your correct path:Scope (\_SB.PC00.LPC0) <- Rename this { @@ -587,7 +620,7 @@ The reason for this is that the real EC is considered disabled already. diff --git a/Laptops/backlight.html b/Laptops/backlight.html index 7db0bbe..aa57a9a 100644 --- a/Laptops/backlight.html +++ b/Laptops/backlight.html @@ -385,6 +385,39 @@ + +- Misc
+ + + +- + + + + + Troubleshooting + + + + + +
+ +- + + + + + Contributing + + + + + +
+ + + @@ -429,7 +462,7 @@-
Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Fixing Backlight
So what this SSDT does is create a PNLF device for macOS to play with, specifically one with a hardware ID of
@@ -451,7 +484,7 @@APP0002. WhateverGreen will handle the rest of the work- Note some GPUs may be hiding under "BIOS device name"
+- Misc
+ + + +- + + + + + Troubleshooting + + + + + +
+ +- + + + + + Contributing + + + + + +
+ + + @@ -429,7 +462,7 @@-
Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Disabling laptop dGPUs
So with laptops, we can hide the dGPU from macOS with the little boot-arg called
@@ -452,7 +485,7 @@-wegnoegpufrom WhateverGreen. But one small problem, the dGPU is still pulling power draining your battery slowly. We'll be going over 2 methods for disabling the dGPU in a laptop:- Nvidia dGPU:
\_SB.PCI0.PEG0.PEGP- AMD dGPU:
\_SB.PCI0.PEGP.DGFX - Finding the PCI path:
+Now with that, we'll need to change the ACPI path in the SSDT. Main sections:
@@ -530,7 +563,7 @@ External (_SB_.PCI0.PEG0.PEGP._PS3, MethodObj) // dGPU ACPI Path diff --git a/Laptops/laptop-ec.html b/Laptops/laptop-ec.html index 9ce53e8..d62f27e 100644 --- a/Laptops/laptop-ec.html +++ b/Laptops/laptop-ec.html @@ -385,6 +385,39 @@ + +External(_SB.PCI0.PEG0.PEGP._OFF, MethodObj) - Finding the LowPinCount path:
- Misc + + + +
- + + + + + Troubleshooting + + + + + + + +
- + + + + + Contributing + + + + + + + + + @@ -429,12 +462,12 @@
- Misc + + + +
- + + + + + Troubleshooting + + + + + + + +
- + + + + + Contributing + + + + + + + + + @@ -429,14 +462,14 @@
- Misc + + + +
- + + + + + Troubleshooting + + + + + + + +
- + + + + + Contributing + + + + + + + + + @@ -429,10 +462,10 @@
- macOS Compiling and Decompiling
- Windows Compiling and Decompiling @@ -446,12 +479,12 @@
- If compiled .aml file is provided, a decompiled .dsl file will be given and vice versa.
- If compiled .aml file is provided, a decompiled .dsl file will be given and vice versa.
- Misc + + + +
- + + + + + Troubleshooting + + + + + + + +
- + + + + + Contributing + + + + + + + + + @@ -429,7 +462,7 @@
-
Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Fixing Embedded Controller (Laptop)
To fix the ECs found in laptops, we'll be renaming them to look like the ones macOS expects. The reason for this is that many laptops break when you turn off their EC with an SSDT. So this is why we can't use the fancy SSDTTime to make a patch for us.
To find out what EC you have, open your decompiled DSDT and search for
-PNP0C09. This should give you a result like this:
+
As you can see our
PNP0C09is found within theDevice (EC0)meaning this is the device we want to rename.What happens if multiple
@@ -449,9 +482,9 @@PNP0C09show up
-What if my main
PNP0C09device is already calledDevice (EC)?Mainly relevant for Lenovo and a few other OEMs, when this happens that means that your Embedded Controller is ready to use in macOS! Do make sure that this
+Device (EC)is actually your main EC and not a secondary one.Mainly relevant for Lenovo and a few other OEMs, when this happens that means that your Embedded Controller is ready to use in macOS! Do make sure that this
Device (EC)is actually your main EC and not a secondary one.And please verify that the DSDT hasn't already been patched by Clover or OpenCore, please dump it without booting either of them to be sure or triple check that there aren't any EC renames in your config already
-
+
For those having issues, you can also check
Device Manager -> Embedded Controller -> BIOS device Name. Widows will only report the main EC so will save you some headache on thatApplying your EC patch
As you can see from the table below, we'll be renaming our EC listed in the DSDT. Do note you cannot just throw random renames without checking which is the main EC first, as this can cause actual damage to your laptop.
@@ -486,7 +519,7 @@ -Inside your config:
+Inside your config
-@@ -523,7 +556,7 @@
+
-
Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Fixing Trackpads
This SSDT is used to force enable our GPI0 for VoodooI2C to connect onto.
With most modern laptop DSDTs, there's a variable called
GPENorGPHDwhich are used for setting the status of the GPI0 device. For us, we want to enable the device.Finding our GPI0
So first things we need to do is find out what variable is used to enable our GPI0 device, lets open up our decompiled SSDT and search for
-Device (GPI0). Should give you a desult similar to this:
+
What we care about from this is the
_STAmethod:Method (_STA, 0, NotSerialized) { @@ -450,8 +483,8 @@What we want is for this to always return
0x0Fwhen booting macOS, so we want to make an SSDT that will returnGPHD == Zeroin macOS.NOTE that you may have the other way around where GPHD needs to be set as
Oneto return0x0F. And your device name may also be different, don't throw random SSDTs in thinking it'll workOnce you found the variable and what it should be set to, grab a copy of SSDT-GPI0.dsl and make the required edits. Then clean up with compiling it
-More examples:
-
+
More examples
+
With this example, we can see that we need both
SBRGandGPENto returnOne. If only one is present, it'll create some issues so in our SSDT we'll want to have both of them returnOne:DefinitionBlock("", "SSDT", 2, "ACDT", "GPI0", 0) { @@ -510,7 +543,7 @@ diff --git a/Manual/compile.html b/Manual/compile.html index b27cfca..288cd9d 100644 --- a/Manual/compile.html +++ b/Manual/compile.html @@ -385,6 +385,39 @@ + +-
Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Compiling and decompiling ACPI Tables
-See General Troubleshooting if you have dumping/compiling errors
+See Troubleshooting if you have dumping/compiling errors
+
Windows
Compiling and decompiling on windows is fairly simple though, you will need iasl.exe and Command Prompt:
-path/to/iasl.exe path/to/DSDT.aml
+
-
Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Getting a copy of our DSDT
So to start, we'll need to get a copy of your DSDT from your firmware. The easiest way is grabbing the DSDT.aml SSDTTime dumped for us earlier but here are some other options:
@@ -457,7 +490,7 @@ - Intel: Search
If OpenCore is having issues running acpidump, you can call it from the shell with OpenCoreShell(reminder to add to both
+EFI/OC/Toolsand in your config underMisc -> Tools):If OpenCore is having issues running acpidump, you can call it from the shell with OpenShell(reminder to add to both
EFI/OC/Toolsand in your config underMisc -> Tools):shell> fs0: // replace with proper drive fs0:\> dir // to verify this is the right directory @@ -513,7 +546,7 @@ fs0:\EFI\OC\Tools> acpidump.efi -b -n DSDT -z diff --git a/Universal/awac.html b/Universal/awac.html index 183c988..5cccec7 100644 --- a/Universal/awac.html +++ b/Universal/awac.html @@ -385,6 +385,39 @@ + +- Misc
+ + + +- + + + + + Troubleshooting + + + + + +
+ +- + + + + + Contributing + + + + + +
+ + + @@ -429,7 +462,7 @@-
Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Fixing System Clocks
For Intel 300 series chipsets and newer, this also includes X299 refreshes and Icelake laptops. Common machines:
@@ -439,17 +472,17 @@- B365
- H310
- H370
-- Z370 (Gigabtye and AsRock boards with newer BIOS versions)
+- Z370 (Gigabyte and AsRock boards with newer BIOS versions)
- Z390
- 400 series (Cometlake)
- 495 series (Icelake)
- Finding the PCI path:
So on newer Intel 300 series motherboards, manufactueres started pushing for a new type of system clock: AWAC( A Weird Ass Clock). One small problem, macOS doesn't know what the hell an AWAC clock is instead only familiar with the legacy RTC(Real Time Clock). So we need to figure out how to bring back the old clock, thats where
+SSDT-AWACandSSDT-RTC0come in:So on newer Intel 300 series motherboards, manufactures started pushing for a new type of system clock: AWAC( A Weird Ass Clock). One small problem, macOS doesn't know what the hell an AWAC clock is instead only familiar with the legacy RTC(Real Time Clock). So we need to figure out how to bring back the old clock, thats where
SSDT-AWACandSSDT-RTC0come in:-
- Disables AWAC and enables RTC -
- In your DSDT, there's a varaible called
STASused for holding either aOneorZeroto determine which clock to use(Onefor RTC andZerofor AWAC)
+ - In your DSDT, there's a variable called
STASused for holding either aOneorZeroto determine which clock to use(Onefor RTC andZerofor AWAC)
- @@ -467,11 +500,11 @@
- If nothing shows up then no need to continue and no need for this SSDT as you have no AWAC. Otherwise, continue on!
- If you get a result then you have an
AWACsystem clock present, then continue with the next search forSTAS:
+
As you can see we found the
STASin our DSDT, this means we're able to force enable our Legacy RTC. In this case, SSDT-AWAC will be used As-Is with no modifications required. Just need to compile. Note thatSTASmay be found in AWAC first instead of RTC like in our example, this is normal.For systems where no
STASshows up but you do haveAWAC, you can use SSDT-RTC0 though you will need to check the naming of LPC in your DSDTBy default the SSDT uses
-LPCB, you can check what your system uses by just searching forName (_ADR, 0x001F0000). This address is used for Low Pin Count devices(LPC) but the device name can vary betweenLPCB,LBCorLBC0:
+
Now you're ready to compile the SSDT!
@@ -516,7 +549,7 @@ diff --git a/Universal/irq.html b/Universal/irq.html index 7b434d8..a52c059 100644 --- a/Universal/irq.html +++ b/Universal/irq.html @@ -385,6 +385,39 @@ + + - Finding the LowPinCount path:
- Misc + + + +
- + + + + + Troubleshooting + + + + + + + +
- + + + + + Contributing + + + + + + + + + @@ -429,7 +462,7 @@
- Misc + + + +
- + + + + + Troubleshooting + + + + + + + +
- + + + + + Contributing + + + + + + + + + @@ -429,7 +462,7 @@
But looking back at the screenshot above we notice something, our ACPI path is different:
PC00.LPC0vsPCI0.LPCB. This is very important especially when you're dealing with Intel consumer vs Intel HEDT vs AMD,PC00.LPC0is common on Intel HEDT whilePCI0.SBRGis common on AMD. And they even come with name variation such asEC0,H_EC,PGECandECDV, so there can't be a one size fits all SSDT, always verify your path and device. DO NOT ASSUME.-
-
-
Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Fixing IRQ Conflicts
So you miss having those fancy hot-patches from Clover like FixIPIC, FixTMR, FixRTC, FixHPET, etc
@@ -477,7 +510,7 @@ diff --git a/Universal/nvram.html b/Universal/nvram.html index 276a1cb..fc381f6 100644 --- a/Universal/nvram.html +++ b/Universal/nvram.html @@ -385,6 +385,39 @@ + +-
Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Fixing NVRAM
This SSDT is required for all "true" 300 series motherboards and newer(Z370 is excluded), it specifically brings back NVRAM support and requires very little configuration for the end user.
@@ -453,7 +486,7 @@ - Finding the LowPinCount path:
Now you're ready to compile the SSDT!
@@ -498,7 +531,7 @@ diff --git a/Universal/plug.html b/Universal/plug.html index f584e07..299102f 100644 --- a/Universal/plug.html +++ b/Universal/plug.html @@ -385,6 +385,39 @@ + +-Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Fixing Power Management
CPU naming is fairly easy to figure out as well, open your decompiled DSDT and search for Processor. This should give you a result like this:
As we can see, the first processor in our list is PR00. This is what we'll be applying the plugin-type=1 property too. Now grab SSDT-PLUG and replace the default CPU0 with our PR00. There's a couple things to note:
- There's 2 mentions of CPU0 to change @@ -441,9 +474,9 @@
So in our final example, we'd have _SB_.PR00 and \_SB.PR00
There are also some edge cases with Processor, specifically on HEDT series like X79, X99 and X299. This edge case is that the ACPI path is much longer and not so obvious:
If we then search for instances of CP00 we find that it's ACPI path is SB.SCK0.CP00:
So for this X299 board, we'd change \_PR.CPU0 with \_SB.SCK0.CP00 and External (_PR_.CPU0, ProcessorObj) with External (_SB_.SCK0.CP00, ProcessorObj)
External (_PR_.CPU0, ProcessorObj) <- Rename this
@@ -502,7 +535,7 @@ Scope (\_PR.CPU0) <- Rename this
diff --git a/Universal/smbus.html b/Universal/smbus.html
index eec66f9..2dad0ae 100644
--- a/Universal/smbus.html
+++ b/Universal/smbus.html
@@ -385,6 +385,39 @@
+
+ Misc
+
+
+
+
+
+
+
+
+ Troubleshooting
+
+
+
+
+
+
+
+
+
+
+
+
+ Contributing
+
+
+
+
+
+
+
+
+
@@ -429,7 +462,7 @@
-Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Fixing SMBus support
This section of the guide refers to fixing AppleSMBus support in macOS, what is AppleSMBus? Well this mainly handles the System Management Bus, which has many functions like:
@@ -468,8 +501,8 @@ Scope (_SB.PCI0) <- Rename this
Device (_SB.PCI0.SBUS.BUS0) <- Rename this
To find the correct pathing for your devices, grab Hackintool (Github link) and head to the PCI tab:
-
Look for the SMBus device under Subclass, then look beside and you'll see the ACPI path(under IOReg Name). To convert , omit @...
+Look for the SMBus device under Subclass, then look beside and you'll see the ACPI path(under IOReg Name). To convert , omit @...
/PC00@0/SMBS@1F,4->PC00.SMBS
-Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Renaming GPUs
So this is mainly needed for GPUs that are not natively supported OOB due to their names, most commonly:
@@ -474,8 +507,8 @@ Buffer (0x04) -
-
The second "ACPI" is what we care about:
ACPI(_SB_)#ACPI(PC02)#ACPI(BR2A)#ACPI(PEGP)#PCI(0000)#PCI(0000)
Now converting this to an ACPI path is quite simple, remove the #ACPI and #PCI(0000):
-Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Cleanup
So you've made all your SSDTs but now there's one thing left: Adding them to Opencore
@@ -440,7 +475,7 @@Users of FixHPET will also need to merge oc_patches.plist into their config.plist
Steps to do this:
-
-
- Open both files, +
- Open both files,
- Delete the
ACPI -> Patchsection from config.plist - Copy the
ACPI -> Patchsection from patches.plist - Paste into where old patches were in config.plist @@ -472,11 +507,15 @@ - + + + + + @@ -484,7 +523,7 @@ diff --git a/images/Desktops/amd.png b/images/Desktops/amd.png new file mode 100644 index 0000000..5aa0254 Binary files /dev/null and b/images/Desktops/amd.png differ diff --git a/images/Desktops/lpc.png b/images/Desktops/lpc.png new file mode 100644 index 0000000..7493c52 Binary files /dev/null and b/images/Desktops/lpc.png differ diff --git a/images/Desktops/nvidia.png b/images/Desktops/nvidia.png new file mode 100644 index 0000000..b517e1f Binary files /dev/null and b/images/Desktops/nvidia.png differ diff --git a/images/Desktops/pnp.png b/images/Desktops/pnp.png new file mode 100644 index 0000000..cb13980 Binary files /dev/null and b/images/Desktops/pnp.png differ diff --git a/images/Laptops/laptop-ec-md/config.png b/images/Laptops/laptop-ec-md/config.png new file mode 100644 index 0000000..fd07fa1 Binary files /dev/null and b/images/Laptops/laptop-ec-md/config.png differ diff --git a/images/Laptops/laptop-ec-md/dsdt-pnp.png b/images/Laptops/laptop-ec-md/dsdt-pnp.png new file mode 100644 index 0000000..cb13980 Binary files /dev/null and b/images/Laptops/laptop-ec-md/dsdt-pnp.png differ diff --git a/images/Laptops/ec.png b/images/Laptops/laptop-ec-md/ec.png similarity index 100% rename from images/Laptops/ec.png rename to images/Laptops/laptop-ec-md/ec.png diff --git a/images/Laptops/trackpad-md/gpi0-2.png b/images/Laptops/trackpad-md/gpi0-2.png new file mode 100644 index 0000000..4266251 Binary files /dev/null and b/images/Laptops/trackpad-md/gpi0-2.png differ diff --git a/images/Laptops/trackpad-md/gpi0.png b/images/Laptops/trackpad-md/gpi0.png new file mode 100644 index 0000000..53e36ca Binary files /dev/null and b/images/Laptops/trackpad-md/gpi0.png differ diff --git a/images/Manual/compile-md/macos-compile.png b/images/Manual/compile-md/macos-compile.png new file mode 100644 index 0000000..1950a1e Binary files /dev/null and b/images/Manual/compile-md/macos-compile.png differ diff --git a/images/Manual/compile-md/windows-compile.png b/images/Manual/compile-md/windows-compile.png new file mode 100644 index 0000000..f86f9c3 Binary files /dev/null and b/images/Manual/compile-md/windows-compile.png differ diff --git a/images/Universal/awac-md/lpc.png b/images/Universal/awac-md/lpc.png new file mode 100644 index 0000000..4c3e261 Binary files /dev/null and b/images/Universal/awac-md/lpc.png differ diff --git a/images/Universal/awac-md/stas.png b/images/Universal/awac-md/stas.png new file mode 100644 index 0000000..d92628a Binary files /dev/null and b/images/Universal/awac-md/stas.png differ diff --git a/images/Universal/nvram-md/lpc.png b/images/Universal/nvram-md/lpc.png new file mode 100644 index 0000000..7493c52 Binary files /dev/null and b/images/Universal/nvram-md/lpc.png differ diff --git a/images/Universal/plug-md/cp00.png b/images/Universal/plug-md/cp00.png new file mode 100644 index 0000000..da216b2 Binary files /dev/null and b/images/Universal/plug-md/cp00.png differ diff --git a/images/Universal/plug-md/processor-2.png b/images/Universal/plug-md/processor-2.png new file mode 100644 index 0000000..b00cbfc Binary files /dev/null and b/images/Universal/plug-md/processor-2.png differ diff --git a/images/Universal/plug-md/processor.png b/images/Universal/plug-md/processor.png new file mode 100644 index 0000000..6313fce Binary files /dev/null and b/images/Universal/plug-md/processor.png differ diff --git a/images/Universal/smbus-md/pci.png b/images/Universal/smbus-md/pci.png new file mode 100644 index 0000000..765bfdc Binary files /dev/null and b/images/Universal/smbus-md/pci.png differ diff --git a/images/ssdt-easy-md/ssdttime.png b/images/ssdt-easy-md/ssdttime.png new file mode 100644 index 0000000..a4d3766 Binary files /dev/null and b/images/ssdt-easy-md/ssdttime.png differ diff --git a/images/troubleshooting-md/decompile-error.png b/images/troubleshooting-md/decompile-error.png new file mode 100644 index 0000000..8fa0f8c Binary files /dev/null and b/images/troubleshooting-md/decompile-error.png differ diff --git a/images/troubleshooting-md/invalid-parse.png b/images/troubleshooting-md/invalid-parse.png new file mode 100644 index 0000000..04a6807 Binary files /dev/null and b/images/troubleshooting-md/invalid-parse.png differ diff --git a/index.html b/index.html index e227385..8e53efa 100644 --- a/index.html +++ b/index.html @@ -383,6 +383,39 @@ + +
- Misc + + + +
- + + + + + Troubleshooting + + + + + + + +
- + + + + + Contributing + + + + + + + + + @@ -427,7 +460,7 @@
- SSDT-EC-USBX -
- Misc + + + +
- + + + + + Troubleshooting + + + + + + + +
- + + + + + Contributing + + + + + + + + + @@ -429,7 +462,7 @@
-Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
Getting started with ACPI
What SSDTs do each platform need
Please see the specific ACPI section of your config.plist, all SSDTs needed are covered there with a breif explainer. But here's a very quick TL;DR:
Desktop
-Ivy Bridge:
- -Haswell:
- -Skylake:
- -Kabylake:
- -Coffeelake:
- -AMD:
--
-
| SSDT | +IvyBridge | +Haswell/Broadwell | +Skylake | +KabyLake | +CoffeeLake | +CometLake | +AMD(15/16/17h) | +
|---|---|---|---|---|---|---|---|
| CPU | +CPU-PM(Run in Post-Install) | +SSDT-PLUG | +SSDT-PLUG | +SSDT-PLUG | +SSDT-PLUG | +SSDT-PLUG | +N/A | +
| EC | +SSDT-EC | +SSDT-EC | +SSDT-EC-USBX | +SSDT-EC-USBX | +SSDT-EC-USBX | +SSDT-EC-USBX | +SSDT-EC-USBX | +
| AWAC | +N/A | +N/A | +N/A | +N/A | +SSDT-AWAC | +SSDT-AWAC | +N/A | +
| NVRAM | +N/A | +N/A | +N/A | +N/A | +SSDT-PMC | +SSDT-PMC | +N/A | +
High End Desktop
-Haswell-E:
- -Broadwell-E:
- -Skylake-X:
- +| SSDT | +IvyBridge-E | +Haswell-E | +Broadwell-E | +Skylake-X | +
|---|---|---|---|---|
| CPU | +CPU-PM(Run in Post-Install) | +SSDT-PLUG | +SSDT-PLUG | +SSDT-PLUG | +
| EC | +SSDT-EC | +SSDT-EC | +SSDT-EC | +SSDT-EC-USBX | +
| AWAC | +N/A | +N/A | +N/A | +SSDT-AWAC | +
Laptop
-Ivy Bridge:
- -Haswell:
- -Broadwell:
- -Skylake:
- -Kabylake:
- -Coffeelake(8th Gen):
- -Coffeelake(9th Gen):
- +| SSDT | +IvyBridge | +Haswell | +Broadwell | +Skylake | +KabyLake | +CoffeeLake(8thGen) | +Coffee/Comet/IceLake(9/10thGen) | +
|---|---|---|---|---|---|---|---|
| CPU | +CPU-PM(Run in Post-Install) | +SSDT-PLUG | +SSDT-PLUG | +SSDT-PLUG | +SSDT-PLUG | +SSDT-PLUG | +SSDT-PLUG | +
| EC | +EC ACPI Patch | +EC ACPI Patch | +EC ACPI Patch | +EC ACPI Patch + SSDT-USBX | +EC ACPI Patch + SSDT-USBX | +EC ACPI Patch + SSDT-USBX | +EC ACPI Patch + SSDT-USBX | +
| Backlight | +SSDT-PNLF | +SSDT-PNLF | +SSDT-PNLF | +SSDT-PNLF | +SSDT-PNLF | +SSDT-PNLF-CFL | +SSDT-PNLF-CFL | +
| I2C TrackPad | +SSDT-GPI0 | +SSDT-GPI0 | +SSDT-GPI0 | +SSDT-GPI0 | +SSDT-GPI0 | +SSDT-GPI0 | +SSDT-GPI0 | +
| AWAC | +N/A | +N/A | +N/A | +N/A | +N/A | +N/A | +SSDT-AWAC | +
| NVRAM | +N/A | +N/A | +N/A | +N/A | +N/A | +N/A | +SSDT-PMC | +
| IRQ Patch | +IRQ SSDT | +IRQ SSDT | +IRQ SSDT | +N/A | +N/A | +N/A | +N/A | +
-Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
SSDTs: The easy way
So here we'll be using a super simple tool made by CorpNewt: SSDTTime
@@ -462,14 +495,14 @@-
-
- This is included on sample SSDTs but SSDTTime only makes the SSDT-EC part, Skylake and newer users can grab a prebuilt here: SSDT-USBX.aml +
- This is included on sample SSDTs but SSDTTime only makes the SSDT-EC part, Skylake and newer users can grab a prebuilt here: SSDT-USBX.aml
For users who don't have all the options avaible to them in SSDTTime, you can follow the "SSDTs: The long way" section. You can still use SSDTTime for SSDTs it support for you.
Running SSDTTime
Run the SSDTTime.bat file as Admin on the target machine and you should see something like this:
What are all these options?:
1. FixHPET - Patch out IRQ Conflicts-
@@ -493,7 +526,7 @@
- Misc + + + +
- + + + + + Troubleshooting + + + + + + + +
- + + + + + Contributing + + + + + + + + + @@ -429,7 +462,7 @@
-What about USBX?
For Skylake and newer plus AMD, you can grab a prebuilt file here: SSDT-USBX.aml. This file is plug and play and requires no device configuration, do not use on Broadwell and older.
+For Skylake and newer plus AMD, you can grab a prebuilt file here: SSDT-USBX.aml. This file is plug and play and requires no device configuration, do not use on Broadwell and older.
Troubleshooting note: See General Troubleshooting if you're having issues running SSDTTime
Adding to OpenCore
Don't forget that SSDTs need to be added to Opencore, reminder that .aml is complied, .dsl is code. Add only the .aml file:
@@ -553,7 +586,7 @@ diff --git a/ssdt-long.html b/ssdt-long.html index a7cff2f..ea8b196 100644 --- a/ssdt-long.html +++ b/ssdt-long.html @@ -385,6 +385,39 @@ + +-
Last modified: Wed Apr 15 2020 14:14:15 GMT+0000 (Coordinated Universal Time)
+Last modified: Sat Apr 18 2020 19:30:16 GMT+0000 (Coordinated Universal Time)
SSDTs: The long way
Well sadly some things are not handled by SSDTTime, well have no fear as making SSDTs is super easy. The basic process:
@@ -483,7 +516,7 @@