Skip to content

Latest commit

 

History

History
577 lines (406 loc) · 20.5 KB

README.md

File metadata and controls

577 lines (406 loc) · 20.5 KB
Raw

MacOS on Thinkpad Yoga 12

Hackintosh MacOS Mojave on Thinkpad Yoga 12 with ACPI hotpatches

Pre-Installation

1. Warning - Achtung - Attention : check you BIOS version !!!

There is a known bug in embeded controller, where CPU fan stop triggering. This has been fixed with Bios version 1.20.

I've experimented this bug (with BIOS 1.03 JEET47WW), and the CPU rises up quickly to 99°C at full load (even with short load). This is extremly dangerous for the health and lifespan of your laptop.

So you should update BIOS to version 1.20 at minimum !

BIOS Summary of Changes at https://download.lenovo.com/pccbbs/mobiles/jeuj84ww.txt

<1.20>
- (New) Updated Fan table
- (Fix) Fixed an issue that Fan stops working even when temperature reaching trigger point.

...

<1.08>
- (New) Removed authentication of WLAN cards.

So if you want to be able to replace the Wifi card with a MacOS compatible card, Bios version 1.08 or above is mandatory.

But version 1.20 or later is highly recommended !

Due to so many horror stories and laptop bricked by BIOS update done from within Windows, I highly recommand to update BIOS only from bootable media (CD or USB thumb). Here you can find ISO file to download: https://support.lenovo.com/fr/fr/downloads/ds102287 If you get error message "secure flash athentication failed" while updating the BIOS, you should disable first "rollback prevention " in BIOS settings.

Note: my installation guide will be based on Bios version 1.20.

2. BIOS settings

  • Disable Computrace
  • Disable Vtd / Vtx
  • Enable CSM
  • Enable USB3

3. Know your hardware

Compenent Reference
CPU Intel Core i-5 5200U
RAM 8GB Ram
GFX Intel HD Graphics 5500
Sound Intel HD Audio (Conexant CX22752 Audio Driver)
Display 12.5" FHD IPS LCD (VendorID: 30e4 - ProductID: 437) LG Display LP125WF2-SPB2
Wifi Intel Wifi -> Should be replaced by a Broadcom compatible WLAN card
Touch panel Synaptics Touch Digitizer V04 (USB Internal port)
Stylus digitizer Wacom ISD-V4 (USB Internal port)
Sensor Hub ST Sensor Hub: gyroscope, Accelerometer, rotation detection, luminosity detection. (USB Internal port)
SD Card reader Realtek RTS5227 PCI Express Card Reader
Camera CON4B2E72 Integrated Camera (USB Internal port)
Extension Port Onelink Dock port for extension module Onelink Pro Dock

Note about Touchscreen: the touchscreen is not recognized at all in MacOS, not even as a single mouse pointer (like on the former Thinkpad Yoga S1). I've tried many things: faking USB ProductID/VendorID to get it to work with Wacom Driver, faking kext for several touch device drivers, using VoodooI2C with VoodooI2CHID Satellites... without any success. So I've dediced to just stop bothering trying to get touchscreen on MacOS and forget this feature.

You can use the touchscreen feature with others OS : Win10/Win8, Ubuntu+Gnome (works well), CloudReady/ChromeOS or even PhoenixOS/Android7 or BlissOS/Android8.

USB ports

USB controller XHC is 8086_9cb1 with following ports (when used with UsbInjectAll):

USB Port Usage
HS01 Left port, external (USB2)
HS02 Right port, external (USB2)
HS03 dedicated to Onelink Pro Dock (USB2)
HS04 Bluetooth, Internal USB port
HS05 Synaptic Touch Digitizer, Internal USB port
HS06 Integrated camera, Internal USB port
HS07 Not used
HS08 ISD-V4 (tablet), Internal USB port
HS09 Not used
HS10 Not used
HS11 Not used
SSP1 Left port, external (USB3)
SSP2 Right port, external (USB3)
SSP3 dedicated to Onelink Pro Dock (USB3)
SSP4 Not used
SSP5 Not used

So a kext (USBPorts.kext) will be used to only enable the following ports HS01,HS02,HS03,HS04,HS06,HS08,SSP1,SSP2,SSP3 with appropriate port values (external USB2/external USB3/internal). Note: if you don't plan to use OneLink Dock, you can also disable HS03 and SSP3. But Onlink Dock is really cool.

