Contribute
Register

[Guide] Lenovo Legion Y520/Y720 using Clover UEFI

the-braveknight

Moderator
Joined
Nov 24, 2015
Messages
1,244
Motherboard
Lenovo Legion Y520 (Clover)
CPU
i7-7700HQ
Graphics
HD 630 (1920x1080) + Nvidia GTX 1060
Mac
MacBook Air
Mobile Phone
iOS
Overview

The purpose of this guide is to provide a step-by-step guide to installing Mojave, High Sierra, or Sierra (10.12.6) on the Lenovo Legion Y520/Y720 laptop series.

Note: This series of laptops doesn't appear to have a WiFi whitelist, so you don't need any BIOS modifications.


What you need

- Lenovo Legion Y520 (or Y720).
- Mojave, High Sierra, Sierra, or El Capitan downloaded from the Mac App Store.
- 8GB USB stick.
- Broadcom BCM94352Z for native WiFi.


BIOS settings

To start, set BIOS to defaults.

Then insure:
- UEFI boot is enabled.
- Secure boot is disabled.
- Fast boot is disabled.
- SATA mode is set to AHCI.


Preparing USB and initial Installation

This guide for creating USB and installing using Clover UEFI works well for this laptop: [Guide] Booting the OS X installer on LAPTOPS with Clover

Special notes:

- Definitely copy RealtekRTL8111.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 Lilu.kext and AirportBrcmFixup.kext to Clover/kexts/Other. This will enable WiFi, provided you have the BCM94352Z WiFi card already installed.

Note: Lilu.kext and AirportBrcmFixup.kext are available here: https://github.com/acidanthera/Lilu/releases, https://github.com/acidanthera/AirportBrcmFixup/releases.

- Use the 'createinstallmedia' approach. It works well, and there is little chance for pilot error. This method also gives you a recovery partition.

- Use the config_install.plist from the Y520 repo here: https://github.com/the-braveknight/Lenovo-Y520-macOS.


Post Installation

