diff --git a/SUMMARY.md b/SUMMARY.md index bc5d223..4dd2774 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -35,7 +35,7 @@ * [Prebuilt](/Universal/ec-methods/prebuilt.md) * [SSDTTime](/Universal/ec-methods/ssdttime.md) * [Manual](/Universal/ec-methods/manual.md) -* [Plugin type](/Universal/plug.md) +* [CPU Power Management](/Universal/plug.md) * [Prebuilt](/Universal/plug-methods/prebuilt.md) * [SSDTTime](/Universal/plug-methods/ssdttime.md) * [Manual](/Universal/plug-methods/manual.md) diff --git a/Universal/ec-fix.md b/Universal/ec-fix.md index 03782b9..61b862e 100644 --- a/Universal/ec-fix.md +++ b/Universal/ec-fix.md @@ -1,7 +1,8 @@ # Fixing Embedded Controller (SSDT-EC/USBX) -* [What this SSDT does](#what-this-ssdt-does) -* [Methods to make this SSDT](#methods-to-make-this-ssdt) +- [Fixing Embedded Controller (SSDT-EC/USBX)](#fixing-embedded-controller-ssdt-ecusbx) + - [What this SSDT does](#what-this-ssdt-does) + - [Methods to make this SSDT](#methods-to-make-this-ssdt) ## What this SSDT does @@ -24,6 +25,8 @@ So TL;DR: For the EC fix, there are 3 methods you can choose from: * [Prebuilt](/Universal/ec-methods/prebuilt.md) + * The prebuilt for desktops are very bloated. It's recommended to use the two methods below. + * The Laptop prebuilts are easily usable. * [SSDTTime](/Universal/ec-methods/ssdttime.md) * Note this method does not support **laptops**, **servers** or **HEDT systems** * [Manual](/Universal/ec-methods/manual.md) diff --git a/Universal/ec-methods/manual.md b/Universal/ec-methods/manual.md index 7868a6f..5ce6efd 100644 --- a/Universal/ec-methods/manual.md +++ b/Universal/ec-methods/manual.md @@ -1,12 +1,17 @@ # Fixing Embedded Controllers: Manual -* [Finding the ACPI path](#finding-the-acpi-path) - * [DSDT](#DSDT) - * [DeviceManager](#devicemanager) -* [Edits to the sample SSDT](#edits-to-the-sample-ssdt) -* [Edge Cases](#edge-cases) -* [Compiling the SSDT](#compiling-the-ssdt) -* [Wrapping up](#wrapping-up) +- [Fixing Embedded Controllers: Manual](#fixing-embedded-controllers-manual) + - [Finding the ACPI path](#finding-the-acpi-path) + - [DSDT](#dsdt) + - [DeviceManager](#devicemanager) + - [Edits to the sample SSDT](#edits-to-the-sample-ssdt) + - [Edge Cases](#edge-cases) + - [Multiple PNP0C09's show up](#multiple-pnp0c09s-show-up) + - [No PNP0C09 show up](#no-pnp0c09-show-up) + - [PNP0C09 already named `EC`](#pnp0c09-already-named-ec) + - [PNP0C09 already has an `_STA` method](#pnp0c09-already-has-an-_sta-method) + - [Compiling the SSDT](#compiling-the-ssdt) + - [Wrapping up](#wrapping-up) TO-DO: @@ -38,10 +43,18 @@ But now we get into edge case territory, what fun! The main ones to check for are: -* [Multiple PNP0C09's show up](#multiple-pnp0c09s-show-up) -* [No PNP0C09 show up](#no-pnp0c09-show-up) -* [PNP0C09 already named `EC`](#pnp0c09-already-named-ec) -* [PNP0C09 already has an `_STA` method](#pnp0c09-already-has-an-sta-method) +- [Fixing Embedded Controllers: Manual](#fixing-embedded-controllers-manual) + - [Finding the ACPI path](#finding-the-acpi-path) + - [DSDT](#dsdt) + - [DeviceManager](#devicemanager) + - [Edits to the sample SSDT](#edits-to-the-sample-ssdt) + - [Edge Cases](#edge-cases) + - [Multiple PNP0C09's show up](#multiple-pnp0c09s-show-up) + - [No PNP0C09 show up](#no-pnp0c09-show-up) + - [PNP0C09 already named `EC`](#pnp0c09-already-named-ec) + - [PNP0C09 already has an `_STA` method](#pnp0c09-already-has-an-_sta-method) + - [Compiling the SSDT](#compiling-the-ssdt) + - [Wrapping up](#wrapping-up) If none of the above apply to you, you're ready for the next section: diff --git a/Universal/plug.md b/Universal/plug.md index 316b920..b11433f 100644 --- a/Universal/plug.md +++ b/Universal/plug.md @@ -1,13 +1,14 @@ # Fixing Power Management (SSDT-PLUG) -* [What this SSDT does](#what-this-ssdt-does) -* [Methods to make this SSDT](#methods-to-make-this-ssdt) +- [Fixing Power Management (SSDT-PLUG)](#fixing-power-management-ssdt-plug) + - [What this SSDT does](#what-this-ssdt-does) + - [Methods to make this SSDT](#methods-to-make-this-ssdt) ## What this SSDT does The purpose of SSDT-PLUG is to allow the kernel's XCPM(XNU's CPU Power Management) to manage our CPU's power management. It's pretty self explanatory why you'd want this. -**Note**: SSDT-PLUG is only compatible with Intel's Haswell and newer CPUs, Sandy Bridge and Ivy Bridge will need to follow the [ssdtPRgen method](https://dortania.github.io/OpenCore-Desktop-Guide/post-install/pm.html)(in post-install) while AMD users should not use this(unless attempting to attach AGPM which is outside the scope of Dortania's guides) +**Note**: SSDT-PLUG is only compatible with Intel's Haswell and newer CPUs, Sandy Bridge and Ivy Bridge will need to follow the [ssdtPRgen method](https://dortania.github.io/OpenCore-Desktop-Guide/post-install/pm.html#sandy-and-ivy-bridge-power-management)(in post-install) while AMD users should not use this(unless attempting to attach AGPM which is outside the scope of Dortania's guides) ## Methods to make this SSDT diff --git a/book.json b/book.json index 7d7470b..e6b232e 100644 --- a/book.json +++ b/book.json @@ -1,5 +1,5 @@ { - "plugins": ["theme-default", "-lunr", "-search", "search-plus", "addcssjs", "favicon-plus", "anchors", "github-buttons", "last-modified", "medium-zoom"], + "plugins": ["theme-default", "-lunr", "-search", "search-plus", "addcssjs", "favicon-plus", "anchors", "github-buttons", "last-modified", "medium-zoom", "table-cell-merge"], "pluginsConfig": { "fontsettings": { "theme": "night", diff --git a/ssdt-platform.md b/ssdt-platform.md index f907509..9976c07 100644 --- a/ssdt-platform.md +++ b/ssdt-platform.md @@ -2,49 +2,39 @@ Please see the **specific ACPI section of your config.plist**, all SSDTs needed are covered there with a brief explainer. But here's a very quick TL;DR: -* [Desktop](#desktop) -* [High End Desktop](#high-end-desktop) -* [Laptop](#laptop) +- [What SSDTs do each platform need](#what-ssdts-do-each-platform-need) + - [Desktop](#desktop) + - [Laptop](#laptop) + - [SSDT Creation](#ssdt-creation) ## Desktop -| SSDT | IvyBridge | Haswell/Broadwell | Skylake | KabyLake | CoffeeLake | CometLake | AMD(15/16/17h) | -| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- | -| **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) | N/A | -| **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 - -| SSDT | IvyBridge-E | Haswell-E | Broadwell-E | Skylake-X | -| :--- | :--- | :--- | :--- | :--- | -| **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) | -| **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) | -| **AWAC** | N/A | N/A | N/A | [SSDT-AWAC](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-AWAC.dsl) | +| Platforms | **CPU** | **EC** | **AWAC** | **NVRAM** | **USB** | +| :-------: | :-----: | :----: | :------: | :-------: | :-----: | +| Ivy Bridge | [CPU-PM](https://dortania.github.io/OpenCore-Desktop-Guide/post-install/pm.html#sandy-and-ivy-bridge-power-management) (Run in Post-Install) | [SSDT-EC](/Universal/ec-fix.html) | N/A | N/A | N/A | +| Ivy Bridge-E | ^ | ^ | ^ | ^ | ^ | +| Haswell/Broadwell | [SSDT-PLUG](/Universal/plug.html) | ^ | ^ | ^ | ^ | +| Haswell-E | ^ | ^ | ^ | ^ | ^ | +| Broadwell-E | ^ | ^ | ^ | ^ | ^ | +| Skylake | ^ | [SSDT-EC-USBX](/Universal/ec-fix.html) | ^ | ^ | ^ | +| Skylake-X | ^ | ^ | ^ | ^ | ^ | +| Kabylake | ^ | ^ | ^ | ^ | ^ | +| CoffeeLake | ^ | ^ | [SSDT-AWAC]/Universal/awac.html) | [SSDT-PMC](/Universal/nvram.html) | ^ | +| CometLake | ^ | ^ | ^ | ^ | [SSDT-RHUB](/Universal/rhub.html) | +| AMD (15/16/17h) | N/A | ^ | N/A | N/A | N/A | ## Laptop -| 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) | -| **Backlight** | [SSDT-PNLF](https://github.com/acidanthera/WhateverGreen/blob/master/Manual/SSDT-PNLF.dsl) | [SSDT-PNLF](https://github.com/acidanthera/WhateverGreen/blob/master/Manual/SSDT-PNLF.dsl) | [SSDT-PNLF](https://github.com/acidanthera/WhateverGreen/blob/master/Manual/SSDT-PNLF.dsl) | [SSDT-PNLF](https://github.com/acidanthera/WhateverGreen/blob/master/Manual/SSDT-PNLF.dsl) | [SSDT-PNLF](https://github.com/acidanthera/WhateverGreen/blob/master/Manual/SSDT-PNLF.dsl) | [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) | [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) | [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) | [SSDT-GPI0](https://github.com/hackintosh-guides/vanilla-laptop-guide/tree/master/Misc-files/SSDT-GPIO.aml) | -| **AWAC** | N/A | N/A | N/A | N/A | N/A | N/A | [SSDT-AWAC](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-AWAC.dsl) | -| **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) | +| Platforms | **CPU** | **EC** | **Backlight** | **I2C Trackpad** | **AWAC** | **USB** | **IRQ** | +| :-------: | :-----: | :----: | :-----------: | :--------------: | :------: | :-----: | :-----: | +| Ivy Bridge | [CPU-PM](https://dortania.github.io/OpenCore-Desktop-Guide/post-install/pm.html#sandy-and-ivy-bridge-power-management) (Run in Post-Install) | [SSDT-EC](/Universal/ec-fix.html) | [SSDT-PNLF](/Laptops/backlight.html) | [SSDT-GPI0](/Laptops/trackpad.html) | N/A | N/A | [IRQ SSDT](/Universal/irq.html) | +| Haswell | [SSDT-PLUG](/Universal/plug.html) | ^ | ^ | ^ | ^ | ^ | ^ | +| Broadwell | ^ | ^ | ^ | ^ | ^ | ^ | ^ | +| Skylake | ^ | [SSDT-EC-USBX](/Universal/ec-fix.html) | ^ | ^ | ^ | ^ | N/A | +| KabyLake | ^ | ^ | ^ | ^ | ^ | ^ | ^ | +| CoffeeLake (8th Gen) | ^ | ^ | [SSDT-PNLF-CFL](/Laptops/backlight.html) | ^ | ^ | ^ | ^ | +| CoffeeLake (9th Gen) | ^ | ^ | ^ | ^ | [SSDT-AWAC](/Universal/awac.html) | ^ | ^ | +| CometLake | ^ | ^ | ^ | ^ | ^ | ^ | ^ | +| IceLake | ^ | ^ | ^ | ^ | ^ | [SSDT-RHUB](/Universal/rhub.html) | ^ | ## [SSDT Creation](/ssdt-methods/ssdt-methods.md)