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.

--> Version 1.20 or later 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	FHD 1920x1080 (12.5 英寸)
Sensor Hub	ST Sensor Hub: gyroscope, Accelerometer, rotation detection, luminosity detection..
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

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.

So if you find a good price opportunity on Lenovo's BCM94352Z 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

Installation

....

Post-Installation

1. Tools needed

Clover Installer
Clover configurator
MacIasl
iasl

...

2. Kexts used

ACPIBatteryManager.kext
AppleBacklightFixup.kext
HibernationFixup.kext
IntelMausiEthernet.kext
Lilu.kext
SMCBatteryManager.kext
SMCProcessor.kext
USBInjectAll.kext
VirtualSMC.kext
VoodooHDA.kext
VoodooPS2Controller.kext
WhateverGreen.kext
Sinetek-rtsx kext for PCI SD-Card reader. Sources: https://github.com/syscl/Sinetek-rtsx (fork of https://github.com/sinetek/Sinetek-rtsx ). I've used the build from this repository: https://github.com/Maxcj/Hasee-OS-X It works somehow... (note I've taken the release 2018.11.05

2. Hotpaches

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

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.

https://github.com/mattingalls/Soundflower (free) tutorial / Lifehacker post
https://staticz.com/soundcontrol/ (not free: 10$ License)

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

Re-enable subpixel rendering

defaults write -g CGFontRenderingFontSmoothingDisabled -bool NO

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

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

gartempe/MacOS-Thinkpad-Yoga-12