From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=209.85.128.48 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1793231575; b=NTN08W/JEZZ+df9TDPC8BRSZMpCPMi+BK/QBQLvgnNcVmXWPx/BCfISyo0kgJ6+hRKVl Pl92kNQWtTONue9xFfEQj8QRn3/0NGnQgZHzLoJijqX8XtihhH4fnVxHpAV3Q0pnAB32f 31yYbq4Ad8E4oLXhrap2Ca9GUEyMPkNfuFu4dLPIphmgFhL4kt5zGD8rAhVDJVwcPlagx y1YlMCrGGJcRf3zK5kBSuM54AFYIYxnX/UzuMzmYFI7BBLWtfx+H/mh8QbW1zb1W61gIb LDGLwdO5stHmR4I999/OVovRgppWHvKcr0VNE/GGfdRSCqAUee1u8GjPVHXJ+nBwm9Q== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1793231575; h=DMARC-Filter:Received:DKIM-Signature:X-Google-DKIM-Signature: X-Forwarded-Encrypted:X-Gm-Message-State:X-Gm-Gg:X-Received:Received: From:Date:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding: Message-Id:References:In-Reply-To:To:Cc:X-Mailer; bh=NShZ2F0kBjLdK/kOL2KImL5dsxE3V0Ajk4CzI2p8lPA=; b=OpryzC5dQzbu2wb4PDNdRURxr808BiF930VoNVII/SNPjKX69SAts9m5GCZsbPT1dnYL EEWfLcT8BZfIzdcRCrdPB4d/ylQnwc5GV1MxUuVIEZj3DmJo8EAnP6yWYlH4EVpytkS17 ndgWFB/9Tp4SyT34I4qwGKyS5OpLAB0CZgDYJOnneA2R2MZOPcBLYkdmmXRdDyQsWs7FH R6sKAkBrKzsmnAqbxLmdN+WSuWT62W9FDLPv6bnp5sMleAzddWBIwrWA/9G/Cylnrfzve USZdp+8ksPuqPqBXTVjRltNK3RBVmxKWJbT33RzVctEsNLBEBNdQVauS/AB31chMSFg== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20260707 header.b=ObkCEo3A; arc=none smtp.remote-ip=209.85.128.48 Received: from mail-wm1-f48.google.com (mail-wm1-f48.google.com [209.85.128.48]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 0B44060A2604 for ; Wed, 28 Oct 2026 23:52:54 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 0B44060A2604 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, unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20260707 header.b=ObkCEo3A Received: by mail-wm1-f48.google.com with SMTP id 5b1f17b1804b1-4a9a8d6cea8so2092085e9.1 for ; Wed, 28 Oct 2026 16:52:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20260707; t=1793231573; x=1793836373; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:from:to:cc:subject:date :message-id:reply-to:content-type; bh=NShZ2F0kBjLdK/kOL2KImL5dsxE3V0Ajk4CzI2p8lPA=; b=ObkCEo3ApCzCdBf4QLwsQw/gIczNDklONgJYDnqaoOVsGgVKSXJd1tmG+Fb9fp36Xf IehrQMgYCyhhPhaLmhhcKSOrjNJvduh5BBlwvzyJWINxNfc4D4egOaL+ipRrR4BMopOo pDXhxZhRFRaST0XknNmt7hs5S80V8oJkGKD6Nnwh5WxsPB3iaqnSqeXqLWT+gv8ud4U6 h8k1gtTDdl9XqbTz4X42aMDBoVrbWk+L/OlKYbvkBgloVrKIgN0DDv91RCKwfpgmG3RB P/li0F84zo5DTVY80qFPH+ZeihHTt9xqd6jLQ9QLdb+IMVnNAtK9gGe1YhG8vuU1LsuR wQZg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1793231573; x=1793836373; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to :content-type; bh=NShZ2F0kBjLdK/kOL2KImL5dsxE3V0Ajk4CzI2p8lPA=; b=DQAC97UuvuHwS4rBR4MoIT3mT8DU9hZcENJTcgUjZQgj2M6lFNzzScXy4vYdPF+K0m 1CACUarVAdwXgqu6VbMLytOmhOvNbNeZm6nO9VJ34UEmzxaKQoRCqKbNXYvXrlrv8ZrG bOMC2eJ4CqS7dK2YiKjwXKt2G88JI7w6YTBJflEOrKwWbdoSOhVSltS/9j+y4857sHza MlLvZriLl67qaAmyN76c1NJUPKdEUe+wW6mdTX85iUAf/h2wMNZc0x3oLdP0ShkIF+J1 H9eWjI2x+8m+4bN3eiviQXaT+5KQrEcenGAWjloF1WRKB5ntNCW9M0JsmehVYFMIO8Kd U26Q== X-Forwarded-Encrypted: i=1; AKwUvBwCTjwSzOZurpZXqNmRiEAMk0avpzlJBCAdgNeKQ5GjNYK0KiB3hkRuia6HBFt1a4fwBfemH6l/DaGYa7Q=@vger.kernel.org X-Gm-Message-State: AFq9FYKGrPgiZZfE7qPDto+IW6ab1OYNvZSOpvjaEtzvF4E+pQIp64ok r8JOpdP1TvWkKEqWEdI97Ug8rM1V/slWT6ikU2oewk4U85diHj9d/RxWc7Y6AZF7 X-Gm-Gg: AYBFou21nY+/A2pMmo/VWHEFqjz/x1HIe6udHYGjx1q9S77XJ2ok4kR0GJFKLgy3+qh lTKG0O5t+bPwVsbeq6FrimaX9m1yNr4h06g0u3e+vszSWxeRkaSMCOcr0oKn2HMOj1nBVEccG1y m+yW1Rf4oPAtuB/e6xfziaGk8/DhjqhGqMGLMRvF7aVgIuicsLDH9TbTa6R4Z5GLuctROPDj4MO 3vqocftCOYQu9+VKl5M61P6wpvhVgmqpiOeVEaHzwbVgDd9OKf1ZEPBSs+KL+BHOzKnZ02YkT9r RVPKc8owM11SO03651NFCvAEjX0HDN/Biiycuxbv2Oe2mmcLPxJ/5UpuHXQ4eb4t7vHlDMQteq0 nwjsaz+3BWPq1eKs2VL/EUr/0K/gpe1SFLBDHh28igMJRafoc2tDJjh7Xq6oLEjgcAazOTESXJU ebDA/mKZhks/KTJgXRaTlSCcNeyAhZKyivtXrNvbGz/0grNvEAUx872LzLGIhnzk/SviwHfwMTS RecYH+oD4NTvhIvzxRSw3hdeKTYYksjCWNhumtDHyqVvPBl45hmS5+furtc0H+KxMVrg7pbLczj UeoK2kpTEA28LUVhRITApETugVA= X-Received: by 2002:a05:600c:621a:b0:4a2:10f9:37db with SMTP id 5b1f17b1804b1-4aa871e8be0mr25693755e9.7.1793231573393; Wed, 28 Oct 2026 16:52:53 -0700 (PDT) Received: from [127.0.1.1] ([85.105.252.11]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4aa80f04785sm23669055e9.4.2026.10.28.16.52.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 28 Oct 2026 16:52:53 -0700 (PDT) From: Bartu Alev Date: Thu, 29 Oct 2026 02:48:52 +0300 Subject: [PATCH v4 2/2] Documentation/ABI: asus-wmi: document TUF keyboard RGB attributes X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20261029-asus-tuf-rgb-v4-v4-2-0d3b877d2c30@gmail.com> References: <20261029-asus-tuf-rgb-v4-v4-0-0d3b877d2c30@gmail.com> In-Reply-To: <20261029-asus-tuf-rgb-v4-v4-0-0d3b877d2c30@gmail.com> To: Corentin Chary , "Luke D. Jones" , Denis Benato , Hans de Goede , =?utf-8?q?Ilpo_J=C3=A4rvinen?= Cc: platform-driver-x86@vger.kernel.org, linux-kernel@vger.kernel.org, linux-api@vger.kernel.org, Denis Benato , Bartu Alev X-Mailer: b4 0.15.2 The kbd_rgb_mode and kbd_rgb_state attributes predate their documentation: they were introduced as write-only interfaces and never received ABI entries. The readback support now being added makes the omission visible, since the read format is part of the interface. Describe both attributes, their positional write formats, the write verbs, and the readback form. The attributes are gated on WMI device presence rather than on the laptop model, and userspace tools route several non-TUF ASUS lines through the same devices, so the description says ASUS laptops that expose the WMI zonal RGB devices instead of claiming TUF models only. Signed-off-by: Bartu Alev --- Documentation/ABI/testing/sysfs-platform-asus-wmi | 46 +++++++++++++++++++++++ 1 file changed, 46 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-platform-asus-wmi b/Documentation/ABI/testing/sysfs-platform-asus-wmi index f9825c6150b5..23e5f265f722 100644 --- a/Documentation/ABI/testing/sysfs-platform-asus-wmi +++ b/Documentation/ABI/testing/sysfs-platform-asus-wmi @@ -238,3 +238,49 @@ Description: Set if the MCU can go in to low-power mode on system sleep * 0 - False, * 1 - True + +What: /sys/class/leds/asus::kbd_backlight/kbd_rgb_mode +Date: Oct 2026 +KernelVersion: 7.4 +Contact: Bartu Alev +Description: + Controls the keyboard RGB lighting on ASUS laptops that + expose the WMI zonal RGB devices (the kernel names them + "TUF" for historical reasons; TUF models have them and so + do some other ASUS lines). Writes take six positional + values: + + + + cmd is 1 to save the setting to flash or 0 to apply it for + the current boot only. mode selects the animation, 0 is + static; mode 9 and modes 12 and above are sent as 10. red, + green and blue are 0 to 255. speed is 0 (slow), 1 (normal) + or 2 (fast). + + Reads return the current hardware configuration in the same + positional format, except the command word, which reads as + n/a because it only applies to writes. Reads fail with + -ENODEV on hardware without readback support. + +What: /sys/class/leds/asus::kbd_backlight/kbd_rgb_state +Date: Oct 2026 +KernelVersion: 7.4 +Contact: Bartu Alev +Description: + Controls when the keyboard RGB backlight is lit, on the + hardware that exposes kbd_rgb_mode. Writes take five + positional values: + + + + cmd is 1 to save the setting to flash or 0 to apply it for + the current boot only. Each flag is 1 or 0: boot, awake + and sleep enable the backlight during boot, normal + operation and suspend, and shutdown keeps the backlight lit + while the machine powers off (S5). + + Reads return the current flags in the same positional format, + except the command word, which reads as n/a because it only + applies to writes. Reads fail with -ENODEV on hardware + without readback support. -- 2.56.0