search

5T33Z0 / Thinkpad-T490-Hackintosh-OpenCore

OpenCore EFI folder for running macOS Sequoia on the Lenovo ThinkPad T490.
90 stars 5 forks source link
hackintosh monterey opencore sequoia sonoma t490 thinkpad-t490 ventura

readme

Lenovo ThinkPad T490 Hackintosh OpenCore

OpenCore macOS Sequoia release
10053604

TABLE of CONTENTS

About

OpenCore EFI folder and config for running macOS Sonoma and newer on the Lenovo ThinkPad T490. Read the following documentation carefully in order to install/boot macOS successfully!

[!CAUTION]

Upgrading from to macOS 14.3.1 to 14.4 and newer via System Update causes a Kernel Panic during install! Disable AiportItlwm and enable itlwm.kext instead. Set SecureBootModel to Disabled, reset NVRAM and run the update again. If this does not work, follow this workaround to install macOS 14.4 on a new APFS volume. Use Migration Manager afterwards to get your data onto the new volume!

Notable Features

Future Developments

Issues

[!IMPORTANT]

Before reporting any issues, ensure that your system uses the latest UEFI and EC Firmware as I do. I have no time trying to fix issues which are not caused by my EFI but rather by running the system on outdated firmware!

Specs

Category Description
Model Lenovo ThinkPad T490
Variant 20N3
BIOS UEFI: v1.83 (2024-06-20)
Embedded Controller: v1.27
CPU Intel Intel Core i5 8265U (Quad Core)
RAM 16 GB:
  • 8 GB Samsung DDR 4 @2666 Mhz (soldered)
  • 8 GB Samsung DDR 4 @2666 Mhz (RAM Slot)
