1
0
Fork 0
mirror of https://github.com/tylernguyen/x1c6-hackintosh.git synced 2025-02-05 09:33:13 -06:00
x1c6-hackintosh/README.md

186 lines
15 KiB
Markdown
Raw Normal View History

2020-04-05 19:00:52 -05:00
# macOS on Thinkpad X1 Carbon 6th Generation, Model 20KH\*
2020-07-18 12:56:53 -05:00
[![macOS](https://img.shields.io/badge/macOS-Catalina-yellow.svg)](https://www.apple.com/macos/catalina/)
2020-10-09 00:10:46 -05:00
[![version](https://img.shields.io/badge/10.15.7-yellow)](https://support.apple.com/en-us/HT210642)
2020-07-18 12:56:53 -05:00
[![BIOS](https://img.shields.io/badge/BIOS-1.45-blue)](https://pcsupport.lenovo.com/us/en/products/laptops-and-netbooks/thinkpad-x-series-laptops/thinkpad-x1-carbon-6th-gen-type-20kh-20kg/downloads/driver-list/component?name=BIOS%2FUEFI)
[![MODEL](https://img.shields.io/badge/Model-20KH*-blue)](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/references/x1c6-Platform_Specifications.pdf)
2020-10-09 00:10:46 -05:00
[![OpenCore](https://img.shields.io/badge/OpenCore-0.6.2-green)](https://github.com/acidanthera/OpenCorePkg)
[![LICENSE](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/996icu/996.ICU/blob/master/LICENSE)
<img align="right" src="https://i.imgur.com/I3yUS4Q.png" alt="Critter" width="300">
### Check out my blog [tylerspaper.com](https://tylerspaper.com/)
2020-04-05 19:00:52 -05:00
#### READ THE ENTIRE README.MD BEFORE YOU START.
2020-10-09 00:10:46 -05:00
()
#### I am not responsible for any damages you may cause.
2020-04-05 19:00:52 -05:00
2020-05-24 15:31:14 -05:00
### 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.
2020-04-05 19:00:52 -05:00
`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
##### Recent | [Changelog Archive](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/CHANGELOG.md)
2020-10-09 00:10:46 -05:00
> ### 2020-10-6
2020-10-09 00:10:46 -05:00
#### Notice
2020-10-09 00:10:46 -05:00
- Just getting back to my rountine and maintaining this project. There has been many developments lately, especially with Thunderbolt 3 ACPI patches and [YogaSMC](https://github.com/zhen-zen/YogaSMC). It will take some time for me to review all these developments and understand them. Meanwhile, it seems @benbender has taken matters to his own hand while I was away :)
- His experimental fork: https://github.com/benbender/x1c6-hackintosh
- I will create an issue to specfically to discuss YogaSMC usage and config on this machine.
- Looking forward, Big Sur is almost here so I want to get this project back onto the latest stable build before it comes out.
2020-04-05 19:00:52 -05:00
#### Changed
2020-10-09 00:10:46 -05:00
- Support for Hibernation Mode 25. As with normal macOS machines, mode 3 is default, but if you want, mode 25 is now also an option.
- There seems to be a bug with the GitHub release version of `ThunderboltReset.kext` so I replaced it one built by @benbender. You can monitor the issue here [osy86/ThunderboltReset/issues/7](https://github.com/osy86/ThunderboltReset/issues/7). Thank you @benbender for noticing this.
- OC to 0.6.2
- Upgraded various Acidanthera kexts as well as `VoodooRMI`
#### Added
- Added `RTCMemoryFixUp` for support of Hibernation Mode 25.
- OpenCore config patch for FHD Touchscreen.
- OpenCore config patch for Intel wireless.
#### Removed
- ALCPlugFix is now deprecated and is replaced by new AppleALC (per issue #75). Please run `uninstall.sh` from the previous commit to remove ALCPlugFix.
- Delete legacy DiskImage voice from OC `Resources`
- `GPRW` ACPI patch to fix Bluetooth wake. Make sure that your Wake-on-LAN is disabled in BIOS to prevent sleep problems.
- Removed advice to disable DPTF in modded BIOS as it can break methods in ACPI. Thanks @benbender
- `SMCSuperIO` as it was unnecessary.
2020-07-18 12:56:53 -05:00
> # table of contents
- [summary](#summary)
- [before you start](#references)
- [needed](#needed)
- [my specs for comparison and ref](#specifications)
- [getting started ](#start)
- [other x1c6 repos](#other)
- [contact](#contact)
- [donate and support](#support)
- [credits and thank you](#credits)
> ## SUMMARY
2020-04-05 19:00:52 -05:00
**`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.`**
2020-07-18 12:56:53 -05:00
| Fully functional | Non-functional | Semi-functional. Additional pulls needed and welcomed. |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
2020-10-09 00:10:46 -05:00
| Native Power Mangemenet ✅ \*need BIOS mod, see [docs/1_README-HARDWAREandBIOS.md](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/1_README-HARDWAREandBIOS.md) | Wireless WAN ❌ (DISABLED at BIOS) | Thunderbolt 3 hotplug *with some caveats. See [docs/5_README-other.md](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/5_README-other.md) and [Issue #24](https://github.com/tylernguyen/x1c6-hackintosh/issues/24#issuecomment-603183002) ⚠️ |
2020-08-03 12:10:25 -05:00
| WiFi, Bluetooth, Apple Continuity, iCloud suite: App Store, iMessage, FaceTime, iCloud Drive, etc... ✅ \*need [network card replacement](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/1_README-HARDWAREandBIOS.md) | Fingerprint Reader ❌ (not needed, DISABLED at BIOS) | |
2020-10-09 00:10:46 -05:00
| USB A, USB C, Webcam, Audio Playback/Recording Sleep, Ethernet, Intel Graphics, TrackPoint and Trackpad, MicroSD card reader ✅ | | |
2020-08-03 12:10:25 -05:00
| BIOS Mod, giving access to `Advance` menu.✅ See [docs/1_README-HARDWAREandBIOS.md](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/1_README-HARDWAREandBIOS.md) and [Issue #68](https://github.com/tylernguyen/x1c6-hackintosh/issues/68) | | |
2020-07-18 12:56:53 -05:00
| Multimedia Fn keys ✅ \*need [ThinkpadAssistant](https://github.com/MSzturc/ThinkpadAssistant) | | |
| PM981 installation. ✅ See [Issue #43](https://github.com/tylernguyen/x1c6-hackintosh/issues/43) | | |
2020-08-03 12:10:25 -05:00
| 4K UHD via HDMI/DisplayPort. ✅ Install `patches/OpenCore patches/4K-Output.plist` if your BIOS is unmodded (follow [Issue #40](https://github.com/tylernguyen/x1c6-hackintosh/issues/40#issuecomment-659370165) when upgrading macOS with this patch enabled). If you have a modded BIOS, simply set `DMVT Pre-Allocated` to `64M` (Refer to [docs/1_README-HARDWAREandBIOS.md](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/1_README-HARDWAREandBIOS.md))| | |
2020-07-18 12:56:53 -05:00
| HDMI hotplug(requires a custom EDID override). ✅ See `patches/Internal Displays/` for pre-made ones and [Issue #60](https://github.com/tylernguyen/x1c6-hackintosh/issues/60) if one does not exist already for your display.| |
2020-10-09 00:10:46 -05:00
| Hibernation Mode 25 ✅||
**For more information regarding certain features, please refer to [`docs/3_README-POSTinstallation.md`](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/3_README-POSTinstallation.md)**
2020-04-05 19:00:52 -05:00
2020-07-18 12:56:53 -05:00
> ## REFERENCES
* Read these before you start:
- [dortania's Hackintosh guides](https://github.com/dortania)
2020-10-09 00:10:46 -05:00
- [dortania's OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/)
- [dortania's OpenCore Post Install Guide](https://dortania.github.io/OpenCore-Post-Install/)
2020-07-18 12:56:53 -05:00
- [dortania/ Getting Started with ACPI](https://dortania.github.io/Getting-Started-With-ACPI/)
- [dortania/ opencore `multiboot`](https://github.com/dortania/OpenCore-Multiboot)
2020-10-09 00:10:46 -05:00
- [dortania/ `USB map` guide](https://dortania.github.io/OpenCore-Post-Install/usb/)
2020-07-18 12:56:53 -05:00
- [WhateverGreen Intel HD Manual](https://github.com/acidanthera/WhateverGreen/blob/master/Manual/FAQ.IntelHD.en.md)
2020-10-09 00:10:46 -05:00
- `Configuration.pdf` and `Differences.pdf` in each `OpenCore` releases.
- Additionally, references specific to the x1c6 are located in `docs/references/`
2020-07-18 12:56:53 -05:00
* ### No seriously, please read those.
> ## NEEDED
2020-04-05 19:00:52 -05:00
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](https://www.fatcatsoftware.com/plisteditpro/).
[ProperTree](https://github.com/corpnewt/ProperTree) if you need to edit plist files on Windows.
[MaciASL](https://github.com/acidanthera/MaciASL), for patching ACPI tables.
[MountEFI](https://github.com/corpnewt/MountEFI) to quickly mount EFI partitions.
[IOJones](https://github.com/acidanthera/IOJones), for diagnosis.
[Hackintool](https://www.insanelymac.com/forum/topic/335018-hackintool-v286/), for diagnostic ONLY, Hackintool should not be used for patching, it is outdated.
2020-07-18 12:56:53 -05:00
> ## SPECIFICATIONS
2020-04-05 19:00:52 -05:00
Refer to [x1c6-Platform_Specifications](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/references/x1c6-Platform_Specifications.pdf) for possible stock ThinkPad X1 6th Gen configurations.
2020-04-05 19:00:52 -05:00
| Processor Number | # of Cores | # of Threads | Base Frequency | Max Turbo Frequency | Cache | Memory Types | Graphics |
| :--------------------------------------------------------------------------------------------------------------------------------- | :--------- | :----------- | :------------- | :------------------ | :---- | :----------- | :------------ |
| [i7-8650U](https://ark.intel.com/content/www/us/en/ark/products/124968/intel-core-i7-8650u-processor-8m-cache-up-to-4-20-ghz.html) | 4 | 8 | 1.9 GHz | 4.2 GHz | 8 MB | LPDDR3-2133 | Intel UHD 620 |
**Peripherals:**
```
2020-04-05 19:00:52 -05:00
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
2020-04-05 19:00:52 -05:00
```
**Display:**
`14.0" (355mm) HDR WQHD (2560x1440)`
**Audio:**
`ALC285 Audio Codec`
**Thunderbolt:**
2020-04-05 19:00:52 -05:00
`Intel JHL6540 (Alpine Ridge 4C) Thunderbolt 3 Bridge`
2020-07-18 12:56:53 -05:00
> ## START
2020-04-05 19:00:52 -05:00
2020-07-18 12:56:53 -05:00
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**](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/1_README-HARDWAREandBIOS.md): Requirements before starting.
[**2_README-installMEDIA**](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/2_README-installMEDIA.md): Creating the macOS install drive.
[**3_README-POSTinstallation**](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/3_README-POSTinstallation.md): Settings and tweaks post installation.
[**4_README-ACPIpatching**](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/4_README-ACPIpatching.md): 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**](https://github.com/tylernguyen/x1c6-hackintosh/blob/master/docs/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.
2020-07-18 12:56:53 -05:00
> ## OTHER
2020-04-05 19:00:52 -05:00
[zhtengw/EFI-for-X1C6-hackintosh](https://github.com/zhtengw/EFI-for-X1C6-hackintosh)
[Colton-Ko/macOS-ThinkPad-X1C6](https://github.com/Colton-Ko/macOS-ThinkPad-X1C6)
Create a pull request if you like to be added, final decision at my discreation.
2020-07-18 12:56:53 -05:00
> ## CONTACT
2020-04-05 19:00:52 -05:00
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.
2020-07-18 12:56:53 -05:00
> ## SUPPORT
2020-04-05 19:00:52 -05:00
https://tylerspaper.com/support/
2020-07-18 12:56:53 -05:00
> ## CREDITS
2020-04-05 19:00:52 -05:00
[@Colton-Ko](https://github.com/Colton-Ko/macOS-ThinkPad-X1C6) for the great features template.
[@stevezhengshiqi](https://github.com/stevezhengshiqi) for the one-key-cpufriend script.
2020-08-03 12:10:25 -05:00
[@corpnewt](https://github.com/corpnewt) for GibMacOS, EFIMount, and USBMap.
[@xzhih](https://github.com/xzhih) for one-key-hidpi.
[@daliansky](https://github.com/daliansky) for various hotpatches.
2020-08-03 12:10:25 -05:00
[@velaar](https://github.com/velaar) for your continual support and contributions.
[@benbender](https://github.com/benbender) for your various issue contributions.
[@Porco-Rosso](https://github.com/Porco-Rosso) putting up with my requests to test repo changes.
2020-08-03 12:10:25 -05:00
[@MSzturc](https://github.com/MSzturc) for adding my requested features to ThinkpadAssistant.
paranoidbashthot and \x for the BIOS mod to unlocked Intel Advance Menu.
The greatest thank you and appreciation to [@Acidanthera](https://github.com/acidanthera), without whom's work, none of this would be possible.
And to everyone else who supports and uses my project.
2020-04-05 19:00:52 -05:00
Please let me know if I missed you.