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

Misc fixes

Browse Source
This commit is contained in:
Mykola Grymalyuk
2020-09-01 11:27:37 -06:00
parent 7e198202ea
commit 0b98e8232e
21 changed files with 197 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
.vuepress/config.js
View File

@@ -205,6 +205,7 @@ module.exports = {
sidebarDepth: 2,
children: [
['/Universal/awac-methods/prebuilt', 'Prebuilt'],
['/Universal/awac-methods/ssdttime', 'SSDTTime'],
['/Universal/awac-methods/manual', 'Manual'],
]
},
@@ -215,6 +216,7 @@ module.exports = {
sidebarDepth: 2,
children: [
['/Universal/nvram-methods/prebuilt', 'Prebuilt'],
['/Universal/nvram-methods/ssdttime', 'SSDTTime'],
['/Universal/nvram-methods/manual', 'Manual'],
]
},
@@ -228,6 +230,16 @@ module.exports = {
['/Universal/rhub-methods/manual', 'Manual'],
]
},
['/Universal/imei', 'IMEI'],
{
title: 'Methods',
collapsable: true,
sidebarDepth: 2,
children: [
['/Universal/imei-methods/prebuilt', 'Prebuilt'],
['/Universal/imei-methods/manual', 'Manual'],
]
},
['/Universal/smbus', 'Fixing SMBus Support'],
{
title: 'Methods',

2
Universal/awac-methods/ssdttime.md
View File

@@ -6,7 +6,7 @@ To get the SSDT-PMC, run the following:
* `7. Dump DSDT` then run `6. AWAC`
This will provide you with some files, the main one you care about is SSDT-AWAC**.aml**. or SSDT-RTC0**.aml**. The DSDT and .dsl are only left for referencing or verification.
This will provide you with some files, the main one you care about is SSDT-AWAC.**aml**. or SSDT-RTC0.**aml**. The DSDT and .dsl are only left for referencing or verification.
The main things to note with this method:

5
Universal/awac.md
View File

@@ -5,7 +5,7 @@
## What this SSDT does
The purpose of SSDT-AWAC/RTC0 is to fix the system clocks found on newer hardware, maily found in the following:
The purpose of SSDT-AWAC/RTC0 is to fix the system clocks found on newer hardware, mainly found in the following:
* B360
* B365
@@ -23,7 +23,8 @@ SSDT-AWAC tries to re-enable the old RTC clock that is compatible with macOS, wh
## Methods to make this SSDT
For the RTC fix, there are 2 methods you can choose from:
For the RTC fix, there are 3 methods you can choose from:
* [Prebuilt](/Universal/awac-methods/prebuilt.md)
* [SSDTTime](/Universal/awac-methods/ssdttime.md)
* [Manual](/Universal/awac-methods/manual.md)

2
Universal/ec-fix.md
View File

@@ -28,5 +28,5 @@ For the EC fix, there are 3 methods you can choose from:
* 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)

2
Universal/ec-methods/ssdttime.md
View File

@@ -10,7 +10,7 @@ To get the SSDT-PLUG on laptops, run the following:
* `7. Dump DSDT` then run `3. FakeEC Laptop`
This will provide you with some files, the main one you care about is SSDT-EC**.aml**. The DSDT and .dsl are only left for referencing or verification.
This will provide you with some files, the main one you care about is SSDT-EC.**aml**. The DSDT and .dsl are only left for referencing or verification.
The main things to note with this method:

40
Universal/imei-methods/manual.md Normal file
View File