Storage Samsung PM981a NVMe (unusable)
Western Digital PC SN530 NVMe SSD
Display Full HD (1080p) (Non-Touch)
iGPU Intel(R) Grpahics UHD 620 (spoofed as Iris 655, BusID: 2)
dGPU None
Audio Realtek ALC257 (using Layout 97)
Thunderbolt Titan Ridge Thunderbolt 3 Connector (USB-C)
(Reported working but I don't have any gear to test it)
Ethernet Intel I219-V
WiFi Intel AC-9560
Firmware: iwm-9000-46 (Screenshot)
Bluetooth Device: Intel Wireless Bluetooth
BT Version: 5.1
VID: 0x8087, PID: 0x0aaa
Firmware: ibt-17-16-1.sfi, ibt17-16-1.ddc
USB Port: HS10
Trackpad Synaptics
Device-id: pci8086,9de8. Controlled via SMBus.
SD Card Reader Realtek MicroSD Card Reader
Dock ThinkPad Ultra Docking Station

BIOS Settings

After powering on the machine, spam F1 until you hear a beep to enter the BIOS. Change the following settings:

Category Setting
Config Display
  • Shared Display Priority: HDMI
  • Total Graphics Memory: 256 MB
CPU
  • Intel Hyperthreading Technology: ON
Security Fingerprint
  • Predesktop Authentication: OFF
Security Chip
  • Security ChipON or OFF (enable for Windows 11)
Memory Protection
  • Execution Prevention: ON
Virtualization
  • Kernel DMA Protection: ON (enables VT-D by design)
I/O Port Access
  • Ethernet LAN: ON
  • Wireless LAN: ON
  • Bluetooth: ON
  • USB Port: ON
  • Memory Card Slot: ON
  • Smart Card Slot: OFF
  • Integrated Camera: ON
  • Integrated Audio: ON
  • Microphone: ON
  • Fingerprint Reader: ON (works in Windows only) or OFF
  • Thunderbolt 3: ON
Absolute Persistance Module
  • Absolute Persistance Module Activation: Disabled
Secure Boot Configuration
  • Secure Boot: OFF
Intel SGX
  • Intel SGX Control: Disabled
Startup
  • UEFI/ Legacy Boot: UEFI Only
  • Boot Mode: Quick (Skips Diagnostics)

EFI Folder Content

Click to reveal ``` EFI ├── BOOT │   └── BOOTx64.efi ├── OC │   ├── ACPI │   │   ├── DMAR.aml │   │   ├── SSDT-ALS0.aml │   │   ├── SSDT-AWAC.aml │   │   ├── SSDT-ECRW.aml │   │   ├── SSDT-EXT1-FixShutdown.aml │   │   ├── SSDT-EXT3-LedReset-TP.aml │   │   ├── SSDT-EXT4-WakeScreen.aml │   │   ├── SSDT-GPRW.aml │   │   ├── SSDT-MCHC.aml │   │   ├── SSDT-PLUG.aml │   │   ├── SSDT-PNLF.aml │   │   ├── SSDT-PORTS.aml │   │   ├── SSDT-PTSWAK.aml │   │   ├── SSDT-THINK.aml │   │   └── SSDT-USBX.aml │   ├── Drivers │   │   ├── AudioDxe.efi │   │   ├── HfsPlus.efi │   │   ├── OpenCanopy.efi │   │   ├── OpenRuntime.efi │   │   └── ResetNvramEntry.efi │   ├── Kexts (Loading managed by MinKernel/MaxKernel settings) │   │   ├── AMFIPass.kext │   │   ├── AdvancedMap_Sequoia.kext │   │   ├── AdvancedMap_Sonoma.kext │   │   ├── AirportItlwm_Sonoma.kext │   │   ├── AppleALC.kext │   │   ├── BlueToolFixup.kext │   │   ├── BrightnessKeys.kext │   │   ├── CPUFriend.kext │   │   ├── CPUFriendDataProvider.kext │   │   ├── ECEnabler.kext │   │   ├── IntelBTPatcher.kext │   │   ├── IntelBluetoothFirmware.kext │   │   ├── IntelBluetoothInjector.kext │   │   ├── IntelMausiEthernet.kext │   │   ├── itlwm.kext │   │   ├── Lilu.kext │   │   ├── NVMeFix.kext │   │   ├── RealtekCardReader.kext │   │   ├── RealtekCardReaderFriend.kext │   │   ├── RestrictEvents.kext │   │   ├── SMCBatteryManager.kext │   │   ├── SMCProcessor.kext │   │   ├── SMCSuperIO.kext │   │   ├── VirtualSMC.kext │   │   ├── VoodooPS2Controller.kext │   │   │   └── Contents │   │   │   └── PlugIns │   │   │   ├── VoodooInput.kext (disabled) │   │   │   ├── VoodooPS2Keyboard.kext │   │   │   ├── VoodooPS2Mouse.kext (disabled) │   │   │   └── VoodooPS2Trackpad.kext │   │   ├── VoodooRMI.kext │   │   │   └── PlugIns │   │   │      ├── RMII2C.kext (disabled) │   │   │      ├── RMISMBus.kext │   │   │      └── VoodooInput.kext │   │   ├── VoodooSMBus.kext │   │   ├── WhateverGreen.kext │   │   └── YogaSMC.kext │   ├── OpenCore.efi │   ├── Resources │   │   ├── Audio │   │   │   └── OCEFIAudio_VoiceOver_Boot.mp3 │   │   ├── Font │   │   │   ├── Font_1x.bin │   │   │   ├── Font_1x.png │   │   │   ├── Font_2x.bin │   │   │   └── Font_2x.png │   │   ├── Image │   │   │   ├── Acidanthera (removed icons from tree view) │   │   │   │   ├── Chardonnay │   │   │   │   ├── GoldenGate │   │   │   │   └── Syrah │   │   │   └── Blackosx │   │   │   └── BsxM1 (removed icons from tree view) │   │   └── Label (removed files from tree view) │   └── Config.plist └── OC Changelog.md ```

Preparations

Config Adjustments

[!CAUTION]

  • Don't change the SMBIOS or the USB port mapping stored in USBMap_MBP152.kext won't be applied and Bluetooth won't work either! If you must change the SMBIOS then you also need to change the model property inside the info.plist of the kext to match the selected SMBIOS as well (instructions).
  • If your T490 model uses a different WiFi/BT card than the stock Intel AC-9560 card, use the official itlwm.kext instead because mine only contains the firmware for the 9560 so it won't work with other cards.

AirportItlwm.kext vs. itlwm.kext

Although the Intel AC-9560 Card is compatible with both kexts (use either one or the other), there are Pros and Cons to both of them (check the FAQs for other differences):

[!NOTE]

My config uses AirportItlw.kext by default since it allows accessing the internet during macOS installation (unlike itlwm.kext which requires an additional app to do so). Currently, AirportItlwm kexts for macOS Sonoma is included. My itlwm.kext is a slimmed-down version only containing the firmware for the Intel AC-9560 (1,5 MB instead of 16,1 MB). If you want to use itlwm, disable AirportItlwm (all variants) and enable itlwm in the config.plist instead. Next, download the Helipad app, run it and add it to "Login Items" (in System Settings) so that it starts automatically with macOS.

Deployment

If macOS is installed already

If macOS is not installed

Post-Install

Mounting the EFI partition in macOS 15 beta 5

Apple changed how FAT32 partitions are handled, so mounting the EFI partition does no longer work. For now, use this tool to mount the EFI partition.

[!NOTE]

This issue has been resolved in beta 6, so this workaround is no longer required.

Understanding YogaSMC Settings

Open the YogaSMC preference pane. You will find the following options (among others):

Disabling YogaSMC

If you don't want to use YogaSMC, do the following:

[!NOTE]

After disabling YogaSMC, fan and performance controls are no longer available. F-keys besides Volume and Brightness will no longer work either.

For OCAT Users

Add the following entries to the "Kext URL Upgrade" list accessible via "Settings" from the "Sync" window (if not present already), so kext which are marked in grey in the Sync window will be downloaded when checking for updates:

Kext Name Source URL
AdvancedMap.kext https://github.com/notjosh/AdvancedMap
AirportItlwm.kext https://github.com/OpenIntelWireless/itlwm
AMFIPass.kext https://github.com/dortania/OpenCore-Legacy-Patcher
IntelBluetoothFirmware.kext https://github.com/OpenIntelWireless/IntelBluetoothFirmware
IntelMausiEthernet.kext https://github.com/CloverHackyColor/IntelMausiEthernet
itlwm.kext https://github.com/OpenIntelWireless/itlwm
RealtekCardReader.kext https://github.com/0xFireWolf/RealtekCardReader
RealtekCardReaderFriend.kext https://github.com/0xFireWolf/RealtekCardReaderFriend

[!IMPORTANT]

Don't update AirportItlwm.kext, AppleALC.kext, IntelBluetoothFirmware.kext and itlwm.kext via OCAT because then you lose the slimmed versions of these kexts!

Compile Intel Wi-Fi and Bluetooth Firmware kexts easily

Chris1111 has created a helpful little app called Wifi-Intel-KextsBuilder which automates the process of compiling Intel Wi-Fi and Bluetooth Firmware kexts. It only requires you to have Xcode installed and will handle the rest on its own once you run it.

Wifi-Intel-KextsBuilder downloads the source code of itlwm, IntelBluetoothFirmware, MacKernelSDK and Lilu and then compiles itlwm, AirportItlwm and Intel Bluetooth Firmware kexts. They will be located under "Users/YOUR_USERNAME/Developer/Wifi-Intel-KextsBuilder/ in the "build/Release" folder of each repo.

These kexts won't be slimmed like the ones present in my EFI folders but at least you now have a simple option to compile them on your own in the future. For compiling slimmed kexts, follow my guide

Credits and Thank Yous