mirror of https://github.com/NixOS/nixos-hardware synced 2024-11-23 03:19:42 +01:00

History

Adam Dinwoodie e4ad9ce38f Framework: add workaround for Bluetooth device issues Framework have published a workaround for a bug that affects the MediaTek Bluetooth and Wi-Fi cards used in their laptops on kernel version 6.11. Their workaround assumes a writable /etc/systemd directory, so reimplement the workaround for NixOS. For the Framework version of the workaround, see: `eab0148ae8/hibernation/kernel-6-11-workarounds`		2024-11-02 03:52:24 +00:00
..
13-inch	Framework: add workaround for Bluetooth device issues	2024-11-02 03:52:24 +00:00
16-inch	Framework: add workaround for Bluetooth device issues	2024-11-02 03:52:24 +00:00
bluetooth.nix	Framework: add workaround for Bluetooth device issues	2024-11-02 03:52:24 +00:00
default.nix	Fixed broken links in deprecation assertions for framework and surface modules.	2023-11-14 21:35:07 +00:00
framework-tool.nix	framework: install framework-tool	2024-05-06 08:28:51 +00:00
kmod.nix	treewide: remove uses of lib.mdDoc	2024-07-30 09:47:52 +00:00
OLD-BEHAVIOUR-DEPRECATION.md	Explicitly speak of 11th gen Intel Framework new profile	2023-11-11 16:32:26 -05:00
README.md	framework: fix outdated documentation on fw-ectool	2024-09-14 19:14:19 -04:00

README.md

NOTE: Structure changes from 2023-11-11

Please read the Deprecated Behaviour README to understand how some structural changes to the code might affect you!

Framework Laptops

Updating Firmware

First put enable fwupd

services.fwupd.enable = true;

Note

For Intel CPU's, even stable BIOS versions are currently marked as test versions in LVFS (the default remote fwupd uses to get firmware).

If you want to use these versions, you'll have to explicitly enable the lvfs-testing remote:
services.fwupd.extraRemotes = [ "lvfs-testing" ];
# Might be necessary once to make the update succeed
services.fwupd.uefiCapsuleSettings.DisableCapsuleUpdateOnDisk = true;

Caution

Before running the update, make sure you have a NixOS live ISO on a USB stick, because some firmware updates make your system unbootable.

Then run

 $ fwupdmgr update

If you cannot boot into your system after upgrading:

Boot into the live USB
Mount your system into /mnt
Run
```
sudo nixos-enter
```

Run

NIXOS_INSTALL_BOOTLOADER=1 /run/current-system/bin/switch-to-configuration boot

Common Modules

For the Framework 13 laptops, there are common configuration modules available under the 13-inch/common/ directory, including some modules specific to AMD- or Intel-based laptops. By preference, there will already be a specialised module for your model's configuration. Otherwise, it can be added alongside the existing modules.

Support Tools

fw-ectool

There is a fw-ectool package available in nixpkgs that provides some system configuration options via the EC. This ectool only works with the Intel-based Framework laptops at present, as the Framework EC for AMD-based mainboards is based on the Zephyr port of the ChromeOS EC, which involves a slightly changed communication interface.