跳转至内容

Framework Laptop 13

来自 ArchWiki
(重定向自 Framework Laptop)

本文或本节需要在语言、wiki 语法或风格方面进行改进。请参阅 Help:Style 获取参考。

原因
  • 页面已重命名以反映 16 英寸型号的推出，但页面内容可能需要更新以包含该措辞。
  • 来自 #Hardware 的多个表格看起来可以合并到通用表格中，因为一切都被列为正常工作。 #Expansion cards 应保持不变，因为可以随着时间的推移添加更多模块。
(在 Talk:Framework Laptop 13 中讨论)
硬件 PCI/USB ID 是否工作？
GPU 是
Wi-Fi 是
音频 (Intel) 8086:a0c8 是
音频 (AMD) 1002:1640 是
触控板 093a:0274 是
摄像头 0bda:5634 是
指纹识别器 27c6:609c 是
蓝牙 是
TPM 是
环境光传感器 是

本文档涵盖在 Framework Laptop 上安装和配置 Arch Linux。

有关笔记本电脑相关文章和建议的总体概述，请参阅 Laptop。

硬件

Framework 旨在成为一款可配置且可升级的笔记本电脑。以下列表并非 Framework 销售的所有硬件的详尽列表，而是经过测试的组件列表。

注意 请确保已安装 linux-firmware，如 Installation guide#Install essential packages 中所述，然后再向 Arch 错误跟踪器或 Framework 社区论坛报告硬件问题。它是 linux 的可选依赖项，不会作为 base 的一部分自动安装。没有它，许多硬件将被检测到但无法完全正常工作。您将在 journal 中看到固件加载问题。

Wi-Fi/蓝牙

设备名称 PCI ID 蓝牙 USB ID 是否工作？ 蓝牙？ 备注
AX200 8086:2723 8087:0029 是 是 预生产单元
AX201 vPro 未测试 未测试 专业版
AX201 无 vPro 8086:a0f0 8087:0026 是 是 基础版/高性能版
AX210 vPro 8086:2725 8087:0032 是 是 DIY 版 (可选)
AX210 无 vPro 8086:2725 8087:0032 是 是 DIY 版 (可选)
AX411 vPro 8086:51f0 8087:0033 是 是 非 Framework 销售，但可用
BE200 8086:272b 8087:0036 是 是 非 Framework 销售，但可用
RZ608 / MediaTek MT7921K --- 0e8d:e608 是 是 非 Framework 销售，已知可用
RZ616 / MediaTek MT7922 14c3:0616 0e8d:e616 是 是 AMD 版本
RZ717 / MediaTek MT7925 14c3:0717 0e8d:e717 支持不佳 是 AMD 版本

AMD 版本上的 Wi-Fi 性能

如果您未配置 监管域，您将仅限于 802.11n (Wi-Fi 4) 和 2.4GHz 频段。

有报告称，在使用 iwd（直接使用或作为 NetworkManager 的后端）时，Wi-Fi 稳定性和吞吐量有所提高。

对于 MT7921/MT7922，可以通过禁用省电模式来提高 Wi-Fi 稳定性，具体方法请参阅 Network configuration/Wireless#mt7921 / mt7922。

对于 MT7925，Wi-Fi 网络速度非常有限；请参阅 此帖子。

图形

Intel / i915

设备名称 PCI ID 是否工作？
TigerLake-LP GT2 [Iris Xe Graphics] 8086:9a49 是
Alder Lake-P GT2 [Iris Xe Graphics] 8086:46a6 是
Meteor Lake-P [Intel Arc Graphics] 8086:7d55 是

AMD / amdgpu

设备名称 PCI ID 是否工作？ 备注
Advanced Micro Devices, Inc. [AMD/ATI] Phoenix1 1002:15bf 是 需要 BIOS 3.03 或更高版本

扩展卡

卡片名称 PCI/USB ID 是否工作？ 备注
USB-C N/A 是
USB-A N/A 是 如果放置在两个后置插槽上，可能会导致高功耗。
MicroSD 090c:3350 是
HDMI 32ac:0002 是 对于某些系列，如果放置在前左侧插槽上可能无法工作.
DisplayPort 32ac:0003 是 对于某些系列，如果放置在前左侧插槽上可能无法工作.
存储 250GB 13fe:6500 是 可能会在 AMD Ryzen AI 和 UAS 上导致 USB 控制器崩溃。您可以尝试为该设备仅恢复到 usb-storage：`options usb-storage quirks=13fe:6500:u`
存储 1TB 13fe:6500 是
以太网 0bda:8156 是
SD (全尺寸) 32ac:0009 是 如果在启动时插入空的 SD 转 MicroSD 适配器，可能会导致启动问题。

