/WhateverGreen

Various patches necessary for certain ATI/AMD/Intel/Nvidia GPUs

Primary LanguageC++BSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

WhateverGreen

Build Status Scan Status

Lilu plugin providing patches to select GPUs on macOS. Requires Lilu 1.2.5 or newer.

Features

  • Fixes boot to black screen on AMD and NVIDIA
  • Fixes sleep wake to black screen on AMD
  • Fixes boot screen distortion in certain cases
  • Fixes transmitter/encoder in autodetected connectors for multimonitor support (-raddvi)
  • Fixes HD 7730/7750/7770/R7 250/R7 250X initialisation (radpg=15)
  • Allows tuning of aty_config, aty_properties, cail_properties via ACPI
  • Allows enforcing 24-bit mode on unsupported displays (-rad24)
  • Allows booting without video acceleration (-radvesa)
  • Allows automatically setting GPU model name or providing it manually for RadeonFramebuffer
  • Allows specifying custom connectors via device properties for RadeonFramebuffer
  • Allows tuning autodetected connector priority via device properties (HD 7xxx or newer)
  • Fixes an issue in AppleGraphicsDevicePolicy.kext so that we could use a MacPro6,1 board-id/model combination, without the usual hang with a black screen. Patching AppleGraphicsDevicePolicy.kext
  • Modifies macOS to recognize NVIDIA's web drivers as platform binaries. This resolves the issue with transparent windows without content, which appear for applications that use Metal and have Library Validation enabled. Common affected applications are iBooks and Little Snitch Network Monitor, though this patch is universal and fixes them all. NVWebDriverLibValFix
  • Injects IOVARendererID into GPU properties (required for Shiki-based solution for non-freezing Intel and/or any discrete GPU)
  • Allows to use ports HDMI, DP, Digital DVI with audio (Injects @0connector-type - @5connector-type properties into GPU)
  • Fixes NVIDIA GPU interface stuttering on 10.13 (official and web drivers)

Documentation

Read FAQs and avoid asking any questions. No support is provided for the time being.

Boot arguments

  • -wegdbg to enable debug printing (available in DEBUG binaries).
  • -wegoff to disable WhateverGreen.
  • -wegbeta to enable WhateverGreen on unsupported os versions (10.13 and below are enabled by default).
  • -wegnoegpu to disable external GPU (or add disable-external-gpu property to IGPU)
  • -radvesa to disable ATI/AMD video acceleration completely.
  • -igfxvesa to boot Intel graphics without hardware acceleration (VESA mode).
  • -rad24 to enforce 24-bit display mode.
  • -raddvi to enable DVI transmitter correction (required for 290X, 370, etc.).
  • radpg=15 to disable several power-gating modes (see FAQ, required for Cape Verde GPUs).
  • agdpmod=cfgmap enforcing none into ConfigMap dictionary for system board-id
  • agdpmod=vit9696 disables check for board-id , enabled by default
  • agdpmod=pikera replaces board-id with board-ix
  • ngfxgl=1 boot argument (and disable-metal property) to disable Metal support on NVIDIA
  • ngfxcompat=1 boot argument (and force-compat property) to ignore compatibility check in NVDAStartupWeb
  • ngfxsubmit=0 boot argument to disable interface stuttering fix on 10.13
  • igfxrst=1 to prefer drawing Apple logo at 2nd boot stage instead of framebuffer copying.
  • igfxframe=frame to inject a dedicated framebuffer identifier into IGPU (only for TESTING purposes).
  • igfxsnb=0 to disable IntelAccelerator name fix for Sandy Bridge CPUs.
  • igfxgl=0 to disable Metal support on Intel.
  • -igfxnohdmi to disable DP to HDMI conversion patches for digital sound.
  • -cdfon (and enable-hdmi20 property) to enable HDMI 2.0 patches.
  • -igfxdump to dump IGPU framebuffer kext to /AppleIntelFramebuffer_X_Y (available in DEBUG binaries).
  • -igfxfbdump to dump native and patched framebuffer table to ioreg at IOService:/IOResources/WhateverGreen

Credits

  • Apple for macOS
  • AMD for ATOM VBIOS parsing code
  • The PCI ID Repository for multiple GPU model names
  • Floris497 for the CoreDisplay patches
  • headkaze Intel framebuffer patching code
  • igork for power-gating patch discovery
  • lvs1974 for continuous implementation of Intel and NVIDIA fixing code
  • mologie for creating NVWebDriverLibValFix.kext which forces macOS to recognize NVIDIA's web drivers as platform binaries
  • PMheart for CoreDisplay patching code and Intel fix backporting
  • RehabMan for various enhancements
  • RemB for continuing sleep-wake research and finding the right register for AMD issues
  • Vandroiy for maintaining the GPU model detection database
  • YungRaj and syscl for Intel fix backporting
  • vit9696 for writing the software and maintaining it