Dell Latitude 5591 Hackintosh (OpenCore)

macOS on Dell Latitude 5591 (i5-8400H)

Disclaimer

Always make a backup before start. I'm not responsible for bricked laptops, dead USB drives, thermonuclear war, or you getting fired because the Intel processor exploded (here I'm kidding you 😜).

Guide

IMPORTANT NOTE

If you are upgrading from OpenCore v0.6.2 you MUST replace the whole OC folder with the one generated from build script (adding missing files as per guide) and EFI/BOOT/BOOTX64.efi file otherwise you will not able to boot again from MacOS. You CANNOT just replace files or add/remove missing ones since from v0.6.2 to v0.6.7 lot of things changed as well as lot of ACPI lines changed from previous Dell BIOS version to latest one.

Requirements

Running on macOS, Windows or Linux (on Windows you can use WSL https://docs.microsoft.com/it-it/windows/wsl/install-win10)
MaciASL for macOS; acpidump for Windows
Curl installed (if not just run the script and complete the installation process)
USB 2.0 flash drive 12 GB or more (if you have USB 3.0 plug in into USB 2.0 port during booting phase otherwise it will not be recognized)
Internet connection (obviously 😜)

BIOS setup

Make sure your BIOS is up to date. If not install latest from Dell sitee
Reboot to BIOS Setup
Enable Boot from USB and Legacy boot
Disable Fast boot and Secure boot
Disable Intel VT-d
Make sure SATA mode is set to AHCI

Bootable USB creation

Just follow official OpenCore guide here: Creating the USB

EFI Installation

Clone this repository
Run build.sh from terminal (if using WSL on Windows first install dos2unix and run dos2unix build.sh to convert the script to unix format)
Open Out/EFI/OC/config.plist and follow this guide to correctly fill "PlatformInfo">"Generic" empty fields (Do not change "SystemProductName" value, just use the given one)
Run build.sh script and wait while it prepares the EFI folder for you (it may takes long depending on you internet connection quality)
Then copy entire EFI folder to your USB flash drive EFI partition you created previously. It should look like the following

Now it's time to boot macOS installer from your USB drive

macOS installation

On OpenCore boot screen select "Install macOS from your_usb"
Assuming your are dual booting with Windows once you have reached install screen choose "macOS Installation"
Select target partition created before and follow the installer

Post installation

Download MountEFI script and run it
Select HDD macOS partition to mount EFI
Open your USB drive and head to EFI folder
Copy BOOT and OC folders to HDD EFI partition (if you've previously installed CLOVER first make a backup, then delete CLOVER folder and BOOT/BOOTx64.efi or just replace it with OC's one)
Follow this guide to disable "CFG Lock" (Remember to disable "AppleCpuPmCfgLock" and "AppleXcpmCfgLock" under "Kernel">"Quirks" once done)
Open System Preferences and disable PowerNap and wake on ethernet under "Energy Saving"
Copy Audio/alcplugfix_config.plist under your home directory
Run script Audio/install.sh to fix 3.5mm jack output, follow instructions (it will ask you to drag the alcplugfix_config.plist file, drag it from your home directory) and reboot
Fix iServices following these instructions.
(Optional) If you are dual booting with Windows or Linux, follow these instructions to prevent issues where either Windows or Linux try to overwrite the EFI/BOOT/BOOTx64.efi path.

ACPI

ACPI file	Description
SSDT-AWAC	Fix System Clocks
SSDT-BRT6	Fixing the brightness keys
SSDT-EC-USBX	Adds missing EC controller and inject USB power properties
SSDT-PLUG	Injects plugin-type to fix Native Power Management
SSDT-PNLF	Injects backlight properties to fix backlight control
SSDT-PTWK	Fixes screen wake
SSDT-SBUS-MCHC	Fixes Serial BUS for correct sensors management and adds missing MCHC device
SSDT-WKSC	Wakes our screen up on waking
SSDT-XOSI	Patches _OSI to XOSI

Kexts

Kext file	Description
AlpsHID	Touchpad + Trackpoint support
AppleALC	Fixes onboard audio
BlueToolFixup	Support kext for IntelBluetoothFirmware
IntelBluetoothFirmware	Fixes Bluetooth
IntelMausi	Intel LAN drivers
itlwm	OpenSource WiFi Drivers from OpenIntelWireless. Needs HeliPort for configuration
Lilu	Fixes lot of things and make laptop boot
RealtekCardReader	Enables SD card reader support
RealtekCardReaderFriend	SD card reader support data
SMCBatteryManager	Fixes battery percentage
SMCDellSensors	Enhance sensors support like thermal sensors
USBMap	Correctly maps USB ports and their types WARNING: the left USB port is unmapped, as mine is broken. Use https://github.com/corpnewt/USBMap to properly map yours.
VirtualSMC	Fakes our laptop as MacBook making it boot
VoodooI2C	Fixes trackpad
VoodooI2CHID	VoodooI2C plugin for Precision Trackpad
VoodooPS2Controller	Fixes keyboard
WhateverGreen	Fixes Intel HD Graphics and other graphics stuffs

Troubleshooting

To get help just open a issue or visit hackintosh sites on the web:

https://www.insanelymac.com and others

Where can I learn more?

Thanks

@Acidanthera team for this new and more macOS friendly bootloader
@crypticplank for the updated guide for Big Sur
@dortania team for detailed guides
@corpnewt for his amazing scripts, ACPIs, plugins
@VoodooI2C for make I2C trackpad's gestures possible
@RehabMan for his crucial role in the hackintosh world. That will never be forgotten since most of the projects above are based on his work.
@OpenIntelWireless for their work on Intel Wi-Fi cards (no anyone else wanted to work on this in the past so he's doing something deemed by all impossible)
@0xFireWolf for his work on Realtek card reader driver (finally someone is working on it)
@arch-dev for his Inspiron 5767 repo this is based on

Myself5/DellLatitude5591Hackintosh