耳机插孔

在 Intel 和 AMD 主板上，当声卡上的电源管理激活和停用时，会出现轻微的 有噪音的爆裂声 或 嗡嗡声。

如果声卡在没有声音活动的情况下，内核将其置于省电模式的秒数存储在 /sys/module/snd_hda_intel/parameters/power_save 中，因此会产生爆裂声或嗡嗡声。

您可以将 power_save=0 作为模块选项传递给 snd_hda_intel 来完全禁用声卡的省电功能，如 Advanced Linux Sound Architecture/Troubleshooting#Power saving 中所述。

如果您正在使用 TLP，则可以在 /etc/tlp.conf 中设置 SOUND_POWER_SAVE_ 变量。

具有 Intel Core 第 12 代及更高版本的主板使用不同的 DAC，即 Tempo 92HD95B[1]，在使用 PipeWire 音频服务器 播放音频时可能导致爆裂声。这似乎是因为 PipeWire 错误地将设备的位深度设置为 32 位，而该卡仅支持 16、20 和 24 位 [2]。

支持的采样率可以通过探测 /proc/asound/card0/codec#0 来验证

$ cat /proc/asound/card0/codec\#0
...
Default PCM:
    rates [0x560]: 44100 48000 96000 192000
    bits [0xe]: 16 20 24
    formats [0x1]: PCM
...

在播放音频时，当前采样率可以通过探测 /proc/asound/card0/pcm0p/sub0/hw_params 来验证

$ cat /proc/asound/card0/pcm0p/sub0/hw_params
access: MMAP_INTERLEAVED
format: S32_LE
subformat: STD
channels: 2
rate: 48000 (48000/1)
period_size: 1024
buffer_size: 32768

解决方案是通过 WirePlumber 强制使用 16 位样本，方法是创建以下配置文件 [3]

/etc/wireplumber/wireplumber.conf.d/51-fix-crackle.conf
monitor.alsa.rules = [
  {
    matches = [
      {
        node.name = "alsa_output.pci-0000_00_1f.3.analog-stereo"
      }
    ]
    actions = {
      update-props = {
        audio.format = "S16LE",
      }
    }
  }
]

扬声器

默认情况下，扬声器声音不均衡（由于向下发声），因此您可能需要使用均衡器进行修复。推荐的方法是安装 EasyEffects 并使用官方预设，该预设可在 此处找到。

或者，您可以使用用户创建的配置文件，例如 cab404 创建的这个。

显示

Framework Laptop 13 可配置为使用 2 种不同的显示器：2256x1504 的 TFT-LCD 显示器 [4] 或 2880x1920 的圆角显示器，两者均由 BOE 制造。它们出厂时未经校准，提供次优的默认 sRGB 覆盖。因此，建议应用 ICC 配置文件以获得更好的色彩再现。 [5]

HDMI 音频输出

在 Intel 11thGen 上存在一个 问题，其中 HDMI 电视或 HDMI 投影仪被识别为音频输出设备，但在播放音乐时听不到声音。HDMI 电视输出使用全新安装的 Windows 操作系统可以正常发声。要解决此问题，您必须首先安装 sof-firmware 包，然后您必须将 dsp_driver=3 作为模块选项传递给 snd_intel_dspcfg，以便它使用 SOF 版本而不是旧版本。

固件

BIOS 更新

更新通常作为 Framework 直接提供的 UEFI Shell 更新提供。LVFS 支持仍在某些型号的测试中。

代 稳定版 Beta LVFS LVFS
测试		 备注
Intel 第 11 代 3.22 3.17
(仅测试)		 由于 3.22 包含 Intel CSME 更新，因此不会发布 LVFS 版本。可提供 UEFI Shell 更新方法。
公告在此：[6]
Intel 第 12 代 3.18 3.18 后续批次将附带 3.05 以“解决工厂特定问题”[7]。
警告 将 BIOS 更新到版本 3.06 或 3.08 后，您无法降级到版本 3.04 或 3.05，否则将导致左侧端口无法正常工作。
公告在此：[8]
Intel 第 13 代 3.08 3.08 3.09
(仅测试)		 提供 3.05 的 Windows 更新程序和 EFI Shell 包。
公告在此：[9]
Intel Core Ultra 1 3.06 3.06 公告在此：[10]
AMD Ryzen 7040 3.16 3.16 如果您拥有批次 1 或 2 的设备（首次发布的原始 Framework AMD 版本），请确保先升级到至少 3.03。它预装在批次 3 及更高版本上。较新的 AMD 版本搭配新的 2.8k 显示器批次应已包含最新的 BIOS 固件（Framework 已从批次 1 开始重新计数）。
公告在此：[11]
AMD Ryzen AI 300 3.04 3.04 所有初始批次都应预装 3.03。
公告在此：[12]

可以通过放置在可启动 U 盘上的 EFI shell 脚本更新 BIOS。此固件更新方法会清除 NVRAM 中注册的 EFI 引导加载程序，因此建议备好恢复磁盘或替代方法来重新安装引导加载程序。如果您的引导加载程序将自身安装为 EFI 备用路径 esp/EFI/BOOT/BOOTX64.EFI（systemd-boot 默认情况下会这样做，GRUB 会通过 GRUB#Default/fallback boot path 实现），则无需恢复磁盘，但可能需要重新安装引导加载程序以恢复其 NVRAM 条目。

在不重启进入 BIOS 的情况下检查当前安装的 BIOS 版本，可以使用

# dmidecode -s bios-version

LVFS

通过稳定远程支持 fwupd，该远程通常默认启用。有时可以在测试远程 [13] 中找到 Beta 固件构建，可以通过运行以下命令启用

$ fwupdmgr enable-remote lvfs-testing
注
  • 截至 2025 年 8 月，只有原始的第 11 代 Intel 主板在 LVFS 上缺乏任何稳定的 BIOS 更新，部分原因是 BIOS 更新（3.17 以上）中包含的强制性 Intel CSME 补丁。如果您只想使用稳定的 BIOS 更新而不是 Beta 测试中的更新，则不应在较新主板上启用测试远程 [14][15]。
  • 版本早于 3.17 的第 11 代 Intel 主板仅支持内存中的 capsule 更新，不支持磁盘上的。要升级到支持这些更新的版本，请进行以下 fwupd 配置更改，更新到 3.17 或更高版本，然后在 BIOS 更新后撤销更改
/etc/fwupd/fwupd.conf
[uefi_capsule]
DisableCapsuleUpdateOnDisk=true

指纹识别器

Framework 已 发布了指南 供 Intel 第 13 代和 AMD 用户将固件升级到已知可用的版本。

安全启动

本文章或章节需要扩充。

原因：为每个可以注册自定义密钥的模型添加官方来源或论坛帖子的链接。（在 Talk:Framework Laptop 13#Custom Secure Boot keys 中讨论）

可以在不涉及任何 Option ROM 问题的情况下将自定义密钥注册到 Framework Laptop，或者使用 SHIM 方法。有关详细信息，请参阅 Secure Boot。

挂起

在 Intel 主板上，添加 内核参数 acpi_osi="!Windows 2020" 可以修复 s2idle 的回归，使键盘背光和电源按钮在挂起时正确关闭，并将挂起时的电池消耗降低到约 1%/小时[16]。

如果您的系统因 SSD 断开连接而无法从挂起状态唤醒，您可以尝试在 内核参数 中添加 nvme.noacpi=1。如果您的 SSD 具有较差的 ACPI 实现，这也可以提高挂起时的电池续航。这仅适用于 Intel 主板，在 AMD 上它反而会引起问题。

警告 一些 NVMe 驱动器无法成功从下面的深度睡眠状态唤醒，它们会与笔记本电脑断开连接，直到重新启动才能访问，这通常会导致笔记本电脑锁定。一个例子是 Sabrent Rocket NVMe 4.0[17][18]。在生产安装中启用此睡眠状态之前，您可能希望从 Arch 安装环境测试 NVMe 驱动器的挂起功能，以免导致数据损坏。

如果您想使用 S3 睡眠而不是 s2idle，请参阅 Power management/Suspend and hibernate#Changing suspend method。

挂起后 Fn 键失效

一些第 11 代 Intel 主板用户报告称，从挂起恢复后，Fn 键和/或媒体键不再工作。解决方法是黑名单 cros_ec_lpcs 模块

/etc/modprobe.d/cros_ec_lpcs.conf
blacklist cros_ec_lpcs

