# Configuration

# Preparation

# Xcode

N/A

# IORegistryExplorer

Sign in to the Apple Developer site using your Apple ID credentials. Once logged in, look for the most relatable version of the Additional Tools for Xcode and download it.

The download will mount itself in Finder as any .dmg file would, look for the IORegistryExplorer and move it to your /Applications directory.

# MaciASL

Download the latest version of the MaciASL compiler. Make sure to set the compiler to version 6.x of ACPI.

# AppleIntelInfo

N/A

# Clover Configurator

Download the Clover Configurator application and place it in your /Applications directory.

# Kext Management

Launch Terminal and execute the following command to create a .bashrc file within the home directory.

vim ~/.bashrc
Copy

Enter edit mode by pressing the i key, and then paste the following snippet;

function addkext {
    source=$1
    kextName=$(basename $source)
    targetDir="/Library/Extensions"
    target="$targetDir/$kextName"

    # Ask for the administrator password upfront
    sudo -v

    # Move the kext into the target directory
    sudo mv $source $target
    # Change the permission & owner of the kext
    sudo chmod -R 755 $target
    sudo chown -R root:wheel $target
    # Load the kext
    sudo kextload $target

    # Rebuild the kext cache
    # sudo touch $targetDir && sudo kextcache -u /

    clear
    echo -e "\r\n\x1B[0m Installed Kext: \x1B[47m\x1B[30m $targetDir/ \x1B[42m\x1B[30m $kextName \x1B[0m"
    echo -e "\r\n\x1B[0m Remember to rebuild the kext cache, and restart your system \x1B[0m\r\n"
}

function removekext () {
    source=$1
    kextName=$(basename $source)
    targetDir="/Library/Extensions"
    backupDir="/Users/$(whoami)/.kextbackup/$(date '+%s')"
    backup="$backupDir/$kextName"

    # Ask for the administrator password upfront
    sudo -v

    # Create the backup directory
    sudo mkdir -p $backupDir

    # Move the source file to our new backup directory
    sudo mv $source $backup

    clear
    echo -e "\r\n\x1B[0m Uninstalled Kext: \x1B[47m\x1B[30m $targetDir/$kextName \x1B[0m"
    echo -e "\x1B[0m           Backup: \x1B[42m\x1B[30m $backup \x1B[0m"
    echo -e "\r\n\x1B[0m Remember to rebuild the kext cache, and restart your system \x1B[0m\r\n"
}

function rebuildkext () {
    # Rebuild the kext cache
    sudo kextcache -i /

    clear
    echo -e "\r\n\x1B[0m Kext Cache: \x1B[47m\x1B[30m /Library/Extensions/ \x1B[42m\x1B[30m Rebuilt \x1B[0m\r\n"
}
Copy

Save and exit by first exiting out of edit mode by pressing ESC. Once out of edit mode, type :wq. As soon as you've exited the vim editor, run the following command to initialise our new bash functions.

source ~/.bashrc
Copy

# Generic Patches

# Clover Configuration

Apply the following settings to your /EFI/Clover/config.plist file;

# Driver Installation

Download the following items and place them within the /EFI/Clover/drivers64UEFI directory.

# Kext Installation

Download the following items and place them within the ~/Downloads directory.

Launch the Terminal and execute the following command to install the kexts, remember to change the path relative to your kexts.

addkext ~/Downloads/FakePCIID.kext
addkext ~/Downloads/VoodooTSCSync.kext
addkext ~/Downloads/FakeSMC.kext
addkext ~/Downloads/FakeSMC_ACPISensors.kext
addkext ~/Downloads/FakeSMC_CPUSensors.kext
addkext ~/Downloads/FakeSMC_GPUSensors.kext
addkext ~/Downloads/FakeSMC_LPCSensors.kext
Copy

Finally, and optionally, move the HWMonitor.app into your /Applications directory.

# Injecting USB

# Clover Configuration

Apply the following settings to your /EFI/Clover/config.plist file in order to properly inject USB into your system;

# Kext Installation

Download the following item and place it within the ~/Downloads directory.

Launch the Terminal and execute the following command to install the kext, remember to change the path relative to your kext.

addkext ~/Downloads/USBInjectAll.kext
Copy

addkext ~/Downloads/XHCI-x99-injector.kext
Copy

# Injecting Audio

# Clover Configuration

Apply the following settings to your /EFI/Clover/config.plist file in order to properly inject audio into your system;

# Kext Installation

Download the following item and place it within the ~/Downloads directory.

Launch the Terminal and execute the following command to install the kext, remember to change the path relative to your kext.

addkext ~/Downloads/VoodooHDA.kext
Copy

# Injecting Internet

# Kext Installation

Download the following items and place them within the ~/Downloads directory.

Launch the Terminal and execute the following command to install the kexts, remember to change the path relative to your kexts.

addkext ~/Downloads/AppleIntelE1000e.kext
addkext ~/Downloads/FakePCIID_Broadcom_WiFi.kext
Copy

# Injecting Bluetooth

# Kext Installation

Download the following items and place them within the ~/Downloads directory.

Launch the Terminal and execute the following command to install the kexts, remember to change the path relative to your kexts.

addkext ~/Downloads/BrcmFirmwareRepo.kext
addkext ~/Downloads/BrcmPatchRAM2.kext
Copy

