From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=209.85.214.181 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1792803130; b=QeKsvDbfVSqRXU32A8vgsZQrbVK7M7n3eLHT+ZR8uHm8/hMtJ0Pg5SXgRYZ1zQl0jk7D cTLHbgid4d7bY8O5tAm6jtYzMQaI52YvpiS1UuJ+nu7XiA6AhvZn2UN7Z82a88rbGdu9X x0NCVQYAZa3pGKazO7EhDbJV4zXXjb6CC2GKp7YIYBCXiyBXZAklgLy7qVrHcaURKv89/ cS5iaV3K+M3kAbp0F+8Ds8BTpJRciGsmuphbdMqEod6QbAullizSCP3uTnm8/nHQm983b b9oiAO4g8Py16ucNSSKozCXJ2bULL+uOrlJJmg9B7mJp9cHDdn1amQ+QjVXVDqCT/ig== 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=dtmbMQstRtqGy9AU/nxQeT0zjEnLR07rKjtot2burNZz3P1CNQc+XJ9ptn0TdCUPNP03 nRP+MQj019K0OhPKmM+q4d6SY0VUKgUoUQlNS240KC0oTTzxW7Oz/pZKiFOXXdFcX8HCk 7n7mQyjMjoBCHS5zrA3wtHqDiXy5yFv8VmOVZh8BNjtT8A6kJ21ddgar0Y6wGBY34aEyC rNo4WdKtXsHzG7tgu2bdRs8fNd1OceJQxyaxMrwZbP9Qqjp91bL1ynKSQFPkJF++WhYB8 06PF7WgYHstm6NnRsaNPiXMIVu0IgOg5HN+f15uhdnoINQfFp0H8UtySyidyg0izmRw== 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.214.181 Received: from mail-pl1-f181.google.com (mail-pl1-f181.google.com [209.85.214.181]) (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 6E91660A2621 for ; Sat, 24 Oct 2026 00:51:58 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 6E91660A2621 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-pl1-f181.google.com with SMTP id d9443c01a7336-2e987b4a710so13087305ad.1 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=Ia3i2j5GE7h7zIzuB3GbhJhCQY8qnV4hjGTrqaxr7s+hbjTFeH+VEgG6muEB03ypQN +4znnVsFMGNwvDsDynRL+Rw0IpJnQ8JP7xuPeHvXdz4kBdOeSW46ema1IfbvIaIzlZJv sbNtFYcwx+e1FcfLX4QS0irNEENf2qrd+kzKcLm6/EGjK0F4dQR4U1PmWHm/dJCC9cA6 tmMHlSLkzVEHNOgK1+mgrqQVbwslFpdMxyGoKB7jsxY1oP3znFy6oZZdCGsI8x3pMtK0 BNevfA3IPs9JbFS0j8JYwk/awIoiqYEyOtIwhBLfJdKx4n/PIQiQyPezJDwRXdhjhEvR BCsg== X-Forwarded-Encrypted: i=1; AKwUvBy4bzhtonjSBDmZen7x2SevehSXHJ/SboKYslJUKaKNM6VOA6YBJXHygWvEGyEff0t6PRfF1BH8CitDvKQ=@vger.kernel.org X-Gm-Message-State: AFq9FYJezcE0N95Jf/njlilXrY0jXOZCocvsSX2TCugXacpfxA6kpg6g QuCnCNR55IuxWiP/LMJJRByI+fxyQ212l/l73XH7SHjniRz89NIUJp7Q33Nr804ybg== X-Gm-Gg: AYBFou22NraExDCzAOw2rfHFJExJMfh70DkOhDsiYiKIGZ6Ij9sBnRJDgTBSAwo8KeJ JBV/8dhnQWOVpfC6Pz4nAVNLo7ismxoMol9O5djuA5Oqwu5aLZPLBA0iBgyAKm7EjQ5pCoWcnCk cG50iLSsNpLKstKtR856BoICd9eeTRRuPOJNhLmsCye2+MNijrd3/CfNWJEEMt4fV9VAtfLelO9 I7CE6Dic/Jm31hYxeC21PCuvoyssU0YOF7G5fd0PTctcRj+cl0ykVbRkZtTpVtf8WFi26RoUlua LDrfCg2DCl5Lb+kvigTaiOnyjnCxprEbU48NvsVeUMj8CY3m9awKzrn74n8KFYJE/bmZTXOh4Ut bPJ8hPX4TbguslffXGk60z5WJd6+1DTHYcZVq/5RmLhNhMi9VHx8BolQ05xDOvbSQwHBxv6Qd+B NwHLJnl5wXKkkha3QETdMTJtoqe9Gfvz1V8LbWqqxzmdxccVQ1oqKtKswWSAnbr3ikPhbTkAvhM yuY5Wk+i0LDeEjb6xej4bJVNIVLfPaYC40Qr+l4GyIl4DwAnCBoRfTs8zPc+A8q9NhsUqXn8Amk VqqNluzvrPtWEd9mMhsB+oFIpOi9NwXcITdm1tByQIhz3eJLmBAfPMpdn7fNxj4= 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-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