From patchwork Sat Oct 31 13:40:52 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Cameron X-Patchwork-Id: 320072 Delivered-To: patch@linaro.org Received: by 2002:a92:7b12:0:0:0:0:0 with SMTP id w18csp2268380ilc; Sat, 31 Oct 2020 06:44:01 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxd+7g3nXnbxhYA6/OBtwSpWIK57r6bgwqvRwcliQt+FyuFRP52RSEs/ZUHuGSIos7UgCFq X-Received: by 2002:a17:906:aacf:: with SMTP id kt15mr686221ejb.372.1604151841355; Sat, 31 Oct 2020 06:44:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1604151841; cv=none; d=google.com; s=arc-20160816; b=Ka7/tTfT/xprIbm3LfNUHAX56LzySQgYhaR7eiqz13NgHhO48C7SkxZansOVI8mgna DyvtkUFitqRgT1iKgQ/1iwLC8MgFPyaMD4vf5VGgqJx3QxOv8lwakPgP9Ij7ugPdrW/x sEQ2BYzYrJZLXw8P+Vdvlj/AzcHG5VC70rys9HGl3Xgn9e9OUi0BlxP8BTLqM1Ya2U1T rtUKCm85axNvbHD7L9/cKkFebj3GaB0KYn4oU9XwHbL/tl1336qbjBcdKTOtuRaEhz52 8qlDqCm5z5Z7V/4uIZpxeNtD76BMyt2LtnpHAGvO/WxqmghjbZmuorTVe0VdB2ao2N5d Vkng== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=S2H9URLbAP0jezvn4zOuE4op5Kvp5I+zNzYrTLtCKNU=; b=eqGRk1g9h3Y9NpzsfOoQO6ymN6kZuLv+S8U7xy1XFiowt0W7DWXdXxKs9cNgpAmMXC ZwnM0Bq8AOszbovuR7JHz4lOdro4VsHA/n8rdE3SfvjbWBqz6Ve3v3AwDZtiRTF28lmb VUkW9tA0bl7P8uCtjd++6dA3FnVvfuL259n5YdM7GwLa5UkJ/4KB1I4kNrKVlUPIaFva cnBR80mdbym+4XpoA02itD98cGbEna/4nnV4p5XEiExfDArVJqrsu/VsZ8jiMH3WyNSF p1ara0j+rsi1cEZw46IiK4idDA2FWFr4lEtujnM2xjOj/2RkU2e5idGYYEuemNbC2KmB QMKg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b="YrM/kzfn"; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id h25si6243872ejc.209.2020.10.31.06.44.01; Sat, 31 Oct 2020 06:44:01 -0700 (PDT) Received-SPF: pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b="YrM/kzfn"; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727686AbgJaNn6 (ORCPT + 6 others); Sat, 31 Oct 2020 09:43:58 -0400 Received: from mail.kernel.org ([198.145.29.99]:43018 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727669AbgJaNn6 (ORCPT ); Sat, 31 Oct 2020 09:43:58 -0400 Received: from localhost.localdomain (cpc149474-cmbg20-2-0-cust94.5-4.cable.virginm.net [82.4.196.95]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 77C1520756; Sat, 31 Oct 2020 13:43:56 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1604151837; bh=LaNsdVY7oM8IrNuKfaJT0mYv4lTGv2mLADklUxX2Ag8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=YrM/kzfnnAh+9trWSyAve2359rHErYzjgyu6C+Il7o6ry0Fm089RwsmpS8CwIr8eN FK4miqSC8fYi+d1mikf/GOgDOugNTgQMR4IM7a2cUjdOHf2yZW5TqY8gZV8ge4qChQ wWcIqG+B89vNVSAy8lMQ/fN3/v6kpbJko9DcK7QI= From: Jonathan Cameron To: linux-iio@vger.kernel.org, Rob Herring , devicetree@vger.kernel.org Cc: Jonathan Cameron , Rob Herring , Matt Ranostay Subject: [PATCH v2 11/29] dt-bindings:iio:proximity:ams, as3935 yaml conversion Date: Sat, 31 Oct 2020 13:40:52 +0000 Message-Id: <20201031134110.724233-12-jic23@kernel.org> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201031134110.724233-1-jic23@kernel.org> References: <20201031134110.724233-1-jic23@kernel.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Jonathan Cameron A straight forward conversion of this binding. I have added a maximum SPI frequency from the datasheet. Signed-off-by: Jonathan Cameron Reviewed-by: Rob Herring Acked-by: Matt Ranostay Cc: Matt Ranostay --- .../bindings/iio/proximity/ams,as3935.yaml | 71 +++++++++++++++++++ .../bindings/iio/proximity/as3935.txt | 34 --------- 2 files changed, 71 insertions(+), 34 deletions(-) -- 2.28.0 diff --git a/Documentation/devicetree/bindings/iio/proximity/ams,as3935.yaml b/Documentation/devicetree/bindings/iio/proximity/ams,as3935.yaml new file mode 100644 index 000000000000..7fcba5d6d508 --- /dev/null +++ b/Documentation/devicetree/bindings/iio/proximity/ams,as3935.yaml @@ -0,0 +1,71 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/iio/proximity/ams,as3935.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Austrian Microsystems AS3935 Franklin lightning sensor + +maintainers: + - Matt Ranostay + +description: + This lightening distance sensor uses an I2C or SPI interface. The + binding currently only covers the SPI option. + +properties: + compatible: + const: ams,as3935 + + reg: + maxItems: 1 + + spi-max-frequency: + maximum: 2000000 + + spi-cpha: true + + interrupts: + maxItems: 1 + + ams,tuning-capacitor-pf: + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Calibration tuning capacitor stepping value. This will require using + the calibration data from the manufacturer. + minimum: 0 + maximum: 120 + + ams,nflwdth: + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Set the noise and watchdog threshold register on startup. This will + need to set according to the noise from the MCU board, and possibly + the local environment. Refer to the datasheet for the threshold settings. + +required: + - compatible + - reg + - spi-cpha + - interrupts + +additionalProperties: false + +examples: + - | + spi { + #address-cells = <1>; + #size-cells = <0>; + + lightning@0 { + compatible = "ams,as3935"; + reg = <0>; + spi-max-frequency = <400000>; + spi-cpha; + interrupt-parent = <&gpio1>; + interrupts = <16 1>; + ams,tuning-capacitor-pf = <80>; + ams,nflwdth = <0x44>; + }; + }; +... diff --git a/Documentation/devicetree/bindings/iio/proximity/as3935.txt b/Documentation/devicetree/bindings/iio/proximity/as3935.txt deleted file mode 100644 index 849115585d55..000000000000 --- a/Documentation/devicetree/bindings/iio/proximity/as3935.txt +++ /dev/null @@ -1,34 +0,0 @@ -Austrian Microsystems AS3935 Franklin lightning sensor device driver - -Required properties: - - compatible: must be "ams,as3935" - - reg: SPI chip select number for the device - - spi-max-frequency: specifies maximum SPI clock frequency - - spi-cpha: SPI Mode 1. Refer to spi/spi-bus.txt for generic SPI - slave node bindings. - - interrupts : the sole interrupt generated by the device - - Refer to interrupt-controller/interrupts.txt for generic - interrupt client node bindings. - -Optional properties: - - ams,tuning-capacitor-pf: Calibration tuning capacitor stepping - value 0 - 120pF. This will require using the calibration data from - the manufacturer. - - ams,nflwdth: Set the noise and watchdog threshold register on - startup. This will need to set according to the noise from the - MCU board, and possibly the local environment. Refer to the - datasheet for the threshold settings. - -Example: - -as3935@0 { - compatible = "ams,as3935"; - reg = <0>; - spi-max-frequency = <400000>; - spi-cpha; - interrupt-parent = <&gpio1>; - interrupts = <16 1>; - ams,tuning-capacitor-pf = <80>; - ams,nflwdth = <0x44>; -};