唤醒触发器

如果您的 Framework 在运输过程中（例如在背包或袋子中）意外唤醒，这是因为 屏幕压迫键盘。禁用键盘 唤醒触发器可以解决此问题。

禁用直到下次重启

# echo disabled > /sys/devices/platform/i8042/serio0/power/wakeup

禁用从下次重启开始

/etc/udev/rules.d/disable-keyboard-wakeup.rules
ACTION=="add", SUBSYSTEM=="serio", DRIVERS=="atkbd", ATTR{power/wakeup}="disabled"

或者，要禁用键盘和触摸板，可以

# echo disabled > /sys/devices/platform/AMDI0010:03/i2c-1/i2c-PIXA3854:00/power/wakeup

Framework 提供了一个脚本，该脚本创建一个 systemd 触发器以在重启后进行设置。另请参阅 他们的论坛帖子了解更多讨论。

触控板

有报告称触摸板在从睡眠中唤醒后出现问题（例如指针不移动、两指滚动不工作等）。在 BIOS 的“高级”设置中禁用 PS/2 鼠标仿真似乎可以解决这些问题[19]。

与系统交互

您可以使用 framework-system 与您的系统进行交互。

在第 11 代和第 12 代 Intel 主板上，您还可以使用 fw-ectool-gitAUR 与嵌入式控制器进行交互。

警告 Framework Laptop 上的嵌入式控制器负责低级功能，包括系统的电源排序。修改 EC 代码可能导致您的系统无法开机或启动，或损坏主板、电池、系统其他部件或连接到系统的设备。因 EC 固件修改造成的硬件损坏不在 Framework 有限保修范围内。

功能键

按键 可见？1 有标记？2 效果
Fn+Esc 是 是 切换 Fn 锁定
F1 是 是 XF86AudioMute
F2 是 是 XF86AudioLowerVolume
F3 是 是 XF86AudioRaiseVolume
F4 是 是 XF86AudioPrev
F5 是 是 XF86AudioPlay
F6 是 是 XF86AudioNext
F7 是 是 XF86MonBrightnessDown
F8 是 是 XF86MonBrightnessUp
F9 是 是 Super_L+p
F10 是 是 XF86RFKill，软禁用 wlan 和蓝牙
F11 是 是 Print
F12 是 是 XF86AudioMedia
Fn+Delete 是 是 Insert
Fn+Space 是 是 控制键盘背光
Fn+b 否 否 Control_L+Break
Fn+k 否 否 Scroll_Lock
Fn+p 否 否 Pause
Fn+Left 是 是 首页
Fn+Right 是 是 结束
Fn+Up 是 是 上一页/PgUp
Fn+Down 是 是 下一页/PgDn
  1. 该键对 xev 及类似工具可见。
  2. 物理按键上有描述其功能的符号。

环境光传感器

注意 如果您已将 hid_sensor_hub 模块列入黑名单，则此功能不起作用。请参阅 12 代 CPU 在电池模式下使用 tlp 时的 Turbo-Boost。

应该开箱即用，您可以尝试读取 /sys/bus/iio/devices/iio\:device0/in_illuminance_raw 来检查。

在 GNOME 中，您需要安装 iio-sensor-proxy 并重启会话（或重新启动，以防万一）。然后运行 monitor-sensor 来检查是否正常工作。

如果您不使用 GNOME 但仍希望自动亮度控制，请查看 illuminanced。

风扇速度控制

您可以使用此工具将风扇速度强制设置为 0 到 100 之间的任意值：https://gitlab.howett.net/DHowett/ectool（fw-ectool-gitAUR）

$ ectool --interface=lpc fanduty 1OO

要返回自动模式，请使用此命令

$ ectool --interface=lpc autofanctrl

在此期间：https://lore.kernel.org/chrome-platform/20231005160701.19987-1-dustin@howett.net/ 用于直接支持 EC chromium 驱动程序。

电池控制

Framework 笔记本电脑有一个 嵌入式控制器，负责控制各种功能（风扇、电池、LED 等）。在补丁合并到主线内核之前，可以使用 fw-ectool-gitAUR 进行 EC 设置，或者使用 framework-system 中的 framework_tool 二进制文件。 一些与电池健康护理相关的设置是

# ectool chargecontrol idle

# ectool chargecontrol normal lower upper

