From 9531f5ddd2c9e7fa1dbefe4e3278561746f5d4e0 Mon Sep 17 00:00:00 2001
From: 5T33Z0 <76865553+5T33Z0@users.noreply.github.com>
Date: Fri, 9 Jun 2023 12:16:00 +0200
Subject: [PATCH] Update Readme
---
.../Framebuffer_patches.plist | 2 -
README.md | 97 ++++++++++++++++---
2 files changed, 81 insertions(+), 18 deletions(-)
diff --git a/Additional_Files/Framebuffer_Patches/Framebuffer_patches.plist b/Additional_Files/Framebuffer_Patches/Framebuffer_patches.plist
index 547d583..6d2fd09 100755
--- a/Additional_Files/Framebuffer_Patches/Framebuffer_patches.plist
+++ b/Additional_Files/Framebuffer_Patches/Framebuffer_patches.plist
@@ -99,8 +99,6 @@
Intel UHD Graphics 620
- Delete
-
diff --git a/README.md b/README.md
index bae0a75..15be228 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,54 @@
# Lenovo ThinkPad T490 Hackintosh OpenCore
-[](https://github.com/acidanthera/OpenCorePkg/releases/latest) [](https://www.apple.com/macos/ventura/)
-:nut_and_bolt: :construction: **WORK IN PROGRESS…**
+[](https://github.com/acidanthera/OpenCorePkg/releases/latest) [](https://www.apple.com/newsroom/2021/10/macos-monterey-is-now-available/) [](https://www.apple.com/macos/ventura/)
+
+**TABLE of CONTENTS**
+
+- [About](#about)
+ - [Notable Features](#notable-features)
+ - [Future Developments](#future-developments)
+- [Issues](#issues)
+- [Specs](#specs)
+- [BIOS Settings](#bios-settings)
+- [EFI Folder Content](#efi-folder-content)
+- [Preperatios](#preperatios)
+ - [Config adjustments](#config-adjustments)
+- [Deployment](#deployment)
+ - [If macOS is installed already](#if-macos-is-installed-already)
+ - [If macOS is not installed](#if-macos-is-not-installed)
+- [Post-Install](#post-install)
+- [Credits and Thank Yous](#credits-and-thank-yous)
## About
-OpenCore EFI folder and config for running macOS Ventura on the Lenovo Thinkpad T490…
+OpenCore EFI folder and config for running macOS Monterey and newer on the Lenovo Thinkpad T490. Read the documnettion carefully in order to boot your OS successfully.
+
+### Notable Features
+- Latest versions of OpenCore and Kexts
+- Lean EFI folder with slimmed kexts:
+ - **AppleALC** (87 kB instead of 2.2 mb). Only contains layout `97`.
+ - **AirportItlwm** (1.7 mb instead of 16 mb). Only Contains Firmware for Intel AC 9560.
+ - **itlwm** (1.6 mb instead of 16 mb). Only Contains Firmware for Intel AC 9560.
+- Kext loading for different versions of macOS managed via `MinKernel` and `MaxKernel` setting
+- YogaSMC support for addittional features like CPU fan control, performance balance, all Fn Key shortcuts working, additional OSD overlays, etc.
+- No injection of PlatformInfo data into Windows.
+
+### Future Developments
+- I am planning to get my hands on a Lenovo Thinkpad Thunderbolt 3 Dock (Gen 2) to see if it works
+- Since I've had this Notebook for a couple of days only, I am using a USBMap.kext for now. But I am looking into mapping the USB ports via ACPI instead so it works with any SMBIOS and any version of macOS so you never have to wworry about it
+- Adding Clover support (maybe)
+
+## Issues
+- Erratic Mouse Pointer behavior in BootPicker. Disabled `PointerSupport` for now. Since it works fine when using a USB mouse, I think the issue might be related to VoodooSMBus or VoodooRMI. Created an issue report.
+- Audio Jack creates an unpleasant buzz/noise during drivier initialization. So it's best to connect to it *after* booting.
## Specs
Category | Description
:---------:|------------
**Model** | Lenovo ThinkPad T490
**Type** | [**20N3**](https://pcsupport.lenovo.com/us/en/products/laptops-and-netbooks/thinkpad-t-series-laptops/thinkpad-t490-type-20n2-20n3/document-userguide)
+BIOS|
**CPU** | Intel [**Intel Core i5 8265U**](https://ark.intel.com/content/www/us/en/ark/products/149088/intel-core-i58265u-processor-6m-cache-up-to-3-90-ghz.html) (Quad Core)
-**RAM** | 16 GB: - 8 GB Samsung DDR 4 @2667 Mhz (soldered)
- 8 GB Kingston DDR 4 @2400 Mhz (RAM Slot)
+**RAM** | 16 GB:
- 8 GB Samsung DDR 4 @2400 Mhz (soldered)
- 8 GB Kingston DDR 4 @2400 Mhz (RAM Slot)
**Storage** | ~~Samsung PM981 NVMe~~ ([**unusable**](https://dortania.github.io/Anti-Hackintosh-Buyers-Guide/Storage.html))
250 GB M.2 Crucial MX 500 SATA SSD
**Display** | Full HD (1080p) (Non-Touch)
**dGPU** | –
@@ -20,9 +56,10 @@ Category | Description
**Audio** | Realtek ALC257, `alcid=97`
**Thunderbolt** | Titan Ridge Thunderbolt 3 Connector (USB-C)
(Untested)
**Ethernet** | Intel I219-V
-**WiFi** | Intel AC-9560 160 Mhz
-**Bluetooth** |Intel Wireless Bluetooth. Not working yet ([**but it should**](https://openintelwireless.github.io/IntelBluetoothFirmware/Compat.html))
**VID**: `0x8087`, **PID**: `0x0aaa`, **USB Port**: HS10
-**Trackpad** | I2C Device: `pci8086,9de8`
+**WiFi** | Intel AC-9560 (**Model**: iwm-9000-46)
+**Bluetooth** |Intel Wireless Bluetooth. Not working in macOS 13.5b2
**VID**: `0x8087`, **PID**: `0x0aaa`, **USB Port**: HS10
+**Trackpad** | Synaptics (**Device-id**: `pci8086,9de8`). Controlled via SMBUS.
+**SD Card Reader** | Realtek MicroSD Card Reader
## BIOS Settings
After powering on the machine, spam Enter until you hear a beep, then press F1 to enter the BIOS. Change the following settings:
@@ -30,7 +67,7 @@ After powering on the machine, spam Enter until you hear a beep, then
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 Chip`ON` 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: `OFF`
- Smart Card Slot: `OFF`
- Integrated Camera: `ON`
- Integrated Audio: `ON`
- Microphone: `ON`
- Fingerprint Reader: `OFF`
- Thunderbolt 3: `ON`
**Absolute Persistance Module** - Absolute Persistance Module Activation: `Disabled`
**Secure Boot Configuration** **Intel SGX** - Intel SGX Control: `Disabled`
+**Security** | **Fingerprint**
- Predesktop Authentication: `OFF`
**Security Chip** - Security Chip`ON` 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: `OFF`
- Smart Card Slot: `OFF`
- Integrated Camera: `ON`
- Integrated Audio: `ON`
- Microphone: `ON`
- Fingerprint Reader: `OFF`
- Thunderbolt 3: `ON`
**Absolute Persistance Module** - Absolute Persistance Module Activation: `Disabled`
**Secure Boot Configuration** **Intel SGX** - Intel SGX Control: `Disabled`
**Startup** |
- **UEFI/ Legacy Boot**: `UEFI Only`
- **Boot Mode**: `Quick` (Skips Diagnostics)
## EFI Folder Content
@@ -51,16 +88,13 @@ EFI
│ ├── SSDT-EXT1-FixShutdown.aml
│ ├── SSDT-EXT3-LedReset-TP.aml
│ ├── SSDT-EXT4-WakeScreen.aml
- │ ├── SSDT-IRQ_FIXES.aml
│ ├── SSDT-GPRW.aml
│ ├── SSDT-MCHC.aml
│ ├── SSDT-PLUG.aml
│ ├── SSDT-PNLF.aml
- │ ├── SSDT-PRW0.aml
│ ├── SSDT-PTSWAKTTS.aml
│ ├── SSDT-PWRB.aml
│ ├── SSDT-THINK.aml
- │ ├── SSDT-TEMPToFans.aml
│ └── SSDT-USBX.aml
├── Drivers
│ ├── AudioDXE.efi (disabled)
@@ -69,6 +103,7 @@ EFI
│ ├── OpenRuntime.efi
│ └── ResetNvramEntry.efi
├── Kexts (loaded based on Min Kernel/Max Kernel settings)
+ │ ├── AirportItlwm.kext
│ ├── AppleALC.kext
│ ├── BlueToolFixup.kext
│ ├── BrightnessKeys.kext
@@ -77,10 +112,12 @@ EFI
│ ├── ECEnabler.kext
│ ├── IntelBluetoothFirmware.kext
│ ├── IntelBTPatcher.kext
- │ ├── itlwm.kext
│ ├── IntelMausiEthernet.kext
+ │ ├── itlwm.kext
│ ├── Lilu.kext
│ ├── NVMeFix.kext
+ │ ├── RealtekCardReader.kext
+ │ ├── RealtekCardReaderFriend.kext
│ ├── SMCBatteryManager.kext
│ ├── USBMap.kext
│ ├── VirtualSMC.kext
@@ -104,19 +141,47 @@ EFI
```
+## Preperatios
+
+### Config adjustments
+- Download the latest EFI folder from the "Releases" Section and unzip it
+- Open the config.plist with a plist editor of your choice (I am using OCAT)
+- Go to `PlatformInfo/Generic` and generate Serials for `MacBookPro15,4` with GenSMBIOS or OCAT. :warning: Don't change the SMBIOS or the USBMap.kext won't work anymore!
+- If you are using/installing a different OS than macOS Monterey, you need to replace [AirportItlwm.kext](https://github.com/OpenIntelWireless/itlwm/releases) by the version for the OS you are planning to use.
+- Save your config.plist
+
## Deployment
+### If macOS is installed already
+- Put the EFI folder on a FAT32 formatted USB stick
+- Reboot from said USB flash drive for testing
+- If it works, place the EFI forder on the SSD of your Laptop
+- Continue with Post-Install
-**TO BE CONTINUED…**
+### If macOS is not installed
+- Follow Dortania's [OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/installer-guide/#making-the-installer) to prepare a USB Installer
+- Once the USB has been created, mount its EFI Parttion (you can use [MountEFI](https://github.com/corpnewt/MountEFI))
+- Put the EFI folder on the EFI partition of the USB installer
+- Reboot from the USB installer
+- Install macOS
+- Once that is completed, continue with Post-Install
+
+## Post-Install
+- Enable **YogaSMC**:
+ - Download and install the [**YogaSMC App**](https://github.com/zhen-zen/YogaSMC/releases) and Preference Pane so YogaSMC can work
+- **Optional**: Switch WiFi kext form `AirportItlwm` to `itlwm`.
+ - itlm uses Apple's IOEthernet rather than IO80211.
+ - itlm provides a stabler and faster performance than AirportItlwm. You also don't need different versions of the kext for different versions of macOS.
+ - Only downside: it requires its own app called [HeliPort](https://github.com/OpenIntelWireless/HeliPort) to connect to hotspots which does not work during macOS install/recovery. More Info [here](https://openintelwireless.github.io/HeliPort/Installation.html)
## Credits and Thank Yous
- [**Acidanthera**](https://github.com/acidanthera) for OpenCore, Kexts and maciASL
- [**CorpNewt**](https://github.com/corpnewt) for ProperTree, CPUFriendFriend and SSDTTime
+- Dreamwhite for slimmed [**slimmed versions of itlwm kext**](https://github.com/dreamwhite/Chonky-itlwm-Build/releases) kexts
- [**ic005k**](https://github.com/ic005k/OCAuxiliaryTools) for OpenCore Auxiliary Tools
- [**benbaker76**](https://github.com/benbaker76/Hackintool) for Hackintool
-- **T490 OpenCore Repos**:
+- **T490 OpenCore Repos** for referencing and ACPI fixes:
- [yusifsalam](https://github.com/yusifsalam/t490-macos)
- [Krissh-C ](https://github.com/Krissh-C)
- [ganyuanzhen](https://github.com/ganyuanzhen/T490-Hackintosh-Opencore)
- [laserdyke](https://github.com/laserdyke/t490-opencore)
- - [ZoR3oL](https://github.com/ZoR3oL/t490-hackintosh)
-
+ - [ZoR3oL](https://github.com/ZoR3oL/t490-hackintosh)
\ No newline at end of file