INFO Common Device Properties for macOS [Clover/OpenCore]

[EliteMacx86]

Common Device Properties for macOS [Clover/OpenCore]

Kexts Specific


WhateverGreen

---

Global

Device Properties	Description
enable-hdmi20	Enables CoreDisplayFixup functionality via WhateverGreen.kext. Enables HDMI 2.0 patches on IGPU and dGPU. Patches CheckTimingWithRange in CoreDisplay.framework to skip validation of the pixel clock. This prevents a black screen for HDMI in UHD resolution with 60FPS or more. Required for Laptops and OEM systems with 4K/UHD/QHD Displays. If you get "gIOScreenLockState3 error", you'll need to use this property. Does not work on macOS Big Sur (11.x) and later.
rebuild-device-tree	Forces device renaming on Apple FW.
no-gfx-spoof	Avoids forcing of original device-id value from PCI I/O Useful for Graphics spoofs. See Spoofing Graphics for more information. Only valid for GPUs. No other type of device spoof is supported using this property.

Board-id

Device Properties	Description
agdpmod	Disables board-id check. Fixes black screen
agdpmod	Replaces board-id with board-ix. Fixes black screen when macOS finishes loading. Required for Navi-based AMD GPU.
agdpmod	Disables AGDP patches (vit9696,pikera value is implicit default for external GPUs)

GPU Switching

disable-gpu	Disables all external GPUs (NVIDIA and AMD). Mainly required on Dual GPU Laptops. Users who have patched ACPI and dGPU is disabled via DSDT and SSDT, you don't need to use this boot arg. This boot arg is a temporary solution. It's recommended to patch your DSDT and related SSDTs to disable the discrete Graphics for a better power management and improved battery performance.
disable-gpu	Disables internal GPU Requires property on IGPU.
switch-to-external-gpu	Disables internal GPU when external GPU is installed.

NVIDIA Graphics

disable-metal	Disables metal support on NVIDIA GPUs
force-compat	Ignores compatibility check in NVDAStartupWeb
disable-gfx-submit	Disables interface stuttering fix on 10.13

Intel Graphics

AAPL,snb-platform-id	Injects a dedicated framebuffer identifier into IGPU Only for Sandy Bridge.
AAPL,ig-platform-id	Injects a dedicated framebuffer identifier into IGPU Only for Ivy Bridge and Later.
disable-metal	Disables Metal support on IGPU.
enable-metal	to force enable Metal support on Intel for offline rendering.
igfxpavp	to force enable PAVP output
igfxfw	Forces loading of Apple GuC firmware Requires 300 series chipset.
disable-hdmi-patches	Disables DP to HDMI conversion patches for digital sound.
enable-dpcd-max-link-rate-fix	Fixes invalid maximum link rate This property on IGPU can fix the invalid link rate otherwise a kernel panic can occur due to a division-by-zero. Usually required by Laptops with a Sharp Display and more refresh rate.
enable-hdmi-dividers-fix	Fixes the infinite loop when establishing an HDMI connection with a higher pixel clock. For example, connecting to a 2K/4K display with HDMI 1.4, otherwise, the system just hangs and the built-in display will remain black when plugging the HDMI cable.
enable-lspcon-support	Enables LSPCPN driver support to enable DisplayPort to HDMI 2.0 output on IGPU. LSPCON driver is only applicable for Laptops with HDMI 2.0 routed to IGPU. If your HDMI 2.0 is routed to IGPU and is working properly right now, you don't need to enable this driver, as your onboard LSPCON might have been already configured in the firmware to work in PCON mode. This property can also provide HDR signaling over HDMI.
disable-telemetry-load	Disables iGPU telemetry loading that may cause a freeze during startup on certain laptops such as Chromebooks
disable-agdc	Disables AGDC
complete-modeset	to force complete modeset on Skylake or Apple firmwares.
complete-modeset-framebuffers	to specify indices of connectors for which complete modeset must be enforced. Each index is a byte in a 64-bit word; for example, value 0x010203 specifies connectors 1, 2, 3. If a connector is not in the list, the driver's logic is used to determine whether complete modeset is needed. Pass -1 to disable.
force-online	Forces online status on all displays. Resolves display after wake on CFL and later.
force-online-framebuffer	to specify indices of connectors for which online status is enforced. Format is similar to igfxfcmsfbs
rps-control	Enables RPS control patch (improves IGPU performance)
enable-cdclk-frequency-fix	Enables all valid Core Display Clock (CDCLK) frequencies on ICL platforms. This property on IGPU can be used to prevent a kernel due to an unsupported CD clock decimal frequency. Usually required by Laptops with lower clock frequency values such as 172.8MHz.
enable-dvmt-calc-fix	Fixes Kernel Panic due to incorrect amount of DVMT pre-allocated memory. This property on IGPU can fix the invalid link rate otherwise a kernel panic can occur due to a division-by-zero. Usually required by Laptops where the BIOS is locked and the variables cannot be modified using Shell.
enable-max-pixel-clock-override max-pixel-clock-frequency	Fixes HDMI in UHD resolution with 60FPS This property on IGPU can be used to raise the max pixel clock limit (as an alternative to patching CoreDisplay.framework). Prevents black screen on 4K/UHD/QHD Displays @60Hz and HDMI 2.0 in UHD resolution with 60Hz or more. Requires Invalid Maximum Link rate for Laptop Displays with more than 60Hz. This property can be used for 4K@60Hz over HDMI 2.0. Required for Laptops and OEM systems with 4K/UHD/QHD Displays @60Hz. If you get "gIOScreenLockState3" when booting, you'll need to use this property.
enable-backlight-smoother	Make brightness transitions smoother on IVB+ platforms
enable-dbuf-early-optimizer	Fixes garbled display on the built-in screen on Ice Lake platforms.

Backlight

applbkl	Disables AppleBacklight.kext patches for IGPU Requires this property on IGPU.
applbkl	Enables PWM backlight control of AMD Radeon RX 5000 series graphic cards

AppleALC

---

alc-layout-id	Sets Layout ID for AppleALC. Only relevant for Apple hardware.
layout-id	Sets Layout ID for AppleALC. Relevant for both Apple and non-Apple hardware.
alc-verbs	Enables alc-verb support.
alc-delay	Adds delay in AppleHDAController. Useful where the hardware isn't initialized in time for AppleHDAController which results in no Audio output. Must not exceed 3000ms.
external-audio	Disables Audio patching on external Audio devices.
alctcsel	Fixes Audio on macOS after rebooting from Windows.

AirPortBrcmFixup

---

brcmfx-country=XX	Changes the country code to XX (US, CN, #a, ...) Can be injected via DSDT or Properties → DeviceProperties in bootloader
brcmfx-aspm	Overrides value used for pci-aspm-default Possible values for brcmfx-aspm (and pci-aspm-default): 0 disables ASPM kIOPCIExpressASPML0s = 0x00000001, kIOPCIExpressASPML1 = 0x00000002, kIOPCIExpressCommonClk = 0x00000040, kIOPCIExpressClkReq = 0x00000100
brcmfx-driver=0|1|2|3	Enables only one kext for loading 0 - AirPortBrcmNIC-MFG, 1 - AirPortBrcm4360, 2 - AirPortBrcmNIC, 3 - AirPortBrcm4331,

IntelMausi

Device Property	Description
mausi-force-wol	Froce enables Wake on LAN functionality for Intel Ethernet for testing purposes. Required for misconfigured hardware. Requires IntelMausi.kext.

VoodooI2C

force-polling	Force enable polling mode for specific I2C Controller. Required where APIC interrupt is unavailable.