chargecontrol 可设置为 discharge（放电）、idle（空闲）和 normal（正常）。Discharge 使系统使用电池的能量，禁用充电器；normal 允许设置上限和下限（当电池电量在上限和下限之间时，电池处于放电模式；当电量低于下限时开始充电）；idle 允许系统从充电器获取所有能量，基本上不使用电池，避免任何磨损。这对于将笔记本电脑用作始终连接电源的设备非常有用。将 lower = upper 值设置为自动在达到目标值后设置 idle 模式，而使用 idle 则使电池保持在当前电量水平的 idle 模式。

您可以通过以下方式检查从电池吸取的电流或充入电池的电流：

# cat /sys/class/power_supply/BAT0/current_now

或在 Present current 下：

# ectool battery

使用

# ectool fwchargelimit level

似乎与通过 BIOS 设置充电限制相同，该设置尝试将电池电量维持在设定水平，但会不断对其进行充电和放电（在此模式下不使用 idle 模式）。

最后，我们可以通过以下方式设置充电最大电流限制，从而实现慢速充电：

# ectool chargecurrentlimit mA

通过 ectool 设置的参数将保持有效，直到笔记本电脑断电并拔下电源几秒钟（约 10 秒），之后值将恢复为默认值。

故障排除

卡顿、闪烁和周期性冻结

有报告称笔记本电脑出现卡顿、闪烁和周期性冻结。禁用面板自刷新（如 Intel graphics#Screen flickering 中所述）已被 报告有效。但是，它对电池续航有益，因此如果没有任何问题，应保持开启。

如果您安装了 xf86-video-intel 而不是使用 modesetting，也可能发生这种情况，请参阅 Intel graphics#Installation 中的注释。

两指/三指点击

默认情况下，触摸板通过点击特定区域（中部下方用于中键点击，右下角用于右键点击）提供中键和右键单击。要将两指点击切换为右键单击，将三指点击切换为中键单击，您需要通过 libinput 设置“点击方法”。首先，找到您的“触摸板”设备名称

$ xinput

然后设置点击方法，其中 device 是上一步中找到的名称（或 ID）

$ xinput set-prop "device" "libinput Click Method Enabled" 0 1

要使其持久化，请将其放入启动脚本。或者，如果使用 X11，可以创建一个自定义 Xorg 配置文件并设置相应选项（参见 libinput#Via Xorg configuration file）。

HiDPI 设置

  • 对于 2256x1504 显示器，建议使用 1.5 的缩放因子。
  • 对于 2880x1920（2.8K）显示器，建议使用 2 的缩放因子。

更多详情，请参阅 HiDPI。

降低风扇噪音

这仅适用于 Intel 版本。AMD 用户应使用 power-profiles-daemon。

通过使用 thermald 服务可以显著改善风扇的运行。安装该软件包，然后您可以通过 thermald.service 单元文件 启动 和 启用 该服务。

更改显示器亮度无效

请参阅 Backlight#xbacklight returns : No outputs have backlight property。

对于 Alder Lake CPU，使用背光键而不是光传感器的一个解决方案是禁用环境光传感器。

/etc/modprobe.d/framework-als-deactivate.conf
blacklist hid_sensor_hub

需要重启，光传感器模块将被禁用，背光键将正常工作。

请注意，一些最小化的窗口管理器/合成器，例如 sway，不会自动绑定亮度键，因此如果您可以通过其他方式调整亮度但 fn 键不起作用，那很可能是问题所在。

启动管理器闪黑屏且不加载操作系统

如果您的 Framework 笔记本电脑加载 引导加载程序并能识别您闪存驱动器或 m.2 驱动器上的 EFI 系统分区，但无法加载您的引导管理器（它只闪一下黑屏然后返回引导加载程序），您必须禁用 Secure Boot。

  1. 按住 F2 重启。某些版本的 BIOS 中存在一个 bug，导致内置笔记本键盘上的 F2 键在重启或开机时无法识别。解决方法是连接一个外部 USB 键盘到笔记本电脑，并在重启或开机时按住外部键盘上的 F2 键。在笔记本电脑进入 BIOS 设置后，可以使用内置键盘，并可以拔掉外部键盘。
  2. 转到 Security Tab
  3. Secure boot 默认为 ON；将其禁用
  4. 保存更改并重启

Intel Wi-Fi 6E AX210 重置 / 低吞吐量 / "Microcode SW error"

在高负载下，Wi-Fi 设备会重启，网络速度变得非常慢或无响应，直到断开并重新连接到 Wi-Fi 网络。[20]

