From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.6 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,USER_AGENT_SANE_2 autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 4B330C2BB86 for ; Sun, 12 Apr 2020 11:28:42 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 23BB620732 for ; Sun, 12 Apr 2020 11:28:42 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1586690922; bh=A/TM2oZuIWL2EcklHfwd3IM6ORspyJc0stBXtKjtBtQ=; h=Date:From:To:Cc:Subject:In-Reply-To:References:List-ID:From; b=bB4cpPB/x+8YM8fd+d8lMtEGlbLQSuSDRdbXTtszEG1QMuiRX5vWw/Ld5pIKkyvTu cY8UVhFfHhSJei4/0hS7g68yweiFmqiEoqLWM7nfGXDCC0WSOt/lTSaR5KXRpnqT6X b4f+76ulHZgJpT5OVfvUSZZgzq4e790lS6qrlNoc= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726843AbgDLL2l (ORCPT ); Sun, 12 Apr 2020 07:28:41 -0400 Received: from mail.kernel.org ([198.145.29.99]:58088 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726658AbgDLL2k (ORCPT ); Sun, 12 Apr 2020 07:28:40 -0400 Received: from archlinux (cpc149474-cmbg20-2-0-cust94.5-4.cable.virginm.net [82.4.196.95]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 91102206E9; Sun, 12 Apr 2020 11:28:38 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1586690920; bh=A/TM2oZuIWL2EcklHfwd3IM6ORspyJc0stBXtKjtBtQ=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=mjSBtzPdfD5aLHkxChC+xIurPEkwhk6c8vyItlQkRMN3s1SKoXc/TQl98/wLX7vIV /RvUnWHx72Bw43ZtJGMnlJ+xHCQAWVocGyuSg6nBBhP5NuGtwg1AQWxTZIrmG1vBFM +134sAzDi5k5DYt+DYnr8paJwxvNWI0j/fPF/DPI= Date: Sun, 12 Apr 2020 12:28:35 +0100 From: Jonathan Cameron To: Guido =?UTF-8?B?R8O8bnRoZXI=?= Cc: Tomas Novotny , Hartmut Knaack , Lars-Peter Clausen , Peter Meerwald-Stadler , "Angus Ainslie (Purism)" , Marco Felsch , Thomas Gleixner , linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, Andy Shevchenko , Nishant Malpani Subject: Re: [PATCH v4 2/5] dt-bindings: iio: Introduce common properties for iio sensors Message-ID: <20200412122835.15f82420@archlinux> In-Reply-To: <8b91f0b7fa76ca4b2f3cdc251411829f71f8d810.1586094535.git.agx@sigxcpu.org> References: <8b91f0b7fa76ca4b2f3cdc251411829f71f8d810.1586094535.git.agx@sigxcpu.org> X-Mailer: Claws Mail 3.17.5 (GTK+ 2.24.32; x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Sender: linux-iio-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-iio@vger.kernel.org On Sun, 5 Apr 2020 15:50:29 +0200 Guido G=C3=BCnther wrote: > Introduce a file for common properties of iio sensors. So far this > contains the new proximity-near-level property for proximity sensors > that indicates when an object should be considered near. >=20 > Signed-off-by: Guido G=C3=BCnther This works for me. However, I would like to give time for Rob and others to comment on the syntax, naming etc of this file. Thanks, Jonathan > --- > .../devicetree/bindings/iio/common.yaml | 35 +++++++++++++++++++ > 1 file changed, 35 insertions(+) > create mode 100644 Documentation/devicetree/bindings/iio/common.yaml >=20 > diff --git a/Documentation/devicetree/bindings/iio/common.yaml b/Document= ation/devicetree/bindings/iio/common.yaml > new file mode 100644 > index 000000000000..97ffcb77043d > --- /dev/null > +++ b/Documentation/devicetree/bindings/iio/common.yaml > @@ -0,0 +1,35 @@ > +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/iio/common.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Common properties for iio sensors > + > +maintainers: > + - Jonathan Cameron > + - Guido G=C3=BCnther > + > +description: | > + This document defines device tree properties common to several iio > + sensors. It doesn't constitue a device tree binding specification by i= tself but > + is meant to be referenced by device tree bindings. > + > + When referenced from sensor tree bindings the properties defined in th= is > + document are defined as follows. The sensor tree bindings are responsi= ble for > + defining whether each property is required or optional. > + > +properties: > + proximity-near-level: > + $ref: /schemas/types.yaml#/definitions/uint32 > + description: | > + For proximity sensors whether an object can be considered near to = the > + device depends on parameters like sensor position, covering glass = and > + aperture. This value gives an indication to userspace for which > + sensor readings this is the case. > + > + Raw proximity values equal or above this level should be > + considered 'near' to the device (an object is near to the > + sensor). > + > +...