AskDavis/Getting-Started-With-ACPI
1
0
Fork 0
mirror of https://github.com/AskDavis/Getting-Started-With-ACPI.git synced 2026-01-01 05:05:57 -08:00
Code Issues Packages Projects Releases Wiki Activity

Add prebuilt page

Browse Source
This commit is contained in:
Mykola Grymalyuk
2020-05-16 11:36:31 -06:00
parent f233a1d92c
commit 1d63609690
9 changed files with 142 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
README.md
View File

@@ -31,7 +31,6 @@ macOS can be very picky about the devices present in the DSDT and so our job is
* Needed for fixing IRQ conflicts within the DSDT, for laptops mainly. SSDTTime exclusive
* Note Skylake and newer systems rarely have IRQ conflicts, this is mainly prevalent on Broadwell and older
Now head to the next page on what SSDTs do your systems need:
## [Choosing the SSDTs](ssdt-platform.md)

7
SUMMARY.md
View File

@@ -4,8 +4,11 @@
* [Choosing the SSDTs](ssdt-platform.md)
## Methods
* [SSDTs: Easy Way](ssdt-easy.md)
* [SSDTs: Long Way](ssdt-long.md)
* [How to create SSDTs](/ssdt-methods/ssdt-methods.md)
* [SSDTs: Prebuilt](/ssdt-methods/ssdt-prebuilt.md)
* [SSDTs: Easy Way](/ssdt-methods/ssdt-easy.md)
* [SSDTs: Long Way](/ssdt-methods/ssdt-long.md)
## Manual

34
ssdt-easy.md → ssdt-methods/ssdt-easy.md
View File

