From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=209.85.215.182 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1792803130; b=XxTRz4BM8LuYmoLZ8UYMWfOd3ZZMwSF9GL8Fq189vjW1WRqrKY4Cs/AdPVm5VTwXN64X CDtQakLYb+bvvqFuo3Ff7SMVupqRlmXcLiyDwH5OedhLAOFEsVioLhzrjtaLg6irpZ7Cf oqu5CvrLn3dmdv8AGq+j4QE3C6bBWnrGDC7BdeUfTCYcsUQ1tziwQ21Kh3xISDOXFHNqn /6pKvxZo/QXM2X5vlk9sAPGP735zwQ1xg0T55Ibxhbhzk/YrOZHkuJCs2CXFww5iy7axm lLRaGNk9vN6zWHyKVA23D6BtFdLv0kita22311pVzHvxi+NF8bEUwDzPE344wiI/nxw== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1792803130; 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: X-Developer-Signature:X-Developer-Key; bh=FOqWh0YVIMqSNQR+C9AUSAav6J63QCzsPs/EWmskesI=; b=TyqivVb3HZVxtrcUNdPoYabQ4DJGFqMQ9Al6gAoV+NeEXAGvcHz/oqNdpfuxb6zbVYp1 xCUehlYqDXzVPsUKtd+udbM9vmda91lOQNS0F9gKPKbrFxS8mEyR25yjrL+8JfpqLTu7a 7SqdbQaG7axzEYLzI4l4pquO0OxEzDqJfU1bTa9e81k1GH/Sxn+OmB06QcV7oI7xhGdde FLF0fCPNMO2ADMMXEXSw9Yykzvuef3zFQ5uu+MfYr/8N8EXBNmGMK27Zzwlkn7sK6ai2m rdJJCOnzBDWxLFGMY+MGMoXkeMKRzR5VAtgNDj8T1xebGRGcU9pzgJaKa24Np/1vuog== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=chromium.org; spf=pass smtp.mailfrom=chromium.org; dkim=pass header.d=chromium.org header.i=@chromium.org header.a=rsa-sha256 header.s=google header.b=dXuB4Hch; arc=none smtp.remote-ip=209.85.215.182 Received: from mail-pg1-f182.google.com (mail-pg1-f182.google.com [209.85.215.182]) (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 7C1B560A2624 for ; Sat, 24 Oct 2026 00:51:58 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 7C1B560A2624 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=chromium.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=chromium.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key, unprotected) header.d=chromium.org header.i=@chromium.org header.a=rsa-sha256 header.s=google header.b=dXuB4Hch Received: by mail-pg1-f182.google.com with SMTP id 41be03b00d2f7-cc147d86bebso677490a12.0 for ; Fri, 23 Oct 2026 17:51:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org; s=google; t=1792803118; x=1793407918; 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=FOqWh0YVIMqSNQR+C9AUSAav6J63QCzsPs/EWmskesI=; b=dXuB4Hchn949TxwwrxnOqWrN7tFQqf8FYrosr0zcDvftQEXUenfgHn60BVKN0n3e9j fPhI1ylzo3uVaSGq2wfYuA5lesY5wZNd6r+UxMymP/Ln7yips+8XEPVeWsE2gJD6dApk CrJKThWRC/bMhsVKBj5xusQaQGD3wp7ppjIc4= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1792803118; x=1793407918; 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=FOqWh0YVIMqSNQR+C9AUSAav6J63QCzsPs/EWmskesI=; b=ZwctJMpfIp2Mpib1UBJrLBMhesp6JSUmCL6opw+qiNYA51lGEtwHya6/4AP9+zWlEN kdUU2QIfuf6JJ/+3FbJTq0ZOcuTorXNPuIOFp50w6YYrSkweTe8khYSgbqJZdQrm5mlj 3lLlawjgxrsae/D1RDz3Ps+HMUUPhLvT298iGik8zx7SUcw1j/N8tdfNmEKD4lHkHf+S J1mPSr6GAceSIVvyAZp20N5q23nn0rJgjQ9rebKnN1celNCMp6lQOSXJpHfN+RlIK22q gcN9Ge+igiReRWjQlbvpYobsDOLJRgZGFmum/gXCMtS5HDLJW4ZstG1dQyIc1s0egqIR TRIg== X-Forwarded-Encrypted: i=1; AKwUvByM1/i5m4UTUD7o3VyzMvWd+yrQa5oFkJMUywtUwnqsf0Pgg8aOUIkGNWRLSy5bbdK5x39bmEWN7Dib0YmYu+Gv7L0=@vger.kernel.org X-Gm-Message-State: AFq9FYIOjtW8Zd8b0c+xed0USV2HRaQIfP7ImdqYGK9EueXQmCHf5jL1 HHTPeHnAiJCsBb4tgyVo+4TpJlHYIhpDVu162D3D557pxFFbrDUNsyltGEU+hDp0ApsSxbR5dv4 Obfo= X-Gm-Gg: AYBFou3oBrj4EoaiYxjRXioxkU45S5PIqFCulfO1rtNGJp6dv2NxnPukcZQTpu7u++l y7EUN6+5pUoBdzdImk1qbKweBP4lwLOVS2XJmfcd5z9dA0ZCNeQzdzqcxUE/qw2UUaeIpHhRoq5 m5RTM4niHb1btyf/Iqx9rdk9nh7FE9bOfZ/RDAojJLwVdnd0q1dIEIS53H/x9TYiIcJNGkdpiX6 CfEUMVguqvsLOMbmK87C/CyJGZz+muVrkd2eWa1CwUvqvvguwomiGfnQJ119l6+gZk59RuMm4a5 d44exLfCMfdbqOYBM3F0DCGw7fvAZe8OONHmuNx3j1lKJM0d8r4IaAJ6RHJqee9ghY3W7uuEupD xug9guU1+98sJ5uI4pNckRSy1n8NCyiHJ7HkSHfrRSgr5+LTdQizghzN85fiBU+4RCIlMz9l56A Lc+DWfledWc+mvG5ELZPDw71SeXz6bcC1dMUgA9UhqeCie0N6wABC29SdPNFQw3aZsVmUG6W6yC 2ivoItN4hzhgX+Cc5xhOtvT5Zs1Tl348RL37wJwnk9sTLOv2ht4JZI42skLqzTRcWqIRl9p/2t2 VBW7bGHTX/bEYZkLHsNVY67kIqlgjyC9h7J/47Lm81nw6neqpBsx8p98Y+0IajE= X-Received: by 2002:a17:90b:6c8:b0:3ad:ba54:c3d6 with SMTP id 98e67ed59e1d1-3adeb3aa756mr451535a91.1.1792803117836; Fri, 23 Oct 2026 17:51:57 -0700 (PDT) Received: from jingyliang-input-linux.c.googlers.com (218.117.230.35.bc.googleusercontent.com. [35.230.117.218]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-3adebadfeb1sm843763a91.9.2026.10.23.17.51.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 23 Oct 2026 17:51:57 -0700 (PDT) From: Jingyuan Liang Date: Sat, 24 Oct 2026 00:51:42 +0000 Subject: [PATCH v7 08/11] dt-bindings: input: Document hid-over-spi DT schema X-Mailing-List: linux-trace-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: <20261024-send-upstream-v7-8-abad13174b43@chromium.org> References: <20261024-send-upstream-v7-0-abad13174b43@chromium.org> In-Reply-To: <20261024-send-upstream-v7-0-abad13174b43@chromium.org> To: Jiri Kosina , Benjamin Tissoires , Jonathan Corbet , Mark Brown , Steven Rostedt , Masami Hiramatsu , Mathieu Desnoyers , Dmitry Torokhov , Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: linux-input@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-spi@vger.kernel.org, linux-trace-kernel@vger.kernel.org, devicetree@vger.kernel.org, hbarnor@chromium.org, tfiga@chromium.org, fqwqf@fqwqf.xyz, daleyo@gmail.com, Jingyuan Liang , Dmitry Antipov , Jarrett Schultz X-Mailer: b4 0.14.3 X-Developer-Signature: v=1; a=ed25519-sha256; t=1792803111; l=2819; i=jingyliang@chromium.org; s=20260213; h=from:subject:message-id; bh=LKvYa/CLhKW+YzjSrs/NoZ9wb/gOcKYEJBUJ8orknbs=; b=dsZaqSkAfRPlQsBnAlhhKrVeQzXIS3bZOeQJ5YOz7fnco+9KGbTAo5yazXZtfLMbg3/nVpvgb XOaIb5Tfds/C784G7HjUd9pqWsagfxfpzdw8j+o9DFF+ntj2LIpYQjX X-Developer-Key: i=jingyliang@chromium.org; a=ed25519; pk=VTYSdqslTtYOjWWoIGgYoWupGWqNSidrggReKMgfPo4= From: Dmitry Antipov Documentation describes the required and optional properties for implementing Device Tree for a Microsoft G6 Touch Digitizer that supports HID over SPI Protocol 1.0 specification. Signed-off-by: Dmitry Antipov Signed-off-by: Jarrett Schultz Signed-off-by: Jingyuan Liang --- .../devicetree/bindings/input/hid-over-spi.yaml | 75 ++++++++++++++++++++++ 1 file changed, 75 insertions(+) diff --git a/Documentation/devicetree/bindings/input/hid-over-spi.yaml b/Documentation/devicetree/bindings/input/hid-over-spi.yaml new file mode 100644 index 000000000000..bed0746f004c --- /dev/null +++ b/Documentation/devicetree/bindings/input/hid-over-spi.yaml @@ -0,0 +1,75 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/input/hid-over-spi.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: HID over SPI Devices + +maintainers: + - Benjamin Tissoires + - Jiri Kosina + - Jingyuan Liang + +description: |+ + HID over SPI provides support for various Human Interface Devices over the + SPI bus. These devices can be for example touchpads, keyboards, touch screens + or sensors. + + The specification has been written by Microsoft and is currently available + here: https://www.microsoft.com/en-us/download/details.aspx?id=103325 + +allOf: + - $ref: /schemas/input/touchscreen/touchscreen.yaml# + - $ref: /schemas/spi/spi-peripheral-props.yaml# + +properties: + compatible: + enum: + - microsoft,g6-touch-digitizer + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + reset-gpios: + maxItems: 1 + description: + GPIO specifier for the device's reset line. The HID over SPI + specification requires a dedicated, host-driven, active-low reset + line. The line must be flagged with GPIO_ACTIVE_LOW. + + vdd-supply: + description: + Regulator for the VDD supply voltage. + +required: + - compatible + - reg + - interrupts + - reset-gpios + - vdd-supply + +unevaluatedProperties: false + +examples: + - | + #include + #include + + spi { + #address-cells = <1>; + #size-cells = <0>; + + hid@0 { + compatible = "microsoft,g6-touch-digitizer"; + reg = <0x0>; + interrupts-extended = <&gpio 42 IRQ_TYPE_EDGE_FALLING>; + reset-gpios = <&gpio 27 GPIO_ACTIVE_LOW>; + vdd-supply = <&pm8350c_l3>; + pinctrl-names = "default"; + pinctrl-0 = <&ts_d6_int_bias>; + }; + }; -- 2.56.0.257.gf7497c7d27-goog