mirrors/x1c6-hackintosh

Fork 0

mirror of https://github.com/tylernguyen/x1c6-hackintosh.git synced 2025-02-05 01:23:14 -06:00

Tyler Nguyen a985053bc5

Lots of improvements, please check changelog

2020-06-26 08:22:55 -05:00

macOS on Thinkpad X1 Carbon 6th Generation, Model 20KH*

Check out my blog tylerspaper.com

READ THE ENTIRE README.MD BEFORE YOU START.

I am not responsible for any damages you may cause.

Should you find an error, or improve anything, be it in the config itself or in the my documentation, please consider opening an issue or a pull request to contribute.

I AM A ONE MAN TEAM, AND A FULL TIME STUDENT. SO, I MIGHT NOT BE ABLE TO RESPOND OR HELP YOU IN A TIMELY MANNER. BUT, I PROMISE I WILL GET TO YOU EVENTUALLY. PLEASE UNDERSTAND.

Lastly, if my work here helped you. Please consider donating, it would mean a lot to me.

Update

Added

VoodooRMI as alternative trackpad option. Enabled by default, feel free to revert back to VoodooPS2Mouse and VoodooPS2Trackpad if you prefer. *Note, there's currently a bug with RMI where the touchpad would not load once in a while. The RMI kext uploaded in this repo has a temp fix by me (See VoodooSMBUS/PR). However, the issue is still ongoing and the dev team is aware of it. I'm switching this repo to VoodooRMI because I believe it's the future and I want to possible bugs to be reported to be fixed for the kext's first stable release.
Kernel patches to enable 4K external graphics, thank you so much @benbender
XQ74 patch in SSDT-Keyboard to support FnLock HUD per ThinkpadAssistant 1.8.0
In EFI-OpenCore/README.md, I've added a short section explaining why certain variables are the way they are in my config.plist. I will continue to update this section with more details as time goes on.

Changed

iGPU Framebuffer patching for HDMI issue in Catalina.
- In Catalina/WhateverGreen version, for some reasons my previous framebuffer patches for HDMI no longer worked. So I re-did the patch in mode details but eventually the property that fixed it was disable-external-gpu or -wegnoegpu. For some strange reasons, that variable activated on-board HDMI. See similar reports here. I'm going to create an issue on acidanthera/bugtracker soon to report to the dev team. In the mean time, keep this property if you rely on HDMI and do not have an eGPU. Delete this property if you have an eGPU (You're likely using the HDMI on the eGPU anyway).
Fixed VoodooPS2 kexts loading order.
Various reference docs to dortania.
HibernateMode to Auto

Removed

Unnecessary Mutex OpenCore patches, all Mutex are already 0 in stock DSDT.
SSDT-MCHC and SSDT-SBUS for VoodooRMI compatibility.

SUMMARY:

In short, x1c6-hackintosh is very stable and is currently my daily driver. I fully recommend this project to anyone looking for a MacBook alternative.

Fully functional	Non-functional	Semi-functional. Additional pulls needed and welcomed.
WiFi, Bluetooth, Apple Continuity ✅ *need network card replacement	Fingerprint Reader (not needed, DISABLED at BIOS) ❌	Power management and optimizations. See Issue #28 ⚠️
USB A, USB C, Webcam, Audio Playback/Recording Sleep, Ethernet, Intel Graphics, TrackPoint and Trackpad, MicroSD card reader ✅	Wireless WAN (DISABLED at BIOS) *ENABLED if you have a 2nd drive connected❌	Thunderbolt 3 hotplug partially working. See Issue #24 ⚠️
iCloud suite: App Store, iMessage, FaceTime, iCloud Drive, etc... ✅	Hibernation mode 25 ❌ CMOS error, see Issue #44
Multimedia Fn keys ✅ *need ThinkpadAssistant
PM981 installation. ✅ See Issue #43
4K UHD via HDMI/DisplayPort. ✅ *one minor quirk with Recovery and macOS updates, See Issue #28

For more information regarding certain features, please refer to docs/3_README-POSTinstallation.md

NEEDED:

A macOS machine would be VERY useful: to create install drives, and for when your ThinkPad cannot boot. Though it is not completely necessary.
Flash drive, 12GB or more.
Xcode works fine for editing plist files on macOS, but I prefer PlistEdit Pro.
ProperTree if you need to edit plist files on Windows.
MaciASL, for patching ACPI tables.
MountEFI to quickly mount EFI partitions.
IOJones, for diagnosis.
Hackintool, for diagnostic ONLY, Hackintool should not be used for patching, it is outdated.

