Linux Kernel for Surface Devices

Go to file

Blaž Hrastnik 0d3e0c975a Add an issue template.		2019-12-30 21:01:58 +09:00
.github	Add an issue template.	2019-12-30 21:01:58 +09:00
firmware/intel/ipts	Update links due to repo move	2019-12-28 22:57:43 +01:00
keys	Add GPG key	2019-09-28 03:27:11 +02:00
patches	Update patches from kernel repo	2019-12-28 00:54:14 +01:00
root	sleep-script: bluetooth: Add note to disable bluetooth completely	2019-12-22 15:56:41 +01:00
README.md	Update links due to repo move	2019-12-28 22:57:43 +01:00
setup.sh	Update links due to repo move	2019-12-28 22:57:43 +01:00

README.md

Linux Surface

Linux running on the Microsoft Surface devices. Follow the instructions below to install the latest kernel and config files.

Supported Devices

Surface Book
Surface Book 2
Surface Go
Surface Laptop
Surface Laptop 2
Surface Laptop 3
Surface Pro 3
Surface Pro 4
Surface Pro 2017
Surface Pro 6
Surface Pro 7
Surface Studio

What's Working

Keyboard (and backlight)
Touchpad
2D/3D Acceleration
Touchscreen
Pen
WiFi
Bluetooth
Speakers
Power Button
Volume Buttons
SD Card Reader
Hibernate
S2Idle (suspend)
Sensors (accelerometer, gyroscope, ambient light sensor)
Battery Readings
Docking/Undocking Tablet and Keyboard
Surface Docks
DisplayPort
USB-C (including for HDMI Out)
Dedicated Nvidia GPU (Surface Book 2)

What's NOT Working

Cameras (not fully supported yet)
Dedicated Nvidia GPU (Surface Book 1 with Performance Base)
Connected Standby is not supported yet

Disclaimer

For the most part, things are tested on a Surface Book 2. While most things are reportedly fully working on other devices, your mileage may vary. Please look at the issues list for possible exceptions.

Installation and Setup

For a more detailed installation and setup guide, please refer to the corresponding Wiki page. There, you may also find device-specific caveats. A short overview of the process is provided below.

This repository is aimed at Debian based distributions (Ubuntu, Pop!_OS, elementary OS, ...). Releases are provided for both, Debian and Arch Linux based distributions, but if you're running Arch, you may want to consider looking at this project instead, or here if you're running Fedora. These releases can be found here: https://github.com/linux-surface/linux-surface/releases.

You may also want to consider setting up one of the package repositories to obtain automatic updates. After the installation, you should have a look at the post-installation notes, specifically you may want to set up secure-boot and install the proprietary firmware package (usually named linux-firmware) if you have not done so already.

The following setup instructions re for Debian based systems (Debian, Ubuntu, Pop!_OS, elementary OS, ...). If you're running something else, you may need to adapt them for your distribution (have a look at the setup.sh script for more information).

Before you can actually start, you will need to install some required packages. On Debian based distributions, you can do this by simply running
```
sudo apt install git curl wget sed
```
Clone this repository. To save some time, you can use the --depth 1 flag.
```
git clone --depth 1 https://github.com/linux-surface/linux-surface.git
```
If you want to update this git repository later on, e.g. for re-running the setup.sh script, you can simply run git pull inside the repository.
Next, change into the linux-surface directory (cd linux-surface) and run the setup script via
```
sudo ./setup.sh
```
Follow the instructions and make your choices. If you have/intend to set up the kernel and libwacom package via one of the package repositories, say no to installing them. Alternatively, you can also install them manually via (for Debian)
```
sudo dpkg -i linux-headers-[VERSION].deb linux-image-[VERSION].deb linux-libc-dev-[VERSION].deb
```
after downloading these files from the [releases][releases] section of this repo.
Finally, you will need to re-boot your system and boot into the linux-surface kernel. Please make sure that you actually boot in the right kernel via uname -a before opening any issues. This should give you a version string containing surface. If not, you may need to configure your bootloader. For this, please refer to the instructions provided by your bootloader and/or distribution.

If you want to compile the kernel yourself (e.g. if your distribution is not supported), please have a look at the wiki.

Additional Information

Notes

If you are getting stuck at boot when loading the ramdisk, you need to install the Processor Microcode Firmware for Intel CPUs (usually found under Additional Drivers in Software and Updates).
Do not install TLP! It can cause slowdowns, laggy performance, and occasional hangs! You have been warned.
If you chose to use hibernate over suspend, please follow the instructions here.

Support

If you have questions or need support, please use our Gitter Community! For development related questions and discussions, please consider joining our IRC channel on freenode (freenode/##linux-surface).