Hardware/Framework/Laptop 16

← Back to Hardware Hub

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.

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 nixpkgs#pciutils -c 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 nixpkgs#mesa-demos -c glxinfo -B | grep -E "OpenGL vendor|OpenGL renderer"

# Offload: should show NVIDIA dGPU
nix shell nixpkgs#mesa-demos -c 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.