What will work:

CPU, Graphic Card, Power Management, Battery, Sleep, Camera, Screen (FHD), brightness, HiDPI, Keyboard, Trackpad and Trackpoint, Sound, USB ports, HDMI port, HDMI Audio-Out, Onelink Pro Dock (USB2/USB3, DisplayPort, DVI, Ethernet).

What will not work:

  • Touchscreen
  • ST Sensor Hub: gyroscope, Accelerometer, rotation detection, luminosity detection..

What will partially work:

  • Tablet digitzer (with stylus): recognized as a mouse with button
  • SD Card reader: a driver is under development, but not yet stable enough

WIFI :

Default Intel Wifi M.2 card is replaced by a Broadcom BCM94352Z card. Thinkpad Yoga 12 M.2 wifi port is E keyed, so it's compatible with both A+E and E keys cards. So you can either use in it:

  • Dell DW1560 (BCM94352Z) which is M.2 "A+E" keyed.
  • Lenovo BCM94352Z (FRU 04X6020) which is M.2 "E" keyed.

This card works perfectly (both Wifi and BT) with just 3 kexts (1 for wifi and 2 for BT) and no need for any patching.

So if you find a good price opportunity on Lenovo's BCM94352Z card (usually cheaper on the market than Dell's card), you can go for it on Yoga 12 ;) This is not the case for every laptops

WIFI alternative :

While waiting for the internal wifi replacement card to arrive, I've used a USB wifi key TP-Link TL-WN725N. Mine is TL-WN725N V2 (and V3 does also work). It works pretty well, while it's limited to Wifi-N (one band) at 150Mbps and occupy one of the two USB port available on this laptop. Note: for V2 of this adapter TP-Link recommnends the specific V2 of its driver. But the V2 driver is unstable as hell, use instead V3 driver even for a V2 adapter (it works pretty well). Driver URL: https://www.tp-link.com/us/download/TL-WN725N_V3.html

Targeted MacBook

MacBook Air "Core i5" 1.6 13" - Early 2015 Sold from 2015 to 2017 (yeah MacbookAir 2017 is exactly the same laptop, with the Broadwell CPU from 2015...)

It has the closest specs: Core i5 (I5-5250U) / Intel HD6000 (1.5 GB vram) / 13" LCD (1440x900) / Broadcom wifi AC + BT (bcm94360cd) / 8 GB RAM DDR3 / 128GB SSD / 2 x USB3 ports.

Its code name is MacBookAir7,2

Installation

....

Post-Installation

1. Tools needed

  • Clover Installer
  • Clover configurator
  • MacIasl
  • iasl

...

2. Kexts used

In Clover/Kexts/Other

In conjonction with Inject = Detect in config.plist (so these kexts are only used for System updates or boot in recovery mode)

  • AirportBrcmFixup.kext
  • AppleALC.kext
  • AppleBacklightFixup.kext
  • IntelMausiEthernet.kext
  • Lilu.kext
  • SMCBatteryManager.kext
  • SMCProcessor.kext
  • USBPorts.kext
  • VirtualSMC.kext
  • VoodooPS2Controller.kext
  • WhateverGreen.kext

In Library/Extensions

  • AirportBrcmFixup.kext (for Wifi Airport)
  • AppleALC.kext (for sound)
  • AppleBacklightFixup.kext (for LCD brightness management)
  • AppleGraphicsPowerManagement_Broadwell.kext (to inject GPU low frequency management)
  • BrcmFirmwareRepo.kext (for bluetooth)
  • BrcmPatchRAM2.kext (for bluetooth)
  • HibernationFixup.kext
  • IntelMausiEthernet.kext
  • Lilu.kext
  • SMCBatteryManager.kext
  • SMCProcessor.kext
  • Sinetek-rtsx.kext (For SD Card Reader)
  • USBPorts.kext
  • UVC2FaceTimeHD.kext (to fake FaceTimeHD camera)
  • VirtualSMC.kext
  • VoodooPS2Controller.kext (for keyboard/trackpad/trackpoint)
  • WhateverGreen.kext (for GPU support)
  • X86PlatformPlugin_Broadwell.kext (to inject CPU frequencies vectors)

Note about some kexts:

2. Hotpaches

It consitsts of a combinaison of ACPI replacements done in Clover plist along with additional custom SDST files.

HiDPI

