From patchwork Mon Sep 25 03:22:08 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Luca Ceresoli X-Patchwork-Id: 13397188 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2E5F7CE7A91 for ; Mon, 25 Sep 2023 03:22:34 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229908AbjIYDWi (ORCPT ); Sun, 24 Sep 2023 23:22:38 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:41442 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229907AbjIYDWi (ORCPT ); Sun, 24 Sep 2023 23:22:38 -0400 Received: from relay4-d.mail.gandi.net (relay4-d.mail.gandi.net [217.70.183.196]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5440EA3; Sun, 24 Sep 2023 20:22:30 -0700 (PDT) Received: by mail.gandi.net (Postfix) with ESMTPA id 06D9FE0003; Mon, 25 Sep 2023 03:22:21 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1695612148; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding; bh=eKfAb9dM9HwZutIwv6iuMVTU5vDPqNRcb/JuqRISlpc=; b=VYt2ld/QSBksI0sK2Zb46u9XVVfPjTn+ibxWXtoA+pc620ovzyeEntnjzlvCAWCFceT+pG a/p7P0jBbPvahwhzyGOpVnetQEpg0OlyrPnSVZGyQT5Jc7l0zzc0eetc+dpFacxx9LJPJ+ PfkFvFoDlaMhlW+SkV1SMssyrKqrL6d4NFPBddhshLa3nLcJjxtnHAggc7NAmE7Muoa7Mp 9/uGhVP8jRcbYtsciTHcBcd8bcqBMFj04jcspIv5oaALRElxGX5uukVYjy6yBGF/U/EDun 06AfTT3VLpyJ6a214vLYKBZ4hSp9fNQ555dbYhW7VUnDbiWHEmQJGZV9cUymOw== From: Luca Ceresoli To: devicetree@vger.kernel.org Cc: Luca Ceresoli , Dmitry Torokhov , Rob Herring , Jeff LaBundy , Krzysztof Kozlowski , Conor Dooley , linux-input@vger.kernel.org, linux-kernel@vger.kernel.org, Thomas Petazzoni Subject: [PATCH v2] dt-bindings: input: touchscreen: goodix: clarify irq-gpios misleading text Date: Mon, 25 Sep 2023 05:22:08 +0200 Message-Id: <20230925032208.11698-1-luca.ceresoli@bootlin.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 X-GND-Sasl: luca.ceresoli@bootlin.com Precedence: bulk List-ID: X-Mailing-List: linux-input@vger.kernel.org The irq-gpios description misleading, apparently saying that driving the IRQ GPIO resets the device, which is even more puzzling as there is a reset GPIO as well. In reality the IRQ pin can be driven during the reset sequence to configure the client address, as it becomes clear after checking both the datasheet and the driver code. Improve the text to clarify that. Also rephrase to remove reference to the driver, which is not appropriate in the bindings. Signed-off-by: Luca Ceresoli Acked-by: Rob Herring Reviewed-by: Jeff LaBundy --- Changed in v2: - reworded to clarify even further --- .../devicetree/bindings/input/touchscreen/goodix.yaml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Documentation/devicetree/bindings/input/touchscreen/goodix.yaml b/Documentation/devicetree/bindings/input/touchscreen/goodix.yaml index 3d016b87c8df..2a2d86cfd104 100644 --- a/Documentation/devicetree/bindings/input/touchscreen/goodix.yaml +++ b/Documentation/devicetree/bindings/input/touchscreen/goodix.yaml @@ -37,8 +37,9 @@ properties: maxItems: 1 irq-gpios: - description: GPIO pin used for IRQ. The driver uses the interrupt gpio pin - as output to reset the device. + description: GPIO pin used for IRQ input. Additionally, this line is + sampled by the device on reset deassertion to select the I2C client + address, thus it can be driven by the host during the reset sequence. maxItems: 1 reset-gpios: