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。

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

硬件

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

注意： 确保您已安装 linux-firmware，如 安装指南#安装基本软件包 中所述，然后再在 Arch 错误跟踪器或 Framework 社区论坛上报告硬件问题。它是 linux 的可选依赖项，并且不会自动作为 base 的一部分安装。没有它，大部分硬件将被检测到，但无法完全正常工作。您将在 日志 中看到固件加载问题。

Wi-Fi/蓝牙

设备名称	PCI ID	蓝牙 USB ID	工作正常？	蓝牙？	备注
AX200	8086:2723	8087:0029	是	是	预生产单元
AX201 vPro			未测试	未测试	专业版
AX201 w/o vPro	8086:a0f0	8087:0026	是	是	基础版/性能版
AX210 vPro	8086:2725	8087:0032	是	是	DIY 版（可选）
AX210 w/o 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 版本

AMD 版本上的 Wi-Fi 性能

如果您不配置 法规域，您将被限制为 802.11n (Wi-Fi 4) 和 2.4GHz 频段。

有报告称，当使用 iwd 时，无论是直接使用还是作为 NetworkManager 后端，Wi-Fi 稳定性和吞吐量都有所提高。

可以通过禁用省电模式来提高 Wi-Fi 稳定性，如 Network configuration/Wireless#mt7921 中所述。

显卡

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	是
存储 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 圆角显示器，均由 京东方 制造。它们在出厂时未经过校准，因此默认 sRGB 覆盖率欠佳。因此，建议应用 ICC 配置文件 以获得更好的色彩还原。[5]

• Intel Framework 13 ICC 颜色配置文件：https://www.notebookcheck.net/uploads/tx_nbc2/BOE_CQ_______NE135FBM_N41_01.icm
• AMD Framework 13 ICC 颜色配置文件：https://www.notebookcheck.net/uploads/tx_nbc2/BOE_CQ_______NE135FBM_N41_03.icm

• Intel Core Ultra Framework 13 2.8k 显示器 ICC 颜色配置文件：https://www.notebookcheck.net/uploads/tx_nbc2/BOE0CB4.icm

HDMI 音频输出

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

固件

BIOS 更新

更新通常可从 Framework 直接获取 UEFI Shell 更新。LVFS 支持正在测试中。

代	稳定版	Beta 版	LVFS	备注
Intel 11 代	3.20		3.17	3.20 不会发布 LVFS 版本，因为它具有 Intel CSME 更新。UEFI Shell 更新方法可用。
Intel 12 代	3.08			稍后批次的产品配备 3.05 版本，“以解决工厂特定的问题”[6]。 警告： 将 BIOS 更新到版本 3.06 或 3.08 后，您将无法降级到版本 3.04 或 3.05，因为这将导致左侧端口停止正常工作。
Intel 13 代	3.05			3.05 的 Windows 更新程序和 EFI Shell 软件包可用。公告在此处：[7]
Intel Core Ultra 1	3.04		3.04	公告在此处：[8]
AMD Ryzen 7040	3.05	3.06	3.05	如果您拥有批次 1 或 2 设备（第一个原始 Framework AMD 版本），请确保您首先升级到至少 3.03 版本。它预装在批次 3 及更高版本中。具有新的 2.8k 显示器批次的较新 AMD 版本应已包含最新的 BIOS 固件（Framework 已从批次 1 重新开始计数）。

BIOS 可以通过放置在可启动 USB 闪存驱动器上的 EFI shell 脚本进行更新。此固件更新方法会清除 NVRAM 中注册的 EFI 引导加载程序，因此建议手头准备一个恢复盘或重新安装引导加载程序的替代方法。如果您的引导加载程序将其自身安装为 esp/EFI/BOOT/BOOTX64.EFI 的 EFI 后备（systemd-boot 将默认安装，GRUB 将使用 GRUB#Default/fallback boot path），则无需恢复盘，但可能需要重新安装引导加载程序以恢复其 NVRAM 条目。

要检查当前安装的 bios 版本，而无需重启进入 bios 本身，可以使用

# dmidecode -s bios-version

LVFS

对 fwupd 的支持正在测试中 [9]，可以通过运行以下命令启用

$ fwupdmgr enable-remote lvfs-testing

注意