I've used this automated script: https://github.com/xzhih/one-key-hidpi

It allows the follwing scaled resolutions using HiDPI system: 1280x720 / 1440x810 / 1680x845 / 1920x1080

HiDPI

Disable Hibernation

Source: https://www.tonymacx86.com/threads/guide-native-power-management-for-laptops.175801/

sudo pmset -a hibernatemode 0
sudo rm /var/vm/sleepimage
sudo mkdir /var/vm/sleepimage

sudo pmset -a standby 0
sudo pmset -a autopoweroff 0

1. USB power management, port limiting and fix instant wake-up

Adapted from this guide: https://www.tonymacx86.com/threads/guide-usb-power-property-injection-for-sierra-and-later.222266/

1. Fix Embedded Controller reference

In config.plist rename EC0 to EC, in order AppleBusPowerController will get a proper access to embedded controller:

<dict>
	<key>Comment</key>
	<string>change EC0 to EC</string>
	<key>Disabled</key>
	<false/>
	<key>Find</key>
	<data>RUMwXw==</data>
	<key>Replace</key>
	<data>RUNfXw==</data>
</dict>
2. Inject port limits and kUSB power management

USB controller is 8086_9cb1 with following ports:

  • HS01: Left port, external (USB2)
  • HS02: Right port, external (USB2)
  • HS03: Onelink Pro Dock (USB2)
  • HS04: Bluetooth, internal (USB2)
  • HS05: Synaptic Touch Digitizer, internal (USB2)
  • HS06: Integrated camera, internal (USB2)
  • HS07: Not used
  • HS08: ISD-V4 (tablet), internal (USB2)
  • HS09: Not used
  • HS10: Not used
  • HS11: Not used
  • SSP1: Left port, external (USB3)
  • SSP2: Right port, external (USB3)
  • SSP3: Onelink Pro Dock (USB3)
  • SSP4: Not used
  • SSP5: Not used

A SSDT hotpatch is used to:

  • to enable only those used HS01,HS02,HS03,HS04,HS05,HS06,HS08,SSP1,SSP2,SSP3 with appropriate port values (external/internal). Note: if you don't plan to use OneLink Dock, you can also disable HS03 and SSP3
  • to inject proper value for AppleBusPowerController
"kUSBSleepPortCurrentLimit", 2100,
"kUSBSleepPowerSupply", 2600,
"kUSBWakePortCurrentLimit", 2100,
"kUSBWakePowerSupply", 3200,
  • to inject proper AAPL values for \_SB.PCI0.XHC
"AAPL,current-available", Buffer() { 0x34, 0x08, 0, 0 },
"AAPL,current-extra", Buffer() { 0x98, 0x08, 0, 0, },
"AAPL,current-extra-in-sleep", Buffer() { 0x40, 0x06, 0, 0, },
"AAPL,device-internal", 0x02,
"AAPL,max-port-current-in-sleep", Buffer() { 0x34, 0x08, 0, 0 },
3. Fix Power Call
<dict>
	<key>Comment</key>
	<string>change Method(GPRW,2,N) to XPRW, pair with SSDT-GPRW.aml</string>
	<key>Disabled</key>
	<false/>
	<key>Find</key>
	<data>
	FEUIR1BSVwI=
	</data>
	<key>Replace</key>
	<data>
	FEUIWFBSVwI=
	</data>
</dict>

and compile SSDT-GPRW.dsl to SSDT-GPRW.aml with MaciASL and add it to /Clover/ACPI/Patched/

2. Fix LED blinking after waking up from sleep

In config.plist, replace method "WAKH" 14 4E 41 57 41 4B 48 09

by method "WAKO" 14 4E 41 57 41 4B 4F 09

