microsoft/surface: remove repos.nix file and update README

This commit is contained in:
Andre
2025-04-11 14:54:03 -04:00
parent 9726adf371
commit bb295c09d9
3 changed files with 44 additions and 32 deletions

View File

@@ -1,8 +1,3 @@
# NOTE: Structure changes from 2023-01-10
Please read the [Deprecated Behaviour README](./OLD-BEHAVIOUR-DEPRECATION.md) to understand how some structural changes to
the code might affect you!
# Derivations for Microsoft Surface notebooks
These derivatives use the patches from the [linux-surface repo](https://github.com/linux-surface/linux-surface/tree/master/patches).
@@ -32,13 +27,24 @@ Not all hardware is fully supported, but the
[linux-surface feature matrix](https://github.com/linux-surface/linux-surface/wiki/Supported-Devices-and-Features#feature-matrix)
provides details on which devices are supported on which types of machine.
The kernel-specific derivations are under the [`common/kernel/`](./common/kernel/) sub-directory.
In order to simplify maintenance of the Nix code, only the most-recent kernel patch-set is expected
to be maintained in this repo.
The kernel-specific derivations are under the [`common/kernel/`](./common/kernel/) sub-directory. This directory defines patch sets for each supported kernel release (see Kernel versions below for more information).
_*NOTE:*_ Some built-in Kernel config items need to be set, that aren't set by default:
- https://github.com/linux-surface/surface-aggregator-module/wiki/Testing-and-Installing
#### Kernel versions
There are multiple versions of the Surface kernel available:
- `lts`, which tracks the latest LTS release.
- `latest`, which tracks the most recent release.
This repo uses `lts` by default, but you can switch it to `latest` by adding this to your configuration file:
```nix
microsoft-surface.kernelVersion = "latest";
```
### Support Tools
### IPTS
@@ -120,3 +126,7 @@ References:
- https://github.com/thebitstick/surfacego-wifi
- https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/tree/ath10k
- https://wireless.wiki.kernel.org/en/users/drivers/ath10k/firmware
## Structural changes from earlier versions (2023-01-10 and earlier)
If you're upgrading from an older version of nixos-hardware, please read the [Deprecated Behaviour README](./OLD-BEHAVIOUR-DEPRECATION.md) to understand how some structural changes to the code might affect you!