• 对于 AMD 7040 系列笔记本电脑，如果您只想使用已发布的 BIOS 更新，而不是 Beta 测试中的更新，则不应启用测试远程仓库 [10][11]。
• BIOS 版本早于 3.17 的第 11 代 Intel 主板仅支持内存胶囊更新，不支持磁盘更新。要升级到支持磁盘更新的较新版本，请添加以下 fwupd 配置更改，更新到 3.17 或更高版本，然后在 BIOS 更新后恢复更改

/etc/fwupd/fwupd.conf

[uefi_capsule]
DisableCapsuleUpdateOnDisk=true

指纹读取器

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

安全启动

可以将自定义密钥注册到 Framework Laptop 中，而无需担心 Option ROM 问题，或者使用 SHIM 方法。有关详细信息，请参阅 安全启动。

休眠

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

如果您的系统由于 SSD 断开连接而无法从挂起状态唤醒，您可以尝试将 nvme.noacpi=1 放入您的 内核参数 中。如果您的 SSD 的 ACPI 实现不佳，这也可能会延长挂起状态下的电池续航时间。这应该仅在 Intel 主板上使用，因为在 AMD 上，它会引起问题，而不是修复问题。

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

如果您想使用 S3 睡眠而不是 s2idle，请参阅 Power management/Suspend and hibernate#更改挂起方法。

休眠后 Fn 键

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

/etc/modprobe.d/cros_ec_lpcs.conf

blacklist cros_ec_lpcs

AMD 版本上的挂起后休眠

对于运行内核版本低于 6.7 的 AMD 版本，systemd 的挂起后休眠将在正好 5 分钟后唤醒（常规挂起有效）。在内核补丁 [15] 合并之前，添加 内核参数 rtc_cmos.use_acpi_alarm=1 以使用正确的唤醒机制。

触摸板

有报告称，触摸板在从睡眠状态唤醒后出现问题（例如，指针不移动，双指滚动不起作用等）。禁用 BIOS 中 Advanced 下的 PS/2 鼠标仿真似乎可以解决问题[16]。

与系统交互

您可以使用 framework-system-git^AUR 与您的系统交互。

注意： 在 AMD 主板上，如果没有 以下未合并的补丁集（截至 6.6.4），framework_tool 将无法使用 /dev/cros_ec。如果未启用安全启动，则该工具可以绕过内核，并使用 --driver portio 选项直接与 EC 通信。在启用安全启动的情况下，使用它的唯一方法是修补内核或等待这些补丁合并（有关详细信息，请参阅 此问题）。

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

警告： 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	是	是	End
Fn+Up	是	是	Prior/PgUp
Fn+Down	是	是	Next/PgDn

1. 该键对 xev 和类似工具可见。
2. 物理键上有符号，描述其功能。

环境光传感器

注意： 如果您将 hid_sensor_hub 模块列入黑名单，则此功能不起作用。

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

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

如果您不使用 GNOME，但仍然需要自动亮度控制，请查看 illuminanced-git^AUR。

风扇速度控制

您可以使用此工具强制将风扇速度设置为 0 到 100 之间的任何值：https://gitlab.howett.net/DHowett/ectool (fw-ectool-git^AUR)

$ 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-git^AUR 更改此 EC 的设置，直到补丁合并到主线内核中为止。与电池健康护理相关的一些公开设置 是

# 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

或在“当前电流”下

# ectool battery

使用

# ectool fwchargelimit level

似乎与通过 BIOS 设置充电限制的作用相同，BIOS 会尝试将电池电量保持在设定水平，但会不断地充电和放电（在这种模式下不使用 idle 模式）。

最后，我们可以限制允许的最大充电电流，从而启用慢速充电，使用

# ectool chargecurrentlimit mA

通过 ectool 设置的参数在笔记本电脑断电并拔下电源几秒钟（10 秒左右）后仍然有效，之后值将恢复为默认值。

故障排除

卡顿、闪烁和周期性冻结

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

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

双指/三指点击

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

$ 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

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

启动管理器闪烁黑屏且无法加载操作系统

如果您的 Framework 笔记本电脑加载了引导加载程序，并且可以识别闪存驱动器或 m.2 驱动器上的 EFI 系统分区，但无法加载您的启动管理器（仅闪烁黑屏，然后返回到引导加载程序），则您必须禁用 安全启动。