@@ -0,0 +1,40 @@
# Fixing USB: Manual
* [Finding the ACPI device](#finding-the-acpi-device)
* [Edits to the sample SSDT](#edits-to-the-sample-ssdt)
* [Compiling the SSDT](#compiling-the-ssdt)
* [Wrapping up](#wrapping-up)
## Finding the ACPI device
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 following devices:
* `IMEI`
* `HECI`
* `MEI`
If none of the 3 show up, you'll need to create an SSDT-IMEI.
**If one of these 3 devices show up**, you do not need SSDT-IMEI! You can simply skip this page.
The rest of this page will however assume none of those 3 devices showed up.
## Compiling the SSDT
So there's actually no edits required to SSDT-IMEI, you can either grab the source code and compile yourself or use the prebuilt
* [Prebuilt SSDT-IMEI](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/compiled/SSDT-IMEI-S.aml)
* [SSDT-IMEI's source code](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-IMEI.dsl)
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 wrap up:
* [**Cleanup**](/cleanup.md)

11
Universal/imei-methods/prebuilt.md Normal file
View File

@@ -0,0 +1,11 @@
# Fixing USB: Prebuilt
By far the easiest method, all you need to do is download the following file:
* [SSDT-IMEI.aml](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/compiled/SSDT-IMEI.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 wrap up:
* [**Cleanup**](/cleanup.md)

22
Universal/imei.md Normal file
View File

@@ -0,0 +1,22 @@
# Fixing IMEI (SSDT-IMEI)
- [Fixing IMEI (SSDT-IMEI)](#fixing-imei-ssdt-imei)
- [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-IMEI is:
* When mixing Ivy Bridge CPUs with 6 series motherboard, we get an issue where the IMEI device becomes incompatible with macOS. Specifically the device-id won't be recognized and this is a very important issue as macOS relies on the IMEI device for iGPU drivers.
* The same applies when mixing Sandy Bridge motherboards with 7 series motherboards
* An extra issue that may pop up is that the IMEI won't appear in ACPI, which can lead to more issues as macOS expects there to be an ACPI device to apply device-id's. So to resolve, we'll want to verify if we have an IMEI device, and if not create a new device.
## Methods to make this SSDT
For the IMEI fix, there are 2 methods you can choose from:
* [Prebuilt](/Universal/imei-methods/prebuilt.md)
* The prebuilt are a bit bloated. It's recommended to use the method below.
* [Manual](/Universal/imei-methods/manual.md)

2
Universal/nvram-methods/ssdttime.md
View File

@@ -6,7 +6,7 @@ To get the SSDT-PMC, run the following:
* `7. Dump DSDT` then run `5. PMC`
This will provide you with some files, the main one you care about is SSDT-PMC**.aml**. The DSDT and .dsl are only left for referencing or verification.
This will provide you with some files, the main one you care about is SSDT-PMC.**aml**. The DSDT and .dsl are only left for referencing or verification.
The main things to note with this method:

1
Universal/nvram.md
View File

@@ -20,4 +20,5 @@ This SSDT is required for all "true" 300 series motherboards(Z370 is excluded),
The main ways to make this SSDT:
* [Prebuilt](/Universal/nvram-methods/prebuilt.md)
* [SSDTTime](/Universal/nvram-methods/ssdttime.md)
* [Manual](/Universal/nvram-methods/manual.md)

2
Universal/plug-methods/ssdttime.md
View File

@@ -6,7 +6,7 @@ To get the SSDT-PLUG, run the following:
* `7. Dump DSDT` then run `3. PluginType`
This will provide you with some files, the main one you care about is SSDT-PLUG**.aml**. The DSDT and .dsl are only left for referencing or verification.
This will provide you with some files, the main one you care about is SSDT-PLUG.**aml**. The DSDT and .dsl are only left for referencing or verification.
The main things to note with this method:

1
Universal/plug.md
View File

@@ -16,5 +16,4 @@ For SSDT-PLUG, there are 3 methods you can choose from:
* [Prebuilt](/Universal/plug-methods/prebuilt.md)
* [SSDTTime](/Universal/plug-methods/ssdttime.md)
* Note this method does not support **servers** or **HEDT systems**
* [Manual](/Universal/plug-methods/manual.md)

2
cleanup.md
View File

@@ -4,7 +4,7 @@ So you've made all your SSDTs but now there's one thing left: Adding them to Ope
The 2 main locations:
* EFI/OC/ACPI (Only **.aml** files, reminder to [compile your SSDTs](/Manual/compile.md))
* EFI/OC/ACPI (Only .**aml** files, reminder to [compile your SSDTs](/Manual/compile.md))
* config.plist -> ACPI -> Add
You can save yourself some work with the config.plist by running Cmd/Ctrl+R in ProperTree. **Reminder do not add your DSDT.aml to your EFI**

BIN
extra-files/compiled/SSDT-IMEI-S.aml Normal file
View File

Binary file not shown.

BIN
extra-files/compiled/SSDT-IMEI.aml Normal file
View File

Binary file not shown.

19
extra-files/decompiled/SSDT-IMEI-S.dsl Normal file
View File

@@ -0,0 +1,19 @@
/*
* Only necessary when no IMEI device (with any name) is present in the DSDT and a custom device-id
* is needed to be set via DeviceProperties (some Sandy Bridge or Ivy Bridge configurations).
*
* Source: https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/AcpiSamples/SSDT-IMEI.dsl
*/
DefinitionBlock ("", "SSDT", 2, "DRTNIA", "IMEI", 0x00000000)
{
External (_SB_.PCI0, DeviceObj)
Scope (_SB.PCI0)
{
Device (IMEI)
{
Name (_ADR, 0x00160000) // _ADR: Address
}
}
}

25
extra-files/decompiled/SSDT-IMEI-prebuilt.dsl Normal file
View File

@@ -0,0 +1,25 @@
/* Purpose of this SSDT is to:
*
* - Find references of devices named IMEI, HECI, MEI
* - If none are found, only then create a new IMEI device
*
*/
DefinitionBlock ("", "SSDT", 2, "DRTNIA", "SsdtIMEI", 0x00000000)
{
External (_SB_.PCI0, DeviceObj)
External (_SB_.PCI0.IMEI, DeviceObj)
External (_SB_.PCI0.HECI, DeviceObj)
External (_SB_.PCI0.MEI, DeviceObj)
If ((!CondRefOf (\_SB.PCI0.IMEI) && !CondRefOf (\_SB.PCI0.HECI) && !CondRefOf (\_SB.PCI0.MEI)))
{
Scope (_SB.PCI0)
{
Device (IMEI)
{
Name (_ADR, 0x00160000) // _ADR: Address
}
}
}
}

8
ssdt-methods/ssdt-easy.md
View File

@@ -6,10 +6,6 @@ What this tool does is, it dumps your DSDT from your firmware, and then creates
## 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)
* **SSDT-PNLF**:
* Need to be configured to your system
* **SSDT-GPI0**:
@@ -17,7 +13,9 @@ What this tool does is, it dumps your DSDT from your firmware, and then creates
* **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/OpenCore-Post-Install/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.
* If you have a 10th gen CPU, you'll need to either use the prebuilt or manually create it.
* **IMEI SSDT**:
* If you have either a Sandy bridge CPU with 7 series motherboard or Ivy Bridge with 6 series motherboard, 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.

2
ssdt-methods/ssdt-methods.md
View File

@@ -5,7 +5,7 @@ Creating SSDTs mainly fall into 3 camps:
* [Prebuilt SSDTs](../ssdt-methods/ssdt-prebuilt.md)
* They're universal but don't teach much
* [Automated tools](../ssdt-methods/ssdt-easy.md)
* Mainly seen with SSDTTime, work much better though can't cover all situations
* Mainly seen with SSDTTime, work much better than prebuilts as there's less bloat however doesn't teach you much
* [Manually creating them](../ssdt-methods/ssdt-long.md)
* Will always work, be much cleaner and get to learn about the process
* However requires you to deal with code

23
ssdt-methods/ssdt-prebuilt.md
View File

@@ -7,6 +7,8 @@
* [Backlight](#backlight)
* [System Clock(AWAC)](#system-clockawac)
* [NVRAM(PMC)](#nvrampmc)
* [USB(RHUB)](#usbrhub)
* [IMEI](#imei)
This is mainly for users who are having troubles either compiling, decompiling or understanding the overall process of ACPI. The main reasons you'd want to avoid is for the following:
@@ -29,9 +31,9 @@ For Haswell and newer:
For Ivy Bridge and older, see the [Optimizing Power Management page](https://dortania.github.io/OpenCore-Post-Install/universal/pm.html). This will be done *after* install. AMD CPU users **do not** need any SSDTs for power management.
### B550 Fix
### B550 and A520 Fix
For AMD B550 users, you **must** include this SSDT to boot:
For AMD B550 and A520 users, you **must** include this SSDT to boot:
* [SSDT-CPUR](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/compiled/SSDT-CPUR.aml)
@@ -93,7 +95,7 @@ The biggest issue with this prebuilt is that we're just guessing you both have a
Needed to bring back NVRAM support for Z390 , **DO NOT USE ON Z370 or older or Z490 and newer**
Note: Desktop Z490 boards seem to not need this, though if you're having NVRAM issues you can try this SSDT.
Note: Comet Lake, Ice Lake and newer do not need this.
* [SSDT-PMC](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/compiled/SSDT-PMC.aml)
@@ -110,3 +112,18 @@ Reminder only the following need this SSDT:
Needed for 10th gen Asus motherboards, 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)
## IMEI
Required when pairing either:
* Sandy Bridge CPU with 7 series motherboard
* ie. B75, Q75, Z75, H77, Q77, Z77
* Ivy Bridge CPU with 6 series motherboard
* ie. H61, B65, Q65, P67, H67, Q67, Z68
Simply grab the following SSDT:
* [SSDT-IMEI.aml](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/compiled/SSDT-IMEI.aml)

47
ssdt-platform.md
View File

@@ -11,38 +11,55 @@ Please see the **specific ACPI section of your config.plist**, all SSDTs needed
| Platforms | **CPU** | **EC** | **AWAC** | **NVRAM** | **USB** |
| :-------: | :-----: | :----: | :------: | :-------: | :-----: |
| SandyBridge | [CPU-PM](https://dortania.github.io/OpenCore-Post-Install/universal/pm.html#sandy-and-ivy-bridge-power-management) (Run in Post-Install) | [SSDT-EC](/Universal/ec-fix.html) | N/A | N/A | N/A |
| SandyBridge | [CPU-PM](https://dortania.github.io/OpenCore-Post-Install/universal/pm.html#sandy-and-ivy-bridge-power-management) (Run in Post-Install) | [SSDT-EC](/Universal/ec-fix) | N/A | N/A | N/A |
| Ivy Bridge | ^^ | ^^ | N/A | N/A | N/A |
| Haswell | [SSDT-PLUG](/Universal/plug.html) | ^^ | ^^ | ^^ | ^^ |
| Haswell | [SSDT-PLUG](/Universal/plug) | ^^ | ^^ | ^^ | ^^ |
| Broadwell | ^^ | ^^ | ^^ | ^^ | ^^ |
| Skylake | ^^ | [SSDT-EC-USBX](/Universal/ec-fix.html) | ^^ | ^^ | ^^ |
| Skylake | ^^ | [SSDT-EC-USBX](/Universal/ec-fix) | ^^ | ^^ | ^^ |
| Kaby Lake | ^^ | ^^ | ^^ | ^^ | ^^ |
| Coffee Lake | ^^ | ^^ | [SSDT-AWAC](/Universal/awac.html) | [SSDT-PMC](/Universal/nvram.html) | ^^ |
| Comet Lake | ^^ | ^^ | ^^ | N/A | [SSDT-RHUB](/Universal/rhub.html) |
| AMD (15/16/17h) | [SSDT-CPUR](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/compiled/SSDT-CPUR.aml) | ^^ | N/A | ^^ | N/A |
| Coffee Lake | ^^ | ^^ | [SSDT-AWAC](/Universal/awac) | [SSDT-PMC](/Universal/nvram) | ^^ |
| Comet Lake | ^^ | ^^ | ^^ | N/A | [SSDT-RHUB](/Universal/rhub) |
| AMD (15/16h) | N/A | ^^ | N/A | ^^ | N/A |
| AMD (17h) | [SSDT-CPUR for B550](https://github.com/dortania/Getting-Started-With-ACPI/blob/master/extra-files/compiled/SSDT-CPUR.aml) | ^^ | N/A | ^^ | N/A |
## High End Desktop
| Platforms | **CPU** | **EC** | **AWAC** |
| :-------: | :-----: | :----: | :------: |
| Ivy Bridge-E | [SSDT-PLUG](/Universal/plug.html) | [SSDT-EC](/Universal/ec-fix.html) | N/A |
| Haswell-E | ^^ | [SSDT-EC-USBX](/Universal/ec-fix.html) | ^^ |
| Nehalem and Westmere | N/A | [SSDT-EC](/Universal/ec-fix) | N/A |
| Ivy Bridge-E | [SSDT-PLUG](/Universal/plug) | ^^ | ^^ |
| Haswell-E | ^^ | [SSDT-EC-USBX](/Universal/ec-fix) | ^^ |
| Broadwell-E | ^^ | ^^ | ^^ |
| Skylake-X | ^^ | ^^ | [SSDT-AWAC](/Universal/awac.html) |
| Skylake-X | ^^ | ^^ | [SSDT-AWAC](/Universal/awac) |
## Laptop
| Platforms | **CPU** | **EC** | **Backlight** | **I2C Trackpad** | **AWAC** | **USB** | **IRQ** |
| :-------: | :-----: | :----: | :-----------: | :--------------: | :------: | :-----: | :-----: |
| SandyBridge | [CPU-PM](https://dortania.github.io/OpenCore-Post-Install/universal/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) |
| SandyBridge | [CPU-PM](https://dortania.github.io/OpenCore-Post-Install/universal/pm.html#sandy-and-ivy-bridge-power-management) (Run in Post-Install) | [SSDT-EC](/Universal/ec-fix) | [SSDT-PNLF](/Laptops/backlight) | N/A | N/A | N/A | [IRQ SSDT](/Universal/irq) |
| Ivy Bridge | ^^ | ^^ | ^^ | ^^ | ^^ | ^^ | ^^ |
| Haswell | [SSDT-PLUG](/Universal/plug.html) | ^^ | ^^ | ^^ | ^^ | ^^ | ^^ |
| Haswell | [SSDT-PLUG](/Universal/plug) | ^^ | ^^ | [SSDT-GPI0](/Laptops/trackpad) | ^^ | ^^ | ^^ |
| Broadwell | ^^ | ^^ | ^^ | ^^ | ^^ | ^^ | ^^ |
| Skylake | ^^ | [SSDT-EC-USBX](/Universal/ec-fix.html) | ^^ | ^^ | ^^ | ^^ | N/A |
| Skylake | ^^ | [SSDT-EC-USBX](/Universal/ec-fix) | ^^ | ^^ | ^^ | ^^ | N/A |
| Kaby Lake | ^^ | ^^ | ^^ | ^^ | ^^ | ^^ | ^^ |
| Coffee Lake (8th Gen) | ^^ | ^^ | [SSDT-PNLF-CFL](/Laptops/backlight.html) | ^^ | ^^ | ^^ | ^^ |
| Coffee Lake (9th Gen) | ^^ | ^^ | ^^ | ^^ | [SSDT-AWAC](/Universal/awac.html) | ^^ | ^^ |
| Coffee Lake (8th Gen) and Whiskey Lake | ^^ | ^^ | [SSDT-PNLF-CFL](/Laptops/backlight) | ^^ | ^^ | ^^ | ^^ |
| Coffee Lake (9th Gen) | ^^ | ^^ | ^^ | ^^ | [SSDT-AWAC](/Universal/awac) | ^^ | ^^ |
| Comet Lake | ^^ | ^^ | ^^ | ^^ | ^^ | ^^ | ^^ |
| Ice Lake | ^^ | ^^ | ^^ | ^^ | ^^ | [SSDT-RHUB](/Universal/rhub.html) | ^^ |
| Ice Lake | ^^ | ^^ | ^^ | ^^ | ^^ | [SSDT-RHUB](/Universal/rhub) | ^^ |
Continuing:
| Platforms | **NVRAM** | **IMEI** |
| :-------: | :-------: | :------: |
| Sandy Bridge | N/A | [SSDT-IMEI](/Universal/imei) |
| Ivy Bridge | ^^ | ^^ |
| Haswell | ^^ | N/A |
| Broadwell | ^^ | ^^ |
| Skylake | ^^ | ^^ |
| Kaby Lake | ^^ | ^^ |
| Coffee Lake (8th Gen) and Whiskey Lake | ^^ | ^^ |
| Coffee Lake (9th Gen) | [SSDT-PMC](/Universal/nvram) | ^^ |
| Comet Lake | N/A | ^^ |
| Ice Lake | ^^ | ^^ |
## [SSDT Creation](/ssdt-methods/ssdt-methods.md)