Supported macOS: 14 Sonoma, should boot 15 Sequoia with minimum kext updates
Highest tested stable OS: 14.5
DISCLAIMER: Read the entire README and Dortania guides before you start. I am not responsible for any damage. When you encounter bug or want to improve this repo, consider opening issue or pull request. If you find this bootloader configuration useful, consider giving it a star to make it more visible.
Also yes, the README file is not just copy pasted from another repo. It contains information specific to this EFI config.
General knowledge & credits
Hardware
Category | Component | Note |
---|---|---|
CPU | Intel Core 8th Gen | BIOS 1.51 TB NVM 43 |
GPU | Intel UHD 620 | |
SSD | Dual NVMe | Works perfectly with latest NVMeFix.kext |
Memory | Dual Channel DDR4 | |
Battery | Dual battery | |
Camera | Integrated Camera | |
Wifi & BT | DW1820A | Use AirportItlwm for Intel cards. |
Input | PS2 Keyboard & Synaptics TrackPad | Recommended YogaSMC and ThinkpadAssistant (in User Space) |
Main software
Component | Version |
---|---|
OpenCore | v1.0.0 MOD |
UEFI settings
Security
Security Chip
DisabledMemory Protection -> Execution Prevention
EnabledVirtualization -> Intel Virtualization Technology
EnabledVirtualization -> Intel VT-d Feature
EnabledAnti-Theft -> Computrace -> Current Setting
DisabledSecure Boot -> Secure Boot
DisabledIntel SGX -> Intel SGX Control
DisabledI/O Port Access -> Thunderbolt
DisabledDevice Guard
Disabled
Startup
UEFI/Legacy Boot
UEFI OnlyCSM Support
No
Important: Thunderbolt
Thunderbolt BIOS Assist Mode
DisabledWake by Thunderbolt(TM) 3
DisabledSecurity Level
No SecuritySupport in Pre Boot Environment -> Thunderbolt(TM) device
Enabled
Own prev-lang-kbd
Either add as a string or as a data ( HEX data (ProperTree) )
Format is lang-COUNTRY:keyboard
- 🇺🇸 | [0] en_US - U.S --> en-US:0 --> 656e2d55 533a30
etc.
Secure Boot (Optional)
- Set Secure Boot to Setup Mode. Secure Boot should be reported as off by UEFI main tab
- Create FAT32 formatted USB
- Create EFI folder in the root of the newly formatted flash drive and move there content of SecureBoot/KeyTool
- Boot flash drive via F12 boot menu
- Choose Edit keys
- Start by replacing Signature Database. Select .auth file
- Do the same for Key Exchange Keys Database (KEK) and Platform Key (PK) in this order
- Exit and shutdown your machine
- Boot into the UEFI settings and check if Secure Boot is reported as
on
- Boot you favorite OS with Secure Boot enabled
More detailed information here
! Still quite experimental
Colour banding
If you encounter some serious colour banding issues ( Keep in mind that T480 1080p stock panel colour accuracy is not really good, cca 50-60% sRGB), your only solution is to replace GPU properties as bellow or replace the stock panel with one from T490 (400 nits, Low power).
<key>AAPL,ig-platform-id</key>
<data>AAAWGQ==</data>
<key>device-id</key>
<data>FhkAAA==</data>
</dict>
Do not use these any additional boot arguments! Get custom WhateverGreen version instead from Other folder
You can check your screen in gradient test here or just by simple look at Launchpad background.
Generate your own SMBIOS
For the sake of future-proof updates, please use MacBookAir9,1
(MBA 13 Intel 2020). Otherwise edit USB Map files.
CPUFriend power management
Generate CPUFriendDataProvider for your machine here or use at your own risk files provided in the Other folder.
What's working ✅
-
Battery percentage
-
Broadcom Bluetooth - All works! (native)
-
Boot chime
-
Boot menu
OpenCanopy
-
CPU power management / performance
Now on par with Windows without XTU undervolt.
-
FireVault 2
No config.plist changes needed
-
GPU UHD 620 hardware acceleration / performance
-
HDMI
Closed lid. With audio.
-
USB-C Outputs
Both USB-C ports works independently of Thunderbolt status (Non-TB3 EFI only supports DP through the upper port).
-
iMessage, FaceTime, App Store, iTunes Store. Generate your own SMBIOS
-
Intel I219V Ethernet port
Full 1 Gbps speeds and external eithernet adapter next to TB port also works
-
Keyboard
Volume and brightness hotkeys. Another media keys with YogaSMC.
-
Microphone
With keyboard switch using YogaSMC.
-
Realtek® ALC3287 ("ALC257") Audio
-
SD card reader
Fortunately, USB connected.
-
Sidecar wired
Works with 15,2 SMBIOS. Wireless with Broadcom Card
-
Sleep/Wake
Hibernatemode 25 for the best results.
-
Thunderbolt
40 Gbps, cold boot only
-
TouchPad
1-5 fingers swipe works. Emulate force touch using longer and more voluminous touch.
-
TrackPoint
Works perfectly. Edited kext Info.plist for more precise acceleration.
-
USB Ports
USB Map is different for devices with Windows Hello camera.
-
Web camera
Works well with MacOS with no bugs
-
Broadcom Wifi -
For native Broadcom cards disable kext patches. 14.0+ use OCLP.
-
DRM
Widevine, validated on Firefox 82. WhateverGreen's DRM is broken on Big Sur
What must be fixed by unlocking BIOS ⚠️
-
Thunderbolt Sleep/Wake
Thunderbolt needs a cold boot to be enabled. If you enter a sleep/wake cycle you will need to shutdown and cold boot again.
-
4K Output
USB-C currently can only support output up to 2K.
Note that if you perform the skyra1n
mod for your laptop's BIOS, it is possible to adjust the DVMT from the default 32MB to 64MB, making it possible to disable DVMT patches in DeviceProperties
and fix 4K internal/external display output issues. Similarly and less documented previously, by enabling GPIO3 Force Pwr
and GPIO3 Force Pwr for RP05
, you could at least enable Thunderbolt hot reboot functionality, meaning that you do not need to perform a full shutdown and boot cycle to regain Thunderbolt functionality after a Sleep/Wake cycle. While less ideal than a full-fledged Sleep/Wake compatible hotswap functionality, this should be the best solution before further fixing the SSDT.
What will never work 🚫
-
Fingerprint
-
Windows Hello IR Camera
-
Smart Card Reader
CFG Lock | Advanced menu
It's possible to unlock Advanced menu thus disable CFG Lock natively in UEFI + Other Advanced menu benefits. SPI Programmer CH341a is required
https://www.reddit.com/r/thinkpad/comments/ffqqx5/currently_testing_skyra1n/
There are two EFIs in the repo. Which one should I choose?
For Thunderbolt support please download the EFI folder. This one is based on pierpaolodimarzo's EFI config.
For non-Thunderbolt support please download the zip file. This one is based on valnoxy's EFI config. One notably benefit of using this EFI instead of valnoxy's one is that their config contains a rather long and redundant kext injection list.
Note that the non-TB config is no longer maintained. You will lose TB port DP output as well as 40Gb TB3 support, but you will gain better battery life. Both should boot macOS Sonoma equally well.