Framework Laptop 13 (AMD Ryzen 7040 Series) - ArchWiki

Jump to content

# Framework Laptop 13 (AMD Ryzen 7040 Series)

From ArchWiki

This article or section needs expansion.

Reason: This page is under construction - read Framework Laptop 13 for the time being (Discuss in Talk:Framework_Laptop_13#Page_per_mainboard)

Hardware | PCI/USB ID | Working?
--- | --- | ---
GPU |  | Yes
Wi-Fi | `14c3:0616` | Yes
Audio | `1002:1640` | Yes
Touchpad | `093a:0274` | Yes
Keyboard |  | Yes
Webcam (1st Gen) | `0bda:5634` | Yes
Webcam (2nd Gen) | `32ac:001c` | Yes
Fingerprint reader | `27c6:609c` | Yes
Bluetooth | `0e8d:e616` | Yes
TPM |  | Yes
Ambient light sensor |  | Yes

This article covers the installation and configuration of Arch Linux on a Framework Laptop 13 with a AMD Ryzen 7040 Series mainboard.

For a general overview of laptop-related articles and recommendations, see Laptop.

## Installation

Ensure you have linux-firmware installed, as pointed out by Installation guide#Install essential packages before reporting hardware issues on the Arch bug tracker or Framework Community boards. It is an optional dependency of linux and does not automatically get installed as part of base. Without it, much of the hardware will be detected but may not be fully functional. You will see firmware loading issues in the journal.

## Display

The Ryzen 7040 Series can be configured with one of two different displays.

The default 2256x1504 resolution display has 400nit brightness and 60Hz refresh rate. The matte display module is manufactured by BOE and is uncalibrated from factory, giving a suboptimal default sRGB coverage. It is thus recommended to apply this ICC profile if you have this display in order to have better color reproduction.

The newer 2880x1920 resolution display, better known as the 2.8k display module has 30-120Hz variable refresh rate and 10-bit color support. This display can be identified by the rounded top corners. The 2.8k display resolution at 256 DPI is perfect for 2x scaling factor as many desktop environments under Linux currently struggle with fractional scaling. This ICC profile is available to improve color reproduction.

## Speakers

By default, the speakers do not sound very balanced due to the downward firing speakers, so you may want to use an equalizer to fix this. The recommended method is to install EasyEffects and use the official preset found here.

Alternatively, you can use user-created profiles such as this one created by cab404.

## Power management

power-profiles-daemon should be installed and enabled to be able to control power states. AMD and Framework do not recommend the use of tlp - see [1] [2].

## Wi-Fi

You will be limited to 802.11n (Wi-Fi 4) and 2.4GHz bands if you do not configure the regulatory domain.

There have been reports of Wi-Fi stability and throughput improvements when using iwd, either directly or as the NetworkManager backend.

## Fingerprint reader

Install fprint to enable fingerprint authentication. You will need to upgrade the fingerprint reader firmware following the article on the Framework knowledgebase if your reader isn't recognised.

## Ambient light sensor

Install iio-sensor-proxy to enable automatic brightness in Gnome. Other desktop environments are unsupported at this time.

## Firmware

fwupd is support is offered by Framework. It is highly recommended to upgrade to BIOS 3.05 for maximum compatibility. Full instructions, changelogs, known issues and EFI shell updaters can be found in the Framework knowlegebase.

Custom Secure Boot keys can be installed.

## Keyboard

The keyboard uses a custom connector which means that the keyboard does not have a PCI/USB ID. The keyboard is handled by the i8042 kernel module.

## Troubleshooting

### Wakeup issues

Some users experience issues on wakeup from suspend / hibernate, as the framework has a chance of rebooting instead of waking up. The wifi module Mediatek MT7921 seems to cause this. As a workaround, turn off wifi before suspend and enable it after wakeup. The following systemd service automates this for both wifi and bluetooth for suspend / hibernate / suspend-then-hibernate: (See [3])

    /etc/systemd/system/rfkill-before-sleep.service

    [Unit]
    Description=Disable wifi and bluetooth before suspend
    DefaultDependencies=no
    StopWhenUnneeded=yes
    Before=sleep.target

    [Service]
    Type=oneshot
    RemainAfterExit=yes
    ExecStart=/usr/sbin/rfkill block all
    ExecStop=/usr/sbin/rfkill unblock all

    [Install]
    WantedBy=sleep.target

Additionally, the computer can sometimes fail to wake up if a display adapter is plugged into the port on the left side, closest to the user.[4] Display out is not supported on this port per the 7040 series' card functionality diagram.

### Video freezes

Some users experience video freezes. System became completely unresponsive and cames back after a few minutes.

The following kernel parameter seems to fix this issue :

`amdgpu.dcdebugmask=0x10`

see 1

see 2

## See also

- ArchWiki vendor page
- AMD Ryzen 7040 Series Knowledge base[dead link 2025-03-15—HTTP 404]
- Framework Linux forum

Category:

- Framework

Hidden categories:

- Pages or sections flagged with Template:Expansion
- Pages with dead links

Framework Laptop 13 (AMD Ryzen 7040 Series)
Add topic