🚧 THIS IS A TEMPLATE!

This repo is intended to be used as a template for those wanting to share their OpenCore EFI files with others on GitHub, also providing helpful setup information.

Things to replace:

• CPU_MODEL (e.g. Intel® Core™ i9-10900K)
• CPU_GENERATION (e.g. Comet Lake)
• CHIPSET_MODEL (e.g. Z490)
• GPU_MODEL (e.g. AMD RX 5700 XT)
• GPU_INTEGRATED_MODEL (e.g. Intel UHD 630)
• MOTHERBOARD_MODEL (e.g. ASUS ROG STRIX Z490-E GAMING)
• VERSION_NAME (e.g. macOS Sonoma)
• HOST_RAM (e.g. 64 GB DDR4 3200MHz)
• STORAGE_MODEL (e.g. 500 GB WD Blue NVMe) | should I? this laptop houses a nvme not supported by opencore, but is working flawlessly with the latest firmware patch
• ETHERNET_MODEL (e.g. Intel I225-V 2.5Gb) | i forgor
• DISABLED_GPU_MODEL (e.g. NVIDIA RTX 3090)
• SECURE_BOOT_MODEL (e.g. j185f) | as if I knew that one
• BOOT_ARGS (e.g. -v keepsyms=1)
• MAC_MODEL (e.g. iMac20,2)

Other things to change:

• Problem list, including any fixes
• Your SSDT tables in the ACPI section
• Any added DeviceProperties sections
• Any additional kexts you use in Kernel
• Any patches you may have added in Kernel
• Any other NVRAM contents
• Your chosen SMBIOS Mac model, and why you chose it
• The drivers you use in UEFI
• A gallery of your working setup in Gallery
• Your disclaimers in Disclaimer

You can see a completed example of my setup here: OpenCore-Z490E-CometLake

REMEMBER TO DELETE THIS SECTION BEFORE FINISHING!

---

OpenCore ASUS UX390UA for Intel Kaby Lake

This is an OpenCore Hackintosh configuration example for ASUS UX390UA laptop with Intel Kaby Lake processor. This repository has all information you need to run Ventura on this machine.

This OpenCore configuration is a modified template by @Coopydood. This text will lead to the source project.

Warning

This GitHub repository does not serve as the definitive solution, as the critical issues indicated in Problems section are yet to be solved.

What works?

macOS

• macOS Ventura
• macOS Sonoma (and beyond)

Hardware

• iGPU (Intel HD Graphics 620)
• NVMe drive
• USB 3.1 (XHCI)
• Ethernet (not tested)
• Keyboard
• Keyboard backlight
• Trackpad
• Function keys
• Wi-Fi
• Bluetooth
• Camera
• Sound

Software

• AirDrop
• iMessage
• FaceTime
• Unlock with Apple Watch
• QE/CI graphics acceleration
• Metal support
• Temperature sensors
• Sleep / Wake
• RTC (protection)
• Hyperthreading
• Virtualisation (not tested)

---

Problems

Caution

• Internal Display (eDP) detected but displaying black
Despite me trying to find correct framebuffer patches, replacing SSDT's, and adding/deleting .kext's, I'm yet to fix the internal display. I have not been fruitful on my attempts, despite trying to fix the issue with multiple people, who have been longer in the hackintoshing game longer than I have. Please, if you have ANY information on how to fix this issue, leave it in issues.

ANOTHER PROBLEM HERE

DESCRIBE YOUR PROBLEM HERE

FIXED PROBLEM EXAMPLE ‏‏‎ ‏‏‎ ‎‎‏‏‎ ‎ 🎉 FIXED!

THE ART OF FIXING A PROBLEM AS DESCRIBED HERE

Tip

Describe to viewers how you managed to fix the issue here.

---

System

The specs of the main system that the OpenCore configuration targets.

Motherboard	MOTHERBOARD_MODEL
CPU	Intel i7-7500U
Chipset	Intel SR2ZV (to check)
Generation	Kaby Lake
Memory	16GB DIMM, manufacturer unknown
GPU	Intel HD Graphics 620
NIC

[!IMPORTANT] i forgor

---

ACPI

SSDTs used:

• SSDT-1
• SSDT-2
• SSDT-3

todo: replace

---

DeviceProperties

The following tables display the added PCI devices and their child keys.

PciRoot(0x0)/Pci(0x2,0x0)

Key	Type	Value
AAPL,ig-platform-id	Data	00001659
device-id	Data	16590000
framebuffer-fbmem	Data	00009000
framebuffer-patch-enable	Data	01000000
framebuffer-stolenmem	Data	00003001
framebuffer-unifiedmem	Data	00000080
hda-gfx	String	onboard-1

todo: fill more info

PciRoot(0x0)/Pci(0x1b,0x0)

Apple ALC

Key	Type	Value
AAPL,ig-platform-id	Data	0300220D
layout-id	Data	01000000

todo: replace with that generic sunrise controller data. maybe this is why bluetooth not working

---

Kernel

The following shows the kernel configuration.

Kexts

Kexts used:

• Lilu
• WhateverGreen
• ...

Patches

EXAMPLE

Key	Type	Value
Arch	String	Any
Base	String	__Z18e1000_set_mac_typeP8e1000_hw
Comment	String	I225-V patch
Count	Number	1
Enabled	Boolean	True
Find	Data	F2150000
Identifier	String	com.apple.driver.AppleIntelI210Ethernet
Limit	Number	0
Mask	Data
MaxKernel	String	20.4.0
MinKernel	String	19.0.0
Replace	Data	F3150000
ReplaceMask	Data
Skip	Number	0

todo: remove, unness.

---

Security

SecureBootModel 》 SECURE_BOOT_MODEL

Vault 》 Optional

I don't think I need this one

---

NVRAM

Contents stored in NVRAM.

4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14

Key	Type	Value
DefaultBackgroundColor	Data	00000000

todo: remove from readme, unnessecary.

4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102

Key	Type	Value
rtc-blacklist	Data

remove this too? like what the fuck am I gonna block, my virginity?

7C436110-AB2A-4BBB-A880-FE41995C9F82

Key	Type	Value
boot-args	String	BOOT_ARGS

---

SMBIOS

MAC_MODEL

This laptop is operating off a MacbookPro14,1 SMBIOS, which, after a bit of Googling and a very cursed CAPTCHA, will end you up with a Mid-2017 Macbook Pro with 4 Thunderbolt 3 ports. Unfortunately, this laptop has three USB-C holes, but this is the closest specced laptop, even though Apple has officially supported this CPU. This SMBIOS CPU is a 2.5 GHz Core i7 (i7-7660U). This has also been tested to work fine with MacbookPro14,3 SMBIOS.

todo: try other SMBIOS, MBP14,2, MBP15,1 and actually fucking figure out if this Intel CPU was supported by Apple

---

UEFI

Drivers in use:

• OpenRuntime (obviously)
• ...

---

Gallery

ADD SOME IMAGES TO SHOW OFF YOUR WORK!

todo: I have some pics, just need some more

---

Disclaimer

ADD A DISCLAIMER HERE!

---

Greets

• @Coopydood - thanks for getting me in this "hobby" of mine, thanks for this template, thanks for everything. Owing you a beer. And a russian dictionary.