the-braveknight
Moderator
- Joined
- Nov 24, 2015
- Messages
- 1,220
- Motherboard
- Lenovo Legion Y520 (Clover)
- CPU
- i7-7700HQ
- Graphics
- HD 630 (1920x1080) + Nvidia GTX 1060
- Mac
- Mobile Phone
Overview
The purpose of this guide is to provide a step-by-step guide to installing El Capitan on the Lenovo ThinkPad E550 (Haswell) and similar models as well.
Note: This guide is completely based on RehabMan's guides and scripts, I take no credits for this guide, I only modified his scripts and tools to work with this laptop.
My machine is a ThinkPad E550 (Haswell) with Broadcom BCM94352Z and SSD.
What you need
- Lenovo ThinkPad E550 (Haswell).
- OS X El Capitan or Yosemite downloaded from the Mac App Store
- 8GB USB stick
- Broadcom BCM943602BAED or BCM94352Z for native WiFi/BT
BIOS settings
To start, set BIOS to Windows defaults.
Then insure:
- UEFI boot is enabled
- secure boot is disabled
- enable CSM mode and you may experience less boot time glitches
Preparing USB and initial Installation
- Use the 'createinstallmedia' approach. It works well, and there is little chance for pilot error. This method also gives you an OS X recovery partition. Follow RehabMan's guide here > [Guide] Booting the OS X Installers on LAPTOPS with Clover.
- Definitely copy IntelMausiEthernet.kext to Clover/kexts/Other as having network support during post-install is helpful. The rest of this guide depends on it. An alternate is to copy FakePCIID.kext and FakePCIID_Broadcom_WiFi.kext to Clover/kexts/Other. This will enable WiFi, provided you have a compatible WiFi card already installed.
Note: FakePCIID.kext and FakePCIID_Broadcom_WiFi.kext are available here: https://github.com/RehabMan/OS-X-Fake-PCI-ID
- Some of these laptops come with ELAN/Alps/other trackpads so RehabMan's VoodoPS2Controller.kext might not work properly. An alternate is to download ELAN kext from the E550 repo.
- GenericUSBXHCI.kext is not necessary with this laptop since AppleUSBXHCI.kext appears to work well natively. Also, GenericUSBXHCI.kext does not work on 10.11 so it should not be used.
- Use the config_install.plist from the e550 repo: https://github.com/the-braveknight/Lenovo-ThinkPad-E550-DSDT-Patch/raw/master/config_install.plist
Post Installation
- Downlad Clover UEFI from here : Clover UEFI Bootloader
- Install Clover UEFI to your internal SSD/HDD and make sure you click 'Customize' and select:
- Install for UEFI booting only
- Install Clover in the ESP
- Dirvers64UEFI > OsxAptioFixDrv-64
- Copy HFSPlus.efi to drivers64UEFI folder.
Installation of the tools and patching is easy provided the scripts and tools at the repository: https://github.com/the-braveknight/Lenovo-ThinkPad-E550-DSDT-Patch
To start, the developer tools must be installed. Run Terminal, and type:
You will be prompted to install the developer tools. Since you have internet working, you can choose to have it download and install them automatically. Do that before continuing.
After the developer tools are installed, we need to make a copy of the project on github.
In Terminal:
Now it is time to install some more tools and all the kexts that are required...
To download the kexts & tools, in Terminal:
To install:
Or if you don't have a Synpatics trackpad:
The download.sh script will automatically gather the latest version of all tools (patchmatic, iasl, MaciASL) and all the kexts (IntelBacklight.kext, ACPIBatteryManager.kext, etc) from bitbucket. The install_downloads.sh will automatically install them to the proper locations.
If you wish, you can reboot to verify a few more items are working (many only partially).
To finish the setup, we need a correctly patched DSDT/SSDT.
With the current project, no patched DSDT/SSDTs are used. Instead I use Clover hotpatches and a group of small SSDTs.
In Terminal:
The 'make' causes the patched files to be compiled (with iasl), the results placed in ./build.
Finally, 'make install', mounts the EFI partition, and copies the built files where they can be loaded by Clover (to EFI/Clover/ACPI/patched).
10.12 Notes
Most changes for 10.12 are already done in the project or have been fixed by Apple in 10.12.1+.
The SysPrefs->Displays problem though must be fixed by injecting a patched EDID with Clover, I created a script for that (patch_edid.sh), you should run the script only if you're affected by this issue (SysPrefs->Displays fails to load), you should check before running the script.
To use the script, in Terminal:
Power Management
Everything required for CPU/IGPU power management is already installed with the steps above.
There is no longer any need to use the ssdtPRgen.sh script.
Also, be aware that hibernation (suspend to disk or S4 sleep) is not supported on hackintosh.
You should disable it:
Always check your hibernatemode after updates and disable it. System updates tend to re-enable it, although the trick above (making sleepimage a directory) tends to help.
Final config.plist
Up to now, you've been using the same config.plist we were using for installation. After all the APCI files are in place (previous two steps), you're ready to use the final config.plist from the e550 repo.
First, mount the EFI partition:
Then copy the file:
After copying the config.plist from the repo to EFI/Clover/config.plist, you should customize the SMBIOS so you have a unique serial. You can use Clover Configurator to do this (use google to find/download it). DO NOT use Clover Configurator to edit your actual config.plist. Instead edit a "dummy" config.plist to create the SMBIOS data and then use copy/paste with a plist editor (I use Xcode) to copy the SMBIOS section into my active config.plist. Clover Configurator is too buggy and cannot be trusted with edits to your real config.plist. This guide uses MacBookAir6,2. Do not use any other model identifier.
Repeat: DO NOT edit your config.plist with Clover Configurator. Clover Configurator will erase important settings from the config.plist, and as a result, it will not work.
Do not stop reading
Although most of the post-install tasks are done, continue to read this guide. It it has important information you should know about.
Be sure to visit "Known Problems", especially the instructions in the "Audio:" section. Typically, even after completing all the above tasks, audio will not work on the first reboot. You must follow the specific instructions in that section in order to get the audio kexts in cache.
In the case of a problem, don't bother asking about with without all files requested in "Problem Reporting".
WiFi using BCM94352Z
The ./download.sh and ./install_downloads.sh script have both been updated to install the necessary kexts for BCM94352Z.
The config.plist contains the patches required for WiFi 5Ghz and Bluetooth handoff features. The patch in config.plist for 5GHz is the US/FCC patch by the-darkvoid. If you're not in the US, you might consider a different patch. Read here: http://www.tonymacx86.com/network/104850-guide-airport-pcie-half-mini-v2.html
WiFi using BCM943602BAED (DW1830)
This card is a bit more native as it uses the same chip that's found in original Macs (Bcm4360), it is recognized OOB, FakePCIID is used to get the AirPort branding. It doesn't require the 5GHz patch or the fcvo patch that is required for Bcm4352 cards in macOS Sierra (10.12).
BCM943602BAED also uses the newer Bluetooth 4.1 technology...
Updates to the patch repositories
From time to time, updates may become available to the project repository. In the event of such updates, you may want to update your copies, and re-patch DSDT/SSDT with the updates.
Since you're using git, it is easy...
In Terminal:
What works
- UEFI booting via Clover
- built-in keyboard (with special function keys)
- built-in trackpad (basic gestures)
- HDMI video/audio with hotplug
- AirPlay mirroring to AppleTV
- native WiFi via BCM94352Z
- Bluetooth (with handoff) using BCM94352Z
- native USB3 with AppleUSBXHCI (USB2 works also)
- native audio with AppleHDA, including headphone
- built-in mic
- built-in camera
- native power management
- battery status
- backlight controls with smooth transitions, save/restore across restart
- accelerated graphics for HD4400 including OpenCL
- wired Ethernet
- Mac App Store working
- screen works without flicker
- Messages/FaceTime (working on 10.10.3 even though I didn't run through the guide: http://www.tonymacx86.com/general-help/110471-how-fix-imessage.html)
Known Problems
Find My Mac/Locking: Find My Mac does not work properly. Don't lock your mac because it's difficult (or impossible) to unlock again.
Slow WiFi after sleep/wake cycle: Disable "Wake for network access" in SysPrefs->Energy Saver.
Audio: After installing new/updated kexts or after the initial installation, you may lose audio.
To fix:
- reboot without caches (hit space at Clover, select without caches)
- rebuild cache
- reboot normally (if needed, two times)
Audio: External mic via combo headphone/mic jack is not working.
CPU Frequency: Clover identifies the CPU speed (as shown in "About this Mac") incorrectly. On my system (1.9Ghz Core i5-4300U), it shows 2.49Ghz. This appears to be cosmetic. You can fix it by overriding Clover logic with config.plist/CPU/FrequencyMHz. You will see how my setting is commented in the config.plist. Set it as appropriate for your own CPU.
Other post-install tasks
Trackpad: Be sure to visit the options in SysPrefs->Trackpad and change them to your liking.
Bluetooth: If you get the Bluetooth Setup Assistant popup, go to SysPrefs->Bluetooth->Advanced, uncheck the boxes.
Problem Reporting
Download patchmatic: https://bitbucket.org/RehabMan/os-x-maciasl-patchmatic/downloads/RehabMan-patchmatic-2015-0107.zip
Extract the 'patchmatic' binary from the ZIP. Copy it to /usr/bin, such that you have the binary at /usr/bin/patchmatic.
In terminal,
Note: It is easier if you use copy/paste instead of typing the commands manually.
Post contents of Downloads/RehabMan directory (as ZIP).
Also, post ioreg: http://www.tonymacx86.com/audio/58368-guide-how-make-copy-ioreg.html. Please, use the IORegistryExplorer v2.1 attached to the post! DO NOT reply with an ioreg from any other version of IORegistryExplorer.app.
And output from:
Also, post EFI/Clover folder (press F4 at main Clover screen before collecting). Please eliminate 'themes' directory, especially if you have an overabundance of themes installed.
Also post output of:
Credits
RehabMan for his repos, tools, guides, and scripts.
The purpose of this guide is to provide a step-by-step guide to installing El Capitan on the Lenovo ThinkPad E550 (Haswell) and similar models as well.
Note: This guide is completely based on RehabMan's guides and scripts, I take no credits for this guide, I only modified his scripts and tools to work with this laptop.
My machine is a ThinkPad E550 (Haswell) with Broadcom BCM94352Z and SSD.
What you need
- Lenovo ThinkPad E550 (Haswell).
- OS X El Capitan or Yosemite downloaded from the Mac App Store
- 8GB USB stick
- Broadcom BCM943602BAED or BCM94352Z for native WiFi/BT
BIOS settings
To start, set BIOS to Windows defaults.
Then insure:
- UEFI boot is enabled
- secure boot is disabled
- enable CSM mode and you may experience less boot time glitches
Preparing USB and initial Installation
- Use the 'createinstallmedia' approach. It works well, and there is little chance for pilot error. This method also gives you an OS X recovery partition. Follow RehabMan's guide here > [Guide] Booting the OS X Installers on LAPTOPS with Clover.
- Definitely copy IntelMausiEthernet.kext to Clover/kexts/Other as having network support during post-install is helpful. The rest of this guide depends on it. An alternate is to copy FakePCIID.kext and FakePCIID_Broadcom_WiFi.kext to Clover/kexts/Other. This will enable WiFi, provided you have a compatible WiFi card already installed.
Note: FakePCIID.kext and FakePCIID_Broadcom_WiFi.kext are available here: https://github.com/RehabMan/OS-X-Fake-PCI-ID
- Some of these laptops come with ELAN/Alps/other trackpads so RehabMan's VoodoPS2Controller.kext might not work properly. An alternate is to download ELAN kext from the E550 repo.
- GenericUSBXHCI.kext is not necessary with this laptop since AppleUSBXHCI.kext appears to work well natively. Also, GenericUSBXHCI.kext does not work on 10.11 so it should not be used.
- Use the config_install.plist from the e550 repo: https://github.com/the-braveknight/Lenovo-ThinkPad-E550-DSDT-Patch/raw/master/config_install.plist
Post Installation
- Downlad Clover UEFI from here : Clover UEFI Bootloader
- Install Clover UEFI to your internal SSD/HDD and make sure you click 'Customize' and select:
- Install for UEFI booting only
- Install Clover in the ESP
- Dirvers64UEFI > OsxAptioFixDrv-64
- Copy HFSPlus.efi to drivers64UEFI folder.
Installation of the tools and patching is easy provided the scripts and tools at the repository: https://github.com/the-braveknight/Lenovo-ThinkPad-E550-DSDT-Patch
To start, the developer tools must be installed. Run Terminal, and type:
Code:
gitYou will be prompted to install the developer tools. Since you have internet working, you can choose to have it download and install them automatically. Do that before continuing.
After the developer tools are installed, we need to make a copy of the project on github.
In Terminal:
Code:
mkdir ~/Projects
cd ~/Projects
git clone https://github.com/the-braveknight/Lenovo-ThinkPad-E550-DSDT-Patch.git e550.gitNow it is time to install some more tools and all the kexts that are required...
To download the kexts & tools, in Terminal:
Code:
cd ~/Projects/e550.git
./download.sh
Code:
./install_downloads.sh
Code:
./install_downloads.sh elanThe download.sh script will automatically gather the latest version of all tools (patchmatic, iasl, MaciASL) and all the kexts (IntelBacklight.kext, ACPIBatteryManager.kext, etc) from bitbucket. The install_downloads.sh will automatically install them to the proper locations.
If you wish, you can reboot to verify a few more items are working (many only partially).
To finish the setup, we need a correctly patched DSDT/SSDT.
With the current project, no patched DSDT/SSDTs are used. Instead I use Clover hotpatches and a group of small SSDTs.
In Terminal:
Code:
cd ~/Projects/e550.git
make
make installThe 'make' causes the patched files to be compiled (with iasl), the results placed in ./build.
Finally, 'make install', mounts the EFI partition, and copies the built files where they can be loaded by Clover (to EFI/Clover/ACPI/patched).
10.12 Notes
Most changes for 10.12 are already done in the project or have been fixed by Apple in 10.12.1+.
The SysPrefs->Displays problem though must be fixed by injecting a patched EDID with Clover, I created a script for that (patch_edid.sh), you should run the script only if you're affected by this issue (SysPrefs->Displays fails to load), you should check before running the script.
To use the script, in Terminal:
Code:
cd ~/Projects/e550.git
./patch_edid.shPower Management
Everything required for CPU/IGPU power management is already installed with the steps above.
There is no longer any need to use the ssdtPRgen.sh script.
Also, be aware that hibernation (suspend to disk or S4 sleep) is not supported on hackintosh.
You should disable it:
Code:
sudo pmset -a hibernatemode 0
sudo rm /var/vm/sleepimage
sudo mkdir /var/vm/sleepimageAlways check your hibernatemode after updates and disable it. System updates tend to re-enable it, although the trick above (making sleepimage a directory) tends to help.
Final config.plist
Up to now, you've been using the same config.plist we were using for installation. After all the APCI files are in place (previous two steps), you're ready to use the final config.plist from the e550 repo.
First, mount the EFI partition:
Code:
cd ~/Projects/e550.git
sudo ./mount_efi.sh /
Code:
cd ~/Projects/e550.git
cp config.plist /Volumes/EFI/EFI/Clover/config.plistAfter copying the config.plist from the repo to EFI/Clover/config.plist, you should customize the SMBIOS so you have a unique serial. You can use Clover Configurator to do this (use google to find/download it). DO NOT use Clover Configurator to edit your actual config.plist. Instead edit a "dummy" config.plist to create the SMBIOS data and then use copy/paste with a plist editor (I use Xcode) to copy the SMBIOS section into my active config.plist. Clover Configurator is too buggy and cannot be trusted with edits to your real config.plist. This guide uses MacBookAir6,2. Do not use any other model identifier.
Repeat: DO NOT edit your config.plist with Clover Configurator. Clover Configurator will erase important settings from the config.plist, and as a result, it will not work.
Do not stop reading
Although most of the post-install tasks are done, continue to read this guide. It it has important information you should know about.
Be sure to visit "Known Problems", especially the instructions in the "Audio:" section. Typically, even after completing all the above tasks, audio will not work on the first reboot. You must follow the specific instructions in that section in order to get the audio kexts in cache.
In the case of a problem, don't bother asking about with without all files requested in "Problem Reporting".
WiFi using BCM94352Z
The ./download.sh and ./install_downloads.sh script have both been updated to install the necessary kexts for BCM94352Z.
The config.plist contains the patches required for WiFi 5Ghz and Bluetooth handoff features. The patch in config.plist for 5GHz is the US/FCC patch by the-darkvoid. If you're not in the US, you might consider a different patch. Read here: http://www.tonymacx86.com/network/104850-guide-airport-pcie-half-mini-v2.html
WiFi using BCM943602BAED (DW1830)
This card is a bit more native as it uses the same chip that's found in original Macs (Bcm4360), it is recognized OOB, FakePCIID is used to get the AirPort branding. It doesn't require the 5GHz patch or the fcvo patch that is required for Bcm4352 cards in macOS Sierra (10.12).
BCM943602BAED also uses the newer Bluetooth 4.1 technology...
Updates to the patch repositories
From time to time, updates may become available to the project repository. In the event of such updates, you may want to update your copies, and re-patch DSDT/SSDT with the updates.
Since you're using git, it is easy...
In Terminal:
Code:
cd ~/Projects/e550.git
git pull
./download.sh
./install_downloads.sh
./update_config.sh
make
make installWhat works
- UEFI booting via Clover
- built-in keyboard (with special function keys)
- built-in trackpad (basic gestures)
- HDMI video/audio with hotplug
- AirPlay mirroring to AppleTV
- native WiFi via BCM94352Z
- Bluetooth (with handoff) using BCM94352Z
- native USB3 with AppleUSBXHCI (USB2 works also)
- native audio with AppleHDA, including headphone
- built-in mic
- built-in camera
- native power management
- battery status
- backlight controls with smooth transitions, save/restore across restart
- accelerated graphics for HD4400 including OpenCL
- wired Ethernet
- Mac App Store working
- screen works without flicker
- Messages/FaceTime (working on 10.10.3 even though I didn't run through the guide: http://www.tonymacx86.com/general-help/110471-how-fix-imessage.html)
Known Problems
Find My Mac/Locking: Find My Mac does not work properly. Don't lock your mac because it's difficult (or impossible) to unlock again.
Slow WiFi after sleep/wake cycle: Disable "Wake for network access" in SysPrefs->Energy Saver.
Audio: After installing new/updated kexts or after the initial installation, you may lose audio.
To fix:
- reboot without caches (hit space at Clover, select without caches)
- rebuild cache
Code:
sudo touch /System/Library/Extensions && sudo kextcache -u /Audio: External mic via combo headphone/mic jack is not working.
CPU Frequency: Clover identifies the CPU speed (as shown in "About this Mac") incorrectly. On my system (1.9Ghz Core i5-4300U), it shows 2.49Ghz. This appears to be cosmetic. You can fix it by overriding Clover logic with config.plist/CPU/FrequencyMHz. You will see how my setting is commented in the config.plist. Set it as appropriate for your own CPU.
Other post-install tasks
Trackpad: Be sure to visit the options in SysPrefs->Trackpad and change them to your liking.
Bluetooth: If you get the Bluetooth Setup Assistant popup, go to SysPrefs->Bluetooth->Advanced, uncheck the boxes.
Problem Reporting
Download patchmatic: https://bitbucket.org/RehabMan/os-x-maciasl-patchmatic/downloads/RehabMan-patchmatic-2015-0107.zip
Extract the 'patchmatic' binary from the ZIP. Copy it to /usr/bin, such that you have the binary at /usr/bin/patchmatic.
In terminal,
Code:
if [ -d ~/Downloads/RehabMan ]; then rm -R ~/Downloads/RehabMan; fi
mkdir ~/Downloads/RehabMan
cd ~/Downloads/RehabMan
patchmatic -extractNote: It is easier if you use copy/paste instead of typing the commands manually.
Post contents of Downloads/RehabMan directory (as ZIP).
Also, post ioreg: http://www.tonymacx86.com/audio/58368-guide-how-make-copy-ioreg.html. Please, use the IORegistryExplorer v2.1 attached to the post! DO NOT reply with an ioreg from any other version of IORegistryExplorer.app.
And output from:
Code:
kextstat|grep -y acpiplat
kextstat|grep -y appleintelcpu
kextstat|grep -y applelpc
kextstat|grep -y applehdaAlso, post EFI/Clover folder (press F4 at main Clover screen before collecting). Please eliminate 'themes' directory, especially if you have an overabundance of themes installed.
Also post output of:
Code:
sudo touch /System/Library/Extensions && sudo kextcache -u /Credits
RehabMan for his repos, tools, guides, and scripts.
Last edited:
