Skip to content

MeowyCatCute/ThinkPad_T480_OpenCore_Thunderbolt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 

Repository files navigation

ThinkPad_T480_OpenCore_Thunderbolt

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.

Introduction

General knowledge & credits
Hardware

UEFI

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

Before installation

UEFI settings

Security

  • Security Chip Disabled
  • Memory Protection -> Execution Prevention Enabled
  • Virtualization -> Intel Virtualization Technology Enabled
  • Virtualization -> Intel VT-d Feature Enabled
  • Anti-Theft -> Computrace -> Current Setting Disabled
  • Secure Boot -> Secure Boot Disabled
  • Intel SGX -> Intel SGX Control Disabled
  • I/O Port Access -> Thunderbolt Disabled
  • Device Guard Disabled

Startup

  • UEFI/Legacy Boot UEFI Only
  • CSM Support No

Important: Thunderbolt

  • Thunderbolt BIOS Assist Mode Disabled
  • Wake by Thunderbolt(TM) 3 Disabled
  • Security Level No Security
  • Support 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.

AppleKeyboardLayouts.txt

Secure Boot (Optional)
  1. Set Secure Boot to Setup Mode. Secure Boot should be reported as off by UEFI main tab
  2. Create FAT32 formatted USB
  3. Create EFI folder in the root of the newly formatted flash drive and move there content of SecureBoot/KeyTool
  4. Boot flash drive via F12 boot menu
  5. Choose Edit keys
Main menu
  1. Start by replacing Signature Database. Select .auth file
Select key to manipulate with Select .auth file
  1. Do the same for Key Exchange Keys Database (KEK) and Platform Key (PK) in this order
  2. Exit and shutdown your machine
  3. Boot into the UEFI settings and check if Secure Boot is reported as on
  4. Boot you favorite OS with Secure Boot enabled

More detailed information here

! Still quite experimental

Post-Install

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

GenSMBIOS

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.

Status

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

UEFI modding

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/

T480 consuming 60w (~85w total) - unlimited TDP : thinkpad

ThinkPad discord

Repo-specific notes

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.

About

T480 OpenCore config. Tested: macOS 14 Sonoma, macOS 15 Sequoia.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages