Contribute
Register

[Guide] ASUS Zenbook UX310UA macOS Mojave / Catalina Installation Guide

Joined
Jul 29, 2011
Messages
204
Motherboard
ASUS Zenbook UX310UA-Clover
CPU
i7-7500U
Graphics
HD 620, 1920x1080
Mac
MacBook Pro
Mobile Phone
iOS
This is an installation guide for the Asus UX310UA (or UX310UA-FC620T) laptop with macOS Mojave or Catalina. This is intended to install macOS only, removing Windows. This guide is based on and adapted from Patou75's guide for UX330UA here https://www.tonymacx86.com/threads/guide-install-el-capitan-on-asus-ux330ua-skylake-clover-uefi.204479/


What's working ?

Everything except Wi-Fi/Bluetooth (you have to change the card to make it work)


Note:

The Internet WIFI/Bluetooth chip will not work on this laptop. Intel chips are not supported at this time on hackintosh. You need to replace it with a DW1560 from eBay or Amazon for around $30. This is highly recommended versus buying an external USB Wi-Fi adapter.


Pre-Installation Items Needed:


Post-Installation Items Needed:


After replacing the Wi-Fi/BT module, if you replaced it with DW1560 (recommended):



Step 1:

Setup your BIOS at bootup using the ESC on your keyboard and select the following options:
  1. First, activate Advanced Mode
  2. Check that DVMT is set to 64M. If not, set that value
  3. VT-d = disabled
  4. Disabled Secure Boot

Step 2:

Create the USB installer using UniBeast from the Mac where you have dowloaded Mojave or Catalina installer from App Store. It is really easy, follow the guide here: https://www.tonymacx86.com/threads/unibeast-install-macos-sierra-on-any-supported-intel-based-pc.200564/


Step 3:

Before attempting to boot your newly created USB Thumb Drive, replace the clover generated config.plist with the modified config.plist for Intel HD615_620_630_640_650.plist from RehabMan (rename it as config.plist and overwrite). The config.plist that clover creates by default will NOT work.


Step 4:

Open up the folder /Clover/kexts/Other/ and put the following kexts there (replacing if some of them are included already):
  • Lilu.kext
  • VirtualSMC.kext
  • VoodooPS2Controller.kext
  • WhateverGreen.kext
IMPORTANT: If you see FakeSMC.kext in that folder, DELETE IT. You can't use FakeSMC and VirtualSMC at the same time, and we will use VirtualSMC.

Put SSDT-ECUSBX.aml in /Clover/ACPI/patched/

Also put ApfsDriverLoader.efi, AptioMemoryFix.efi, HFSPlus.efi and VirtualSmc.efi in /Clover/drivers/UEFI/


Step 5:

Put the USB stick in a USB port on your ASUS, and power on. For selecting your USB to boot, press the ESC key during boot up.