WHERE TO START:

Explore links included this README, especially those in references and other x1c6-hackintosh repos.

Once you are ready, follow the series of README files included docs/.
1_README-HARDWAREandBIOS: Requirements before starting.
2_README-installMEDIA: Creating the macOS install drive.
3_README-POSTinstallation: Settings and tweaks post installation.
4_README-ACPIpatching: The hardest and most time consuming part, patching the system ACPI table for battery status, brightness, sleep, thunderbolt, thunderbolt hotplugging, etc...
5_README-other.md: for other notices

While you can plug-and-play most of my hotpatches if you have an x1c6, I still suggest that you dump and disassemble your own DSDT. This is imprortant as your DSDT maybe different from mine. And furthermore, you get to learn more about what's actually going on.

MY SPECIFICATIONS:

Refer to x1c6-Platform_Specifications for possible stock ThinkPad X1 6th Gen configurations.

Processor Number	# of Cores	# of Threads	Base Frequency	Max Turbo Frequency	Cache	Memory Types	Graphics
i7-8650U	4	8	1.9 GHz	4.2 GHz	8 MB	LPDDR3-2133	Intel UHD 620

Peripherals:

Two USB 3.1 Gen 1 (Right USB Always On)
Two USB 3.1 Type-C Gen 2 / Thunderbolt 3 (Max 5120x2880 @60Hz)
HDMI 1.4b (Max 4096x2160 @30Hz)
Ethernet via ThinkPad Ethernet Extension Cable Gen 2: I219-LM Ethernet (vPro)
No WWAN
TrackPoint: PS/2
TrackPad: PS/2

Display:
14.0" (355mm) HDR WQHD (2560x1440)
Audio:
ALC285 Audio Codec
Thunderbolt:
Intel JHL6540 (Alpine Ridge 4C) Thunderbolt 3 Bridge

Read These (References):

OTHER x1c6-hackintosh REPOSITORIES:

zhtengw/EFI-for-X1C6-hackintosh
Colton-Ko/macOS-ThinkPad-X1C6
Create a pull request if you like to be added, final decision at my discreation.

CONTACT:

https://tylerspaper.com/contact
Signal: +1 (202)-644-9951 *This is a Signal ONLY number. You will not get a reply of you text me at this number.

DONATE AND SUPPORT:

https://tylerspaper.com/support/

Credits and Thank You:

@Colton-Ko for the great features template.
@stevezhengshiqi for the one-key-cpufriend script.
@corpnewt for CPUFriendFriend.
@Sniki and @goodwin for ALCPlugFix.
@xzhih for one-key-hidpi.
@daliansky for various hotpatches.
@velaar for your continual support and contributions. @benbender for the the 4K output patch.
@Porco-Rosso putting up with my requests to test repo changes.
@MSzturc for adding my requested features to ThinkpadAssistant.

The greatest thank you and appreciation to @Acidanthera, without whom's work, none of this would be possible.

And to everyone else who supports and uses my project.

Please let me know if I missed you.

14 KiB

Raw Blame History

macOS on Thinkpad X1 Carbon 6th Generation, Model 20KH*

Check out my blog tylerspaper.com

READ THE ENTIRE README.MD BEFORE YOU START.

I am not responsible for any damages you may cause.

Should you find an error, or improve anything, be it in the config itself or in the my documentation, please consider opening an issue or a pull request to contribute.

Update

Recent | Changelog Archive

2020-6-26

Added

Changed

Removed

SUMMARY:

NEEDED:

WHERE TO START:

MY SPECIFICATIONS:

Read These (References):

OTHER x1c6-hackintosh REPOSITORIES:

CONTACT:

DONATE AND SUPPORT:

Credits and Thank You:

14 KiB Raw Blame History

macOS on Thinkpad X1 Carbon 6th Generation, Model 20KH*

Check out my blog tylerspaper.com

READ THE ENTIRE README.MD BEFORE YOU START.

I am not responsible for any damages you may cause.

Should you find an error, or improve anything, be it in the config itself or in the my documentation, please consider opening an issue or a pull request to contribute.

Update

Recent | Changelog Archive

2020-6-26

Added

Changed

Removed

SUMMARY:

NEEDED:

WHERE TO START:

MY SPECIFICATIONS:

Read These (References):

OTHER x1c6-hackintosh REPOSITORIES:

CONTACT:

DONATE AND SUPPORT:

Credits and Thank You:

14 KiB

Raw Blame History