Linux Kernel for Surface Devices

Go to file

Maximilian Luz 5ea45b56a8 scripts/diagnostic: Add support for collecting USB information		2021-10-10 02:15:12 +02:00
.github	Bump Debian pkgrel	2021-10-10 01:52:21 +02:00
configs	Add patches for v5.14	2021-09-15 15:36:37 +02:00
contrib	Add Thermald Conf FIle for AMD Surface Laptop 4 (#572 )	2021-09-25 14:38:24 +02:00
patches	Update v5.14 patches	2021-10-10 01:47:36 +02:00
pkg	fixup! Bump Fedora pkgrel	2021-10-10 01:59:49 +02:00
scripts	scripts/diagnostic: Add support for collecting USB information	2021-10-10 02:15:12 +02:00
FUNDING.yml	Add FUNDING.yml	2020-08-06 15:59:10 +02:00
README.md	README: Add SL4 to supported devices list	2021-09-02 23:57:50 +02:00

README.md

Linux Surface

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

Supported Devices

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

Features / What's Working

See the feature matrix for more information about each device.

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

We provide package repositories for the patched kernel and other utilities. Please refer to the detailed installation and setup guide. There, you may also find device-specific caveats. After installation, you may want to have a look at the wiki and the contrib/ directory for useful tweaks.

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).
Using TLP can cause slowdowns, laggy performance, and occasional hangs if not configured properly! You have been warned.
If you want to use hibernate instead of suspend, you need to create a swap partition or file, please follow your distribution's instructions (or here).

Support

If you have questions or need support, please join our Matrix Space! This space contains

a support channel for general support and
a development channel for all development related questions and discussions. If you prefer IRC, you can also join in via our channel at libera.chat/#linux-surface, to which the matrix room is bridged to.

License

This repository contains patches, which are either derivative work targeting a specific already licensed source, i.e. parts of the Linux kernel, or introduce new parts to the Linux kernel. These patches fall thus, if not explicitly stated otherwise, under the license of the source they are targeting, or if they introduce new code, the license they explicitly specify inside of the patch. Please refer to the specific patch and source in question for further information. License texts can be obtained at https://github.com/torvalds/linux/tree/master/LICENSES.