When you reach the Installer, open Utilities, select Disk Utility, and format the HDD as HFS+ Journaled or as APFS (Apple's new file system). I prefer APFS, but choose what's best to you. If you don't know, just use APFS. Name the HDD as you like. I prefer to call it "MacOS" but that is up to you. After that, start and complete the installation process.

IMPORTANT: Please pay attention to the installation process. You will see it restarts the system at some point, and that is normal. It usually reboots and you will see it starts from a partition called "macOS Install Prebooter from Preboot". That is ok. However, usually it will reboot again after some minutes, and then it will try to boot from "MacOS" (or whatever name you chose when you formatted the HDD). You will have to manually move (using the arrow keys) the selection to "macOS Install Prebooter from Preboot" again and press enter.


Step 6:

After the installation process, make sure you install Clover EFI to the Mac HD so you don’t have to keep booting via your Thumb Drive. If you receive a message saying something like Clover is not meant to be installed in that partition or something like that, don't pay attention to it, just install anyway.

Optional: Install CloverThemeManager.app. This will install an App that you can use to preview, download and use themes for Clover bootloader (recommended Themes are "Mojave" and "Catalina") - https://sourceforge.net/p/cloverefiboot/themes/ci/master/tree/CloverThemeManagerApp/Updates/CloverThemeManager.zip


Step 7:

After following the above steps and successfully installing macOS as well as Clover to the Mac HD, install Clover Configurator, open it, and use the tool to mount the EFI partition of your HDD. You need to add these kets to EFI/Clover/kexts/Other:
  • VirtualSMC.kext
  • VoodooPS2Controller.kext
Also, replace the created config.plist with RehabMan's config.plist. The same you have used for the installation USB Thumb Drive. DO NOT FORGET THIS, IT IS IMPORTANT.

Put SSDT-ECUSBX.aml in /Clover/ACPI/patched/

Lastly, put ApfsDriverLoader.efi, AptioMemoryFix.efi, HFSPlus.efi and VirtualSmc.efi in /Clover/drivers/UEFI/


Step 8:

Reboot your computer booting without the USB, and get to the clover loading screen. Do NOT boot into the system yet, just press any arrow key to stop the countdown if you need it. Then, press the keyboard F4 button once in order to save the system DSDT and SSDT files to clover. This will be done automatically AFTER you press the F4 button ONCE and you will not see any message as indicative, that is normal. Proceed in booting into macOS.

Note: You will find unpatched DSDT and SSDT's on EFI/Clover/ACPI/origin


Step 9:

Now we are going to patch the DSDT and SSDT so your laptop will function like a "Real" Mac with the proper Power Management, Battery Indicator, Screen Brightness Control, etc.

For patching the DSDT and SSDT, I followed this guide here… READ THIS slowly!!! It can be difficult to understand if you’ve never done a DSDT and SSDT patch before: http://www.tonymacx86.com/threads/guide-patching-laptop-dsdt-ssdts.152573/

For models post Skylake (like this one and newer ASUS models) we will not need to use refs.txt and we will not use -da. Basically, we will use this code from that guide
Code:
cd "to directory where you placed all SSDT/DSDT"
iasl -dl DSDT.aml SSDT*.aml
Of course you will need internet by sharing the internet connection with USB using your phone for example. Or you can also copy the extracted DSDT and SSDT's to a USB drive, and take them to the Mac you used to download Mojave or Catalina installer and do the patching process there.

Please read and follow the instructions in the above link before going down further here:

-Use the MaciASL 6.1 application that you should have downloaded from the above link.

-Go to Preferences, and make sure iASL 6.1 is selected. Click the Sources tab, click the "+" and the following Patch Info (if it's not already there):
Name = Rehabman
URL = http://raw.github.com/RehabMan/Laptop-DSDT-Patch/master

-It is good to create a copy of your system DSDT and SSDT's to work with the copies and thus keep the originals untouched in case you need them in the future.

-These are the patches I used for my DSDT. I applied this in order from top to bottom:
  • "Asus N55SL/VivoBook Battery Patch"
  • "Fn Brightness Keys" (for ASUS Fn keys from the attached Asus DSDT patches ZIP file)
  • "NullEthernet" patch from RehabMan to make it work with the kext
  • "Shutdown Fix v2"
  • "Audio Layout 3" patch from RehabMan, that will make AppleALC kext to recognize the audio chip (remember: if it does not work for you, try the other layout numbers)
  • "OS Check Fix (Windows 10" patch from RehabMan
After trying to compile the DSDT, I got 1 error about BNUM. Just search for BNUM and delete the line
Code:
External (BNUM, UnknownObj)    // (from opcode)
Compile, save, and save as DSDT.aml

For all the SSDTs:

Just open them, and save them as SSDT-x.aml (the x is the corresponding number. In my case they go from 0 to 12). If you receive errors compiling SSDT-12.aml, you need to apply "Remove _DSM methods" (as per ACPI patching guide) only on that SSDT and compile.

For SSDT-PNLF:

This file comes in WhateverGreen's Zip file and it's needed to get brightness control. It comes as SSDT-PNLF.dsl so you also need to open it and save it as aml, the same as you did with the other SSDTs.


Step 10:

By now you should have your patched SSDTs.aml and DSDT.aml files. Place these files along with the rest of your system files into your EFI HDD Partition. Navigate to the following folder: EFI/Clover/ACPI/patched/ and place your modified DSDT.aml and modified SSDTs.aml.

Also place these kexts into EFI/Clover/kexts/Other:
  • AppleALC.kext
  • AsusNBFnKeys.kext
  • HibernationFixup.kext
  • Lilu.kext
  • NullEthernet.kext
  • SMCBatteryManager.kext
  • USBInjectAll.kext
  • VirtualSMC.kext (should be there already from previous step)
  • VoodooI2C.kext
  • VoodooI2CHID.kext
  • VoodooPS2Controller.kext (should be there already from previous step)
  • WhateverGreen.kext

Step 11:

-Open Clover Configurator. Go to Mount EFI, and mount your HDD EFI Partition. Then touch the Home icon, and load the file EFI/Clover/config.plist

-Go to SMBIOS and change it to MacBook Pro 14,1. Leave the App open.

-Go to ACPI, where it says "Fixes" you should see two buttons labeled 1 and 2. Touch 2, and enable the option "AddPNLF".

-Also in ACPI, on "Patches" section, make sure you enable these patches (untick "Disabled" and that will enable the patch):
  • change HDAS to HDEF
  • change HECI to IMEI
  • change MEI to IMEI
  • change GFX0 to IGPU
  • change PCI0.VID to IGPU #1 (Thinkpad)
  • change PCI0.VID to IGPU #2 (Thinkpad)
-Again in ACPI, SSDT section, make sure you enable "PluginType" in Generate Options (if it's not enabled already).

-Go to Boot, in "Arguments" touch the + symbol at the bottom right of the list labeled "Boot Arguments", then double click the first line and write this: kext-dev-mode=1

-Go to Devices, and write a 0 in the Audio Inject option (if it's not already there). Then, in the box titled "Add Properties" (in the middle of that screen) click the + symbol and add this patch:

Device: IntelGFX / Key: hda-gfx / Value: 6F6E626F6172642D3100 / Value Type: DATA

Then touch the + again and add this:

Device: HDA / Key: hda-gfx / Value: 6F6E626F6172642D3100 / Value Type: DATA

And one more time:

Device: HDA / Key: layout-id=3 / Value: 03000000 / Value Type: DATA <- IMPORTANT: If you applied a patch with a different layout-id for your audio chip, change the values of this patch accordingly.

-Go to Kernel and Kext Patches, and in KextsToPatch add two lines (touch the + button at the bottom twice), and add these patches:

Name: com.apple.driver.AppleIntelLpssI2C
Find: 494F4B69 74
Replace: 494F4B69 73
Comment: Prevent Apple I2C kexts from attaching to I2C controllers, credit CoolStar

Name: com.apple.driver.AppleIntelLpssI2CController
Find: 494F4B69 74
Replace: 494F4B69 73
Comment: Prevent Apple I2C kexts from attaching to I2C controllers, credit CoolStar

Touch ForceKextsToLoad, again add two lines, and add these lines:
  • \System\Library\Extensions\AppleIntelKBLGraphicsFramebuffer.kext
  • \System\Library\Extensions\IOGraphicsFamily.kext
NOTE: IOGraphicsFamily.kext really is not needed, but VoodooI2C needs it and if we don't force load it, it will cause a boot panic. VoodooI2C must be upgraded to solve this. After we can get a fixed version for VoodooI2C, I will update this guide and remove the line regarding IOGraphicsFamily.kext.

-Go to System Parameters, and set Inject Kexts to Yes.

-Now hit File -> Save to save changes. Close all windows of the App.


Step 12 (THIS IS ONLY NEEDED AFTER YOU HAVE REPLACED THE WIFI/BT MODULE):

Place these kexts into EFI/Clover/kexts/Other:
  • AirportBrcmFixup.kext
  • BrcmFirmwareData.kext
  • BrcmPatchRAM2.kext (only for Mojave)
  • BrcmBluetoothInjector.kext and BrcmPatchRAM3.kext (only for Catalina)
  • FakePCIID.kext
Note that you need either BrcmPatchRAM2 or BrcmBluetoothInjector.kext and BrcmPatchRAM3, according to if you installed Mojave or Catalina. Do not place all three kexts, use one or the others accordingly.

Read this guide, carefully, and follow the steps needed to setup your USB internal and external ports. It works with USBInjectAll.kext, which we already installed. You will have to create SSDT-UIAC.aml and place it into EFI/Clover/ACPI/patched/.This is needed to guarantee Wi-Fi and BT (among other things) to work properly: https://www.tonymacx86.com/threads/guide-10-11-usb-changes-and-solutions.173616/


Step 13:

Restart the Mac. You will have a fully working Mac now :)


FINISH!


NOTE : All USB 3.0 are working, USB-C too, Webcam too, SD Card reader too.


NOTE 2: To make iMessage work, you will need some extra changes. Check this guide: https://www.tonymacx86.com/threads/an-idiots-guide-to-imessage.196827/

Thanks to:

@RehabMan for his great work. You are the greatest.
@haimann951 for his workaround for ELAN 1200 touchpad. (although it is not needed anymore due to the updates in the VoodooI2C project)
Alexandred for his work with VoodooI2C (we have multitouch at last!)
@ben9923 for his patience and his great help. Without him I wouldn't be able to make the touchpad work.
And @patou75 for the UX330UA guide that I used not only as template, but also as guide and source of information to install Mac on my own system.

GUIDE UPDATED ON Nov 5th, 2019. Removed support for Sierra and High Sierra. Keeping Mojave support, since some people don't want to upgrade yet. Now there are less steps, it is easier to make the audio work (and native, without touching system files), battery indication works perfect (way better than before), power management works great, and we have a trackpad with multitouch ;)
 

Attachments

Last edited:
Joined
Apr 23, 2017
Messages
92
Motherboard
elitebook 2570p/ThinkPad x220/elitebook 840g3
CPU
i7-3520m/i7-2620m/i7-6600U
Graphics
HD 4000/HD 3000/HD 4520
Mobile Phone
Android,
Thanks
 
Joined
Jul 29, 2011
Messages
204
Motherboard
ASUS Zenbook UX310UA-Clover
CPU
i7-7500U
Graphics
HD 620, 1920x1080
Mac
MacBook Pro
Mobile Phone
iOS
Awesome, thanks for the guide! Bought a UX3410UA today, should be almost exactly the same. Will try this.

Edit: No keyboard and touchpad input after step 7, guess the hardware is not supported (yet) :(
Touchpad will work after step 13, that is when you install the needed kexts and do the proper dsdt modifications. But keyboard should be working since just the very beginning by using VoodooPS2Controller.kext in Clover/kexts. Make sure you have put it in the proper folder, inside the EFI partition.
 
Joined
Aug 11, 2016
Messages
121
Motherboard
Asus Z170I PRO Gaming
CPU
i5 6600k
Graphics
GTX 1060
Touchpad will work after step 13, that is when you install the needed kexts and do the proper dsdt modifications. But keyboard should be working since just the very beginning by using VoodooPS2Controller.kext in Clover/kexts. Make sure you have put it in the proper folder, inside the EFI partition.
Thats really weird, I'll just try it again.

I cant quite follow step 6 though, while installing clover I dont have the options for FSInject-64 and HFSPlus in the advanced menu.
 
Joined
Jul 29, 2011
Messages
204
Motherboard
ASUS Zenbook UX310UA-Clover
CPU
i7-7500U
Graphics
HD 620, 1920x1080
Mac
MacBook Pro
Mobile Phone
iOS
Thats really weird, I'll just try it again.

I cant quite follow step 6 though, while installing clover I dont have the options for FSInject-64 and HFSPlus in the advanced menu.
You are right, I have updated the guide. Also, I have updated the DSDT patches section. Less patches are needed.
 
Joined
Jul 29, 2011
Messages
204
Motherboard
ASUS Zenbook UX310UA-Clover
CPU
i7-7500U
Graphics
HD 620, 1920x1080
Mac
MacBook Pro
Mobile Phone
iOS
Alrighty, got almost everything working - didnt think that it would actually work with a different model! Thanks so much for this guide.
Only thing that is not working yet it audio. Any idea how to find out which kext I need for my specific model?
Step 11 creates a patch for the Audio and a kext you install in step 12. If it does not work then your lap does not have CX8050. Have you got a screenshot or saved the information that Windows had about the audio hardware? You need to know brand (vendor) and model, and select the proper model when you create the audio patch in step 11.

Also, you can try VoodooHDA that works with many model. But it's always better to create a patch and install the generated aDummyHDA than to just install Voodoo that sometimes has issues with volume or audio quality.
 
Joined
Aug 11, 2016
Messages
121
Motherboard
Asus Z170I PRO Gaming
CPU
i5 6600k
Graphics
GTX 1060
Step 11 creates a patch for the Audio and a kext you install in step 12. If it does not work then your lap does not have CX8050. Have you got a screenshot or saved the information that Windows had about the audio hardware? You need to know brand (vendor) and model, and select the proper model when you create the audio patch in step 11.

Also, you can try VoodooHDA that works with many model. But it's always better to create a patch and install the generated aDummyHDA than to just install Voodoo that sometimes has issues with volume or audio quality.
This is what windows says about the audio device (apart from the typical HD audio):
func_01&ven_14f1&dev_1f72&subsys_10431530&rev_1000

Quick google search reveals it is indeed by Conexant. Ill try to reinstall it again and report back.

Edit: Hmmm no success. Did everything according to the guide but I still dont have output or input devices.
I dont have the same exact mirone folder structure as you though, which is weird considering we have the same model.

MironeAudio/14f11f72/279.48/clover

Edit: Used VoodooHDA - everything working! Thanks for your great support!
 
Last edited:
Joined
Jul 29, 2011
Messages
204
Motherboard
ASUS Zenbook UX310UA-Clover
CPU
i7-7500U
Graphics
HD 620, 1920x1080
Mac
MacBook Pro
Mobile Phone
iOS
This is what windows says about the audio device (apart from the typical HD audio):
func_01&ven_14f1&dev_1f72&subsys_10431530&rev_1000

Quick google search reveals it is indeed by Conexant. Ill try to reinstall it again and report back.

Edit: Hmmm no success. Did everything according to the guide but I still dont have output or input devices.
I dont have the same exact mirone folder structure as you though, which is weird considering we have the same model.

MironeAudio/14f11f72/279.48/clover

Edit: Used VoodooHDA - everything working! Thanks for your great support!
The problem should be the patch added to Clover, that maybe is disabled, or something about aDummyHDA.kext not properly installed into S/L/E, but hey, if it works fine with Voodoo, then great! I am glad that you have your system working. Enjoy!

Oh, and about your model, is the exact same as mine, Conexant CX8050. I copied the path from another guide, thanks for pointing that. The proper path is the one you mentioned, so I have updated the guide to reflect that
 
Top