From nobody Mon Feb 9 15:26:00 2026 Received: from mail-qv1-f65.google.com (mail-qv1-f65.google.com [209.85.219.65]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 52F1C2C1594 for ; Sun, 28 Dec 2025 12:20:39 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.219.65 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766924441; cv=none; b=iprKXbMe7rjSxYN5VTq+R7TDturjixyZjXSA6jmMgCz0UG5fORYPC03lqurd5aYQbMm2Qf9SKSTiRtG5yXvWYgUuDRELk0crJ6fSl70ebdnqv1PTmmmxSPIOMBsjA/llf4dXNaf7k+PBv6Vw0N5i0B27Np80s7TNmXa8Q+Jb9Ew= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766924441; c=relaxed/simple; bh=ZaRre9KeRHlWpTrdmOFo1E3VLeEptXG4YplvxcGUxVw=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=NGPbHVCGlIrjhuj1u0r3EBLCnThLRis/dvuyZCkOiQcqKT/qB0aBpMlenUbRPGlJjKYru8maC8S+dSrNum6DbifljKDtusgbCcSHd5t11nYRN/Ry6ZLUqLa0OwLpgEoCJrGmzWql+3ytHbGOygf+wDsMB9u9Mn00mWVGmVpabJ8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=Qlf+jLLL; arc=none smtp.client-ip=209.85.219.65 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="Qlf+jLLL" Received: by mail-qv1-f65.google.com with SMTP id 6a1803df08f44-88fca7bce90so79987346d6.3 for ; Sun, 28 Dec 2025 04:20:39 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1766924438; x=1767529238; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=WiT7vd66H/0g7zS/sfr9KNa7Y0rTVJ0HEgehE7M8NCc=; b=Qlf+jLLLjUI0tC3v1m1wDP2YsJdMwbZ6fdG9zVgQfdm0VBu0nQBFQU72RN0cbou3/M lgNnNLSa6zuryFuaAAl2GpHl9pgdOEIuSSVUi+eRWSjl50jxqnxRB2pT4oGYJ7A27Q9T bXo13+bsvr6Wgxnlowoi/Lar98+YOXRyu5iM2nSs/pQY/98Gvz5o5dK5tO1T+075JDW5 W7w69Z9LchAzmEnQ4jLVPRcI/rzRpBltDQJr4O9FliD7fFRFc0EdgT7Sg+M7lJvYusyG 7Ru3SaBrd+LrfpJxIv+kheQuAypMHy98u/GDxIwdDB4nZPdoRqc0//Zoz8X3/1cSqJdo ulSA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1766924438; x=1767529238; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=WiT7vd66H/0g7zS/sfr9KNa7Y0rTVJ0HEgehE7M8NCc=; b=B/IUlTYE1v5whd8CWkcfzfP+zGcQQPIEvTHPZBC0j4QrV/dUhZLGA1j59tBenMLhFa zE87LQ78KCQSc5lpNKJ09AogdMtmV8jvuqfZ6CsXDwzOzu6AbHre9idWkZeZ8rht7G7S /Dp9paYiSdmMedF8GYdU5ELatbgebH9WKzoOEOXTwJd3S+UI5c6XxXBnuBN+sHgfgmkq FKSMv8uObPidNjk/6mnRiki0moILjM71BiTxkzKb0w0KcZsRo8a5GChIhqGa75duUgSp s7dxZpqZ3pBqHhTZgNw8GKeQ0FxpirOTO5qh9wbiyHybUcSt0h68K/kkRHJc9oQXgmwT HFDg== X-Forwarded-Encrypted: i=1; AJvYcCVsxn2QIDyt2w+MigQqxdbAoga/oHO07zaITnSrfUnAy/LgKWBRS3hlRJKHDx+r4k1rQBBkdkMsyidJ+WE=@vger.kernel.org X-Gm-Message-State: AOJu0YxawDqa57Yuu5eIMS+dksby12hA/JiabphMrEbLk9R53dNGsGI7 fqvxl6jBQKrBMtn7AQVseY7EfN/3oI3OXIOsIG9jE1gsItTj7H6Gxjml X-Gm-Gg: AY/fxX6XFHvMSbEJ0zOHpVw5K4a2CWECwj3xfoXaFgwTg7YP/TOloNEwXwwGUb53Ue1 p8F2Rj89Ejy3SFW5FxW0cVG/QjrL6HfIfXs/s+cnIDo8xdRUlvcF5RcFV09cO7qg2PHlDidQOL4 V20uYNl8m5hKLLI01ljflIJWA7RbN3e2mlZAXPO/GV7oJk48ZvdO5i3WHvy38yQelucqYPg3w6I Ov+IvbXw46ZgJKzSn4wiBqK/o8kcEL8770sI1p7XUNsmLATLXr1X3e8unDgB6y0hNbBTQ1Tzzn8 u81tRauu92swK5B+YxPHbcQk8CTZ+dFF6HLB8DF4sovHB4B/48cP4W/PZxYc0mQUcrjqa5MsV6c JxOKLZTi2cdacPBsznayG0W+ecmTbmVPm/n1RvaOqTf7sR1m3zhNpYSlJaz6CYFaEcuJc7qfO0H ti9oOpMrtW7t8ljGPJcLGEZUSN48Ifcd4IhJpzoL3S3jQKI1YqB3qUQW7bGQ== X-Google-Smtp-Source: AGHT+IHVT80eOLqzT36cdjP443bt7VWsCGjcpEsIo0xp8ya1wDSesm0f0xL8IbXzpm+3e3OHhWSFaw== X-Received: by 2002:a05:6214:3110:b0:88a:568b:f4af with SMTP id 6a1803df08f44-88d828162edmr447081896d6.23.1766924438126; Sun, 28 Dec 2025 04:20:38 -0800 (PST) Received: from achantapc.mynetworksettings.com ([2600:4040:1233:de00:c673:8e0d:7a28:6166]) by smtp.gmail.com with ESMTPSA id 6a1803df08f44-88d99d7dbdcsm208744456d6.43.2025.12.28.04.20.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 28 Dec 2025 04:20:37 -0800 (PST) From: Sriman Achanta To: Jiri Kosina , Benjamin Tissoires , linux-input@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Sriman Achanta Subject: [PATCH 3/4] Documentation: ABI: Document SteelSeries headset sysfs attributes Date: Sun, 28 Dec 2025 07:20:24 -0500 Message-ID: <20251228122025.154682-4-srimanachanta@gmail.com> X-Mailer: git-send-email 2.52.0 In-Reply-To: <20251228122025.154682-1-srimanachanta@gmail.com> References: <20251228122025.154682-1-srimanachanta@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Replace the SRW-S1 specific documentation with comprehensive documentation for the hid-steelseries driver covering both the legacy SRW-S1 wheel and the modern Arctis headset lineup. New sysfs attributes documented: - sidetone_level: Control microphone monitoring volume - inactive_time: Auto-sleep timeout configuration - chatmix_level: Game/Chat audio balance (read-only) - mic_mute_led_brightness: Microphone mute LED brightness control - mic_volume: Internal microphone gain control - volume_limiter: EU hearing protection volume limiter - bluetooth_on_power: Bluetooth auto-enable on power-on - bluetooth_call_vol: Bluetooth call audio attenuation settings The SRW-S1 LED documentation is preserved and moved into the new unified documentation file. Signed-off-by: Sriman Achanta --- .../ABI/testing/sysfs-driver-hid-srws1 | 21 --- .../ABI/testing/sysfs-driver-hid-steelseries | 123 ++++++++++++++++++ 2 files changed, 123 insertions(+), 21 deletions(-) delete mode 100644 Documentation/ABI/testing/sysfs-driver-hid-srws1 create mode 100644 Documentation/ABI/testing/sysfs-driver-hid-steelseries diff --git a/Documentation/ABI/testing/sysfs-driver-hid-srws1 b/Documentati= on/ABI/testing/sysfs-driver-hid-srws1 deleted file mode 100644 index d0eba70c7d40..000000000000 --- a/Documentation/ABI/testing/sysfs-driver-hid-srws1 +++ /dev/null @@ -1,21 +0,0 @@ -What: /sys/class/leds/SRWS1::::RPM1 -What: /sys/class/leds/SRWS1::::RPM2 -What: /sys/class/leds/SRWS1::::RPM3 -What: /sys/class/leds/SRWS1::::RPM4 -What: /sys/class/leds/SRWS1::::RPM5 -What: /sys/class/leds/SRWS1::::RPM6 -What: /sys/class/leds/SRWS1::::RPM7 -What: /sys/class/leds/SRWS1::::RPM8 -What: /sys/class/leds/SRWS1::::RPM9 -What: /sys/class/leds/SRWS1::::RPM10 -What: /sys/class/leds/SRWS1::::RPM11 -What: /sys/class/leds/SRWS1::::RPM12 -What: /sys/class/leds/SRWS1::::RPM13 -What: /sys/class/leds/SRWS1::::RPM14 -What: /sys/class/leds/SRWS1::::RPM15 -What: /sys/class/leds/SRWS1::::RPMALL -Date: Jan 2013 -KernelVersion: 3.9 -Contact: Simon Wood -Description: Provides a control for turning on/off the LEDs which form - an RPM meter on the front of the controller diff --git a/Documentation/ABI/testing/sysfs-driver-hid-steelseries b/Docum= entation/ABI/testing/sysfs-driver-hid-steelseries new file mode 100644 index 000000000000..3066dbb486d3 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-driver-hid-steelseries @@ -0,0 +1,123 @@ +What: /sys/class/leds/SRWS1::::RPM1 +What: /sys/class/leds/SRWS1::::RPM2 +What: /sys/class/leds/SRWS1::::RPM3 +What: /sys/class/leds/SRWS1::::RPM4 +What: /sys/class/leds/SRWS1::::RPM5 +What: /sys/class/leds/SRWS1::::RPM6 +What: /sys/class/leds/SRWS1::::RPM7 +What: /sys/class/leds/SRWS1::::RPM8 +What: /sys/class/leds/SRWS1::::RPM9 +What: /sys/class/leds/SRWS1::::RPM10 +What: /sys/class/leds/SRWS1::::RPM11 +What: /sys/class/leds/SRWS1::::RPM12 +What: /sys/class/leds/SRWS1::::RPM13 +What: /sys/class/leds/SRWS1::::RPM14 +What: /sys/class/leds/SRWS1::::RPM15 +What: /sys/class/leds/SRWS1::::RPMALL +Date: Jan 2013 +KernelVersion: 3.9 +Contact: Simon Wood +Description: Provides a control for turning on/off the LEDs which form + an RPM meter on the front of the controller + +What: /sys/class/hid/drivers/steelseries//sidetone_level +Date: January 2025 +KernelVersion: 6.19 +Contact: Sriman Achanta +Description: + Controls the sidetone (microphone monitoring) volume level. + This determines how much of the microphone input is fed back into + the headset speakers. + + Range: 0-128 (mapped internally to device-specific values). + Access: Write + +What: /sys/class/hid/drivers/steelseries//inactive_time +Date: January 2025 +KernelVersion: 6.19 +Contact: Sriman Achanta +Description: + Sets the time in minutes before the headset automatically enters + standby/sleep mode when no audio is playing. + + Range: 0-90 (minutes). + Some devices (e.g., Arctis 1/7X) map this to specific presets. + Access: Write + +What: /sys/class/hid/drivers/steelseries//chatmix_level +Date: January 2025 +KernelVersion: 6.19 +Contact: Sriman Achanta +Description: + Reports the current balance between Game and Chat audio channels + (ChatMix). This value changes when the physical ChatMix dial + on the headset is adjusted. + + Range: 0-128 + 0 =3D 100% Chat / 0% Game + 64 =3D 50% Chat / 50% Game (Balanced) + 128 =3D 0% Chat / 100% Game + Access: Read + +What: /sys/class/hid/drivers/steelseries//mic_mute_led_brightness +Date: January 2025 +KernelVersion: 6.19 +Contact: Sriman Achanta +Description: + Controls the brightness of the LED on the microphone boom that + indicates when the microphone is muted. + + Range: 0-3 (off, low, medium, high) for most devices. + 0-10 for newer Nova series devices. + Access: Write + +What: /sys/class/hid/drivers/steelseries//mic_volume +Date: January 2025 +KernelVersion: 6.19 +Contact: Sriman Achanta +Description: + Controls the internal microphone gain/volume of the headset. + This is distinct from the OS input volume. + + Range: 0-128 (mapped internally to device-specific values). + Access: Write + +What: /sys/class/hid/drivers/steelseries//volume_limiter +Date: January 2025 +KernelVersion: 6.19 +Contact: Sriman Achanta +Description: + Enables or disables the EU volume limiter (hearing protection). + When enabled, the maximum output volume is capped. + + Values: + 0 =3D Disabled + 1 =3D Enabled + Access: Write + +What: /sys/class/hid/drivers/steelseries//bluetooth_on_power +Date: January 2025 +KernelVersion: 6.19 +Contact: Sriman Achanta +Description: + Configures whether the Bluetooth radio automatically turns on + when the headset is powered on. + + Values: + 0 =3D Bluetooth must be turned on manually + 1 =3D Bluetooth turns on automatically with headset + Access: Write + +What: /sys/class/hid/drivers/steelseries//bluetooth_call_vol +Date: January 2025 +KernelVersion: 6.19 +Contact: Sriman Achanta +Description: + Configures how the 2.4GHz Game/Chat audio is attenuated when + a Bluetooth call is active. + + Values: + 0 =3D No attenuation (mix both equally) + 1 =3D Attenuate Game audio by -12dB + 2 =3D Mute Game audio completely + Access: Write --=20 2.52.0