Jump to content

Framework Laptop 16

From Official NixOS Wiki
Framework Laptop 16
Laptop 16
Manufacturer Framework
Support components
Architecture x86_64-linux
AMD Ryzen 7040 Series
Maintainer
AMD Ryzen AI 300 Series
Maintainer

The Framework Laptop 16 is a configurable, upgradeable, and repairable laptop made by Framework.

Status

The device boots NixOS and works well with a recent kernel and the appropriate nixos-hardware module for your CPU generation.

Known issues

The device still has a couple of hardware quirks (see below).

Using the latest kernel will fix some issues. Also read configuration hints in this article.

Double suspend after GNOME automatic/idle suspend (systemd v258 regression)

Some users have reported a "double suspend" / "suspend loop" on Framework Laptop 16 (notably with GNOME and the NVIDIA dGPU module): after the machine suspends due to *automatic idle suspend* and is resumed, it may suspend again ~20-30 seconds later (sometimes repeating multiple times). Manual suspend and lid-close suspend may still behave normally.

Upstream tracking:

Workaround 1: add a post-resume sleep inhibitor

Add this snippet to configuration.nix: 

systemd.services.inhibit-sleep-after-resume = {
  description = "Temporary sleep inhibitor after resume (workaround for double-suspend)";
  wantedBy = [ "post-resume.target" ];
  after = [ "post-resume.target" ];
  serviceConfig.Type = "oneshot";
  script = ''
    ${pkgs.systemd}/bin/systemd-inhibit \
      --mode=block \
      --what=sleep:idle \
      --why="Workaround: avoid immediate second suspend after resume" \
      ${pkgs.coreutils}/bin/sleep 60
  '';
};

Workaround 2: disable GNOME idle-suspend (low risk; lid-close suspend still works)

Quick (imperative) test

Disable idle suspend on AC power: 

gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-ac-type 'nothing'
gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-ac-timeout 0

Optionally also disable it on battery: 

gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-battery-type 'nothing'
gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-battery-timeout 0
Declarative configuration (recommended)
{ lib, ... }:

{

# Declaratively set GNOME dconf defaults.

programs.dconf.enable = true;
programs.dconf.profiles.user.databases = [
  {
    settings = {
      "org/gnome/settings-daemon/plugins/power" = {
        # Disable idle-suspend on AC power (keeps lid-close suspend behavior):
        sleep-inactive-ac-type = "nothing";
        sleep-inactive-ac-timeout = lib.gvariant.mkUint32 0;

        # Optional: also disable idle-suspend on battery:
        # sleep-inactive-battery-type = "nothing";
        # sleep-inactive-battery-timeout = lib.gvariant.mkUint32 0;
      };
    };
  }

];
}

After applying, log out and log back in (or reboot) to ensure GNOME picks up the updated settings.

Workaround 3: pin nixpkgs to pre-systemd-v258 for the affected machine (higher impact)

If you prefer to keep GNOME idle-suspend enabled, another workaround is to pin the affected system to a nixpkgs revision before systemd v258 landed.

Configuration

Framework-specific NixOS hardware configuration is bundled within the nixos-hardware project.

AMD Ryzen 7040 Series

It is recommended to use power-profiles-daemon over tlp for the AMD Framework.

  • NixOS Hardware module for flakes: nixos-hardware.nixosModules.framework-16-7040-amd
  • NixOS Hardware module for channels: <nixos-hardware/framework/16-inch/7040-amd>

AMD Ryzen AI 300 Series

  • NixOS Hardware module for flakes: nixos-hardware.nixosModules.framework-16-amd-ai-300-series
  • NixOS Hardware module for channels: <nixos-hardware/framework/16-inch/amd-ai-300-series>

NVIDIA dGPU module (RTX 5070 etc.)

If you have the NVIDIA dGPU module, prefer the maintained nixos-hardware NVIDIA submodule (it enables hybrid graphics with PRIME offload and provides nvidia-offload <command>):

  • NixOS Hardware module for flakes: nixos-hardware.nixosModules.framework-16-amd-ai-300-series-nvidia
  • NixOS Hardware module for channels: <nixos-hardware/framework/16-inch/amd-ai-300-series/nvidia>

