View source for Installing Fedora 23 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 23 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.}}
|}

== New in this release ==
New in this Fedora release, with regards to this model ThinkPad is the following;
* ...

Regressions;
* ...

== 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}} || but required passing the boot parameter intel_pstate=disable
|- 
|rowspan=4|Display - [[Intel HD Graphics]]
| Laptop Screen  || {{Cyes}} || Requires a newer kernel to detect HiDPI display
|-
| 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}} || After installing a newer kernel
|-
| 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=8|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}} ||
|-
| Touch screen || {{Cyes}} ||
|-
| Automatic screen rotation || {{Cno}} || While the capability seems to be detected, it does not actually rotate
|-
| rowspan=3|Ports
| Intel Ethernet || {{Cyes}} || via OneLink+ dongle
|-
| 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 || {{Cunk}} || Have not received the OneLink+ dock yet
|-
|}

= Tested and Verified on Fedora 23 =

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

== 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 ==

By default, the installation will hang immediately after the bootloader with a black screen. It is necessary to edit the boot options and add "intel_pstate=disable" to the end of the line of options.

After this, installation is straight forward; you can follow the generic Fedora install instructions.

What you may notice is that during installation on the HiDPI display that everything is very small, and that WIFI does not work. For both of these it is necessary to upgrade the kernel and linux-firmware modules after installation.

== Configuration ==

=== Kernel ===
As root, edit {{path|/etc/default/grub}} and adding the option {{bootparm|intel_pstate|disable}} which will prevent a hang at boot. After adding this, update the grub configs with the following (assuming default uEFI setup);

 grub2-mkconfig -o /boot/efi/EFI/fedora/grub.cfg

There is a work around for this BIOS bug in the 4.6 kernel, which is not available for Fedora 23 at this point.

=== X Server - Intel HD Graphics===
Works out of the box, but HiDPI is not detected until you install a more recent kernel.

In addition, a HiDPI display has a whole lot of issues. Most of them are covered here; [https://wiki.archlinux.org/index.php/HiDPI ArchLinux HiDPI].

Basically with the default kernel, everything is tiny but with a later kernel everything is quite large as it tries to scale everything 2x. 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.

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 long term solution would be to switch to a Wayland desktop which should be able to handle multiple displays with various DPI settings, although right now this is not the case and support for this is likely to land in Fedora 24.

=== 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}} || Wireless Kill || || {{Cyes}} || {{Cyes}} || No OSD, but kills wireless
|-
| {{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]]