此问题已被其他制造商的笔记本电脑（不仅仅是 framework）的所有者观察到。[21]

暂时禁用 IEEE 802.11ax 似乎是一个可行的解决方法。[22]

/etc/modprobe.d/iwlwifi.conf
options iwlwifi disable_11ax=Y

Intel 已知此问题[23]，并且有一个补丁[24]可以修复重启后的慢速 tx，以及另一个补丁[25]可以解决 SW 错误。

指纹识别器设备断开连接错误

当在 Windows 上使用指纹读取器录入指纹后，如果您在未先从 Windows 中注销指纹的情况下尝试在 Linux 下使用读取器，fprintd 可能会无法工作。在这种情况下，在 使用 fprintd-enroll 进行录入 时，该命令会挂起，因为 fprintd 已崩溃。

如果仍然可以访问 Windows，处理此问题的最佳方法是重新启动到 Windows 并从那里注销您的指纹。如果无法做到这一点，您可以尝试使用 Framework 笔记本论坛上有人发布的脚本。

低帧率或卡顿的网络摄像头

如果显示网络摄像头画面的程序使用了 YUYV 4:2:2 颜色格式，则可能出现此问题。大多数 GUI 相机应用程序不允许配置此项。一些允许您配置此项的应用程序包括 guvcview 和 obs-studio，它们在使用默认配置时似乎也能正常工作。

您也可以使用 vlc 打开网络摄像头，命令如下：

$ vlc v4l2:///dev/video1 --v4l2-chroma MJPG

或者使用 mpv，命令如下：

$ mpv --cache=no --demuxer-lavf-format=video4linux2 --demuxer-lavf-o=video_size=1920x1080,input_format=mjpeg av://v4l2:/dev/video0

12 代处理器在电池供电时使用 tlp 时无法 Turbo-Boost

本文或该部分候选合并到 TLP。

注意： 这不是特定于硬件的问题，因此应该放在特定工具的页面上。（请在 Talk:Framework Laptop 13 中讨论）

默认情况下，如果安装了 tlp，12 代处理器在电池供电时不会 Turbo-Boost。可以在 tlp 的配置中进行调整。

/etc/tlp.conf
CPU_ENERGY_PERF_POLICY_ON_AC=balance_performance
CPU_ENERGY_PERF_POLICY_ON_BAT=balance_performance

12 代亮度与飞行模式按键

在 12 代主板上，存在一个错误[无效链接 2025-08-15—HTTP 404]，其中 ALS（自动光线传感器）和亮度增/减键，包括飞行模式键会发生冲突。为了使亮度键和飞行模式键工作（**但会牺牲环境光传感器的使用**），请黑名单 `hid_sensor_hub` 模块。

使用 tlp 时以太网不工作

默认情况下，tlp 会对 Framework 以太网适配器进行功耗限制。可以在 tlp 的配置中更改此设置，其中 `0bda:8156` 是 Framework 以太网适配器的 ID。

/etc/tlp.conf
USB_DENYLIST="0bda:8156"

Framework Laptop 13 AMD Ryzen 7040 系列配置建议使用power-profiles-daemon (PPD)，而不是TLP，并且强烈不建议为该处理器使用 TLP。更多讨论请参见此 Framework 社区主题。

(AMD) 使用 power-profiles-daemon 的省电或平衡模式时颜色会显得暗淡

PPD（从 Linux 6.9 和 PPD 0.20 开始）使用了 ABM（环境背光管理器），它会影响显示器的色彩真实度以节省设备未充电时的电量。有关配置 ABM 的更多信息，请查看此Framework 社区主题。

要简单地阻止 PPD 调整此设置，请创建一个独立配置文件，其中包含以下行：

/etc/systemd/system/power-profiles-daemon.service.d/disable_panel_powersavings.conf
[Service]
ExecStart=
ExecStart=/usr/lib/power-profiles-daemon --block-action=amdgpu_panel_power
注意 这将保留当前活动的 ABM 设置；如果您想要最高的色彩深度，请先切换到 `performance` 模式。

(AMD) 连接第二个显示器时出现闪烁、伪影和白屏

注意：此问题应通过最新的 BIOS 更新解决

连接第二个显示器时（可能仅限于更高分辨率或刷新率，可能仅限于 Wayland），可能会触发一个问题，即出现图形伪影或白屏，有时在屏幕内容变化时会闪烁显示原始内容。这可以通过将 `amdgpu.sg_display=0` 添加为内核参数来解决。

