From patchwork Mon Nov 5 03:57:21 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jeff LaBundy X-Patchwork-Id: 10667385 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 2C88D175A for ; Mon, 5 Nov 2018 04:05:45 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 1B64329645 for ; Mon, 5 Nov 2018 04:05:45 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 0F44E29655; Mon, 5 Nov 2018 04:05:45 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-7.9 required=2.0 tests=BAYES_00,MAILING_LIST_MULTI, RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 83B292964F for ; Mon, 5 Nov 2018 04:05:44 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727288AbeKENXM (ORCPT ); Mon, 5 Nov 2018 08:23:12 -0500 Received: from p3plsmtpa12-05.prod.phx3.secureserver.net ([68.178.252.234]:57854 "EHLO p3plsmtpa12-05.prod.phx3.secureserver.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727331AbeKENXM (ORCPT ); Mon, 5 Nov 2018 08:23:12 -0500 Received: from localhost.localdomain ([136.62.165.143]) by :SMTPAUTH: with ESMTPSA id JW1hgLjeFuPTpJW1ngEj5j; Sun, 04 Nov 2018 20:58:16 -0700 From: Jeff LaBundy To: dmitry.torokhov@gmail.com, devicetree@vger.kernel.org Cc: linux-input@vger.kernel.org, rydberg@bitmath.org, robh+dt@kernel.org, mark.rutland@arm.com, Jeff LaBundy Subject: [PATCH 1/2] dt-bindings: input: touchscreen: iqs5xx: Add bindings Date: Sun, 4 Nov 2018 21:57:21 -0600 Message-Id: <1541390242-8355-1-git-send-email-jeff@labundy.com> X-Mailer: git-send-email 2.7.4 X-CMAE-Envelope: MS4wfBSU7eljAj/K0aL0fJn0XZxCUeMqVIaYPbkYTBGviYHiw/gqBAo9twKl96ht3F+OZ6gMSphq/uZ0MQLcgidFuex75y0pKMf1kjpm9ZB+07TTikL9Snj5 WiYuEOh2jZDNole9vIjuzdtrhSaNG9EQUJdWcDaXfslSGIUM/XPNEjkAKZDIzXYozkn1LMMnciCQrpExmVJYaCoAWBbT/J8pHnAO1A+0Rm1IwJGmBZNuTtno 3xFR26wsKZ4FW+43R9OZlzazx9cAvDHeZ47nJpwpWuVxDocfmYczkEuIJXkdRbgL68CL65TzQATOCRs8qH77JmH2L6PENbHfDSkZrHn23jkOCBNZk9xARD1q I6uTvdzJf3dQnuA5qkYD8WfLu1CIEg== Sender: linux-input-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-input@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP This patch adds binding documentation for the Azoteq IQS550/572/525 family of trackpad/touchscreen controllers. Signed-off-by: Jeff LaBundy --- .../bindings/input/touchscreen/iqs5xx.txt | 123 +++++++++++++++++++++ .../devicetree/bindings/vendor-prefixes.txt | 1 + 2 files changed, 124 insertions(+) create mode 100644 Documentation/devicetree/bindings/input/touchscreen/iqs5xx.txt diff --git a/Documentation/devicetree/bindings/input/touchscreen/iqs5xx.txt b/Documentation/devicetree/bindings/input/touchscreen/iqs5xx.txt new file mode 100644 index 0000000..d201f68 --- /dev/null +++ b/Documentation/devicetree/bindings/input/touchscreen/iqs5xx.txt @@ -0,0 +1,123 @@ +Azoteq IQS550/572/525 Trackpad/Touchscreen Controller + +Required properties: + +- compatible : One of "azoteq,iqs550", "azoteq,iqs572" or + "azoteq,iqs525". + +- reg : I2C slave address for the device. + +- interrupts : GPIO to which the device's RDY output is + connected (see [0] for more information). + +- reset-gpios : GPIO to which the device's NRST input is + connected (see [1] for more information). + Hardware reset access is required so as to + facilitate in-system firmware replacement. + +Optional properties: + +- azoteq,exp-ver-major : Major field of the export file version number + (0 through 255 inclusive). This property must + be specified as a '/bits/ 8' value. + +- azoteq,exp-ver-minor : Minor field of the export file version number + (0 through 255 inclusive). This property must + be specified as a '/bits/ 8' value. + + The export file version number is a customer- + assigned parameter embedded in the device's + firmware at the time it is exported from the + manufacturer's PC-based configuration tool. + + If the export file version number stored in + the device's nonvolatile memory does not match + the number specified here, the driver replaces + the firmware on the device with that which is + stored on the local filesystem (for which the + export file version number must match). + + If both major and minor fields are omitted or + specified as zero, the driver does not query + the device's export file version number. + +- touchscreen-min-x : Minimum horizontal coordinate that can be + reported by the device. If this property is + omitted, zero is used. + +- touchscreen-min-y : Minimum vertical coordinate that can be + reported by the device. If this property is + omitted, zero is used. + +- touchscreen-size-x : Horizontal resolution (in pixels) of the touch + area. If this property is omitted, the default + horizontal resolution embedded in the device's + firmware is used. + +- touchscreen-size-y : Vertical resolution (in pixels) of the touch + area. If this property is omitted, the default + vertical resolution embedded in the device's + firmware is used. + +- touchscreen-max-pressure : Maximum touch strength that can be reported by + the device, specified as the sum of the deltas + across all channels impacted by a touch event. + A channel's delta is calculated as its count + value minus a reference, where the count value + is inversely proportional to the channel's + capacitance. The maximum touch strength is + therefore dependent on hardware configuration + and can vary by application. + +- touchscreen-fuzz-x : Hysteresis level (in pixels) applied to the + horizontal coordinates reported by the device. + +- touchscreen-fuzz-y : Hysteresis level (in pixels) applied to the + vertical coordinates reported by the device. + +- touchscreen-fuzz-pressure : Hysteresis level applied to the strength level + reported by the device, specified in the same + units as touchscreen-max-pressure (deltas). + +- touchscreen-inverted-x : Boolean to indicate that the horizontal axis + of the touch area is inverted. Inversion is + applied relative to that which may already be + embedded in the device's firmware. + +- touchscreen-inverted-y : Boolean to indicate that the vertical axis + of the touch area is inverted. Inversion is + applied relative to that which may already be + embedded in the device's firmware. + +- touchscreen-swapped-x-y : Boolean to indicate that the horizontal and + vertical axes of the touch area are swapped. + Transposition is applied relative to that + which may already be embedded in the device's + firmware. + +[0]: Documentation/devicetree/bindings/interrupt-controller/interrupts.txt +[1]: Documentation/devicetree/bindings/gpio/gpio.txt + +Example: + + &i2c1 { + /* ... */ + + iqs550: iqs550@74 { + compatible = "azoteq,iqs550"; + reg = <0x74>; + interrupt-parent = <&gpio>; + interrupts = <17 1>; + reset-gpios = <&gpio 27 0>; + + azoteq,exp-ver-major = /bits/ 8 <1>; + azoteq,exp-ver-minor = /bits/ 8 <0>; + + touchscreen-size-x = <640>; + touchscreen-size-y = <480>; + + touchscreen-max-pressure = <16000>; + }; + + /* ... */ + }; diff --git a/Documentation/devicetree/bindings/vendor-prefixes.txt b/Documentation/devicetree/bindings/vendor-prefixes.txt index a38d8bf..d2ed740 100644 --- a/Documentation/devicetree/bindings/vendor-prefixes.txt +++ b/Documentation/devicetree/bindings/vendor-prefixes.txt @@ -49,6 +49,7 @@ avia avia semiconductor avic Shanghai AVIC Optoelectronics Co., Ltd. axentia Axentia Technologies AB axis Axis Communications AB +azoteq Azoteq (Pty) Ltd bananapi BIPAI KEJI LIMITED bhf Beckhoff Automation GmbH & Co. KG boe BOE Technology Group Co., Ltd.