Framework Laptop 13 (AMD Ryzen 7040 Series)

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 and KDE. 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