[Bug]: SteelSeries Arctis Nova 5X reports 3% battery instead of 97%
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 22/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- c, linux
调研方向
The code in question is the Linux kernel driver drivers/hid-steelseries-arctis.c, not this placeholder repository. Start at steelseries_arctis_nova_parse_status(), where the battery percentage is read from data[2], and compare it with the captured 0xb0 response (byte 3 is 0x61, or 97). Done means the Nova 5X reads the correct byte without changing decoding for other models, verified against that capture.
由索引模型根据 Issue 内容生成。
描述
Kernel
7.3.1-1-cachyos
Desktop environment / window manager
KDE Plasma, Wayland.
CPU
AMD Ryzen 7 7800X3D 8-Core Processor.
GPU / driver
- NVIDIA GeForce RTX 4080 SUPER, using the
nvidiadriver, version615.78.08. - AMD Radeon 610M integrated graphics, using the in-kernel
amdgpudriver from7.3.1-1-cachyos.
Description
KDE shows a critical-battery notification when a charged SteelSeries Arctis Nova 5X is turned on. HeadsetControl reports 97% battery, but the kernel power-supply device and UPower report 3%.
The affected device has USB vendor ID 1038 and product ID 2253. Its active HID driver is hid-steelseries-arctis.
Steps to reproduce
- Connect the Nova 5X USB transmitter and turn on the charged headset.
- Query its status with
headsetcontrol -d 0x1038:0x2253 -m -o json. - Compare the battery percentage with
upower --dumpand the headset's power-supply properties under/sys/class/power_supply/. - Observe the critical-battery notification in KDE.
In the affected session, a ChatMix helper also runs the HeadsetControl query every 0.5 seconds. Reproduction with that helper stopped has not been tested.
Expected behavior
The kernel and UPower should report the headset's battery percentage correctly. KDE should not warn that a nearly full battery is critically low.
Actual behavior
HeadsetControl reports 97%, while the kernel reports 3%. UPower marks the battery as critical, and KDE displays a low-battery warning. UPower history also contains repeated jumps between near-full and critically low readings.
Logs / error messages
Relevant excerpts only. Full system logs are not attached to avoid disclosing unrelated personal information.
HeadsetControl 4.1.0 reports:
"battery": {
"status": "BATTERY_AVAILABLE",
"level": 97
}
The kernel power-supply properties report:
POWER_SUPPLY_STATUS=Discharging
POWER_SUPPLY_PRESENT=1
POWER_SUPPLY_CAPACITY=3
POWER_SUPPLY_CAPACITY_LEVEL=Critical
POWER_SUPPLY_MODEL_NAME=Arctis Nova 5X
POWER_SUPPLY_MANUFACTURER=SteelSeries
UPower reports:
model: Arctis Nova 5X
warning-level: critical
percentage: 3%
A read-only capture from the transmitter's HID interface 3 received a 64-byte status response. Its first eight bytes were:
b0 03 03 61 03 64 64 00
Additional context
The evidence points to a model-specific offset error in the 0xb0 status decoder:
steelseries_arctis_nova_parse_status()readsdata[2]as the battery percentage. That byte is0x03in the captured response, which explains the kernel's 3% reading.- HeadsetControl's Nova 5X implementation reads
data[3]. That byte is0x61, or 97 in decimal, matching its reported percentage. - The kernel assigns the Nova 5X to the shared Nova decoder. A correction should account for the Nova 5X report layout without changing other models' decoding incorrectly.
The same shared decoder still reads data[2] in Linux 7.4-rc1 and in the upstream development source checked on 2026-11-03. The running kernel's upstream version, 7.3.1, is the latest stable release listed on kernel.org on that date. A full system update was not performed as part of this investigation, and a different kernel was not boot-tested.
References:
- Linux 7.4-rc1 driver source: https://github.com/torvalds/linux/blob/v7.4-rc1/drivers/hid/hid-steelseries-arctis.c
- HeadsetControl 4.1.0 Nova 5X battery decoder: https://github.com/Sapd/HeadsetControl/blob/4.1.0/lib/devices/steelseries_arctis_nova_5.hpp
- Original Nova 5X support commit: https://github.com/torvalds/linux/commit/83e70ced0d16eaa22425f93e63af2bb87ffaf4eb
- Kernel release information: https://www.kernel.org/releases.json
- 主要语言
- 没有语言数据
- 星标
- 29
- 派生
- 2
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
CachyOS/distribution 的其他 Issue
-
难度 1/5 1 小时以内 新手友好度 74/100
CachyOS/distribution#620 ·
-
bug
难度 2/5 1-3 小时 新手友好度 75/100
CachyOS/distribution#603 · 2 条评论 · 1 个 reaction ·
-
enhancement
难度 2/5 1-3 小时 新手友好度 65/100
CachyOS/distribution#602 ·
-
bug
难度 2/5 1-3 小时 新手友好度 68/100
CachyOS/distribution#590 ·
-
bug
难度 2/5 1-3 小时 新手友好度 70/100
CachyOS/distribution#588 ·
查看 CachyOS/distribution 的全部 Issue
相似的 Issue
-
bug good first issue
难度 1/5 1 小时以内 新手友好度 90/100
-
area:filesystem bug need-triage
难度 2/5 1-3 小时 新手友好度 85/100
维护者通常 1 天内回复
-
0.kind: bug 6.topic: nixos
难度 2/5 半天 新手友好度 68/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复
-
area: preconfig bug claude priority: medium size: S triaged
难度 2/5 1-3 小时 新手友好度 88/100
exceev-consulting/server-prep#224 ·
维护者通常 2 天内回复