View source for Installing Fedora 26 on a ThinkPad X1 Yoga

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
{{NOTE|This is based on the x86-64 workstation version of Fedora 26 with the default GNOME desktop. Your experience with a different edition may be different.}}
{{HELP|Not all models of this ThinkPad are equal, you may have a different WiFi adapter or display, or some options I did not have. If you tested them, please add their status down below.}}
|}

== Firmware Update!==
The issues you may encounter with touch and pen input on the X1 Yoga likely are due to a firmware issue. Lenovo has issued an updated firmware [http://support.lenovo.com/lu/en/products/Laptops-and-netbooks/ThinkPad-X-Series-laptops/ThinkPad-X1-Yoga-Type-20FQ-20FR/downloads/DS112340]. With this update the touch and pen input in Xorg is stable. Only issue is that the firmware update needs to run from Windows.

Note, this does not fix the pen input in xwayland, that is a totally different issue and effects every Wacom device with Wayland right now. While wayland supports tablet devices, the issue is that that only works in combination with GTK3 applications today. Any applications using GTK2, QT or other toolkits will use xwayland, which does not support tablet devices. This including GIMP, Firefox, Chrome, etc. This issue is solved in the upstream Xorg server 1.20.

And while your at it, you should also make sure you have the latest [http://pcsupport.lenovo.com/lu/en/products/laptops-and-netbooks/thinkpad-x-series-laptops/thinkpad-x1-yoga-type-20fq-20fr/downloads/ds112240 Intel Management Engine firmware], and the latest [http://pcsupport.lenovo.com/lu/en/products/laptops-and-netbooks/thinkpad-x-series-laptops/thinkpad-x1-yoga-type-20fq-20fr/downloads/ds111756 BIOS update]

== New in this release ==
New in this Fedora release, with regards to this model ThinkPad is the following;
* Wacom settings app now also works in Wayland mode
* Screen rotation works out of the box
* brightness sensor works out of the box
* The error that the wacom device is not recognised has been fixed


== Success Chart - Out of the box experience ==
{| border="1" cellpadding="5" cellspacing="0"
|-
|colspan=2| '''Item''' || '''Working''' || '''Notes'''
|-
|rowspan=3|Installation 
| Local CD/DVD install || {{Cunk}} || did not test
|-
| Network Installation || {{Cunk}} || did not test
|-
| USB Installation     || {{Cyes}} || did not test
|- 
|rowspan=4|Display - [[Intel HD Graphics]]
| Laptop Screen  || {{Cyes}} ||
|-
| VGA || {{Cunk}} || I do not have the VGA OneLink+ dongle
|-
| Displayport || {{Cunk}} || did not test
|-
| HDMI || {{Cyes}} ||
|-
|rowspan=2|Power Management
| Software Suspend (hibernate) || {{Cunk}} ||
|-
| Suspend to Memory (ACPI sleep) || {{Cyes}} ||
|-
|colspan=2| [[CX11852|Intel HD Audio]] || {{Cyes}} ||
|-
|colspan=2| Web Cam || {{Cyes}} ||
|-
|rowspan=5| Wireless || | WiFi - Intel 8260 AC|| {{Cyes}} ||
|-
| WiFi - Intel 18260 AC + WiGig || {{Cunk}} ||
|-
| Bluetooth 4.1 || {{Cyes}} ||
|-
| WWAN - Sierra Wireless EM7455 || {{Cunk}} ||
|-
| WWAN - Huawei 4G  || {{Cunk}} || did not test, but is detected
|-
| rowspan=9|Input
| Keyboard || {{Cyes}} ||
|-
| [[TrackPoint|TrackPoint]] || {{Cpart}} || Yes, but does not get disabled in tablet mode!
|-
| [[UltraNav|TouchPad]]|| {{Cpart}} || Yes, but does not get disabled in tablet mode!
|-
| Extra keys || {{Cyes}} || see ThinkPad Extra keys section below
|-
| [[Integrated Fingerprint Reader|Fingerprint reader]] || {{Cno}} || does not work
|-
| Pen Pro (Wacom) || {{Cyes}} || works in Xorg, does not work in xwayland
|-
| Touch screen || {{Cyes}} || issues resolved after touch firmware update
|-
| Automatic screen rotation || {{Cyes}} ||
|-
| Ambient light sensor || {{Cyes}} ||
|-
| rowspan=3|Ports
| Intel Ethernet || {{Cyes}} || via OneLink+ dongle or OneLink+ dock
|-
| MicroSD reader || {{Cyes}} ||
|-
| [[USB Port|USB]] || {{Cyes}} ||
|-
| colspan=2| [[Embedded Security Subsystem|TPM]] || {{Cunk}} || did not test, but tpm kernel modules are being loaded
|-
| colspan=2| Docking || {{Cyes}} || OneLink+ dock works fine
|-
|}

= Tested and Verified on Fedora 26 =

Information in this section has been tested and verified using Fedora 25.

== BIOS ==
In the BIOS (F1 to enter during boot), be sure to disable secure boot.

 Security > Secure Boot > Secure Boot = Disabled

Also, if your planning to run any kind of virtual machines, make sure you enable the CPU virtualization support.

 Security > Virtualization > Intel (R) Virtualization Technology = Enabled

And while your in the BIOS setup you may also want to immediately change the default Function key behaviour. On this ThinkPad by default the function keys will not work as one would expect. When pressing F1 you do not get F1, but you get Mute. To get F1 you need to press Fn-F1 or you first need to enable the FnLk (Fn-ESC). To reverse this behaviour back to how to should be, change the setting in the BIOS.
 Config > Keyboard/Mouse > F1-F12 as Primary Function = Enabled

== Installation ==

Nothing special, you can follow the generic Fedora install instructions.

== Configuration ==

=== Kernel ===
No special configuration needed

=== Wayland ===
This is the default starting with Fedora 25. For the most part works fine, but there are still a couple of issues that are not specific to this ThinkPad.

For one, the Pen and Touch does not work in xwayland mode. Also window placement with full-screen programs on a multi-monitor setup is still problematic. But the list of issues is getting shorter with every new update.

=== X Server ===
Works out of the box, but is no longer the default.

If you have the HiDPI display option, it brings with it a whole lot of issues. Most of them are covered here; [https://wiki.archlinux.org/index.php/HiDPI ArchLinux HiDPI].

Basically everything is quite large as it tries to scale everything 2x when a HiDPI display is detected. In fact a bit too large to my liking. On the archlinux website there are some hints and tips on how to scale things down a bit again, but it is really a hack and far from ideal. After experimenting with various options, I decided to use the default 2x scaling in Gnome, but change the zoom option in the webbrowser to scale everything a bit smaller since that is what I use most.

Also having a HiDPI primary display causes everything on external non-HiDPI displays to appear huge as they will receive the same scaling factor. This is a limitation of the X11 windowing system. The solution would be to switch to a Wayland desktop which is able to handle multiple displays with various DPI settings.

=== Touchscreen & Pen ===
It is essential that you apply the Lenovo Touch firmware update for the X1 Yoga. Without this update the Pen and Touch is flaky and may stop working even by such simple actions as locking the screen.

Also when using the default Wayland desktop, the pen does not work at all for applications relying on xwayland, which are the majority. This is a known issue. The solution for now is to use Gnome on Xorg.

=== ThinkPad Extra keys ===
ThinkPad keys are handled by a mixture of the thinkpad_acpi, acpi button, acpi dock and acpi video drivers.

{| border="1" cellpadding="5" cellspacing="0"
|-
| '''Key''' || '''Function''' || '''Handled by''' ||'''Event''' || '''Works''' || '''Notes'''
|-
| {{key|Fn}}{{key|ESC}} || FnLk || || {{Cunk}} || {{Cyes}} || Locks Fn key state
|-
| {{key|Fn}}{{key|F1}} || Mute || || {{Cyes}}|| {{Cyes}} ||
|-
| {{key|Fn}}{{key|F2}} || Volume - || || {{Cyes}} || {{Cyes}} ||
|-
| {{key|Fn}}{{key|F3}} || Volume + || || {{Cyes}} || {{Cyes}} ||
|-
| {{key|Fn}}{{key|F4}} || Mic Mute || || {{Cyes}} || {{Cyes}} ||
|-
| {{key|Fn}}{{key|F5}} || brightness down || || {{Cyes}} || {{Cyes}} ||
|-
| {{key|Fn}}{{key|F6}} || brightness up || || {{Cyes}} || {{Cyes}} ||
|-
| {{key|Fn}}{{key|F7}} || presentation mode || || {{Cunk}}  || {{Cyes}} || Cycles through External Only, mirror and dual display
|-
| {{key|Fn}}{{key|F8}} || Airplane mode || || {{Cyes}} || {{Cpart}} || Activates and deactivates airplane mode.
|-
| {{key|Fn}}{{key|F9}} || Settings || || {{Cyes}} || {{Cyes}} || Opens Gnome settings panel
|-
| {{key|Fn}}{{key|F10}} || Find || || {{Cyes}} || {{Cyes}} || Opens Gnome find
|-
| {{key|Fn}}{{key|F11}} || ? || || {{Cunk}} || {{Cunk}} || Does not seem to do anything
|-
| {{key|Fn}}{{key|F12}} || ? || || {{Cyes}} || {{Cyes}} || Opens Gnome Places
|-
| {{key|Fn}}{{key|Space}} || keyboard light || - || {{Cunk}} || {{Cyes}} || no OSD.
|-
| Power || Power button || acpi button|| {{Cyes}} || {{Cyes}} || Need to press button for ~1 second to trigger a Suspend event.
|-
| Volume keys on side || Volume || || {{Cyes}} || {{Cyes}} ||
|-
| Lid || Lid button || acpi button|| {{Cyes}} || {{Cyes}} || Triggers suspend event
|-
|}

[[Category:X1 Yoga]][[Category:Fedora]]