From patchwork Tue Mar 26 12:31:23 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andreas Klinger X-Patchwork-Id: 10870937 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 85F30922 for ; Tue, 26 Mar 2019 12:31:50 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 6FDAB2902A for ; Tue, 26 Mar 2019 12:31:50 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 64247290F6; Tue, 26 Mar 2019 12:31:50 +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 E5B2D2902A for ; Tue, 26 Mar 2019 12:31:49 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726261AbfCZMbt (ORCPT ); Tue, 26 Mar 2019 08:31:49 -0400 Received: from mout.kundenserver.de ([212.227.17.10]:47089 "EHLO mout.kundenserver.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726480AbfCZMbt (ORCPT ); Tue, 26 Mar 2019 08:31:49 -0400 Received: from localhost ([89.247.163.190]) by mrelayeu.kundenserver.de (mreue107 [212.227.15.183]) with ESMTPSA (Nemesis) id 1MUGNZ-1hYz6N1XzX-00RGvz; Tue, 26 Mar 2019 13:31:24 +0100 Date: Tue, 26 Mar 2019 13:31:23 +0100 From: Andreas Klinger To: jic23@kernel.org, robh+dt@kernel.org, mark.rutland@arm.com Cc: knaack.h@gmx.de, lars@metafoo.de, pmeerw@pmeerw.net, linux-iio@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 1/2] devantech-srf04.yaml: transform DT binding to YAML Message-ID: <20190326123121.ibe3olu3yxptauws@arbad> MIME-Version: 1.0 Content-Disposition: inline User-Agent: NeoMutt/20170113 (1.7.2) X-Provags-ID: V03:K1:+aNG149jcbuYqmoS1FcLb4ZqRan3eMznzWnK+1xbjVnQccBcCpy 8hF005ooTX6Ef/p/vTc/fOvkeH9Q+5Cj9nMz3Bh3fLMu7h91y/5hyrIn8okUw2NH8a6lVl4 SJFE5FlwxIchHudxoLFNOAz2J69eO7jExxqz92IUvNW38y74/gzQhvQ/qivG/WUo4RQGzFn DRiClsGtkLNfLMOyqyhzg== X-UI-Out-Filterresults: notjunk:1;V03:K0:EigqP6sLmBA=:OhNTIzeDTbtnEYfHMbs0jN xydQ88sm0J1DiEzN1uyUgy7HhTqlcJuy/YRmPxFUiiCYkZ6izdFShquX44lDOMZTgCPhKk9Dl tp6wUM5J8UaaHovbO+M0VJw9/UmxRijoUgD+mWKUai4q4k2qLaW4NMCpJDBOYnWJC5CeyXsq/ gMDE+cKOcjENznewVNkAe4uqd3Ux4Tr7pAvR5UftSAnrHeoBiZpyG8NBvwbP9fy0MgmTn5FtC +eRmAiBF70uAK9Kn77emh+R7xGtk5lQa8E2U7ghYYa+Y4+EvI+sMqr93UPToQV1zW7d018hhk 3Hw7SasPowA+F44gQU9DWHp2Ye/hKeNLpBZWRolL3EEGiuLGGeM2+HWY80S5NQdo4GABMD0i0 fqKj9iMQGy7kyWor+5PP5gU462ZriN98vZodEL1I7pbIB5OhHMOcaLDf6WlA18mXiK6fWqJ8X M6gHb1rZcnMeVCihdDJmQc7bCqoaE1p0Du/69f1SAjRIslZ14r44KpueKFlOf0bKzBEZzcu/6 v274TyIDPwnHYVUOTldGWu4UGB9EVeZ/Qo5J9vwJ4Vv937KOB4Iy75tMdjg0rugFc1UZykUcN ncOyjjMvznEBtUZ3ghA0fQ6yKmaekwL+Sde8YPlpJCfmu+xcBJtB5Unsh3Sxiuzjw50Wxz4ei GBDBgFEYPD9skogGJ7P60gQbRIJgRvJdGwL4biMA61R/d1b8iO7hSTAbfIyiyd3KSGkT0S1Xg P0cROKmmtv78PpbPX08nkRHhrONgEIPY20ehDA== Sender: linux-iio-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-iio@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP use devantech-srf04.txt and transform binding into yaml Signed-off-by: Andreas Klinger --- .../bindings/iio/proximity/devantech-srf04.yaml | 62 ++++++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml diff --git a/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml b/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml new file mode 100644 index 000000000000..cd065393b062 --- /dev/null +++ b/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml @@ -0,0 +1,62 @@ +# SPDX-License-Identifier: GPL-2.0 +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/iio/proximity/devantech-srf04.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Devantech SRF04 ultrasonic range finder + +maintainers: + - Andreas Klinger + +description: | + Bit-banging driver using two GPIOs: + - trigger-gpio is raised by the driver to start sending out an ultrasonic + burst + - echo-gpio is held high by the sensor after sending ultrasonic burst + until it is received once again + + Specifications about the driver can be found at: + http://www.robot-electronics.co.uk/htm/srf04tech.htm + +allOf: + - $ref: /schemas/i2c/i2c-controller.yaml# + +properties: + compatible: + items: + - const: devantech,srf04 + + trig-gpios: + description: + Definition of the GPIO for the triggering (output) This GPIO is set + for about 10 us by the driver to tell the device it should initiate + the measurement cycle. + maxItems: 1 + + echo-gpios: + description: + Definition of the GPIO for the echo (input) + This GPIO is set by the device as soon as an ultrasonic burst is sent + out and reset when the first echo is received. + Thus this GPIO is set while the ultrasonic waves are doing one round + trip. + It needs to be an GPIO which is able to deliver an interrupt because + the time between two interrupts is measured in the driver. + See Documentation/devicetree/bindings/gpio/gpio.txt for information + on how to specify a consumer gpio. + maxItems: 1 + +required: + - compatible + - trig-gpios + - echo-gpios + +examples: + - | + #include + proximity { + compatible = "devantech,srf04"; + trig-gpios = <&gpio1 15 GPIO_ACTIVE_HIGH>; + echo-gpios = <&gpio2 6 GPIO_ACTIVE_HIGH>; + }; From patchwork Tue Mar 26 12:31:47 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andreas Klinger X-Patchwork-Id: 10870939 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 A3D77922 for ; Tue, 26 Mar 2019 12:32:13 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 8E97D28D94 for ; Tue, 26 Mar 2019 12:32:13 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 7F800290EB; Tue, 26 Mar 2019 12:32:13 +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 2612F28D94 for ; Tue, 26 Mar 2019 12:32:13 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726480AbfCZMcM (ORCPT ); Tue, 26 Mar 2019 08:32:12 -0400 Received: from mout.kundenserver.de ([212.227.126.134]:57653 "EHLO mout.kundenserver.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726266AbfCZMcM (ORCPT ); Tue, 26 Mar 2019 08:32:12 -0400 Received: from localhost ([89.247.163.190]) by mrelayeu.kundenserver.de (mreue012 [212.227.15.167]) with ESMTPSA (Nemesis) id 1MzCMN-1gmfmZ2RMZ-00wCCK; Tue, 26 Mar 2019 13:31:48 +0100 Date: Tue, 26 Mar 2019 13:31:47 +0100 From: Andreas Klinger To: jic23@kernel.org, robh+dt@kernel.org, mark.rutland@arm.com Cc: knaack.h@gmx.de, lars@metafoo.de, pmeerw@pmeerw.net, linux-iio@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 2/2] devantech-srf04.txt: remove old DT documentation Message-ID: <20190326123146.2ru6yu5vea2xha4r@arbad> MIME-Version: 1.0 Content-Disposition: inline User-Agent: NeoMutt/20170113 (1.7.2) X-Provags-ID: V03:K1:J1IvtnjsYDmCbBuLUGJ0KDNWv/mRgevvaCPI/eth5+RFYBVGxfU x+GmvmeZgIP9PvNp5Kha1WkP+00Ys0ZQmRSKJaTq0Fd8zJ14Me95m8kc2RAFRYJj0LZgq0x ruyVbs+sFhmWZhne+13pewAJDht7clSm3cKFWsXlgvjW0ybVgieKQeH1V/jmhHPzGdakGe1 dmXZ/oZohD8mKuSbTFD7Q== X-UI-Out-Filterresults: notjunk:1;V03:K0:TC9I9ebi+zw=:DPv24boWwIo70nut1l8gcJ bY70w260yKn1GA+XgIsIfyZaBEWejl6synTmroAUyrday8QpTdzsGRWNfM71nNv4zno5KYFtu PmU2N9PDR/snLr2zdlrERkZhHmA1LfXnUB5S0FQ380mX4VUDRee4/rmMM173q2kh8g20k3EXK xSk8McVnLzyhiDsicM8g+2cA+KwwFTE7ywHSMku2s76Dbf5h+AxVxIrpVt1xyNceT4A4HWyOF mgkEWGC43B2LkOO75gaYrfjElDVzGHwoeIwFSkMJ94RYIzcBze/Ql1fIjThdquu2EvBRoV4mL Jw7Xgys3k39u4vZ6EZvV6FvH4OF6IAMpVcjBNdsGMpR8FO2kreGZrXMO3IsL4sc393RCRz3k1 azHV+2nAzFvr/reitvG37U8q+o4/7LxCGYRku/E4AJSoBArKQkAvoaTkt9pGp5KjevcFQqTyD TfbLyaSv0OYJTWf7iR806wlo1bctazwmS4vyUOukmiGEofsLVby8fnGo1dK4Q0xyB6lS1O0mF iBLKnbeJDHNMu8u4G3CEalFG6vAwKKpTbfZLt7lRXJSdri3Tdl1yOoUY/NxJT79/OXWYHxLYj BMT8I6aGoRRJkGWjcIyuxRBc20xbP+13ek5cOvx+tC+4BmixLuWtMZscLHnGIPOftO2CGZQWy I3ggyPcrnTVPCrtyEiOdOTqfIuuRZyxTMVO5nc5XqYGGncnQCPVLycD98qbeqVL8qeRl/hkUF JFL+mH/+42O9Pq+an9cQ15pcij+5hwDAWxKtZQ== Sender: linux-iio-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-iio@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP remove the outdated DT documentation of devantech srf04 iio driver which is replaced by devantech-srf04.yaml Signed-off-by: Andreas Klinger --- .../bindings/iio/proximity/devantech-srf04.txt | 28 ---------------------- 1 file changed, 28 deletions(-) delete mode 100644 Documentation/devicetree/bindings/iio/proximity/devantech-srf04.txt diff --git a/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.txt b/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.txt deleted file mode 100644 index d4dc7a227e2e..000000000000 --- a/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.txt +++ /dev/null @@ -1,28 +0,0 @@ -* Devantech SRF04 ultrasonic range finder - Bit-banging driver using two GPIOs - -Required properties: - - compatible: Should be "devantech,srf04" - - - trig-gpios: Definition of the GPIO for the triggering (output) - This GPIO is set for about 10 us by the driver to tell the - device it should initiate the measurement cycle. - - - echo-gpios: Definition of the GPIO for the echo (input) - This GPIO is set by the device as soon as an ultrasonic - burst is sent out and reset when the first echo is - received. - Thus this GPIO is set while the ultrasonic waves are doing - one round trip. - It needs to be an GPIO which is able to deliver an - interrupt because the time between two interrupts is - measured in the driver. - See Documentation/devicetree/bindings/gpio/gpio.txt for - information on how to specify a consumer gpio. - -Example: -srf04@0 { - compatible = "devantech,srf04"; - trig-gpios = <&gpio1 15 GPIO_ACTIVE_HIGH>; - echo-gpios = <&gpio2 6 GPIO_ACTIVE_HIGH>; -};