From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=91.218.175.235 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1793975090; b=Xh44hYGDVuh4qRIsqs2xmYh435KrpaigYtJhW+YleqDfuWVU+WNZAZv1RmCqQs0L5rsU LApAHM3phDWWlHIcMysn4uqFPDS2ysya2C8Qo3Pwix3DxXdkRoHSpnsINFybb9qU6CoWK Z0FLlOt3hOLpkH6ZCIsJ/Tdx2YNZLqoIDQw64pBGBipiR/pl/2xFHoh70NoC+JfkHgJgD QPRMfwRxqzVvs0MOOqcMV8+sGPQn1jH/8nOfm8BrTT60Dwe48q4OnSS/Lp1iPaIiz/nez qK03QRj7mdF5kHMexY8ubucp0DfYFPcjnYC96I3A6+rwyaENmsBVHmVUr7/8o135t8Q== 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=uQ9FKlDg3OSsohko0nQ+qvemiBl5X8uNr/SRHzBjv9y+RtA4+YVVQXVENmaCJyFLlirT 2NAw87EQjseBgEynus/bDBxrwkKjOPuhEEDwZ4jxhGHlrM+dybRhiBkZOouMoj+GUJvE9 riUDgqsWc6qzfxiZftsrJTOQVOK8X/qOSuaG0yZjQBAP+5JbPIj/Ro0O+FVqkMSiG98zE TzvqkSip7x1FEZjgBiOqddTLCCA6aEXrUJRFrGn36Xhd6KRtcJ5KdjtE8mtKbxD41zk82 Xzm39GxDDyhmzBtppap9hX5ow486hGDw1HputPUZlzghMu0w7GUoWPEUqZW341sD0Ew== 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=MI7xQOeB; arc=none smtp.remote-ip=91.218.175.235 Received: from mta0.migadu.com (out-235.mta0.migadu.com [91.218.175.235]) (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 C45BD606D820 for ; Fri, 6 Nov 2026 14:24:49 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org C45BD606D820 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=MI7xQOeB X-Envelope-To: linux-input@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=1793975088; v=1; x=1794579888; b=MI7xQOeBDoh1PwFwS/+m2ShT9Y7NIYrRP5WKrSxCRyfRTOCssyERkuN0Rqkvut0nCbOPjWW9 5uwSMVMPF5wm0bVETL9c0w79mO1vtP7yldhagAyOYDEa8kLUU12q5/pwzRFrkdOD3dmIacJ53ye 7l7dLL1RYDE6UhTCYIKjPP5Q= X-Envelope-To: linux-input@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-input@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