# Injecting Graphics

# Clover Configuration

Apply the following settings to your /EFI/Clover/config.plist file in order to properly inject the NVIDIA drivers into your system;

# NVIDIA Web Drivers

Our safest bet is to rely on the nVidia Update repository.

Launch the Terminal and execute the following command;

bash <(curl -s https://raw.githubusercontent.com/Benjamin-Dobell/nvidia-update/master/nvidia-update.sh)
Copy

# NVIDIA Cuda Drivers

Download the latest

# Bootloader

In order to prevent resolution flickering between the bootloader and the login window, as well as possible "no signal" issues with multiple monitors, we must make a few adjustments to our setup.

For any "no signal" issues with DisplayPort connections, try moving the connections around if there are free DisplayPort slots on your graphics card.

When these settings are applied, you'll want to make sure that the CsmVideoDxe-64.efi driver isn't installed, as well as disabling CSM in the UEFI.

# NVMe Drives

As of High Sierra, macOS now supports NVMe natively out of the box. It may however interpret it as an external drive regardless of whether it is internal or external.

In order to mitigate this, launch

If the above kext patch doesn't work, we may instead create a custom ACPI patch. Launch IORegistryExplorer and search for nvme. In the dropdown field just below the search bar, you should see the full path to the NVMe controller.

Launch

Place the newly created .aml file within the /EFI/Clover/ACPI/patches directory, so as you have /EFI/Clover/ACPI/patches/SSDT-NVMe-extern-icon-patch.aml.

/*
 * Intel ACPI Component Architecture
 * AML/ASL+ Disassembler version 20180427 (64-bit version)(RM)
 * Copyright (c) 2000 - 2018 Intel Corporation
 * 
 * Disassembling to non-symbolic legacy ASL operators
 *
 * Disassembly of iASLC8MKNF.aml, Tue Aug 21 22:33:17 2018
 *
 * Original Table Header:
 *     Signature        "SSDT"
 *     Length           0x000000C4 (196)
 *     Revision         0x02
 *     Checksum         0x15
 *     OEM ID           "hack"
 *     OEM Table ID     "nvme"
 *     OEM Revision     0x00000000 (0)
 *     Compiler ID      "INTL"
 *     Compiler Version 0x20160422 (538313762)
 */
DefinitionBlock ("", "SSDT", 2, "hack", "nvme", 0x00000000)
{
    External (_SB_.
lPCI0
.
lBR1B
, DeviceObj)    // (from opcode)
    External (_SB_.
lPCI0
.
lBR1B
.
lH000
._ADR, UnknownObj)    // (from opcode)

    Scope (\_SB.
lPCI0
.
lBR1B
)
    {
        Device (NVME)
        {
            Name (_ADR, Zero)  // _ADR: Address
            Name (_SUN, One)  // _SUN: Slot User Number
            Method (_INI, 0, NotSerialized)  // _INI: Initialize
            {
                Store (0x0F, \_SB.
lPCI0
.
lBR1B
.
lH000
._ADR)
            }

            Method (_DSM, 4, NotSerialized)  // _DSM: Device-Specific Method
            {
                If (LEqual (Arg2, Zero))
                {
                    Return (Buffer (One)
                    {
                         0x03                                           
                    })
                }

                Return (Package (0x02)
                {
                    "built-in", 
                    Buffer (0x0A)
                    {
                        "NVMe SSD"
                    }
                })
            }
        }
    }
}
Copy

# CPU Power Management

# Intel P & C States

Launch

Once your computer is back up and running, launch the Terminal and run the folliwng command;

sysctl machdep.xcpm.mode
Copy

If everything works as expected, you should see a 1 being returned.

If you're using the MacPro6,1 system definition, download

./freqVectorsEdit.sh
Copy

Follow the on-screen instructions and select the number representing iMac15,1 when asked for a donor file. Reboot when prompted.

Now, download

sudo ./ssdtPRGen.sh -turbo 
l4200
Copy

When the above command has finished, navigate over to ~/Library/ssdtPRGen and copy the ssdt.aml file into the /EFI/Clover/ACPI/patches directory of your hard drive's EFI partition. Rename it to SSDT-XCPM.aml. Again, reboot your computer.

Lastly, it's time to run a few tests to make sure everything went well.

# Should display plugin-type = 1
ioreg -l | grep -A 25 CP00@0 | grep plugin-type

# Should display com.apple.driver.X86PlatformPlugin
kextstat | grep -y x86plat

# Should NOT display anything
kextstat | grep -y appleintelcpu

# Should display 1
sysctl -n machdep.xcpm.vectors_loaded_count

# Should display a bunch of P & C state lines at the end of the output
sudo kextload ~/Desktop/AppleIntelInfo.kext
sudo cat /tmp/AppleIntelInfo.dat

# Finally, unload the AppleIntelInfo.kext
sudo kextunload ~/Desktop/AppleIntelInfo.kext
Copy

Should this fail at some stage, please refer to this guide.

# Intel SpeedStep Technology

Verify that Enhanced Intel SpeedStep Technology (EIST) is enabled in your BIOS. Please note that enabling EIST breaks any hope of sleep/wake functionality.

You must also make the following changes to the System Preferences.

Launch Terminal and run the following command;

addkext ~/Downloads/PMDrvr.kext
Copy