From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=91.218.175.234 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1793975090; b=x3iDI2uc3EpOwUfyFIiogl3UBtNBC/m8MghRhv8+B/nltrEZFWKotZWg6SHpvRm5m/g1 tnCuQnNaLvm/WVA0J0b4lQ1mHib5D0j8rh+3PjcMOT2tSOsRC1ZZzcjVg09rFNUQGU56t 9mTeQM45My/uxqaSDF6bPyY4zXSkOWeVBiWt7qXyuAbWy97Ffe6haYeuXRTKMX8g3tRbc n1OPtjYIH6lpJOAnffEetlYVLQGotTTpEq2XN73q0cZql99HAB806VqMgIZvKKVg184XX apjtubBafmh349tykVXMrwgKzoei+XKv29w9rfEJR2FYOWTkc9ULNTJo7e7Q+k3SWJQ== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1793975090; h=DMARC-Filter:X-Envelope-To:DKIM-Signature:X-Envelope-To:Received: X-Mizu-Trace-ID:X-Migadu-Flow:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; bh=5379CRQJx8I15aivicNrF0oYqHlT2w74jNzhiFSUHZA=; b=l3G+zKuBUy+qCNsGoCz1tK64AsuaA1V//vWBmvXNQRHQbx+/+0029fPE9jU2SIxcdFZd ZW1AvYAtsDhWw9ou5+G2Wc1kuWOKWmcnGXV8FHOLZXC/YAFtxql185rzuJTkKJO3/dgp1 Ui/IhrRmL9G5L1IPqgDho+phgsqvWPtiEQ6fgGMQyN7EmoJMLYAJLLc0GPF8qZI0W+F9P TDwmyqkA/oVUqbRZGLiHFlv84xhluDHuonUNtxNXTUZXUiMYKd7cdHs6NkDaScpKJKWYp IfL6Qetw8hxQtQEs7689PZLF9CxQ5YEKqLCENeubvCDGb994QC9O8EVYH6htJvyaLaA== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=linux.dev; spf=pass smtp.mailfrom=linux.dev; dkim=pass header.d=linux.dev header.i=@linux.dev header.a=rsa-sha256 header.s=key1 header.b=WrmROsrZ; arc=none smtp.remote-ip=91.218.175.234 Received: from mta0.migadu.com (out-234.mta0.migadu.com [91.218.175.234]) (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 C68C1606D821 for ; Fri, 6 Nov 2026 14:24:49 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org C68C1606D821 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.dev Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linux.dev Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key, unprotected) header.d=linux.dev header.i=@linux.dev header.a=rsa-sha256 header.s=key1 header.b=WrmROsrZ X-Envelope-To: linux-kernel@vger.kernel.org DKIM-Signature: a=rsa-sha256; bh=PzuoZhu6Eoqymm75/Wmyv8NSmRksFQncwoKiOhcjjSQ=; c=simple/simple; d=linux.dev; h=from:to:subject:date:message-id:mime-version:content-type; s=key1; t=1793975087; v=1; x=1794579887; b=WrmROsrZ7/7s/Oc78IgKATwM6M5li+OQEtIhZiLWIg0673S5RK7pqNvdxe2bZV92ZS0yopWn NKJlIBlXPz2aPi4+bYSQ3tMOxyd2RqPZsx/Xn8kmLph7WvQk854EtHVgCne3O9X0foy9E+G5+is hbx3wGz815v0u9BRcpQ1EM08= X-Envelope-To: linux-kernel@vger.kernel.org Received: by smtp.migadu.com with ESMTPS id 190aad73d1cac137; Fri, 06 Nov 2026 14:24:47 +0000 X-Mizu-Trace-ID: 190aad73d1cac137 X-Migadu-Flow: FLOW_OUT From: Denis Benato To: linux-kernel@vger.kernel.org Cc: linux-input@vger.kernel.org, kernel@lists.opengamingcollective.org, "Benjamin Tissoires" , "Jiri Kosina" , "Luke D . Jones" , "Mateusz Schyboll" , "Denis Benato" , Denis Benato Subject: [PATCH v14 15/18] HID: asus: document ROG XG Mobile sysfs attributes Date: Fri, 6 Nov 2026 14:23:31 +0000 Message-ID: <20261106142334.1881-16-denis.benato@linux.dev> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20261106142334.1881-1-denis.benato@linux.dev> References: <20261106142334.1881-1-denis.benato@linux.dev> 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-Transfer-Encoding: 8bit The driver publishes the station's model, serial, mainboard identifier, part number, firmware version and hardware generation as read-only sysfs files. Document each file: when it is created, what a read returns, and when that read is an empty line. Signed-off-by: Denis Benato --- .../ABI/testing/sysfs-driver-hid-asus | 95 +++++++++++++++++++ 1 file changed, 95 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-driver-hid-asus diff --git a/Documentation/ABI/testing/sysfs-driver-hid-asus b/Documentation/ABI/testing/sysfs-driver-hid-asus new file mode 100644 index 000000000000..30e0d17d4cec --- /dev/null +++ b/Documentation/ABI/testing/sysfs-driver-hid-asus @@ -0,0 +1,95 @@ +What: /sys/bus/hid/drivers/asus//xgm_model +Date: October 2026 +Contact: linux-input@vger.kernel.org +Description: + Model of the connected ASUS ROG XG Mobile station, as + reported by the station. An example is "GC33Y". + + The file is created only for a supported station, one whose + model name starts with GC31, GC32 or GC33, and only while that + station is bound. + The value is one line and is never empty while the file + exists. + + Access: Read only + Valid values: a single line of text + +What: /sys/bus/hid/drivers/asus//xgm_serial +Date: October 2026 +Contact: linux-input@vger.kernel.org +Description: + Serial number of the connected ASUS ROG XG Mobile station, + as reported by the station. + + The file is created only for a supported station, one whose + model name starts with GC31, GC32 or GC33, and only while that + station is bound. + The read is an empty line when the station did not report a + serial number. + + Access: Read only + Valid values: a single line of text + +What: /sys/bus/hid/drivers/asus//xgm_mainboard +Date: October 2026 +Contact: linux-input@vger.kernel.org +Description: + Mainboard identifier of the connected ASUS ROG XG Mobile + station, as reported by the station. + + The file is created only for a supported station, one whose + model name starts with GC31, GC32 or GC33, and only while that + station is bound. + The read is an empty line when the station did not report a + mainboard identifier. + + Access: Read only + Valid values: a single line of text + +What: /sys/bus/hid/drivers/asus//xgm_part_number +Date: October 2026 +Contact: linux-input@vger.kernel.org +Description: + Part number of the connected ASUS ROG XG Mobile station, as + reported by the station. + + The file is created only for a supported station, one whose + model name starts with GC31, GC32 or GC33, and only while that + station is bound. + The read is an empty line when the station did not report a + part number. + + Access: Read only + Valid values: a single line of text + +What: /sys/bus/hid/drivers/asus//xgm_firmware_version +Date: October 2026 +Contact: linux-input@vger.kernel.org +Description: + Firmware version of the connected ASUS ROG XG Mobile + station, as reported by the station. + + The file is created only for a supported station, one whose + model name starts with GC31, GC32 or GC33, and only while that + station is bound. + The read is an empty line when the version query failed or + the station did not report a firmware version. + + Access: Read only + Valid values: a single line of text + +What: /sys/bus/hid/drivers/asus//xgm_generation +Date: October 2026 +Contact: linux-input@vger.kernel.org +Description: + Hardware generation of the connected ASUS ROG XG Mobile + station, as reported by the station. + + The file is created only for a supported station, one whose + model name starts with GC31, GC32 or GC33, and only while that + station is bound. + The read is an empty line when the version query failed or + the station did not report a generation. + + Access: Read only + Valid values: a single line of text -- 2.47.3