README.md

ASUS Vivobook S15 S531FL Hackintosh

OpenCore version: 1.0.0

Guide used: https://dortania.github.io/OpenCore-Install-Guide/

Geekbench 6 Score

Updated 17 July 2024 for macOS 14.5, will update again when 15.0 is released

This EFI may work on other ASUS laptops with similar specs, use it at your own risk!

You may use older versions of macOS with this EFI, just replace AirportItlwm.kext with your desired version accordingly and rebuild CPUFriendDataProvider.kext

My Specs

• ASUS Official Website
• CPU: Intel Core i7-8565U
• GPU: Intel UHD 620 & Nvidia MX250
• RAM: 8GB Internal + 8GB Slotted DDR4 2133MHz
• Storage: Intel 660p 512GB
• Wifi/BT Card: Intel(R) Dual Band Wireless AC 8265
• Touchpad: ELAN1200
• BIOS revision: Version 301

Working:

• CPU & Full Power Management (800MHz min freq)
• GPU QE/CI with 2GB VRAM & Brightness adjustment
• HiDPI with framebuffer patch to run any HiDPI resolution
• Wifi & Bluetooth
• Sleep (S3 state)
• Sound (Internal speaker) with boot chime
• All USB ports including Micro SD slot
• Native battery charging limiter to 83%, toggle in settings

Not Working:

• UVC IR Webcam
• Nvidia MX250
• Keyboard Backlight

Issues:

1. CPU thermal throttles at 70C under heavy load instead of 95C. Clock speed and Power draw drops to 2.5GHz and 12W respectively. This issue also occurs on some real MacBooks. There is currently no known fix.

Untested:

• HDMI (probably need to patch framebuffer)
• Multicombo headphone jack (probably need VerbStub.kext)
• Apple features such as Continuity, AirDrop, iMessage and FaceTime as I don't have an iOS device. (App Store works)

Pre Installation:

The EFI folder in this repo is the final setup of this hack. Please follow the official guide and remove unnecessary kexts, SSDTs and modify the config.plist before booting into the installer to install macOS.

• Get your PlatformInfo serial number here
• Refer to this readme for the purpose of each ACPI patch and kexts

Post Installation Stuff:

• Monitor your CPU, GPU, fan speed, memory usage and more

• Enable HiDPI by following steps from this website and with this app

• Calibrate your display white point with this accessibility option

• Build your own Voltageshift.kext for undervolting without disabling SIP

• Automate applying undervolt on boot & waking from sleep with Hammerspoon

  • Paste this in init.lua (modify to your username)
  • Following code below has power limits set when plugged in/on battery. Change accordingly to suit your needs

function sleepWatchFunction(eventType)
  if (eventType == hs.caffeinate.watcher.systemDidWake) then
    batteryWatchFunction()
   end
end

function batteryWatchFunction(eventType)
  hs.execute("/users/yongj1e/voltageshift offset -121 -100 -100 -100 -100 0")
  if (hs.battery.powerSource() == 'AC Power') then
    hs.execute("/users/yongj1e/voltageshift power 25 25")
  else
    hs.execute("/users/yongj1e/voltageshift power 5 5")
  end
end

sleepWatcher = hs.caffeinate.watcher.new(sleepWatchFunction)
sleepWatcher:start()

batteryWatcher = hs.battery.watcher.new(batteryWatchFunction)
batteryWatcher:start()
batteryWatchFunction()

• Get a powerful systemwide EQ with Apple's AU Lab and BlackHole

  • 1. Install both AU Lab & BlackHole.
  • 2. Follow steps here
  • 3. Open AU Lab, select "BlackHole" as input device and your desired audio device as output.