From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-dl1-f45.google.com (mail-dl1-f45.google.com [74.125.82.45]) (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 BD1E6331A4B for ; Mon, 9 Mar 2026 05:44:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.82.45 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773035095; cv=none; b=hNofW5+Lk4gEjX9wFDymKnwsExYPA+diZyZ3wPXX1p2Rme/Hu3DNezd3aCn+t6efz6kcGXBDaN7zKnd5U2y3BKB8UrhS0eBX+rwqiAtjQeS7KMIeYASyFeEuWSUZo68NZb6aI9BS7jGoRBPau9My6AfJHFwFKkZxPuR7wTAlEf8= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773035095; c=relaxed/simple; bh=hqi/Df1JPDp/BlPm0GTdyjJF+qjIicQyIWh3azQlrf8=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=QIIUmO3Fk/5sUIbCEbgRvc94gz1WUCrLQcZ5IQfw+EMiJclFyubrhBDuUCy7nxBzE6B8ZomymcGePP8fFBYeCeZwQ+6mkHv8+GTyfAmWr8kROq/wu5MkTCjsAuMUCvocA+MXpN3sayNapWdsIq2esomamDVcQ436OcfhIezy+0Q= 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=PH9kTvFY; arc=none smtp.client-ip=74.125.82.45 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="PH9kTvFY" Received: by mail-dl1-f45.google.com with SMTP id a92af1059eb24-1271195d2a7so6040539c88.0 for ; Sun, 08 Mar 2026 22:44:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1773035093; x=1773639893; darn=vger.kernel.org; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date:from:to :cc:subject:date:message-id:reply-to; bh=Ug9w3Bfo3Ur8mbdFfczjnMxT2pbrXyiERJeMtAuIh8g=; b=PH9kTvFYazGcAHB330To/OeFzVVVoAetzeAqLqtqgO8FTevOSlJFg0vBVgSis1D2qx ei4tNvhFPmh9rlOXr2szTzSoqAD0b7HIcOIrEvL5+ngd6IVklpLZT6rHLnG7PimKZxJ9 WNgr1m+pUKPVhXczgU5mbe5tNGgj5xXXBCyEvkqnAFWkvr0DnL5lcVxj8bcLuaBKAWQj nuRXFxAHJBYhnJ9oofghicqrvnLlnsy7xl+xR5W6CAGNw7Ab3S8+FdKBlMHTEgwLb98/ MWsGRvDGo8vDBF/Va9cyyNDPmbCaaATQfCaHXHHlieVPDqYlbgqs+bSBorjqAbNtezJr wD2g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1773035093; x=1773639893; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=Ug9w3Bfo3Ur8mbdFfczjnMxT2pbrXyiERJeMtAuIh8g=; b=lvM4m29L4glxqYvhC87KwEznIpjwbPFdMQlrEnFh6yl08GhwlkFTzRxRsFxPzLM0tv kD4Xl3PfQqn+NIir3H7YFC7C3V2XlnmxvMIJooLUrS//+im+kKLSW67r1sEDoprcjHVP L4k0Iga+5K7+4hF0tQbZgaiDwcjygtesC1RLjWEYmxIKVTKE39dBmetcDGG3u2Ga3GZj 2pOrLXn+iuN08ZgcAqk757ltC4H3hvr/mQXi1HUwK4iJgvYvAc8S80XA612XY1lCYrWm 5uOHUuko+7uRkRtK/rfxOjUekg3ok3s2NuhrCbAHeP7IVh8h9f13mmfaFH81sWSA2X0b kcLQ== X-Forwarded-Encrypted: i=1; AJvYcCUrrFpLKkv293a/jbjsEcW8wxmxlloo+AF8Bx/ghi5Vqz3FmCtyXwvxdx97b02rfS/GwSuJpto1+A8=@vger.kernel.org X-Gm-Message-State: AOJu0YzqOTh+gaCb2g5IZw8gsR780Llr8Lup1a4uyk72Uu71sLktKUf6 lGq9LWPwcCxxMPGex3AuXpO8oTLpBCy8/+LoKBVUREMenkhshaov/QJy X-Gm-Gg: ATEYQzzawhSWU+YWgCrPzx9bobbnrUvbyQ0fI8YoqCv9zQoMRzN3N0gCII9mFVc+0Xu W5Jm9dX/VBWoTdhnner3GV46a3g655pf9M6rpl3sKcA/quMXfRuv0iWaVvYsjZYS5AOqLUu/Z78 2AnGE/TmIcQmE4uXAhZb2nlNzv7SSukDkGURN19+Ut0PW/QVhkw6vtHlb0F9GTeUC37fRpLHbCn K6L2wzubnop11g9kadFEeVm7hmFbA3stt/Sl0wOMm6+29nXZ95ptus4Mx2zD05omAG7fakz+KdV XtVuDQUTP9Gznjyarm/Yb4QtcFJmlfQh2DrsFaQd5XtbPvzaL0uDE0ryZlJT4gsXS6Ie+jsIW0y QFRrV2aP6Hd8D0Dt2E9ei+I2Ne28l4Eiusdlscs+JVG8OHjQK5kV5WsMFim2sD6XcvH8Dj+2KUr kWbUzW+q4279TcxJYJfrrQou6Np0zglMU= X-Received: by 2002:a05:7022:906:b0:127:5cfd:785 with SMTP id a92af1059eb24-128c2d8f553mr4232707c88.4.1773035092704; Sun, 08 Mar 2026 22:44:52 -0700 (PDT) Received: from google.com ([2601:647:5e00:4acd:af9:a43b:9d9e:841c]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-128c3f43593sm8122381c88.9.2026.03.08.22.44.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 08 Mar 2026 22:44:52 -0700 (PDT) Date: Mon, 9 Mar 2026 05:44:48 +0000 From: Dmitry Torokhov To: Val Packett Cc: Jingyuan Liang , Jiri Kosina , Benjamin Tissoires , Jonathan Corbet , Mark Brown , Steven Rostedt , Masami Hiramatsu , Mathieu Desnoyers , Rob Herring , Krzysztof Kozlowski , Conor Dooley , 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, Dmitry Antipov , Jarrett Schultz Subject: Re: [PATCH 09/12] dt-bindings: input: Document hid-over-spi DT schema Message-ID: References: <20260303-send-upstream-v1-0-1515ba218f3d@chromium.org> <20260303-send-upstream-v1-9-1515ba218f3d@chromium.org> <1cc6de61-8b56-492e-ab78-e3aa448f58ad@packett.cool> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <1cc6de61-8b56-492e-ab78-e3aa448f58ad@packett.cool> On Sat, Mar 07, 2026 at 04:25:44AM -0300, Val Packett wrote: > > On 3/3/26 3:13 AM, Jingyuan Liang wrote: > > 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. > > […] > > +properties: > > + compatible: > > + oneOf: > > + - items: > > + - enum: > > + - microsoft,g6-touch-digitizer > > + - const: hid-over-spi > > + - description: Just "hid-over-spi" alone is allowed, but not recommended. > > […] > > +required: > > + - compatible > > + - interrupts > > + - reset-gpios > > Why is reset required? Is it so implausible on some device implementing the > spec there wouldn't be a reset gpio? No, because it is mandated by the spec: "HID SPI peripheral must provide a dedicated reset line, driven by the HOST, which, when toggled (pulled LOW for at least 10ms, normally HIGH), will have the effect of resetting the device. If a HID SPI peripheral is enumerated via ACPI, the device ASL configuration must expose an ACPI FLDR (_RST) method to control this line." The spec also states that the host must initiate reset during initialization of the device. > > > + - vdd-supply > Linux makes up a dummy regulator if DT doesn't provide one, so can > regulators even be required? There is still a supply line to the chip even if it is not exposed to the OS control. So as far as chip is concerned the supply is required. Thanks. -- Dmitry