• Become a Premium Member for $25/year with no ads to improve your community experience.

INFO Common SSDT usage for macOS

Common SSDT usage for macOS


What is SSDT?

In order to boot into the installation, you need to add the necessary SSDTs. Depending on the Platform you have, copy the SSDTs from OpenCore/RELEASE/Docs/AcpiSamples/Binaries to EFI/OC/ACPI directory.

QUICK INFO:
Driver marked with * are bundled with OpenCore. Additional SSDTs described here can be downloaded from the SSDTs Download section.

SSDT NameNotes
SSDT-ALS0.aml*
  • Enables Ambient Light Sensor ACPI Device
  • Required for Backlight functioning
  • Required for AIO and Laptops only.
SSDT-BRG0.aml
  • Adds missing ACPI device for proper GPU initialization.
  • Reduces boot time and provides faster userspace.
  • Required for mainly GPUs. If there are other devices that have missing ACPI devices, it is recommended to create an SSDT for such. See Tuning ACPI for more information.
  • Relevant for AMD Vega, RX 5000 series, and newer GPUs
  • Required for all versions of macOS and is mandatory for macOS Big Sur (11.x) and later.
SSDT-EC.aml*
  • Fixes EC.
  • Required for Penryn to Broadwell
SSDT-EC-USBX.aml*
  • Fixes EC and USB Power Supply
  • Required for EC and correcting USB Power Supply.
  • Required for Skylake and Later
SSDT-AWAC-DISABLE.aml*
  • Serves 300 series RTC patch.
  • Fixes stuck at apfs_module_start error while booting into macOS
  • Required for Coffee Lake and Later.
  • Do not use SSDT-AWAC-DISABLE.aml and SSDT-RTC0.aml or SSDT-RTC0-RANGE.aml together
SSDT-PM.aml
  • Enables CPU Power Management on Legacy Intel CPUs (Ivy Bridg and prior).
  • Fixes potential issues such as sleep/wake function and improves CPU performance
  • Required for proper CPU and GPU Power Management.
  • Required for Ivy Bridge and prior. Use SSDT-PLUG.aml for Haswell and later.
  • See X79 CPU Power Management for more information on X79 CPU Power Management.
SSDT-PLUG.aml*
  • Enables native CPU Power Management (XCPM) function on Haswell and newer CPUs.
  • Fixes potential issues such as sleep/wake function and improves CPU performance
  • Required for proper CPU and GPU Power Management.
  • Requires MSR unlocked Motherboard. Where not feasible, use the Bootloader patch.
  • Required for Haswell to Rocket Lake Systems.
  • Required for up to macOS Big Sur (11.x) only.
  • Use SSDT-PM.aml generated using ssdtPRGen script for Ivy Bridge and prior.
SSDT-PLUG-ALT.aml*
  • Enables native CPU Power Management function on Alder Lake and newer CPUs.
  • Fixes potential issues such as sleep/wake function and improves CPU performance
  • Required for proper CPU and GPU Power Management.
  • Requires MSR unlocked Motherboard. Where not feasible, use the Bootloader patch.
  • Required for Alder Lake and newer CPUs.
  • Use SSDT-PLUG.aml for Comet Lake and prior.
SSDT-PNLF.aml*
  • Provides Backlight support
  • Adds a Brightness slider in System Preferences>Displays.
  • Required for Brightness control.
  • Requires a full Graphics acceleration with QE/CI.
  • Requires WhateverGreen.kext to function.
  • Must load after all OEM DSDT and SSDTs
  • Requires mapping Brightness keys for a functional Brightness Control via Hotkeys. See remapping Brightness Hotkeys for more information.
SSDT-EHCx-DISABLE.aml*Required for 7, 8, and 9-series Chipsets on 10.11 and newer.
SSDT-HV-CPU.aml*
  • Enables proper CPU detection under macOS
  • Required for Hyper-V only.
  • Requires MacHyperVSupport.kext to function.
SSDT-HV-VMBUS.aml*
  • Enables ACPI node identification
  • Required for Hyper-V only
  • Requires MacHyperVSupport.kext to function.
SSDT-HV-PLUG.aml*
  • Enables VMplatformPlugin on Big Sur and newer
  • Required for Hyper-V only
  • This SSDT must be loaded after SSDT-HV-CPU.aml
  • Requires MacHyperVSupport.kext to function.
SSDT-IMEI.aml*
  • Enables missing IMEI Device
  • Required for IGPU Graphics acceleration on macOS.
  • Required when no IMEI device (with any name) is present in the native DSDT.
  • Usually required for Sandy Bridge CPUs on 7 Series Chipsets and Ivy Bridge CPUs on 6 Series Chipsets.
  • Requires a custom device-id in DeviceProperties for Sandy Bridge and Ivy Bridge Systems. See injecting Device Properties and booting macOS for more information.
  • Do not use if IMEI Device is present with the 0x00160000 address in the native DSDT.
SSDT-PMC.aml*
  • Enables NVRAM support
  • Fixes NVRAM, Sleep/Wake, and Restart/Shut Down
  • Fixes the black screen after macOS finishes loading and is applicable for IGPU, NVIDIA and AMD GPUs.
  • Required for all 300 series motherboards except Z370.
SSDT-RTC0.aml*
  • Required for 300 series chipset only
  • Can fix stuck at PCI Configuration begin error when booting into macOS
  • Required where SSDT-AWAC.aml is not compatible
  • Do not use SSDT-RTC0.aml or SSDT-RTC0-RANGE.aml and SSDT-AWAC-DISABLE.aml together.
SSDT-RTC0-RANGE.aml*
  • Required for all X99 and X299 Motherboards
  • Can fix stuck at PCI Configuration begin error when booting into macOS
  • Do not use SSDT-RTC0-RANGE.aml or SSDT-RTC0.aml and SSDT-AWAC-DISABLE.aml together.
SSDT-SBUS-MCHC.aml*
  • Adds missing MCHC Device
  • Fixes AppleSMBus support in macOS/OS X.
  • Required when no MCHC device is present in the native DSDT.
  • Do not use if MCHC is present in your DSDT.
SSDT-UNC.aml*
  • Disables unused devices in ACPI
  • Ensures IOPCIFamily doesn't Kernel Panic
  • Required for Sandy Bridge-E to Broadwell-E Systems.
SSDT-DMAC
  • Adds Direct Memory Access Controller (DMA) to the LPCB.
  • Do not use this SSDT if an existing DMAC or DMAD Device is present in the native DSDT.
  • Usually not required for HEDT and Server grade Systems.
SSDT-FWHDAdds virtual Firmware Hub Device (FWHD)
SSDT-MEM2
  • Adds MEM2 ACPI Device to IGPU
  • Required for Systems with Intel IGPUs only.
  • Required for Haswell to Kaby Lake Systems.
  • Do not use this SSDT if you have a dGPU-only system.
SSDT-XSPIAdds Intel PCH SPI Controller
SSDT-PWRB
  • Enables Power button ACPI Device
  • Mainly relevant for Laptops but still some desktops may lack it.
  • Do not use this SSDT if an existing ACPI Device with PNP0C0C _HID is present in the native DSDT.
SSDT-SLPB
  • Enables Sleep button ACPI Device.
  • Mainly relevant for Laptops but still some desktops may lack it.
  • Do not use this SSDT if an existing ACPI Device with PNP0C0E _HID is present in the native DSDT.
 
Last edited:

Forum statistics

Threads
1,638
Messages
15,377
Members
23,452
Latest member
timothee