Skip to content

Opencore-based Hackintosh EFI and guide for Lenovo Thinkpad X1 Carbon Gen 7

License

Notifications You must be signed in to change notification settings

aidanchandra/x1c7-hackintosh

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

macOS on Thinkpad X1 Carbon 7th Generation

OpenCore-based Hackintosh EFI and guide for Lenovo Thinkpad X1 Carbon Gen 7. This guide has been generated for both the model numbers specified below.

Usage

This OpenCore config comes with empty PlatformInfo / SMBIOS!

Follow Dortania's OpenCore Install Guide to generate your own: Laptop Coffee Lake and Whiskey Lake > Platforminfo. If you own a Lenovo 20R1 (Intel 10th gen) also note the hint at Hardware Compatability

Overview

Summary

This X1C7 Hackintosh project aims to be an all-in-one maintained hub for Opencore-based hackintoshes on the Thinkad X1 Carbon Gen 7. In short, this x1c7-hackintosh is very stable and is currently our daily driver (Simon and Aidan). We fully recommend this project to anyone looking for a MacBook alternative. There are also multiple contributors to this project who have all helped in various fashions - see credits.

This repo is meant to serve as a hub and guide for users of the X1C7 and X1Cx community in general.

Functional Overview

What works, what doesn't and why.

WHAT IS WORKING

Install

working Device / Step Comment
Booting macOS installer
Installed to HD
Installed to HD and Dualbooting Windows on the same drive Windows Use this guide to setup dualboot on the same drive

Post-Install

working Device / Step Comment
Graphics Requires WhateverGreen.kext
Touchpad Requires VoodooGPIO, VoodooI2CServices,VoodooInput This was very trial-and-error based and I reccomend looking at our config.plist. Order and location matter.
Trackpoint Requires VoodooPS2
Keyboard Requires VoodooPS2
Keyboard-Multimedia Fn keys Requires YogaSMC.kext + TODO: Add ACPI here and YogaSMC-App
WiFi Native WiFi with AirportItlwm.kext - no companion app required
Bluetooth IntelBluetoothFirmware.kext and IntelBluetoothInjector.kext
⚠️ audio input (e.g. of headset) is not working, see #3
WWAN DISABLED at BIOS to conserve power
Ethernet IntelMausi.kext for bundled USB-C adapter
Hibernation hibernatemode=3
HDMI output Requires WEG?
USB A / USB C
Thunderbolt 3 Tested with a Vega 64 EGUP in a Razer Core X Enclosure, requires TB3 BIOS Assist to be ENABLED
Webcam checked on 2021-02-19
Audio Internal Speaker and Headphones / Line in
⚠️ Internal Microphone not working
Realtek ALC285, layout 11, 21, 31 (all seem to work equal) TODO supported layouts have changed ➡️ boot-args: alcid=71
iCloud (App Store, iMessage, FaceTime, etc) All iServices work
HiDPI, Handoff, Sidecar Handoff/sidecar sporadic function. Would not rely on these
Fingerprint Reader Disabled in BIOS to save power
Power Management Optimizations Fully working with CPUFriend and CPUFriendFriend, more options with YogaSMC to come
Intel SpeedStep Fully working (Higher performance when plugged in, lower when on battery, tested with GeekBench 5)

✅ Fully functional; ❓ Untested/Intermittent (might work); ❌ Non-functional

LIMITATIONS

Limitations what is not working as expected or improvements:

Common Issues

gioLockscreenState error is a common one working with uncommon iGPUs (like our UHD 620) See issue #11 for solution


Hardware Compatability

Lenovo allows for many different hardware configurations and will update CPU generations while maintaining the same generation. This makes is somewhat confusing to tell exactly what hardware you have and exactly what this project was meant for. The Shared Hardware tab lists all common hardware info between different models of the X1C7. Following tabs for specific model numbers provide small modificaitons needed to the EFI for their respective model numbers, if needed.

Odds are your hardware will work with minor modifications to the EFI

Shared Hardware

Again: These are the hardware specs of 20QES01L00 and 20QD-000SUS: Refer to ThinkPad_X1_Carbon_7th_Gen_Spec.PDF for possible stock ThinkPad X1 7th Gen configurations.
Source: Lenovo Product Specification Reference (PSREF) [psref.lenovo.com]

Ports 2x USB 3.1 Gen 1 (Right USB Always On)
2x USB 3.1 Type-C Gen 2 / Thunderbolt 3 (Power Delivery and DisplayPort) [Max 5120x2880 @60Hz]
HDMI 1.4b (Max 4096x2160 @24Hz)
Ethernet via ThinkPad Ethernet Extension Adapter Gen 2: I219-LM Ethernet (vPro)
WLAN + BT Intel Wireless-AC 9560, Wi-Fi 2x2 802.11ac + Bluetooth 5.0
WWAN(optional) Nothing else supported, no adapters, nothing. Locked by BIOS
Display 14.0" (355mm) HDR HD (1920 x 1080)
Camera IR and HD720p camera with ThinkShutte. Chicony manufacturer
Audio Realtek ALC3286 codec
Linux: Realtek ALC285, layout 11, 21, 31 ; @acidanthera/AppleALC > Supported codecs [Github]
Fingerprint reader ✔️
NFC (optional) ✔️

Further Specs:

  • Keyboard: PS/2
  • TrackPoint: PS/2, included alongside te PS2 Keyboard
  • TrackPad: Synaptics enabled i2c
  • Thunderbolt: Intel JHL6540 (Alpine Ridge 4C) Thunderbolt 3 Bridge with what appears to be native MacOS Support

NOTE: The WWAN M.2 slot does NOT support SSDs. "If you do manage to fit something in there, you'll be presented with this whitelist error when you try and power the laptop on" source and photos by @acoutts [Github] You can modify the bios if you really need the extra SSD.

20QD-000SUS Tested functioning as expected with provided EFI (Aidan's Machine)
Processor Number Code Name # of Cores # of Threads Base Frequency Max Turbo Frequency Cache Memory Types Graphics
i7-8665U Whiskey Lake
(based on Coffee Lake)
4 8 1.9 GHz 4.8 GHz 8 MB LPDDR3-2133 Intel UHD 620
20QE-S01L00 Tested functioning as expected with provided EFI (Simon's Machine)
Processor Number Code Name # of Cores # of Threads Base Frequency Max Turbo Frequency Cache Memory Types Graphics
i7-8565U Whiskey Lake
(based on Coffee Lake)
4 8 1.8 GHz 4.6 GHz 8 MB LPDDR3-2133 Intel UHD 620
20R1-S05B00 (20R1/20R2) Tested functioning as expected with the FOLLOWING MODIFICATIONS
Cpuid1Data: EC060800 00000000 00000000 00000000
Cpuid1Mask: FFFFFFFF 00000000 00000000 00000000

(Credit to @muhchaudhary)

Processor Number Code Name # of Cores # of Threads Base Frequency Max Turbo Frequency Cache Memory Types Graphics
i7-10710u Whiskey Lake
(based on Coffee Lake)
6 12 1.1 GHz 4.7 GHz 12 MB LPDDR3-2133 Intel® UHD Graphics for 10th Gen Intel® Processors


Credits

OTHER REPOSITORIES
CREDITS

Acidanthera
For bringing us OpenCore and maintaining all the essential kexts, like VirtualSMC, Lilu, WhateverGreen, and many many more!

Tyler Nguyen @tylernguyen

Dortania
for his awesome OpenCore guides - here to mention Dortania's OpenCore Install Guide and OpenCore Post-Install