From patchwork Tue Oct 24 18:35:45 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephan Gerhold X-Patchwork-Id: 157670 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:ce89:0:b0:403:3b70:6f57 with SMTP id p9csp2134014vqx; Tue, 24 Oct 2023 11:37:04 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHfl4ughpH6IizvJVDBBiQbcFE+HwOJiBM1vVYcWnBBgKVIP+o+nyZcY9G0vXYaJaL5ixaQ X-Received: by 2002:a17:903:28c4:b0:1c9:db23:705f with SMTP id kv4-20020a17090328c400b001c9db23705fmr9292888plb.45.1698172624564; Tue, 24 Oct 2023 11:37:04 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1698172624; cv=pass; d=google.com; s=arc-20160816; b=vG7IAwod3aPHTE45Hw7Nu/XPsMKn8umNGyWpaQYtnRcNVjrtP35onI72FX0ugYkaPZ jFHmmp2GxQQDtn6JTfQsx8i31/ZiHe++48gwtAakmV9Td1Wy870ry+oPpUjNVazPjUX+ ddk6mB+g641ebQuMRJU1UavllxQzepeklp5EDxc6cS+3CrNE1YkLejN66g+So3QpWGDA omi5uhryP/KY94bfG9yosLqw6HUXL9NjOGQXzz94GMehykygPMdy6u8FGo2Osy9cGFzA B/ub1KzXVcfNg4JqZqe84PjOqdYX0JdJndC3Qe198G8jKVMGDq1jZi6Tzs0tDhT6GfZb pyTA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:in-reply-to:references:message-id :content-transfer-encoding:mime-version:subject:date:from :dkim-signature:dkim-signature; bh=lUzNzqc8pnjA19u06jBcBi2HrnJlfBUjIE0lrHSoBuU=; fh=H4F8PtkBoYP1ArzA3bm8hSQ/P8f+7HD296M+UpmB+dE=; b=K1Zs8wqbAvyEUqmRP8WE3IRalF+8ik8nvEEj8zlEROHdWvki17gcCAhQZgZ1EVGHty BFgvGww6O8LL0ylcmAOPAciT9lEwbxa3R9NkCctBSnqDyhtfYQVOnuhexfBdhLVvNsT5 gsMsRjg8xwAj8IOn5zD4+MEE/aF+4szAeY957RD6+4NLK3G80eBfz1js0NcYkPatWuqK xKlG4+ejQjVnj8lnwDKC4y5VMNAXrGS92KagbfHw7MCXsIUzBsUQu5b03UQe9Z1GWw5o llHsxZrKPDu1cY1lcyYOK++jvjfAHCGmBvWWOIpWjzBGR8JFhHXNM1AX5+MGqoB98nNm zJzA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@gerhold.net header.s=strato-dkim-0002 header.b="oKDlTZ/X"; dkim=neutral (no key) header.i=@gerhold.net header.s=strato-dkim-0003 header.b=fBJsoTi8; arc=pass (i=1); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.36 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from pete.vger.email (pete.vger.email. [23.128.96.36]) by mx.google.com with ESMTPS id y18-20020a1709027c9200b001c5fa46f0e6si8649023pll.190.2023.10.24.11.37.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 24 Oct 2023 11:37:04 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.36 as permitted sender) client-ip=23.128.96.36; Authentication-Results: mx.google.com; dkim=pass header.i=@gerhold.net header.s=strato-dkim-0002 header.b="oKDlTZ/X"; dkim=neutral (no key) header.i=@gerhold.net header.s=strato-dkim-0003 header.b=fBJsoTi8; arc=pass (i=1); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.36 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by pete.vger.email (Postfix) with ESMTP id 99CB0802FB04; Tue, 24 Oct 2023 11:36:56 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at pete.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344171AbjJXSgK (ORCPT + 27 others); Tue, 24 Oct 2023 14:36:10 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53338 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344167AbjJXSgH (ORCPT ); Tue, 24 Oct 2023 14:36:07 -0400 Received: from mo4-p02-ob.smtp.rzone.de (mo4-p02-ob.smtp.rzone.de [85.215.255.80]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B6A0C10DE; Tue, 24 Oct 2023 11:36:02 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698172554; cv=none; d=strato.com; s=strato-dkim-0002; b=ja8T6NxLVZFtwNQxHTqJMik/bXM7QQpGElHC8shWYJlRVqxae/UhM7QTtMQiihod7x MPbN7ukblot6tEZV9l8KvvlLJaRp1IFkhwOBqukMB8ErAu4s++WJ6uG5nT7Mx4BC5SR5 m3A+PQLwmnhCtN/GiZ7ulAywLbvIL9wEGj4qSCTeYgAr7p5VBx3Xlt95EN1S10Kmq7nz 7v7V5qSofx7aiHyiQfuMmCQYuOs5hQw8HmbHXlf+h5XwHifURZHfDGUCpG4e/FKZA/ZU vUpeyCnFlxc9KGwu+KD2/PX18qi/jwIOmH7qRwhK3nHhR2xvK0Ccwy1Ln44mDVhacVS8 fw7w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; t=1698172554; s=strato-dkim-0002; d=strato.com; h=Cc:To:In-Reply-To:References:Message-Id:Subject:Date:From:Cc:Date: From:Subject:Sender; bh=lUzNzqc8pnjA19u06jBcBi2HrnJlfBUjIE0lrHSoBuU=; b=DgmDauJ0SUoXAQFFlpfEJ62/Hhhmz6jc85pr7rear0KMMePocOl9Bkmmdn203/2pJV 43jCJB99AEt8BdUg4DD6+x3AqtQMkeG8JZJap592mj0D6Pnvd/9OYHAac7tSyLSba3Yg rb1APRQfRtxobq2BspcpkVxbKB6bEXt4zFTKhqV2j8v3wFvUQg0MInZ1luFk+xk7nTXJ bu+xnFWMl7sNFBcVGRAepaun4k0gJHitwLxf3oRFcYaiwI+Jh9nSO+BwTgHAS9jl8NVH Os9Ajn39cCS3H0r2av04VKFhGfGzFOX3CDf33GVelf1CoaUawWGJnnKFtLMBwbwdaXax p2zw== ARC-Authentication-Results: i=1; strato.com; arc=none; dkim=none X-RZG-CLASS-ID: mo02 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; t=1698172554; s=strato-dkim-0002; d=gerhold.net; h=Cc:To:In-Reply-To:References:Message-Id:Subject:Date:From:Cc:Date: From:Subject:Sender; bh=lUzNzqc8pnjA19u06jBcBi2HrnJlfBUjIE0lrHSoBuU=; b=oKDlTZ/XFqSimcl59y2yt7OAFQ3KS49iFG7GwfERLff5ldCBQbhyCmmUcb8+bl3qGz GxzHiX4/T/K+TB92ZB/WTePT278ZtM7y8TTccO0zNFB2yYSofUtXfmYWC0K4PT0wP+V9 hbGVEKDGMRq/CmByMpeLRyZRKDUK5S8GwasylgOlIr5bvgCKYwAaD5ySO+5CHMPnnzCK Q4HASkOnaKmSkb9tQEr8tUwQHxpUdKf/fLaByuNCb83R24uxo+eWWEFcDkoayY+1MBKF 3u/prEMmoRL7njxbgIHpYYcIoF6ykjJvZluu0usisB5gV1/Ih8d8jnb6LtY2JuhsYTMk teXw== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; t=1698172554; s=strato-dkim-0003; d=gerhold.net; h=Cc:To:In-Reply-To:References:Message-Id:Subject:Date:From:Cc:Date: From:Subject:Sender; bh=lUzNzqc8pnjA19u06jBcBi2HrnJlfBUjIE0lrHSoBuU=; b=fBJsoTi8nmjIJ0YScR3LygOx2BI/VXb/KNrMD/sYk5VP4j+U0QMGkpWeHTweNIbMuQ 0uzAd3TmASlWrWQ4RiDw== X-RZG-AUTH: ":P3gBZUipdd93FF5ZZvYFPugejmSTVR2nRPhVOQjVd4CteZ/7jYgS+mLFY+H0JAn8u4p39TY=" Received: from [192.168.244.3] by smtp.strato.de (RZmta 49.9.0 DYNA|AUTH) with ESMTPSA id j34a49z9OIZrRxh (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256 bits)) (Client did not present a certificate); Tue, 24 Oct 2023 20:35:53 +0200 (CEST) From: Stephan Gerhold Date: Tue, 24 Oct 2023 20:35:45 +0200 Subject: [PATCH v3 1/2] dt-bindings: input: touchscreen: document Himax HX852x(ES) MIME-Version: 1.0 Message-Id: <20231024-hx852x-v3-1-a1890d3a81e9@gerhold.net> References: <20231024-hx852x-v3-0-a1890d3a81e9@gerhold.net> In-Reply-To: <20231024-hx852x-v3-0-a1890d3a81e9@gerhold.net> To: Dmitry Torokhov Cc: Rob Herring , Krzysztof Kozlowski , Conor Dooley , Henrik Rydberg , linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Jeff LaBundy , Christophe JAILLET , Jonathan Albrieux , Stephan Gerhold , Krzysztof Kozlowski X-Mailer: b4 0.12.3 X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on pete.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (pete.vger.email [0.0.0.0]); Tue, 24 Oct 2023 11:36:56 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1780663057856405132 X-GMAIL-MSGID: 1780663057856405132 Himax HX852x(ES) is a touch panel controller with optional support for capacitive touch keys. Unfortunately, the model naming is quite unclear and confusing. There seems to be a distinction between models (e.g. HX8526) and the "series" suffix (e.g. -A, -B, -C, -D, -E, -ES). But this doesn't seem to be applied very consistently because e.g. HX8527-E(44) actually seems to belong to the -ES series. The compatible consists of the actual part number followed by the "series" as fallback compatible. Typically only the latter will be interesting for drivers as there is no relevant difference on the driver side. Reviewed-by: Krzysztof Kozlowski Signed-off-by: Stephan Gerhold --- .../bindings/input/touchscreen/himax,hx852es.yaml | 81 ++++++++++++++++++++++ 1 file changed, 81 insertions(+) diff --git a/Documentation/devicetree/bindings/input/touchscreen/himax,hx852es.yaml b/Documentation/devicetree/bindings/input/touchscreen/himax,hx852es.yaml new file mode 100644 index 000000000000..40a60880111d --- /dev/null +++ b/Documentation/devicetree/bindings/input/touchscreen/himax,hx852es.yaml @@ -0,0 +1,81 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/input/touchscreen/himax,hx852es.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Himax HX852x(ES) touch panel controller + +maintainers: + - Stephan Gerhold + +allOf: + - $ref: touchscreen.yaml# + +properties: + compatible: + items: + - enum: + - himax,hx8525e + - himax,hx8526e + - himax,hx8527e + - const: himax,hx852es + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + description: Touch Screen Interrupt (TSIX), active low + + reset-gpios: + maxItems: 1 + description: External Reset (XRES), active low + + vcca-supply: + description: Analog power supply (VCCA) + + vccd-supply: + description: Digital power supply (VCCD) + + touchscreen-inverted-x: true + touchscreen-inverted-y: true + touchscreen-size-x: true + touchscreen-size-y: true + touchscreen-swapped-x-y: true + + linux,keycodes: + minItems: 1 + maxItems: 4 + +required: + - compatible + - reg + - interrupts + - reset-gpios + +additionalProperties: false + +examples: + - | + #include + #include + #include + + i2c { + #address-cells = <1>; + #size-cells = <0>; + + touchscreen@48 { + compatible = "himax,hx8527e", "himax,hx852es"; + reg = <0x48>; + interrupt-parent = <&tlmm>; + interrupts = <13 IRQ_TYPE_LEVEL_LOW>; + reset-gpios = <&tlmm 12 GPIO_ACTIVE_LOW>; + vcca-supply = <®_ts_vcca>; + vccd-supply = <&pm8916_l6>; + linux,keycodes = ; + }; + }; + +...