| lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
|
Open Source and information security mailing list archives
| ||
|
Message-ID: <cc997c35b10ca1073397cb0c3b66ab2c0a2bdcb0.camel@hadess.net> Date: Mon, 12 Jan 2026 14:08:44 +0100 From: Bastien Nocera <hadess@...ess.net> To: Sriman Achanta <srimanachanta@...il.com>, Jiri Kosina <jikos@...nel.org>, Benjamin Tissoires <bentiss@...nel.org>, linux-input@...r.kernel.org, linux-kernel@...r.kernel.org Subject: Re: [PATCH v2 3/4] Documentation: ABI: Document SteelSeries headset sysfs attributes On Sun, 2026-01-11 at 23:19 -0500, Sriman Achanta wrote: > 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. Renaming the sysfs-driver-hid-srws1 should be done separately from adding new contents. This patch should also come after the feature gets added. > > New sysfs attributes documented: > - sidetone_level: Control microphone monitoring volume This should be an ALSA mixer, not a sysfs file. > - inactive_time: Auto-sleep timeout configuration > - chatmix_level: Game/Chat audio balance (read-only) Ditto for an ALSA mixer. > - mic_mute_led_brightness: Microphone mute LED brightness control This probably needs to be a standard LED device. > - mic_volume: Internal microphone gain control Ditto for an ALSA mixer. > - volume_limiter: EU hearing protection volume limiter Ditto for an ALSA switch. > - bluetooth_on_power: Bluetooth auto-enable on power-on > - bluetooth_call_vol: Bluetooth call audio attenuation settings Ditto for an ALSA mixer. > > The SRW-S1 LED documentation is preserved and moved into the new > unified > documentation file. > > Signed-off-by: Sriman Achanta <srimanachanta@...il.com> > --- > .../ABI/testing/sysfs-driver-hid-srws1 | 21 --- > .../ABI/testing/sysfs-driver-hid-steelseries | 131 > ++++++++++++++++++ > 2 files changed, 131 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/Documentation/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::<serial>::RPM1 > -What: /sys/class/leds/SRWS1::<serial>::RPM2 > -What: /sys/class/leds/SRWS1::<serial>::RPM3 > -What: /sys/class/leds/SRWS1::<serial>::RPM4 > -What: /sys/class/leds/SRWS1::<serial>::RPM5 > -What: /sys/class/leds/SRWS1::<serial>::RPM6 > -What: /sys/class/leds/SRWS1::<serial>::RPM7 > -What: /sys/class/leds/SRWS1::<serial>::RPM8 > -What: /sys/class/leds/SRWS1::<serial>::RPM9 > -What: /sys/class/leds/SRWS1::<serial>::RPM10 > -What: /sys/class/leds/SRWS1::<serial>::RPM11 > -What: /sys/class/leds/SRWS1::<serial>::RPM12 > -What: /sys/class/leds/SRWS1::<serial>::RPM13 > -What: /sys/class/leds/SRWS1::<serial>::RPM14 > -What: /sys/class/leds/SRWS1::<serial>::RPM15 > -What: /sys/class/leds/SRWS1::<serial>::RPMALL > -Date: Jan 2013 > -KernelVersion: 3.9 > -Contact: Simon Wood <simon@...gewell.org> > -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/Documentation/ABI/testing/sysfs-driver-hid-steelseries > new file mode 100644 > index 000000000000..751cf01ceda3 > --- /dev/null > +++ b/Documentation/ABI/testing/sysfs-driver-hid-steelseries > @@ -0,0 +1,131 @@ > +What: /sys/class/leds/SRWS1::<serial>::RPM1 > +What: /sys/class/leds/SRWS1::<serial>::RPM2 > +What: /sys/class/leds/SRWS1::<serial>::RPM3 > +What: /sys/class/leds/SRWS1::<serial>::RPM4 > +What: /sys/class/leds/SRWS1::<serial>::RPM5 > +What: /sys/class/leds/SRWS1::<serial>::RPM6 > +What: /sys/class/leds/SRWS1::<serial>::RPM7 > +What: /sys/class/leds/SRWS1::<serial>::RPM8 > +What: /sys/class/leds/SRWS1::<serial>::RPM9 > +What: /sys/class/leds/SRWS1::<serial>::RPM10 > +What: /sys/class/leds/SRWS1::<serial>::RPM11 > +What: /sys/class/leds/SRWS1::<serial>::RPM12 > +What: /sys/class/leds/SRWS1::<serial>::RPM13 > +What: /sys/class/leds/SRWS1::<serial>::RPM14 > +What: /sys/class/leds/SRWS1::<serial>::RPM15 > +What: /sys/class/leds/SRWS1::<serial>::RPMALL > +Date: Jan 2013 > +KernelVersion: 3.9 > +Contact: Simon Wood <simon@...gewell.org> > +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/<dev>/sidetone_le > vel > +Date: January 2025 > +KernelVersion: 6.19 > +Contact: Sriman Achanta <srimanachanta@...il.com> > +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/<dev>/inactive_ti > me > +Date: January 2025 > +KernelVersion: 6.19 > +Contact: Sriman Achanta <srimanachanta@...il.com> > +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/<dev>/chatmix_lev > el > +Date: January 2025 > +KernelVersion: 6.19 > +Contact: Sriman Achanta <srimanachanta@...il.com> > +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 = 100% Chat / 0% Game > + 64 = 50% Chat / 50% Game (Balanced) > + 128 = 0% Chat / 100% Game > + > + Access: Read > + > +What: /sys/class/hid/drivers/steelseries/<dev>/mic_mute_le > d_brightness > +Date: January 2025 > +KernelVersion: 6.19 > +Contact: Sriman Achanta <srimanachanta@...il.com> > +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/<dev>/mic_volume > +Date: January 2025 > +KernelVersion: 6.19 > +Contact: Sriman Achanta <srimanachanta@...il.com> > +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/<dev>/volume_limi > ter > +Date: January 2025 > +KernelVersion: 6.19 > +Contact: Sriman Achanta <srimanachanta@...il.com> > +Description: > + Enables or disables the EU volume limiter (hearing > protection). > + When enabled, the maximum output volume is capped. > + > + Values: > + 0 = Disabled > + 1 = Enabled > + > + Access: Write > + > +What: /sys/class/hid/drivers/steelseries/<dev>/bluetooth_o > n_power > +Date: January 2025 > +KernelVersion: 6.19 > +Contact: Sriman Achanta <srimanachanta@...il.com> > +Description: > + Configures whether the Bluetooth radio automatically > turns on > + when the headset is powered on. > + > + Values: > + 0 = Bluetooth must be turned on manually > + 1 = Bluetooth turns on automatically with headset > + > + Access: Write > + > +What: /sys/class/hid/drivers/steelseries/<dev>/bluetooth_c > all_vol > +Date: January 2025 > +KernelVersion: 6.19 > +Contact: Sriman Achanta <srimanachanta@...il.com> > +Description: > + Configures how the 2.4GHz Game/Chat audio is > attenuated when > + a Bluetooth call is active. > + > + Values: > + 0 = No attenuation (mix both equally) > + 1 = Attenuate Game audio by -12dB > + 2 = Mute Game audio completely > + > + Access: Write
Powered by blists - more mailing lists