Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Steam Deck OLED: QCA2066 Bluetooth times out after S4 hibernation on SteamOS 3.9.1

未关闭
#2,845 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
52/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
活跃
技术栈
linux

调研方向

Start by reproducing explicit S4 hibernation in Desktop Mode on the Steam Deck OLED and compare the hci_uart_qca/serial0-0 logs with and without the tested systemd-hibernate.service workaround. Investigate the QCA2066 controller recovery path across hibernate and verify that Bluetooth returns powered with existing paired headphones still usable. Done means a native recovery works reliably without the local unbind/bind hook.

由索引模型根据 Issue 内容生成。

描述

System information
  • Device: Steam Deck OLED / Valve Galileo
  • BIOS: F7G0114
  • SteamOS: 3.9.1, build 20260914.100
  • Kernel: 7.2.4-valve1-1-neptune-72-g5ab4af5e2eb9 (linux-neptune-72 7.2.4.valve1-1)
  • BlueZ: 5.87-2.4
  • KDE PowerDevil: 6.7.3-2.1
  • Configured atomupd branch: beta (the installed OS reports 3.9.1)
  • Bluetooth device: QCOM2066 / QCA2066, UART driver hci_uart_qca, serdev device serial0-0
Expected behavior

After an explicit suspend-to-disk (S4 / hibernate) in Desktop Mode, the Bluetooth adapter should return to its previous powered state and existing paired headphones should remain usable.

Actual behavior

The system resumes successfully, but the Bluetooth controller repeatedly times out and cannot be powered on normally. bluetooth.service remains active and rfkill reports neither a soft nor a hard block. bluetoothctl reports Powered: no while PowerState is on. The paired headphones cannot be used.

This is hibernate, not ordinary suspend-to-RAM: logind records a hibernate request from PowerDevil, Valve's hibernate-prepare.service successfully creates its temporary swap file, and systemd-sleep reports returning from hibernate. No manual swap/GRUB/initramfs changes were made to enable hibernation. The Desktop Mode power button was configured to Hibernate.

Related report: #2201. That report was closed because its author could no longer reproduce it. This report supplies a reproducible case on 3.9.1 triggered by explicit hibernation, rather than a low-battery event.

Steps to reproduce
  1. Boot the OLED Deck, enter Desktop Mode, and enable Bluetooth. Use an already paired Bluetooth headset.
  2. Select Hibernate in KDE (or configure the Desktop Mode power button to Hibernate and press it).
  3. Wait for the Deck to finish hibernating, then press the power button to resume.
  4. Try to use the headset or enable the Bluetooth adapter. The controller is unresponsive and HCI commands time out.

Game Mode power-button behavior was not modified or tested. This report concerns explicit S4 in Desktop Mode.

Relevant logs before the workaround

These excerpts use Asia/Shanghai time (UTC+08:00), 2026-09-28:

02:03:33 systemd-logind: hibernate requested from client PID 5116 ('org_kde_powerde')
02:03:33 hibernate-swap-helper.sh: Creating swap file: 16204716 KB (15824 MB)
02:03:33 hibernate-swap-helper.sh: Hibernation configured successfully
02:03:34 systemd-sleep: Performing sleep operation 'hibernate'...
02:04:22 kernel: ACPI: PM: Waking up from system sleep state S4
02:04:24 kernel: Bluetooth: hci0: command 0x0c01 tx timeout
02:04:24 kernel: Bluetooth: hci0: Opcode 0x0c01 failed: -110
02:04:24 kernel: Bluetooth: hci0: crash the soc to collect controller dump
02:04:26 kernel: Bluetooth: hci0: Opcode 0x0c1a failed: -110
02:04:29 systemd-sleep: System returned from sleep operation 'hibernate'.
02:04:35 kernel: Bluetooth: hci0: Injecting HCI hardware error event
02:04:37 kernel: Bluetooth: hci0: clearing allocated memory due to memdump timeout
02:04:39 kernel: Bluetooth: hci0: Opcode 0x0c03 failed: -110
02:05:24 kernel: Bluetooth: hci0: Opcode 0x0c03 failed: -110
Workaround tested on this device

A local systemd-hibernate.service drop-in runs a script before and after the hibernate operation:

  • Before hibernating: save the BlueZ Powered state, then unbind only serial0-0 from /sys/bus/serial/drivers/hci_uart_qca/unbind.
  • After resuming: bind serial0-0 back through the same driver's bind attribute, wait for the BlueZ adapter to become available, and restore its Powered state.
  • The script does not touch Wi-Fi, pairing data, or the ordinary suspend service.

One complete real hibernate/resume test with this workaround succeeded. QCA firmware setup completed, Powered returned to yes about two seconds after binding, and the original paired headphones worked without re-pairing. This is one successful cycle, not a claim of long-term reliability.

Simply unbinding/rebinding after the failure recovered the controller once, but repeating that on a healthy controller caused firmware-download/version-query timeouts and the adapter disappeared. Therefore the final workaround detaches the device before S4 and binds it after resume; it does not blindly reset a healthy controller after every wake.

The successful cycle logs were:

02:17:21 helper: saved power state: on
02:17:21 helper: detaching QCA UART controller before hibernation
02:17:21 systemd-sleep: Performing sleep operation 'hibernate'...
02:18:22 systemd-sleep: System returned from sleep operation 'hibernate'.
02:18:23 helper: binding QCA UART controller after hibernation
02:18:24 kernel: Bluetooth: hci0: QCA setup on UART is completed
02:18:25 helper: controller restored successfully: powered=true

Both systemd-hibernate.service and its pre/post actions completed successfully; temporary hibernation swap and the helper's saved state were cleaned up. The two existing paired-device records were retained. A transient Frame reassembly failed (-84) also appeared during reinitialization, followed by successful firmware setup; the earlier persistent HCI timeouts did not recur after setup in this observation window.

Investigation direction

The workaround suggests that the controller/transport state needs to be reconstructed across S4, but the kernel or firmware root cause has not been established. A native QCA2066 hibernate recovery fix would be preferable to maintaining a local unbind/bind hook, particularly because SteamOS updates can remove the local drop-in.

主要语言
没有语言数据
星标
2.6k
派生
88
PR 合并指标
30 天内没有已合并 PR

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

ValveSoftware/SteamOS 的其他 Issue

查看 ValveSoftware/SteamOS 的全部 Issue

相似的 Issue

更多 Operating Systems Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。