<dict>
      <key>Comment</key>
      <string>change Method(WAKH to WAKO</string>
      <key>Disabled</key>
      <false/>
      <key>Find</key>
      <data>
      FE5BV0FLSAk=
      </data>
      <key>Replace</key>
      <data>
      FE5BV0FLTwk=
      </data>
</dict>

Then add and call an additional SSDT-LED.aml file that create a new method WAKH which calls the LED ON status \_SI._SST (0x00) on wake up

3. Brightness Hotkeys

<dict>
	<key>Comment</key>
	<string>change Method(_Q14,0,S) to XQ14</string>
	<key>Disabled</key>
	<false/>
	<key>Find</key>
	<data>
	X1ExNA==
	</data>
	<key>Replace</key>
	<data>
	WFExNA==
	</data>
</dict>
<dict>
	<key>Comment</key>
	<string>change Method(_Q15,0,S) to XQ15</string>
	<key>Disabled</key>
	<false/>
	<key>Find</key>
	<data>
	X1ExNQ==
	</data>
	<key>Replace</key>
	<data>
	WFExNQ==
	</data>
</dict>

2. HiDPI

Reference guide: https://www.tonymacx86.com/threads/adding-using-hidpi-custom-resolutions.133254/

1. Enable HiDPI

sudo defaults write /Library/Preferences/com.apple.windowserver DisplayResolutionEnabled -bool YES
sudo defaults delete /Library/Preferences/com.apple.windowserver DisplayResolutionDisabled

2. Generate a display override plist

I don't have eagle eyes anymore to read confortably at 1920x1080 pixels on a 12.5" screen... So I tried to use scaled resolutions, but vthen erything is blurry. That's why I've used HiDPI feature to get crisp and clear scaled resolutions.

My custom override folder is set for 1920x1080 native resolution + 1600x900 scaled HiDPI + 1366x768 scaled HiDPI.

You can either copy my custom override folder DisplayVendorID-30e4 (copy the whole "DisplayVendorID-30e4" folder) in /System/Library/Displays/Contents/Resources/Overrides/ or generate your own at https://comsysto.github.io/Display-Override-PropertyList-File-Parser-and-Generator-with-HiDPI-Support-For-Scaled-Resolutions/ (also read the doc at the bottom of the page).

If you want to generate your own resolutions override, the LCD panel references in Yoga 12 are :

  • VendorID: 30e4
  • ProductID: 437

Or this automated script: https://github.com/xzhih/one-key-hidpi

3. Use RDM to switch resolution

https://github.com/avibrazil/RDM

2. SMBIOS

2. CPU Low Frequency Mode

By default in Macbook Air 7.1 and 7.2 CPU lowest CPU frequency is 1300Mhz, while the i5-5200U can go lower to 800Mhz on idle or basic load. This means, as-is, your CPU will consume too much power (and so drain battery) when on low frequency. To fix that, you can patch the frequency vectors.

Notice: The LFM frequency in Mac-9F18E312C5C2BF0B.plist is set to 1300 MHz! This restriction can be lifted with help of freqVectorsEdit.sh from: https://github.com/Piker-Alpha/freqVectorsEdit.sh

-> to check: https://github.com/nguyenlc1993/mac-os-k501l/wiki/Postinstall-optimization

Actually, I included 2 dummy kexts in the installation pack namely AppleGraphicsPowerManagement_K501LX.kext and X86PlatformPlugin_K501LX.kext, which contain the modified power profiles. You just have to install these two kexts to get the effect, thus no need to modify the original kexts.

Keyboard special keys

For reference: Apple Key Codes https://eastmanreference.com/complete-list-of-applescript-key-codes

Done with https://github.com/RehabMan/OS-X-ACPI-Debug

Mute (f1): ApplePS2Keyboard: sending key e020=4a down ACPI: EC _Q43

  • Volume - (on F2): ApplePS2Keyboard: sending key e02e=49 down
  • Volume + (on F3): ApplePS2Keyboard: sending key e030=48 down
  • Mic Mute (on F4): ACPI EC _Q6A
  • Brightness Down (on F5): ACPI EC _Q15
  • Brightness Up (on F6): ACPI EC _Q14
  • Miror (on f7) : ApplePS2Keyboard sending key e05b=3a down and after ApplePS2Keyboard sending key 19=23 down = mapped by default to ⌥P
  • WIFI (on F8): ACPI EC _Q64
  • Settings (on F9): ACPI EC _Q5A
  • Search (on F10): ACPI EC _Q5B
  • Menu (on F11): ACPI EC _Q5C
  • Apps (on F12): ACPI EC _Q5D
  • Lock screen rotation (on side): This button also send a two signals at the same time : PS2 scan code e017 (F15) / ACPI EC _Q36

-> disabling _Q36 method, and mapping e017=64 (F13) to avoid duplicate button for Brightness Up

power plug on: ACPIDebug: "EC _Q26 enter" power plug off: ACPIDebug: "EC _Q27 enter"

Win key : ?

fn+Space (keyboard light): ACPI: EC _Q1F

Sound

Sound is reported to be Conexant CX22752 (aka Conexant CX20752) from Lenovo Win8 driver page or Conexant CX22751 (aka Conexant CX20751) from Lenovo Win10 driver page.

Hopefully Conexant CX20751/20752 is supported by AppleALC kext. And the sound device in DSDT is already HDEF without patching anything. The layout-id to use for 20751/20752 is either 3 or 28.

So it is just needed to install AppleALC.kext in /Library/Extensions/ , along with Lilu. And configure in config.plist:

  • ACPI/DSDT/Fixes/FixHPET -> Yes
  • Devices/Audio/Inject -> 28

No need for VoodooHDA or CodecCommander.

HDMI SOUND OUTPUT

OK, I get HDMI Audio-Out working, but no control over the volume on that output ?

It's not a bug, it's a feature !

This is how Apple/MacOS think it should be : no control on the volume for this kind of audio output, sound is sent at full volume and you should control the volume directly on your monitor...

There are external tools to enable sound volume control (from the system) for HDMI output. What they do basically it to create an additional virtual audio device (with controlable volume) and you send system audio to it, then it routes the sound the desired output. It acts like a proxy with audio routing.

The caveat with these solutions above: expect some sound distortion and/or some delay, CPU usage and memory footprint increase, some issues with audio output/control after wake.... So it's up to you.

ICC profile

LCD panel is LG Display LP125WF2-SPB2

By default with ICC profile generated automatically by Apple, the display is a bit yellowish

Here is an ICC profile that gets more accurate colors: https://github.com/soleblaze/icc/raw/master/lp125wf2-spb2.icc Found here: https://github.com/soleblaze/icc

Another profile found here (but more redish): redish https://www.thinkscopes.com/2014/08/24/color-profiles-for-current-thinkpads/

Subpixel antialiasing

On macOS Mojave nukes subpixel antialiasing, making your non retina monitor appear blurry.

While this is considered as a "refinement" on Apple retina displays, it is clearly a downgrade regarding font rendering on FHD panel.

-> Solution: open the terminal

  1. Re-enable subpixel rendering
defaults write -g CGFontRenderingFontSmoothingDisabled -bool NO
  1. Fine tune font smoothing

To read the actual setting:

defaults read NSGlobalDomain AppleFontSmoothing

Then you can set it to 1, 2, 3 or 4. Test the setting that suits you the best (I've used 3 on mine).

defaults write NSGlobalDomain AppleFontSmoothing -int 3

You'll need to either reboot your laptop or close the session an log on again, in order to see any change.

Sources: tonymacx86 post and reddit post

Update to 10.14.1

after update, when all set and done, restarted with a fatal osxaptio error.

Had to update my old OsxAptioFixDrv-64.efi to OsxAptioFix3Drv-64.efi.

Unknown PCI devices:

  • pci8086,9ca4 : Intel PCH Thermal Reporting
  • pci8086,1604 : Intel Broadwell-U Host Bridge -OPI

Stylus (Tablet). Recognized as Mouse.

In IORegistryExplorer:

  • VendorID: 0x56a
  • ProductId: 0xec
  • USB Product Name: ISD-V4
  • USB Vendor Name : Tablet

In System Information:

  • Identifiant du fournisseur : 0x056a (WACOM Co., Ltd.)
  • Fabricant : Tablet

Note about the ThinkPad OneLink Pro Dock https://support.lenovo.com/us/en/solutions/pd029981

OneLink Pro Dock

If you plan to use your Thinkpad Yoga 12 regularly on a desk, this dock is very convenient. If you get the opportunity to buy one for cheap (I bought mine for 25 euros on Ebay), go for it ;)

It adds the follwoing features totally working with MacOS Mojave: main power replicator, Ethernet Gigabit, additional sound output, powered USB Hub with 2 USB2 ports and 4 USB3 ports, DisplayPort, DVI port. And everything is hotplug.

Note: I've tested everything except DVI port, but as FB Patcher reports 4 framebuffers including one disabled (set as dummy), I'm pretty sure it's possible to enable the framebuffer for DVI port.

Sleep:

https://www.tonymacx86.com/threads/guide-native-power-management-for-laptops.175801/

sudo pmset -a hibernatemode 0
sudo rm /var/vm/sleepimage
sudo mkdir /var/vm/sleepimage

sudo pmset -a standby 0
sudo pmset -a autopoweroff 0