Add SSDT-RHUB support

SUMMARY.md

@@ -45,6 +45,9 @@
 * [NVRAM PMC](/Universal/nvram.md)
   * [Prebuilt](/Universal/nvram-methods/prebuilt.md)
   * [Manual](/Universal/nvram-methods/manual.md)
+* [USB RHUB](/Universal/rhub.md)
+  * [Prebuilt](/Universal/rhub-methods/prebuilt.md)
+  * [Manual](/Universal/rhub-methods/manual.md)
 * [IRQ Fix](/Universal/irq.md)
 * [GPU Spoof](/Universal/spoof.md)
 * [Fixing SMBus Support](/Universal/smbus.md)

Universal/awac-methods/manual.md

@@ -28,7 +28,7 @@ But to double check, next search for `PNP0B00`:
 
 And looks at that, we can in fact disable our AWAC and enable the RTC! If not skip to here: [RTC0 Method](#rtc0-method)
 
-Now it's as simple as grabbing [SSDt-AWAC.dsl]() and [compile](#compiling-the-ssdt), no changes needed You can also use the below SSDT to the same effect:
+Now it's as simple as grabbing [SSDT-AWAC.dsl](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-AWAC.dsl) and [compile](#compiling-the-ssdt), no changes needed You can also use the below SSDT to the same effect:
 
 * [SSDT-AWAC.aml](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/compiled/SSDT-AWAC.aml)
 

Universal/nvram.md

@@ -5,17 +5,15 @@
  
 ## What this SSDT does
 
-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.
+This SSDT is required for all "true" 300 series motherboards(Z370 is excluded), it specifically brings back NVRAM support and requires very little configuration for the end user.
 
 * B360
 * B365
 * H310
 * H370
 * Z390
-* 400 series (Cometlake)
-* 495 series (Icelake)
 
-Oddly enough, desktop Z490 boards **DO NOT** need this SSDT. NVRAM just works out of the box for most users, if there's issues though it's recommended to try this SSDT
+10th gen motherboards **do not** need this SSDT, NVRAM's native on these platforms.
 
 ## Methods to make this SSDT
 

Universal/rhub-methods/manual.md

@@ -0,0 +1,67 @@
+# Fixing USB: Manual
+
+* [Finding the ACPI path](#finding-the-acpi-path)
+* [Edits to the sample SSDT](#edits-to-the-sample-ssdt)
+* [Compiling the SSDT](#compiling-the-ssdt)
+* [Wrapping up](#wrapping-up)
+
+## Finding the ACPI path
+
+Finding the ACPI pathing is quite easy actually, first open your decompiled DSDT you got from [Dumping the DSDT](/Manual/dump.md) and [Decompiling and Compiling](/Manual/compile.md) with either maciASL(if in macOS) or any other text editor if in Windows or Linux(VSCode has an [ACPI extension](https://marketplace.visualstudio.com/items?itemName=Thog.vscode-asl) that can also help).
+
+Next, search for the `Device (RHUB)`
+
+You should get something like the following show up:
+
+![](/images/Universal/rhub-md/rhub-path.png)
+
+From the above, we can see that the full ACPI pathing for RHUB is `PCI0.XHC.RHUB`. If it's not as clear you can search for what those device paths are for your system:
+
+* Finding the PCI path:
+  * Search `PNP0A08` (If multiple show up, use the first one)
+* Finding XHCI path
+  * Search for `XHC`, `XHCI` and `XHC1`, and yours is whichever shows up.
+
+Now with the pathing, you can head here: [Edits to the sample SSDT](#edits-to-the-sample-ssdt)
+
+## Edits to the sample SSDT
+
+Now that we have our ACPI path, lets grab our SSDT and get to work:
+
+* [SSDT-RHUB.dsl](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/decompiled/SSDT-RHUB.dsl)
+
+By default, this uses `PCI0.XHC_.RHUB` for the pathing. you'll want to rename accordingly.
+
+Following the example from above, we'll be renaming it to `PCI0.XHC1.RHUB`:
+
+**Before**:
+
+```
+External (_SB_.PCI0.XHC_.RHUB, DeviceObj) <- Rename this
+
+Scope (_SB.PCI0.XHC_.RHUB) <- Rename this
+```
+
+![](/images/Universal/rhub-md/ssdt-before.png)
+
+Following the example pathing we found, the SSDT should look something like this:
+
+**After**:
+
+```
+External (_SB.PCI0.XHC1.RHUB, DeviceObj) <- Renamed
+
+Scope (_SB.PCI0.XHC1.RHUB) <- Renamed
+```
+
+![](/images/Universal/rhub-md/ssdt-after.png)
+
+## Compiling the SSDT
+
+ With the SSDT done, you're now [ready to compile the SSDT!](/Manual/compile.md)
+
+## Wrapping up
+
+Once you're done making your SSDT, either head to the next page to finish the rest of the SSDTs or head here if you're ready to warp up:
+
+* [**Cleanup**](/cleanup.md)

Universal/rhub-methods/prebuilt.md

@@ -0,0 +1,11 @@
+# Fixing USB: Prebuilt
+
+By far the easiest method, all you need to do is download the following file:
+
+* [SSDT-RHUB.aml](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/compiled/SSDT-RHUB.aml)
+
+## Wrapping up
+
+Once you're done making your SSDT, either head to the next page to finish the rest of the SSDTs or head here if you're ready to warp up:
+
+* [**Cleanup**](/cleanup.md)

Universal/rhub.md

@@ -0,0 +1,20 @@
+# Fixing USB
+
+* [What this SSDT does](#what-this-ssdt-does)
+* [Methods to make this SSDT](#methods-to-make-this-ssdt)
+
+## What this SSDT does
+
+So on 400 series motherboards, certain OEMs have broken the ACPI spec and this results in issues when booting into macOS. To fix this, we'll want to turn off the RHUB device and force macOS to manually rebuild the ports.
+
+The following platforms will require fixing:
+
+* Mobile Icelake(currently Dell and Lenovo are the 2 known with this issue)
+* Asus Z490 (Gigabyte and AsRock users are fine, whether MSI currently this is unknown)
+
+## Methods to make this SSDT
+
+For the RTC fix, there are 2 methods you can choose from:
+
+* [Prebuilt](/Universal/rhub-methods/prebuilt.md)
+* [Manual](/Universal/rhub-methods/manual.md)

extra-files/decompiled/SSDT-GPU-SPOOF.dsl

@@ -6,36 +6,31 @@ DefinitionBlock ("", "SSDT", 2, "DRTNIA", "AMDGPU", 0x00001000)
     External (_SB_.PCI0.PEG0.PEGP, DeviceObj)
 
 
-    Scope (\_SB.PCI0.PEG0.PEGP)
+    Scope (\_SB_.PCI0.PEG0.PEGP)
     {
-      
+        if (_OSI ("Darwin"))
-        Method (_DSM, 4, NotSerialized)  // _DSM: Device-Specific Method
         {
-          If (_OSI ("Darwin"))
+            Method (_DSM, 4, NotSerialized)  // _DSM: Device-Specific Method
-          {
-            Store (Package ()
             {
-                // Where we shove our FakeID
+                Local0 = Package (0x04)
-                "device-id",
-                Buffer (0x04)
                 {
-                    0xB0, 0x67, 0x00, 0x00
+                    // Where we shove our FakeID
-                },
+                    "device-id",
+                    Buffer (0x04)
+                    {
+                        0xB0, 0x67, 0x00, 0x00
+                    },
 
-                // Changing the name of the GPU reported, mainly cosmetic
+                    // Changing the name of the GPU reported, mainly cosmetic
-                "model",
+                    "model",
-                Buffer ()
+                    Buffer ()
-                {
+                    {
-                    "AMD Radeon R9 390"
+                        "AMD Radeon R9 390"
+                    }
                 }
-                        
+                DTGP (Arg0, Arg1, Arg2, Arg3, RefOf (Local0))
-             }, Local0)
+                Return (Local0)
-             DTGP (Arg0, Arg1, Arg2, Arg3, RefOf (Local0))
+            }
-             Return (Local0)
-           }
-          Else
-          {
-          }
         }
     }
     Scope (\_SB.PCI0)

extra-files/decompiled/SSDT-PLUG-DRTNIA.dsl

@@ -1,70 +1,18 @@
 /*
- * Intel ACPI Component Architecture
+ * Adds plugin-type property to the furst thread of your CPU, this is just a mirror
- * AML/ASL+ Disassembler version 20200214 (64-bit version)
+ * from OpenCorePkg 
- * Copyright (c) 2000 - 2020 Intel Corporation
- * 
- * Disassembling to symbolic ASL+ operators
- *
- * Disassembly of /Users/mykolagrymalyuk/Documents/GitHub/Getting-Started-With-ACPI/extra-files/compiled/SSDT-PLUG-DRTNIA.aml, Thu May 28 18:59:18 2020
- *
- * Original Table Header:
- *     Signature        "SSDT"
- *     Length           0x000002B5 (693)
- *     Revision         0x02
- *     Checksum         0xDD
- *     OEM ID           "DRTNIA"
- *     OEM Table ID     "CpuPlug"
- *     OEM Revision     0x00003000 (12288)
- *     Compiler ID      "INTL"
- *     Compiler Version 0x20190509 (538510601)
  */
 DefinitionBlock ("", "SSDT", 2, "DRTNIA", "CpuPlug", 0x00003000)
 {
-    External (_PR_.C000, ProcessorObj)
-    External (_PR_.CPU0, ProcessorObj)
-    External (_PR_.P000, ProcessorObj)
-    External (_PR_.PR00, ProcessorObj)
     External (_SB_.CPU0, ProcessorObj)
-    External (_SB_.PC00.LPC0, DeviceObj)
+    External (_PR_.CPU0, ProcessorObj)
-    External (_SB_.PC00.LPC0.EC0_, DeviceObj)
+    External (_PR_.CP00, ProcessorObj)
-    External (_SB_.PC00.LPC0.EC__, DeviceObj)
+    External (_PR_.C000, ProcessorObj)
-    External (_SB_.PC00.LPC0.ECDV, DeviceObj)
+    External (_PR_.P000, ProcessorObj)
-    External (_SB_.PC00.LPC0.H_EC, DeviceObj)
-    External (_SB_.PC00.LPC0.PGEC, DeviceObj)
-    External (_SB_.PCI0.LPC0, DeviceObj)
-    External (_SB_.PCI0.LPC0.EC0_, DeviceObj)
-    External (_SB_.PCI0.LPC0.EC__, DeviceObj)
-    External (_SB_.PCI0.LPC0.ECDV, DeviceObj)
-    External (_SB_.PCI0.LPC0.H_EC, DeviceObj)
-    External (_SB_.PCI0.LPC0.PGEC, DeviceObj)
-    External (_SB_.PCI0.LPC_, DeviceObj)
-    External (_SB_.PCI0.LPC_.EC0_, DeviceObj)
-    External (_SB_.PCI0.LPC_.EC__, DeviceObj)
-    External (_SB_.PCI0.LPC_.ECDV, DeviceObj)
-    External (_SB_.PCI0.LPC_.H_EC, DeviceObj)
-    External (_SB_.PCI0.LPC_.PGEC, DeviceObj)
-    External (_SB_.PCI0.LPCB, DeviceObj)
-    External (_SB_.PCI0.LPCB.EC0_, DeviceObj)
-    External (_SB_.PCI0.LPCB.EC__, DeviceObj)
-    External (_SB_.PCI0.LPCB.ECDV, DeviceObj)
-    External (_SB_.PCI0.LPCB.H_EC, DeviceObj)
-    External (_SB_.PCI0.LPCB.PGEC, DeviceObj)
-    External (_SB_.PCI0.PX40, DeviceObj)
-    External (_SB_.PCI0.PX40.EC0_, DeviceObj)
-    External (_SB_.PCI0.PX40.EC__, DeviceObj)
-    External (_SB_.PCI0.PX40.ECDV, DeviceObj)
-    External (_SB_.PCI0.PX40.H_EC, DeviceObj)
-    External (_SB_.PCI0.PX40.PGEC, DeviceObj)
-    External (_SB_.PCI0.SBRG, DeviceObj)
-    External (_SB_.PCI0.SBRG.EC0_, DeviceObj)
-    External (_SB_.PCI0.SBRG.EC__, DeviceObj)
-    External (_SB_.PCI0.SBRG.ECDV, DeviceObj)
-    External (_SB_.PCI0.SBRG.H_EC, DeviceObj)
-    External (_SB_.PCI0.SBRG.PGEC, DeviceObj)
     External (_SB_.PR00, ProcessorObj)
+    External (_PR_.PR00, ProcessorObj)
     External (_SB_.SCK0.CP00, ProcessorObj)
     External (_SB_.SCK0.PR00, ProcessorObj)
-
     Method (PMPM, 4, NotSerialized)
     {
         If ((Arg2 == Zero))

extra-files/decompiled/SSDT-RHUB-prebuilt.dsl

@@ -0,0 +1,57 @@
+/*
+ * Goal of this SSDT is to shut off the RHUb to force macOS into
+ * manually building ports when the ACPI is screwed up
+ */
+DefinitionBlock ("", "SSDT", 2, "DRTNIA", "RhubOff", 0x00001000)
+{
+    // Handle 99% of XHCI naming variations
+    
+    External (_SB_.PCI0.XHC_.RHUB, DeviceObj)
+    External (_SB_.PCI0.XHCI.RHUB, DeviceObj)
+    External (_SB_.PCI0.XHC1.RHUB, DeviceObj)
+
+
+    If (CondRefOf (\_SB.PCI0.XHC_.RHUB))
+    {
+        Scope (_SB.PCI0.XHC_.RHUB)
+        {
+            If (_OSI ("Darwin"))
+                    {
+                        Return (Zero)
+                    }
+                    Else
+                    {
+                    }
+        }  
+    }
+    
+    If (CondRefOf (\_SB.PCI0.XHCI.RHUB))
+    {
+        Scope (_SB.PCI0.XHCI.RHUB)
+        {
+            If (_OSI ("Darwin"))
+                    {
+                        Return (Zero)
+                    }
+                    Else
+                    {
+                    }
+        }  
+    }
+    
+    If (CondRefOf (\_SB.PCI0.XHC1.RHUB))
+    {
+        Scope (_SB.PCI0.XHC1.RHUB)
+        {
+            If (_OSI ("Darwin"))
+                    {
+                        Return (Zero)
+                    }
+                    Else
+                    {
+                    }
+        }  
+    }
+    
+}
+

extra-files/decompiled/SSDT-RHUB.dsl

@@ -0,0 +1,21 @@
+/*
+ * Goal of this SSDT is to shut off the RHUB to force macOS into
+ * manually building ports when the ACPI is screwed up
+ */
+DefinitionBlock ("", "SSDT", 2, "DRTNIA", "RhubOff", 0x00001000)
+{
+    External (_SB_.PCI0.XHC1.RHUB, DeviceObj) // Full pathing to RHUB, change to yours
+
+
+    Scope (_SB.PCI0.XHC1.RHUB) // Full pathing to RHUB, change to yours
+        {
+            If (_OSI ("Darwin"))
+                    {
+                        Return (Zero) // This disables the device only in macOS
+                    }
+                    Else
+                    {
+                    }
+        }  
+}
+

ssdt-methods/ssdt-easy.md

@@ -24,6 +24,8 @@ What this tool does is, it dumps your DSDT from your firmware, and then creates
   * Prebuilt can be found here: [NVRAM PMC](/Universal/nvram.md)
 * **USBX SSDT**:
   * This is included on sample SSDTs but SSDTTime only makes the SSDT-EC part, Skylake and newer users can grab a pre-built here: [SSDT-USBX.aml](https://github.com/dortania/USB-Map-Guide/blob/master/extra-files/SSDT-USBX.aml)
+* **RHUB SSDT**:
+  * if you have a 10th gen CPU, you'll need to either use the prebuilt or manually create it.
 
 For users who don't have all the options available to them in SSDTTime, you can follow the "SSDTs: The long way" section. You can still use SSDTTime for SSDTs it does support.
 

ssdt-methods/ssdt-prebuilt.md

@@ -95,3 +95,9 @@ Reminder only the following need this SSDT:
 * Z390
 * 400 series (Comet Lake)
 * 495 series (Icelake)
+
+## USB(RHUB)
+
+Needed for 10th gen CPUs, Gigabyte and AsRock motherboards don't need this
+
+* [SSDT-RHUB.aml](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/compiled/SSDT-RHUB.aml)

ssdt-platform.md

@@ -14,6 +14,7 @@ Please see the **specific ACPI section of your config.plist**, all SSDTs needed
 | **EC** | [SSDT-EC](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC.dsl) | [SSDT-EC](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC.dsl) | [SSDT-EC-USBX](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC-USBX.dsl) | [SSDT-EC-USBX](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC-USBX.dsl) | [SSDT-EC-USBX](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC-USBX.dsl) | [SSDT-EC-USBX](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC-USBX.dsl) | [SSDT-EC-USBX](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC-USBX.dsl) |
 | **AWAC** | N/A | N/A | N/A | N/A | [SSDT-AWAC](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-AWAC.dsl) | [SSDT-AWAC](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-AWAC.dsl) | N/A |
 | **NVRAM** | N/A | N/A | N/A | N/A | [SSDT-PMC](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-PMC.dsl) | N/A | N/A |
+| **USB** | N/A | N/A | N/A | N/A | N/A | [SSDT-RHUB](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/compiled/SSDT-RHUB.aml) | N/A |
 
 ## High End Desktop
 
@@ -25,7 +26,7 @@ Please see the **specific ACPI section of your config.plist**, all SSDTs needed
 
 ## Laptop
 
-| SSDT | IvyBridge | Haswell | Broadwell | Skylake | KabyLake | CoffeeLake(8thGen) | Coffee/Comet/IceLake(9/10thGen) |
+| SSDT | IvyBridge | Haswell | Broadwell | Skylake | KabyLake | CoffeeLake(8thGen) | CoffeeLake(9thGen |
 | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
 | **CPU** | [CPU-PM](https://github.com/Piker-Alpha/ssdtPRGen.sh)(Run in Post-Install) | [SSDT-PLUG](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-PLUG.dsl) | [SSDT-PLUG](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-PLUG.dsl) | [SSDT-PLUG](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-PLUG.dsl) | [SSDT-PLUG](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-PLUG.dsl) | [SSDT-PLUG](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-PLUG.dsl) | [SSDT-PLUG](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-PLUG.dsl) |
 | **EC** | [SSDT-EC](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC.dsl) | [SSDT-EC](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC.dsl) | [SSDT-EC](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC.dsl) | [SSDT-EC-USBX](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC-USBX.dsl) | [SSDT-EC-USBX](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC-USBX.dsl) | [SSDT-EC-USBX](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC-USBX.dsl) | [SSDT-EC-USBX](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC-USBX.dsl) |
@@ -35,4 +36,15 @@ Please see the **specific ACPI section of your config.plist**, all SSDTs needed
 | **NVRAM** | N/A | N/A | N/A | N/A | N/A | N/A | [SSDT-PMC](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-PMC.dsl) |
 | **IRQ Patch** | [IRQ SSDT](https://github.com/corpnewt/SSDTTime) | [IRQ SSDT](https://github.com/corpnewt/SSDTTime) | [IRQ SSDT](https://github.com/corpnewt/SSDTTime) | N/A | N/A | N/A | N/A |
 
+| SSDT | CometLake | IceLake |
+| :--- | :--- | :--- |
+| **CPU** | [SSDT-PLUG](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-PLUG.dsl) | [SSDT-PLUG](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-PLUG.dsl) |
+| **EC** | [SSDT-EC-USBX](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC-USBX.dsl) | [SSDT-EC-USBX](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-EC-USBX.dsl) |
+| **Backlight** | [SSDT-PNLF-CFL](https://i.applelife.ru/2019/12/463488_SSDT-PNLFCFL.aml.zip) | [SSDT-PNLF-CFL](https://i.applelife.ru/2019/12/463488_SSDT-PNLFCFL.aml.zip) |
+| **I2C TrackPad** |[SSDT-GPI0](https://github.com/hackintosh-guides/vanilla-laptop-guide/tree/master/Misc-files/SSDT-GPIO.aml) | [SSDT-GPI0](https://github.com/hackintosh-guides/vanilla-laptop-guide/tree/master/Misc-files/SSDT-GPIO.aml) |
+| **AWAC** | [SSDT-AWAC](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-AWAC.dsl) | [SSDT-AWAC](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-AWAC.dsl) |
+| **NVRAM** | N/A | N/A |
+| **IRQ Patch** | N/A | N/A |
+| **USB** | N/A | [SSDT-RHUB](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/compiled/SSDT-RHUB.aml) |
+
 ## [SSDT Creation](/ssdt-methods/ssdt-methods.md)