@@ -4,26 +4,26 @@ So here we'll be using a super simple tool made by CorpNewt: [SSDTTime](https://
What this tool does is dumps your DSDT from your firmware, and then creates SSDTs based off your DSDT. **This must be done on the target machine running either Windows or Linux**
## So what **can't** SSDTTime do?:
## So what **can't** SSDTTime do
* **HEDT SSDTs**:
* The ACPI is odd on these platforms so manual work is required
* This includes X79, X99 and X299 systems
* Prebuilt can be found here: [Embedded Controller](/Universal/ec-fix.md)
* The ACPI is odd on these platforms so manual work is required
* This includes X79, X99 and X299 systems
* Prebuilt can be found here: [Embedded Controller](/Universal/ec-fix.md)
* **Laptop EC fix**:
* This is because you do not want the EC powered off
* Prebuilt can be found here: [Embedded Controller](/Universal/ec-fix.md)
* This is because you do not want the EC powered off
* Prebuilt can be found here: [Embedded Controller](/Universal/ec-fix.md)
* **SSDT-PNLF**:
* Need to be configured to your system
* Need to be configured to your system
* **SSDT-GPI0**:
* Need to be configured to your system
* Need to be configured to your system
* **AWAC and RTC0 SSDTs**:
* 300 series Intel boards will also need to figure his out(Z390 systems are most common for requiring this but some Gigabyte Z370 do as well)
* 300 series Intel boards will also need to figure his out(Z390 systems are most common for requiring this but some Gigabyte Z370 do as well)
* **PMC SSDT**:
* For fixing 300 series Intel NVRAM
* Prebuilt can be found here: [NVRAM PMC](/Universal/nvram.md)
* For fixing 300 series Intel NVRAM
* 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)
* 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)
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 support for you.
@@ -36,14 +36,13 @@ Run the `SSDTTime.bat` file as Admin on the target machine and you should see so
What are all these options?:
* `1. FixHPET - Patch out IRQ Conflicts`
* IRQ patching, mainly needed for X79, X99 and laptop users(use option `C` to omit conflicting legacy IRQs)
* IRQ patching, mainly needed for X79, X99 and laptop users(use option `C` to omit conflicting legacy IRQs)
* `2. FakeEC - OS-aware Fake EC`
* This is the SSDT-EC, required for Catalina users
* This is the SSDT-EC, required for Catalina users
* `3. PluginType - Sets plugin-type = 1 on CPU0/PR00`
* This is the SSDT-PLUG, for Intel only
* This is the SSDT-PLUG, for Intel only
* `4. Dump DSDT - Automatically dump the system DSDT`
* Dumps your DSDT from your firmware
* Dumps your DSDT from your firmware
What we want to do is select option `4. Dump DSDT` first, then select the appropriate option(s) for your system.
@@ -56,6 +55,7 @@ For Skylake and newer plus AMD, you can grab a pre-built file here: [SSDT-USBX.a
## 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**:
* EFI/OC/ACPI
* config.plist -> ACPI -> Add

1
ssdt-long.md → ssdt-methods/ssdt-long.md
View File

@@ -8,4 +8,3 @@ Well sadly some things are not handled by SSDTTime, well have no fear as making
* Compile SSDTs
Now continue forth and master the ways of ACPI!

10
ssdt-methods/ssdt-methods.md Normal file
View File

@@ -0,0 +1,10 @@
# How to create SSDTs
Creating SSDTs mainly fall into 3 camps:
* Prebuilt SSDTs
* They work but not perfect
* Automated tools
* Mainly seen with SSDTTime, work much better though can't cover all situations
* Manually creating them
* Will always work, be much cleaner and get to learn about the process

95
ssdt-methods/ssdt-prebuilt.md Normal file
View File

@@ -0,0 +1,95 @@
# Pre-Built SSDTs
* [Power Management](#power-management)
* [Embedded Controllers](#embedded-controllers)
* [Trackpad](#trackpad)
* [Backlight](#backlight)
* [System Clock(AWAC)](#system-clockawac)
* [NVRAM(PMC)](#nvrampmc)
This is mainly for users who are having troubles either compiling, decompiling or understanding the overal process of ACPI. The main reasons you'd want to avoid is for the following:
* Slowing down the boot process
* Mainly because these SSDTs have to go through every possible pathing
* Fun fact: the prebuilt SSDT-EC-DESKTOP is 42 times larger than making the file yourself
* Doesn't always work
* The SSDTs provided can only handle so many situations, and some may in fact not work
* Mainly seen with SSDT-AWAC, as it assumes there is a way the RTC can be easily enabled
* Teaches nothing
* This is the **biggest** issue as you have no real idea on how to troubleshoot or how to make these files down the line
Please refer to [Choosing the SSDTs](/ssdt-platform.md) page for which your system needs.
## Power Management
For Haswell and newer:
* [SSDT-PLUG-DRTNIA](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/SSDT-PLUG-DRTNIA.aml)
For Ivy Bridge and older, see the [Optimizing Power Management page](https://dortania.github.io/OpenCore-Desktop-Guide/post-install/pm.html). This will be done *after* install. AMD CPU users **do not** need any SSDTs for power management.
## Embedded Controllers
For desktops:
* [SSDT-EC-USBX-DESKTOP](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/SSDT-EC-USBX-DESKTOP.aml)
* For Skylake and newer and all AMD systems.
* [SSDT-EC-DESKTOP](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/SSDT-EC-DESKTOP.aml)
* For Broadwell and older.
For laptops:
* [SSDT-EC-USBX-LAPTOP](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/SSDT-EC-USBX-LAPTOP.aml)
* For Skylake and newer.
* [SSDT-EC-LAPTOP](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/SSDT-EC-LAPTOP.aml)
* For Broadwell and older.
## Trackpad
Used for enabling Windows only features in macOS, do note that the below patches will more than likely break Windows booting via OpenCore. I **highly** encourage you to make one yourself to prevent any issues down the line: [Trackpad GPI0](/Laptops/trackpad.md)
* [SSDT-XOSI](https://github.com/hackintosh-guides/vanilla-laptop-guide/tree/master/Misc-files/SSDT-XOSI.aml)
* [XOSI-Rename.plist](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/XOSI-Rename.plist)
* Note you'll need to add this into your config.plist under `ACPI -> Patch`:
| Comment | String | Change _OSI to XOSI |
| :--- | :--- | :--- |
| Enabled | Boolean | YES |
| Count | Number | 0 |
| Limit | Nuber | 0 |
| Find | Data | 5f4f5349 |
| Replace | Data | 584f5349 |
## Backlight
For laptops and all-in-one desktops, fixies brightness control support
* [SSDT-PNLF](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/SSDT-PNLF.aml)
* For most users.
* [SSDT-PNLF-CFL](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/SSDT-PNLF-CFL.aml)
* For Coffee Lake and newer.
## System Clock(AWAC)
Mainly needed for newer systems running AWAC based system clocks, mainly relavant for Z390 and newer(Gigabyte and AsRock however did backport it to Z370 with a BIOS update)
* [SSDT-AWAC](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/SSDT-AWAC.aml)
The biggest issue with this prebuilt is that we're just guessing you both have an AWAC clock and that it can be turned off, I **highly** encourage you to make one yourself to really know whether you both need this and if it's going to work: [AWAC vs RTC](/Universal/awac.md)
## NVRAM(PMC)
Needed to bring back NVRAM support for Z390 and newer, **DO NOT USE ON Z370 or older**
* [SSDT-PMC](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/SSDT-PMC.aml)
Reminder only the following need this SSDT:
* B360
* B365
* H310
* H370
* Z390
* 400 series (Comet Lake)
* 495 series (Icelake)

2
ssdt-platform.md
View File

@@ -34,3 +34,5 @@ Please see the **specific ACPI section of your config.plist**, all SSDTs needed
| **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 Creation](/ssdt-methods/ssdt-methods.md)