From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wr1-f43.google.com (mail-wr1-f43.google.com [209.85.221.43]) (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 5B3FF3F9F50 for ; Sat, 10 Oct 2026 10:17:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.43 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1791627433; cv=none; b=P30tkRTt1cJIwiO9A3/TfUBF+BoX0oTXTe18Zqj9xLB4FytW7G4Fhm2s2YTJZOGK2Fu6bEXSGvCqGlaabZ4pYTUqTZcBcpMlgN+U2zxi1UvcpAMnBoa/9KHmPGVjpNtOhdUmsAeql/MbjZUEOT11lPw1XavZT4T8MdXMC9EtnH0= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1791627433; c=relaxed/simple; bh=J6vDvjbCk7MX9LMkq+wxze1fd6NDlSnZqCj5f9c4+ho=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=YIPcWfxb+NbsHFvZUr6VxMdK8jPGzgGuhw+8wG5wkRKRn9Qbl8AcW3p97/DL3qKwLC+ootNE1C9oyYFEES+NEmOlR/wjAFnQj7S2JMnFTtfcLcWCv4W25HgbVsg/ECtsZF2x9Jq0Eb6yxGrZJ0dUuDjLYMrPagrfSKDbIosXERo= 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=K+9UkMdt; arc=none smtp.client-ip=209.85.221.43 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="K+9UkMdt" Received: by mail-wr1-f43.google.com with SMTP id ffacd0b85a97d-48b0ef9c76eso414192f8f.0 for ; Sat, 10 Oct 2026 03:17:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1791627423; x=1792232223; 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:content-type; bh=Pmb79NaTW27JYmEVgkO6fhUqLko5WfA8ujw653XjoMk=; b=K+9UkMdtgssN7RUKlVEm7ikmSWN2s3yOAKc+5Go4e1PbOlqFF7cwQL3r7zJnLWV6To N7j6YMVRHhio2Ettd7pXnu17pNVN++uYYNbXlcCt0YaU9+PgqBWZVwjTnxHJQyb1UXUi kMKBUuA3K7SB46uNUzQr+Euyi6iXxt0gu9RTv+Lr7W94vrlN5LQEuUSgkCrlg8MvV0db ItvFR+FAWVKQq/XKbrq1+p1Zqy8nY0GYBwGtUmHOpk1BTLHB2dbJEWs8zZjgPycKgLuq YL5NVnrs78WFs2U+X8XyAuZ8FWqX89LZ+w5QW/UwERll7PURNmBTsS0gkKxyYdIGOsUS PxMw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1791627423; x=1792232223; 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:content-type; bh=Pmb79NaTW27JYmEVgkO6fhUqLko5WfA8ujw653XjoMk=; b=NXVSs3nT//gRBy+t0lri/z/1SKypC2dhIEP4w38FSo9LTxWv3hXy1W9lAz8rYZN6IT eAFlf7b85tuwQN5bSLLepGkeMg+JooQDPXSeqBPo3lzwkbIdf2EMxdWdM0ykVj9WwKfp 83eTELEhTAQyyWMABD8U0mQTuhOHt+K0jDkLH9nXzV+jiekQc/fsMtqIZJYhh7dECAOX 8Ib5nwlcnzLt0aKX9cNBk+7eS8edZgNrIOk0fBht5568JxT5UyUtRs5eFEFbLw6Afvqh mwg4lx0qZTeqOWmLc/W1jIc7TGhU/IvCZaBP8+i0q+JOfCeubXG4jq20Q9nf1rzWIJU6 ji0g== X-Forwarded-Encrypted: i=1; AKwUvBwMuwaVqEeEV0u8UeBnQQvXhSLTZqwHXnoVdi+pFLdiQvmvJvGFlpGskDIj9WXlzfVAPAltjtJYtluZHnc=@vger.kernel.org X-Gm-Message-State: AFq9FYLn33zd8+S67Cs/0cRNCXeAGc5DuKhQWBt8+rmDnFDJ5wFPcovR acAKdgwQZ0W3zvoKzXiYGuDsQjcW0uvauCVL1fkNU6caxD5HT+GLPvAC X-Gm-Gg: AYBFou1M/q73gT3yp4AHXcvVeGVYJO3E+iHpUXWi+uWHn3XkmciNjDZvM5I9+k2ElZb 4R4cMJqmDW4tCCYPc+QkdVK9Q9HQXsG1x+iuqOT/8qAwSwNp27QMSpSJlCzZfUYamsttOAyhH+Y k+CuQRm5+cabWEv3FPQsZdEMWxJQuLovrBmecWDzp2Cj3p8+9/ccNf5zjLojSD9ZD/CUl+Qd7km PyW6V/gH1RH7ueKZp3OkcddFpm5lviyGF0HXTRnbi73OKkSsJSh4nFMVhHM8XLoo6+ZOx3/8gr5 M85CgraotQrGPFyPsnIl3982GPj6rv/VsDh5VUx7+mEr/puL5ZAPTXXdYbVwUX2BLJXrrAtAbg7 ruoGc4yKhu3j56t8d50h3o4VhLrE4yRZSNvah8Ij5L1GvY+jlIC3myZZxm039OepCP4NX5fSBb6 U6bWSaLRht2hNhM5XIDJHbCr5et47WAY+Bgrs/cPnL+7wrEs+DLFB6VDwgrtIG X-Received: by 2002:a5d:5386:0:b0:487:767:b301 with SMTP id ffacd0b85a97d-48dbacd94c0mr6289963f8f.57.1791627423442; Sat, 10 Oct 2026 03:17:03 -0700 (PDT) Received: from ASUS ([85.105.252.11]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-48db98c38f4sm9417856f8f.27.2026.10.10.03.16.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 10 Oct 2026 03:17:02 -0700 (PDT) From: Bartu Alev To: platform-driver-x86@vger.kernel.org Cc: ilpo.jarvinen@linux.intel.com, hansg@kernel.org, luke@ljones.dev, denis.benato@linux.dev, benato.denis96@gmail.com, corentin.chary@gmail.com, linux-api@vger.kernel.org, linux-kernel@vger.kernel.org, Bartu Alev Subject: [PATCH v3 5/5] Documentation/ABI: asus-wmi: document TUF keyboard RGB attributes Date: Sat, 10 Oct 2026 13:16:01 +0300 Message-ID: <20261010101601.888709-6-bartualev@gmail.com> X-Mailer: git-send-email 2.56.0 In-Reply-To: <20261010101601.888709-1-bartualev@gmail.com> References: <20261010101601.888709-1-bartualev@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: 8bit 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 --- .../ABI/testing/sysfs-platform-asus-wmi | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-platform-asus-wmi b/Documentation/ABI/testing/sysfs-platform-asus-wmi index f9825c6150b5..c63e7cdaefb0 100644 --- a/Documentation/ABI/testing/sysfs-platform-asus-wmi +++ b/Documentation/ABI/testing/sysfs-platform-asus-wmi @@ -238,3 +238,45 @@ 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, with 0 + static; values of 9 and above 12 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 + format, with the command word fixed at 1. + +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 format, with the + command word fixed at 1. -- 2.56.0