IMPORTANT: You MUST override the PRIME PCI bus IDs for your specific system. Framework 16’s modular design means bus IDs can vary depending on installed expansion cards and NVMe drives.

Example override: 

{
  # In your system configuration:
  hardware.nvidia.prime = {
    # Replace these values with your own system's IDs:
    amdgpuBusId = "PCI:XXX:YY:Z";
    nvidiaBusId = "PCI:AAA:BB:C";
  };
}

Find PCI IDs: 

$ nix-shell -p pciutils --run 'lspci | grep -E "VGA|3D|Display"'

Convert the hex bus/device numbers to decimal and format as PCI:<bus>:<device>:<function>. Example: c1:00.0 → PCI:193:0:0.

Quick helper (optional): 

# Replace BDF with the lspci value like c1:00.0
BDF="c1:00.0"
BUS="${BDF%%:*}"; REST="${BDF#*:}"
DEV="${REST%%.*}"; FUN="${REST#*.}"
printf 'PCI:%d:%d:%d\n' "$((16#$BUS))" "$((16#$DEV))" "$FUN"

Validation (hybrid/offload): 

# Default: should show AMD iGPU
nix-shell -p mesa-demos --run 'glxinfo -B | grep -E "OpenGL vendor|OpenGL renderer"'

# Offload: should show NVIDIA dGPU
nix-shell -p mesa-demos --run 'nvidia-offload glxinfo -B | grep -E "OpenGL vendor|OpenGL renderer"'

# Idle power check: should become "suspended" when idle
cat /sys/bus/pci/devices/0000:??:??.?/power/runtime_status

Note: nvidia-smi can wake the GPU, so it is not a reliable “is the GPU sleeping?” probe.

Fix color accuracy in Power Saving modes

Active Backlight Management is used to reduce battery power consumption, which can cause the colors of the screen to be inaccurate.

Some desktop environments may already be able to modify this setting.

To disable it add the kernel parameter: 

boot.kernelParams = [ "amdgpu.abmlevel=0" ];

Prevent wake up in backpack

Putting your Framework in a backpack can cause it to wake up due to the screen flexing onto the keyboard. While this is not resolved in firmware, you can work around this issue with a udev rule.

If you are also importing nixos-hardware, prefer merging (e.g. lib.mkAfter) rather than overwriting services.udev.extraRules, since nixos-hardware may install its own udev rules. 

{ lib, ... }:
{
  services.udev.extraRules = lib.mkAfter ''
    SUBSYSTEM=="usb", DRIVERS=="usb", ATTRS{idVendor}=="32ac", ATTRS{idProduct}=="0012", ATTR{power/wakeup}="disabled", ATTR{driver/1-1.1.1.4/power/wakeup}="disabled"
    SUBSYSTEM=="usb", DRIVERS=="usb", ATTRS{idVendor}=="32ac", ATTRS{idProduct}=="0014", ATTR{power/wakeup}="disabled", ATTR{driver/1-1.1.1.4/power/wakeup}="disabled"
  '';
}
Product Vendor and Product ID
RGB Macropad 32ac 0013
Backlit keyboard ISO 32ac 0018
Other devices Use lsusb to find Vendor/Product IDs

This does not prevent the trackpad from waking up the device; this however seems to happen less in a backpack.

BIOS configuration

Enable Linux Audio Compatibility in the BIOS to improve speaker audio quality.

Useful utilities

Framework provides and the community maintains utilities that help manage Framework hardware.

  • framework-tool provides libraries and tools to interact with Framework-specific features.
  • Input modules (LED matrix / numpad) can be controlled with tools such as inputmodule-control.

To enable input module support (if installed), set: 

inputmodule.enable = true;

Example (LED matrix clock): 

# Serial device is often /dev/ttyACM0 (or ttyACM1 if you have two modules)
inputmodule-control --serial-dev /dev/ttyACM0 led-matrix --clock

External resources

There is a NixOS thread on the Framework forum, where you can find additional help, guidance, and example configurations.

Retrieved from "https://wiki.nixos.org/w/index.php?title=Hardware/Framework/Laptop_16&oldid=29301"