Microsoft Surface Pro 3

From ArchWiki
Revision as of 16:03, 30 September 2017 by Lahwaacz.bot (talk | contribs) (update Pkg/AUR templates)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Tango-view-refresh-red.pngThis article or section is out of date.Tango-view-refresh-red.png

Reason: Improvements landed in recent Linux versions (Discuss in Talk:Microsoft Surface Pro 3#)

Tango-edit-clear.pngThis article or section needs language, wiki syntax or style improvements.Tango-edit-clear.png

Reason: Help:Style#Language register (Discuss in Talk:Microsoft Surface Pro 3#)
Warning: The warranty of the device is only valid if the OEM image of Windows is still present. A dual boot, however, will not invalidate the warranty as explained here.

This page aims to document all relevant information on getting Arch Linux working on the Microsoft Surface Pro 3 tablet.

Booting into the installer

To boot from USB, you will need to instruct the tablet to boot from USB or SD Card. Also, you may want to avoid disabling Secure Boot[broken link: invalid section] as this will cause each boot to display an ugly bright red background intentionally clashing with the "Surface" splash logo.

There are three types of boots in the Surface Pro 3 explained here:

  1. Normal mode
    1. Just leave the computer go. You can change it from "Alternate Boot order" in the UEFI Setup
  2. Boot into the UEFI Setup
    1. With the device powered off (or rebooting, but better play safe)
    2. Press & hold Volume up
    3. Press power button
    4. Wait until the surface logo appears
    5. Release Volume up
    6. You will be presented with the UEFI Setup Menu
  3. Boot into the USB/SD card
    1. Power off the device
    2. Press & hold Volume down
    3. Press power button
    4. Wait until the surface logo appears
    5. Release Volume down

Disable Secure Boot

Note: This will cause a red background before the logo when booting.

Boot into the UEFI setup, and select Secure Boot Control > Disable. Now continue with the installation. See the Microsoft steps for more information.

Boot with Secure Boot

See Secure Boot.

Installation

Merge-arrows-2.pngThis article or section is a candidate for merging with UEFI#Secure Boot.Merge-arrows-2.png

Notes: These steps are on how to support Secure Boot for Arch Linux, need to try it in a regular computer. (Discuss in Talk:Microsoft Surface Pro 3#)

I have done the installation with systemd's bootctl Systemd-boot (old Gummiboot). After doing all the steps of installation, you should do two more things. Booting in Secure Boot won't work for the new installation, as the vmlinuz hasn't been registered within its loader.

The easiest way is to do all the setup is the following, just before rebooting:

  1. Exit from the chroot but don't umount anything
  2. Move /mnt/boot/EFI/boot/bootx64.efi to /mnt/boot/EFI/boot/loader.efi
  3. Copy /boot/EFI/boot/bootx64.efi and HashTool.efi to /mnt/boot/EFI/boot/

(If you are unable to find HashTool in /boot, try in /usr/run)

Here, we have enabled Preloader to boot our gummiboot loader, and if it detects that something hasn't been signed, it will boot the HashTool.efi to sign the vmlinuz-image binary.

The idea is, we take the systemd bootloader and make it the one that PreLoader will boot (the one in its same folder, named loader.efi). Then, we copy both the PreLoader (which is the archiso's bootx64.efi) and the HashTool (already with that name).

This way, with Secure Boot enabled, you will be able to boot your kernel whenever you wish to, signed or not, repeating the hash storing procedure on the next boot.

Extra steps

Although in latest kernel you have basic support for the touchpad, the screen, etc. the cameras are not yet supported by the kernel. A github repo to track the support of the Surface Pro 3 in Archlinux was created: [1], where you can check for the status.

The easiest way for Arch Linux users is to use a Surface Pro 3 specific package available in the AUR linux-surfacepro3AUR[broken link: package not found]. You can check there the support for the different modules available, or take the patch from upstreamGitHub.

Compile Kernel with Patches

Ref: Kernels/Traditional compilation#Configuration

Note: The most up-to-date source at the time of writing for the kernel patches is shvr's github repository.

Surface Pro 3 Linux Kernel Hardware Patches

Since kernel 4.3, only the multitouch and camera patches are required.

Note: These patches can be automatically applied using git-apply from the Git package.

Enabling Touchpad

Ref: GitHub In order to enable full functionality of the touchpad (e.g. two-finger scrolling, right click), you need to Install the xf86-input-synaptics package, have the kernel patch applied as well as add the following to /etc/X11/xorg.conf.d/10-multitouch.conf:

Section "InputClass"
  Identifier "Default clickpad buttons"
  MatchDriver "synaptics"
  Option "ClickPad" "true"
  Option "SoftButtonAreas" "50% 0 82% 0 0 0 0 0"
  Option "SecondarySoftButtonAreas" "58% 0 0 15% 42% 58% 0 15%"
EndSection

Tuning the Pen

The pen buttons might not work out of the box. Install the xf86-input-wacom package and comment the MatchIsTablet section in /usr/share/X11/xorg.conf.d/10-evdev.conf. Furthermore add 1B96:1B05 Pen in the MatchProduct line of N-Trig in /usr/share/X11/xorg.conf.d/50-wacom.conf. Note that the purple bluetooth button is recognized but able to be bound to an action. Ref:Reddit

Virtual Keyboard

Depending on the desktop environment you are using, you might want to use different virtual keyboard. onboard provides a reliable and comfortable experience. A guide for optical tweaking is provided here. If you are using GNOME, these two extension (1, 2) provide a better integration.

Booting with Secure Boot Enabled

Merge-arrows-2.pngThis article or section is a candidate for merging with UEFI#Secure boot.Merge-arrows-2.png

Notes: Generic instructions (Discuss in Talk:Microsoft Surface Pro 3#)

The recommended bootloader for UEFI with Secure Boot enabled is systemd-boot

To boot with Secure Boot, you will need the following packages: efibootmgr prebootloader[broken link: replaced by efitools]

Ref: Surface Pro 3 and Secure Boot post-install

Copy /boot/EFI/systemd/systemd-bootx64.efi to /boot/EFI/systemd/loader.EFI. Copy /usr/lib/prebootloader/HashTool.efi and /usr/lib/prebootloader/PreLoader.efi to /boot/EFI/systemd/. Create an NVRAM entry for PreLoader.efi:

 efibootmgr -d /dev/sdX -p Y -c -L Preloader -l /EFI/systemd/PreLoader.efi
Note: Y is the partition number of the /boot partition.

Verify the entry was made and that it is first in the boot order:

efibootmgr

Enrolling your kernel in the bootloader: Unified Extensible Firmware Interface#Secure Boot[broken link: invalid section] Enroll HashTool.efi and vmlinuz-linux, and then reboot to system. You should now be able to boot with Secure Boot enabled.

Note: Since PreLoader.efi is the default boot option per efibootmgr, if you change the kernel you will be presented with PreLoader to enroll the new kernel with HashTool again
Note: Ensure that you add the entry in /boot/loader/entries/ so that you are presented the option to boot with the new kernel

Troubleshooting

Invalid signature detected check secure boot policy in setup

This happened to me after deleting the Secure Boot database and initializing it with Microsoft & CAs. I also had to do the recovery of the bitlocker partition, but I would follow these steps:

  1. After the reset, switch off and try to boot from the sd/usb. If you don't succeed and get the message many times:
    1. Leaving all TPM & SecureBoot enabled and SSD Only alternate system order
    2. Do another database reset
    3. Enroll the Microsoft and CAs again
    4. reboot into sd/usb with volume down
    5. It should work now
  2. Follow steps in the Secure Boot installation
  3. After the full installation of archlinux, when you have it working, do the BitLocker recovery

If after doing these steps doesn't still work. Flash the archiso image once more and try again,

Keyboard Cover not working

This can happen sometimes when you restart. The solution was to shutdown and reboot. (not restart)

Pen/Touchscreen issues in Xournal

When using the xf86-input-wacom package there is a bug in the last official release of xournal (0.48.2) where it'll incorrectly detect the Surface Pen as the touchscreen device. However it's been fixed in the latest Xournal source as per this bug. Installing the AUR package xournal-gitAUR builds the latest source including this fix. Note that you'll need to select 'NTRG0001:01 1B96:1B05' as the touchscreen device (Options > Pen and Touch).