[Bug]: SteelSeries Arctis Nova 5X reports 3% battery instead of 97%

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

还没有人认领这个 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 nvidia driver, version 615.78.08.
  • AMD Radeon 610M integrated graphics, using the in-kernel amdgpu driver from 7.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
  1. Connect the Nova 5X USB transmitter and turn on the charged headset.
  2. Query its status with headsetcontrol -d 0x1038:0x2253 -m -o json.
  3. Compare the battery percentage with upower --dump and the headset's power-supply properties under /sys/class/power_supply/.
  4. 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() reads data[2] as the battery percentage. That byte is 0x03 in the captured response, which explains the kernel's 3% reading.
  • HeadsetControl's Nova 5X implementation reads data[3]. That byte is 0x61, 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:

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

环境准备

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

从这里开始

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

CachyOS/distribution 的其他 Issue

查看 CachyOS/distribution 的全部 Issue

相似的 Issue

更多 Operating Systems Issue

把新 issue 发到你的邮箱

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