(AMD) 图形负载期间 GPU 锁定（系统仍可通过 SSH 访问）

注意：此问题应通过最新的 BIOS 更新和 linux-firmware 包解决。

许多措施似乎降低了这种情况发生的几率，并且通过结合它们实现了系统的完全稳定性。随着内核和固件的更新，其中一些或全部措施可能不再是必需的。

  • 将 `linux-firmware` 包替换为 `linux-firmware-git`AUR （在执行此操作之前，请确保 `linux-firmware-git`AUR 比 `linux-firmware` 更新）
  • 在 BIOS 中，将 `iGPU Configuration` 设置为 `UMA_GAME_OPTIMIZED`
  • 将 `/sys/class/drm/card1/device/power_dpm_force_performance_level` 设置为 `high` 或 `low` 而不是 `auto`（在 tlp 中，可以通过 `RADEON_DPM_PERF_LEVEL_ON_AC=high` 和 `RADEON_DPM_PERF_LEVEL_ON_BAT=low` 实现）

由于不建议将TLP与 AMD CPU 一起使用，因此可以通过简单的 udev 规则和一个小程序来实现根据电源适配器是否存在来设置性能级别。

/etc/udev/rules.d/60-power-dpm-force-performance-level.rules
SUBSYSTEM=="power_supply" ENV{POWER_SUPPLY_TYPE}=="Mains" RUN+="/usr/local/bin/set_dpm_perf_level.sh %E{POWER_SUPPLY_ONLINE}"
/usr/local/bin/set_dpm_perf_level.sh
#!/bin/bash

#default level
DRM_PERF_LEVEL=low
#evaluate argument passed by udev
if [ "$1" = 1 ] ; then
    DRM_PERF_LEVEL=high
else
    DRM_PERF_LEVEL=low
fi

#set drm performance level
echo $DRM_PERF_LEVEL > /sys/class/drm/card1/device/power_dpm_force_performance_level

(AMD) 单显示器出现闪烁的图形损坏

正如 Framework 支持在此社区主题中所述，为 iGPU 提供额外的内存似乎可以解决此问题。请遵循此Framework 指南，以在 BIOS 中启用为 iGPU 分配更多内存。

"Boot failed" when booting the Arch installer

尝试启动官方安装程序时，BIOS 可能会显示错误“${device} boot failed”。这是因为官方安装镜像不支持 Secure Boot（FS#53864），而 Secure Boot 默认是启用的。这可以通过在 BIOS 菜单中禁用 Secure Boot 来解决。

附加硬件

扩展坞

请查看 Framework 社区版块的USB-C/Thunderbolt Dock Megathread，以获取关于兼容扩展坞的最新信息。

注意 在 AMD 系统上，只有左上角和右上角（后部端口）支持 Thunderbolt 3，并且是 USB 4。请确保将 USB-C 模块插入这两个端口之一，并将扩展坞连接在那里。

外部 GPU

名称 型号 接口 电源传输？ 外置显卡？ 备注
AKITO Node Pro Thunderbolt 3 T3NP USB-C 是 否 PCIe 总线扩展用于外置显卡时出现错误，3.16.5 内核，3.07 固件
Sonnet eGPU 550 USB-C 是 是 在内核 5.15 及以上版本中测试
Razer Core USB-C 是 是 在内核 5.15 及以上版本中测试
Mantiz MZ-03 Saturn Pro eGPU V2 MZ-03-EU-SG USB-C 是 是 欧盟版，可能需要 intel_iommu=on，在内核 5.15 及以上版本、3.06 固件、3.10 及 12 代 Framework 中测试
TREBLEET Mini eGPU Enclosure JHL7440 USB-C 是 是 在内核 6.8.7 及以上版本中测试。

冷启动时 LUKS 分区解密超时，热插拔时工作正常。拔出时会崩溃 WM，并返回 DM 登录界面。

ADT-Link UT3G ASMedia ASM2464PDX USB-C 否 是 在内核 6.6.52-1-lts 及以上版本中测试。

外置显卡在插入时工作正常，拔出时不会导致系统崩溃。

在 12 代处理器上，无论是在 Arch 还是 Windows 下，带宽似乎都限制在 PCIe 4 x1。

参见

检索自 "https://wiki.archlinux.org.cn/index.php?title=Framework_Laptop_13&oldid=856774"