Guide Differences
This section will point out things that were altered in the guide which you should change in your configuration as soon as possible to improve your experience.
Convenient, huh?
Gathering Files
OpenCore
config.plist
-> Config.plist
Summary
We used to name the configuration file config.plist
.
Mediation
Rename it to Config.plist
to match the file naming convention of OpenCore. This is purely cosmetic, and therefore optional.
Kexts
AMDRyzenCPUPowerManagement
and SMCAMDProcessor
Summary
This kext used to be listed for AMD CPU temperature readings and power management, but was removed from the guide due to it causing major performance and efficiency regressions, especially on laptops!
Mediation
You should remove both of them, leaving the firmware to do its job. The firmware can do the job on its own better than the kexts anyway.
You can continue receiving temperature readings via SMC using SMCProcessorAMD
(notice the different order of AMD
).
USBToolBox
Summary
The USBToolBox
kext used to be listed for USB mapping. You would have this kext along with a companion UTBMap.kext
(not UTBDefault.kext
, that one's an example dummy!) and this would map your USBs.
However, it was observed that for a bunch of people it was causing issues like broken sleep/wake or stalls on boot.
Mediation
Remove all USBToolBox
kexts.
For USB mapping, you can use USBToolBox
's tool with "Use Native Classes" enabled in its settings. This will use Apple's native USB map kexts which work much better.
The tool will prompt you for your SMBIOS when building the kext, as that's how Apple's kexts match which USB mapping configuration to use.
You can also use the USBMap
tool. This one only works inside macOS itself.
Make sure that you're not using the old map when attempting to generate the new one!
SMCBatteryManager
and SMCLightSensor
Summary
There used to be no note telling you to not use these kexts on desktops.
Mediation
If you are using those kexts on a desktop, remove them.
SMCSuperIO
Summary
There used to be no note telling you to not use this kext on AMD.
Mediation
If you are using this kext on an AMD-CPU-based system, remove it.
ECEnabler
Summary
There used to be no note telling you to not use this kext on a desktop.
There also was no note telling you to use it on a laptop for battery status to work.
Mediation
If you are using this kext on a desktop, remove it.
If you are not using this kext and are using a laptop, add it (along with SMCBatteryManager
).
AmdTscSync
Summary
It was recommended to use this kexts on AMD APUs, but we have now made a new proper TSC sync kext replacing all other TSC sync kexts (even Intel).
This also includes Seey6/CpuTscSync
.
Mediation
Replace all TSC sync kexts with ForgedInvariant
.
ACPI
PatchMerge
missing Results/config.plist
step
Summary
There was a missing step, where you would copy the modified Config.plist
from Results/config.plist
replacing your old Config.plist
.
Mediation
Rerun the tool, copy the resulting SSDTs into your EFI, and after running PatchMerge
, replace your configuration with the newly generated one, as per the current instructions in the guide.