1. 重启并按住 F2。某些版本的 BIOS 中存在一个错误，该错误阻止在重启或开机期间识别内置笔记本电脑键盘上的 F2 键。解决方法是将外部 USB 键盘连接到笔记本电脑，并在重启或开机时按住外部键盘上的 F2 键。笔记本电脑进入 BIOS 设置后，可以使用内置键盘，并且可以断开外部键盘的连接。
2. 转到“Security”选项卡
3. 安全启动默认为“ON”；禁用它
4. 保存更改并重启

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

在高压力下，Wi-Fi 设备重启，并且网络速度变得异常缓慢或无响应，直到断开并重新连接到 Wi-Fi 网络。[17]

其他制造商的笔记本电脑（不仅限于 Framework）的所有者也观察到了此问题。[18]

禁用 IEEE 802.11ax 似乎是目前合适的解决方法。[19]

/etc/modprobe.d/iwlwifi.conf

options iwlwifi disable_11ax=Y

英特尔已知晓[20] 此问题，并且有一个补丁[21] 修复重启后发送速度缓慢的问题，以及另一个补丁[22] 解决软件错误。

指纹读取器设备断开连接错误

当指纹读取器已在 Windows 上用于注册指纹后，如果您稍后尝试在 Linux 下使用该读取器，而没有首先从 Windows 中取消注册指纹，则 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

在电池供电时使用 tlp 的第 12 代睿频加速

默认情况下，如果安装了 tlp，第 12 代处理器在电池供电时不会进行睿频加速。这可以在 tlp 的配置中进行配置。

/etc/tlp.conf

CPU_ENERGY_PERF_POLICY_ON_AC=balance_performance
CPU_ENERGY_PERF_POLICY_ON_BAT=balance_performance

第 12 代亮度键和飞行模式键

在第 12 代主板上，存在一个错误^{[死链接 2023-10-29 ⓘ]}，其中 ALS 和亮度向上/向下键（包括飞行模式键）冲突。为了使亮度键和飞行模式键工作（以牺牲使用环境光传感器为代价），拉黑 hid_sensor_hub 模块。

以太网在使用 tlp 时无法工作

默认情况下，tlp 会限制 framework 以太网适配器的功率。这可以在 tlp 的配置中更改，其中 0bda:8156 是 framework 以太网适配器的 ID。

/etc/tlp.conf

USB_DENYLIST="0bda:8156"

(AMD) 不建议使用 TLP 进行电源管理。建议使用 PPD

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（环境光背光管理器），这会影响显示颜色的真实性，以便在设备未充电时节省电量。有关配置它的更多信息，请查看这个 Framework 社区帖子。

要简单地阻止 PPD 调整此设置，请为其 systemd-unit 创建一个 drop-in 文件，命令为 systemctl edit power-profiles-daemon.service --drop-in=disable_panel_powersavings，并将以下行添加到其中

[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/card0/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" 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 RAM。

(AMD) 使用内核 6.7 休眠后无法重新连接 Wi-Fi

内核版本 6.7 中引入了一个错误，导致 Wi-Fi 连接在休眠后无法恢复。修复程序已经提出，应该会包含在 6.8 版本中。除了修补内核或使用 lts 版本外，一种解决方法是使用 modprobe 删除并重新添加 mt7921e 模块，如此社区帖子中所述。

启动 Arch 安装程序时显示 “Boot failed”

尝试启动官方安装程序时，BIOS 可能会显示错误“${device} boot failed”。这是因为官方安装镜像不支持安全启动 (FS#53864)，并且默认启用安全启动。可以通过从 BIOS 菜单禁用安全启动来解决此问题。

其他硬件

扩展坞

查看 Framework 社区论坛上的USB-C/Thunderbolt 扩展坞综合讨论帖，以获取有关正常工作的扩展坞的最新信息。

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

外接 GPU

名称	型号	接口	供电？	eGPU？	备注
AKITO Node Pro Thunderbolt 3	T3NP	USB-C	是	否	eGPU 的 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 及以上版本中测试。 eGPU 在插入时工作，拔下插头时不会导致系统崩溃。 在第 12 代 Arch 和 Windows 上，带宽似乎都限制为 PCIe 4 x1。

另请参阅

• Framework 网站
• Framework 社区 Arch Linux 讨论帖
• Framework 社区电池续航调整讨论帖