Install Clover UEFI as described in the guide linked by the previous section (post #2). After installing Clover, and configuring it correctly (config.plist, kexts, etc) you should be able to boot from the HDD/SSD.

But there are still many issues and devices that won't work correctly. For that, we need to patch DSDT, provide a proper config.plist, and install the kexts that are required.

Since you have RealtekRTL8111.kext already injected by Clover, you should have internet access simply by using an Ethernet cable to your router. Plug it in and make sure you have internet access before continuing. Or if you're using Lilu.kext and AirportBrcmFixup.kext, you can connect to your WiFi router before continuing.

Installation of the tools and patching is easy provided the scripts and tools at the Lenovo Y520 repository: https://github.com/the-braveknight/Lenovo-Y520-macOS.

To start, the developer tools must be installed. Run Terminal, and type:
Code:
git
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 get a couple of projects from my github.

In Terminal:
Code:
mkdir ~/Projects
cd ~/Projects
git clone https://github.com/the-braveknight/Lenovo-Y520-macOS legion.git
Now it is time to install some more tools and all the kexts that are required...
Code:
cd ~/Projects/legion.git
./Y520.sh --download-requirements
./Y520.sh --install-downloads
Or if you have Y720:
Code:
cd ~/Projects/legion.git
./Y720.sh --download-requirements
./Y720.sh --install-downloads
The '--download-requirements' command will automatically gather the latest version of all tools (patchmatic, iasl, MaciASL) and all the kexts (VirtualSMC.kext, SMCBatteryManager.kext, etc) from their release points. The '--install-downloads' will automatically install them to the proper locations.

Note: The current repo can be considered somewhat experimental. It uses the new SMC kext (VirtualSMC.kext) instead of FakeSMC.kext. If you have any problem with VirutalSMC.kext, replace it with RehabMan's FakeSMC.kext available here: https://bitbucket.org/RehabMan/os-x-fakesmc-kozlek/downloads/.
Also make sure to remove SMCBatteryManager.kext too and install RehabMan's ACPIBatteryManager.kext available here: https://bitbucket.org/RehabMan/os-x-acpi-battery-driver/downloads/.

Note: My Y520 has a Synaptics trackpad. But some of these Y520 laptops are coming with an ELAN trackpad instead. I'm not going to link the ELAN trackpad kext due to the author's disregard for the open source license, but you can find it on the internet. Also keep in mind that the ELAN kext has not been updated in more than a year, so do not expect it to work properly.

The Y520's DSDT USB ports have correct _UPC/_PLD objects so USBInjectAll.kext is not needed. However, the Y720's DSDT port configuration aren't correct, so the current repo corrects those ports by injecting the the right _UPC configuration for each port.

Note: The Y720 appears to have I2C trackpad and USB keyboard. For those machines, I suggest looking at VoodooI2C project here: https://github.com/alexandred/VoodooI2C.

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 ACPI.

In Terminal:
Code:
make
make install_y520
Or for the Y720:
Code:
make
make install_y720
The 'make' causes the patched files to be compiled (with iasl), the results placed in ./build.

Finally, 'make install_y520' or 'make install_y720', mounts the EFI partition, and copies the built files where they can be loaded by Clover (to EFI/Clover/ACPI/patched).

Note: No actual patching of DSDT/SSDT is happening here. We are simply building an add-on SSDT (SSDT-Y520.aml or SSDT-Y720.aml) which provides the necessary changes. This is because these machines require only minimal patching so a full patched DSDT is not needed.

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.

Be aware that hibernation (suspend to disk or S4 sleep) is not well supported on hackintosh.

You should disable it:
Code:
sudo pmset -a hibernatemode 0
sudo rm /var/vm/sleepimage
sudo mkdir /var/vm/sleepimage
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 ACPI files are in place (previous two steps), you're ready to use the final config.plist from the y520 repo.

In Terminal:
Code:
cd ~/Projects/legion.git
./Y520.sh --install-config
Or if you have Y720:
Code:
cd ~/Projects/legion.git
./Y720.sh --install-config
You could also copy the file using Finder.

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.

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.

Note: The config.plist in the repo is using MacBookPro14,1. It works. You could also use MacBookPro11,1 to avoid problems related to HWP.

Note regarding HDMI/DP ports: These ports are connected to the Nvidia GTX1050 (or GTX1060) card, which is disabled. Therefore those ports will never work on macOS. The provided config_y520.plist/config_y720.plist completely disables all the external framebuffer ports.


Do not stop reading

Although most of the post-install tasks are done, continue to read this guide. 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".


Updates to the patch repositories

From time to time, updates may become available to the NUC repository. In the event of such updates, you may want to update your copies, and re-patch ACPI with the updates.

Since you're using git, it is easy...

In Terminal:
Code:
cd ~/Projects/legion.git
./Y520.sh --update # or ./Y720.sh --update # to save any local changes you might have made and update repo to latest
./Y520.sh --download-requirements # or ./Y720.sh --download-requirements
./Y520.sh --install-downloads # or ./Y720.sh --install-downloads
./Y520.sh --update-config # or ./Y720.sh --update-config
make clean
make
make install_y520 # or make install_y720

What works

- UEFI booting via Clover.
- Built-in keyboard (with special function keys).
- Built-in trackpad (basic gestures).
- AirPlay mirroring to AppleTV.
- Native WiFi via BCM94352Z.
- Bluetooth (with handoff) using BCM94352Z.
- Native USB3/USB2/USB-C.
- Native audio with AppleHDA, including headphones.
- Built-in camera.
- Native power management.
- Battery status.
- Backlight controls.
- Accelerated graphics for HD630 including OpenCL.
- Wired Ethernet.
- Mac App Store working.
- Messages/FaceTime.


Not tested/not working

- USB 3.1 Type-C port on the Y720 doesn't work properly because it's connected to the TB device (not XHC). It works only if the device is plugged in prior to booting, hotplug is not working/not reliable. There are current solutions being worked on, but no 100% solution AFAIK.
- HDMI/DP video/audio don't work because those ports are connected to the Nvidia card, which is disabled.


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 kextcache -i /
- Reboot normally (if needed, two times)


Other post-install tasks

Trackpad: Be sure to visit the options in SysPrefs->Trackpad and change them to your liking.

Trackpad three finger support: You can configure three finger swipes in SysPrefs->Keyboard->Shortcuts. Instead of pressing keys for a given function, do the three finger swipe (up/down/left/right).

Disable trackpad when using an external mouse: The latest script installs the latest VoodooPS2Controller.kext. It allows you to disable the built-in trackpad when a USB mouse is plugged in. Just check the box in SysPrefs->Accessibility->"Mouse & Trackpad".

Bluetooth: If you get the Bluetooth Setup Assistant popup, go to SysPrefs->Bluetooth->Advanced, uncheck the boxes.


Problem Reporting

Read the FAQ here: [FAQ] READ FIRST! Laptop Frequent Questions.


Credits

@RehabMan: his repos, guides, kexts, tools, and scripts.
 
Last edited:
Joined
Mar 4, 2013
Messages
22
Motherboard
Dell XPS 8500
CPU
i7 3770
Graphics
GTX 1050 2GB
Mac
iMac
Mobile Phone
iOS
I followed all the steps in the Laptop guide and used the provided y720 config plist for installation but I cant reach the installer. I get a white circle with a line through it. Any help would be greatly appreciated.
 

RehabMan

Moderator
Joined
May 3, 2012
Messages
191,075
Motherboard
Intel DH67BL
CPU
Core i7-2600K
Graphics
Intel HD 3000
Mac
MacBook Air
Mobile Phone
iOS
I followed all the steps in the Laptop guide and used the provided y720 config plist for installation but I cant reach the installer. I get a white circle with a line through it. Any help would be greatly appreciated.

No "Problem Reporting" files attached.
Read FAQ, "Problem Reporting" again. Carefully. Attach all requested files/output.
https://www.tonymacx86.com/threads/faq-read-first-laptop-frequent-questions.164990/

Also, please fix your profile, as per FAQ... it says "Dell".
 

the-braveknight

Moderator
Joined
Nov 24, 2015
Messages
1,244
Motherboard
Lenovo Legion Y520 (Clover)
CPU
i7-7700HQ
Graphics
HD 630 (1920x1080) + Nvidia GTX 1060
Mac
MacBook Air
Mobile Phone
iOS
I followed all the steps in the Laptop guide and used the provided y720 config plist for installation but I cant reach the installer. I get a white circle with a line through it. Any help would be greatly appreciated.
Wrong. config_install.plist should be used for the installation.
 
Last edited:
Joined
Mar 4, 2013
Messages
22
Motherboard
Dell XPS 8500
CPU
i7 3770
Graphics
GTX 1050 2GB
Mac
iMac
Mobile Phone
iOS
**I will edit this post with the details on moment**
 
Joined
May 3, 2014
Messages
285
Motherboard
Lenovo Legion Y720
CPU
i7-7700HQ
Graphics
HD 630 + GTX 1060, 1920x1080
Mobile Phone
iOS
Hello, good work for this guide mate... I have a couple questions

- What is the difference between disabling Nvidia SSDT-9-CB-01 by calling _OFF() in _INI and moving Store (Zero, \_SB.PCI0.LPCB.EC0.GATY) to _REG in DSDT ?

- Why are you using "Disable Clover IGPU injection" as an SSDT ?

- I have updated to Mojave everything is okay except the audio what can I do to implement your audio patch without installing your whole package ?
 

the-braveknight

Moderator
Joined
Nov 24, 2015
Messages
1,244
Motherboard
Lenovo Legion Y520 (Clover)
CPU
i7-7700HQ
Graphics
HD 630 (1920x1080) + Nvidia GTX 1060
Mac
MacBook Air
Mobile Phone
iOS
- What is the difference between disabling Nvidia SSDT-9-CB-01 by calling _OFF() in _INI and moving Store (Zero, \_SB.PCI0.LPCB.EC0.GATY) to _REG in DSDT ?
My guide does that. It excutes the same code found in _OFF without the EC-related code at _INI, and then excutes that EC code at _REG. However, my guide uses the hotpatch technique. It doesn’t involve patching the DSDT manually.

- Why are you using "Disable Clover IGPU injection" as an SSDT ?
Clover tends to inject more IGPU properties than needed, and sometimes those properties cause problems (especially on Mojave), so I use RehabMan’s IGPU SSDT instead to inject the needed properties.
- I have updated to Mojave everything is okay except the audio what can I do to implement your audio patch without installing your whole package ?
Read the guide carefully and run the scripts. I don’t understand what you mean by "without installing your whole package". The scripts are there for a good reason.
 
Joined
May 3, 2014
Messages
285
Motherboard
Lenovo Legion Y720
CPU
i7-7700HQ
Graphics
HD 630 + GTX 1060, 1920x1080
Mobile Phone
iOS
My guide does that. It excutes the same code found in _OFF without the EC-related code at _INI, and then excutes that EC code at _REG. However, my guide uses the hotpatch technique. It doesn’t involve patching the DSDT manually.


Clover tends to inject more IGPU properties than needed, and sometimes those properties cause problems (especially on Mojave), so I use RehabMan’s IGPU SSDT instead to inject the needed properties.
Thanks for clarifying....

don’t understand what you mean by "without installing your whole package".
I meant I did not want to use make install....
The scripts are there for a good reason.
Yea I just got my hands on them I didn't see them first.
 

the-braveknight

Moderator
Joined
Nov 24, 2015
Messages
1,244
Motherboard
Lenovo Legion Y520 (Clover)
CPU
i7-7700HQ
Graphics
HD 630 (1920x1080) + Nvidia GTX 1060
Mac
MacBook Air
Mobile Phone
iOS
I meant I did not want to use make install....
Why not?

Yea I just got my hands on them I didn't see them first.
They’re very easy to use and require almost zero knowledge of what’s going on. You should really run those scripts and commands and let me know how it goes.
 
Joined
May 3, 2014
Messages
285
Motherboard
Lenovo Legion Y720
CPU
i7-7700HQ
Graphics
HD 630 + GTX 1060, 1920x1080
Mobile Phone
iOS
Because I have configured my hack myself and everything is working fine except audio I don't want to use other configurations I am still unfamiliar with but I really appreciate what you have done to make it that simple it defiantly took you lots of time to prepare.

They’re very easy to use and require almost zero knowledge of what’s going on. You should really run those scripts and commands and let me know how it goes.
I have removed what AppleHDA Patcher have done removed: aDummyHDA.kext then the config.plist patches.
Changed DSDT audio layout to 7.
added the resulting kext from ur script to /L/E
added config.plist patches from the one you provided
rebooted without caches rebuilt them (done this twice)
reboot still no audio for me.

Can you help @RehabMan ?
 

Attachments

Last edited:
Top