From patchwork Mon Apr 5 16:23:25 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Cameron X-Patchwork-Id: 415298 Delivered-To: patch@linaro.org Received: by 2002:a02:8562:0:0:0:0:0 with SMTP id g89csp3811516jai; Mon, 5 Apr 2021 09:25:27 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzDLal5JxkIf52vkkTacgBhc7UN08FPwt8WWewSsfCTLsaXtsAxSushyXNlp5cVHUXLUABT X-Received: by 2002:a17:906:4b0e:: with SMTP id y14mr28610484eju.393.1617639927308; Mon, 05 Apr 2021 09:25:27 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1617639927; cv=none; d=google.com; s=arc-20160816; b=VJIwThsX9nBi5phlAyBJg9xY/aaJuJ7vcxclHZbPeHtHj/3mYSoYNxcFsJT8bHnL0Z bT4zvouON/w7unroEydGp9Dt+WWn9VGlI7KfUSc4Pq0oeuo78qL5wMLR9s4V8cIZQGc0 p5aP3CVwIRY/+XWQl4Q1F7yQlpE0DYl77CEt2wjjAUikousZ60/b/oupeTf+vk/03+ef ya70yhuPjSpObIZMeEJnJBd3hvbSuUWSDXPh6vgyng1hWSWXUcamWeD0Wpx5rJpD91Od NteZBwbbVMJqHMaB+A5MjbANaRbocx7GIa6zFwQRwzXuOOup3zq7gXVAA00D2yGAFNhR qKZA== 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=hrWXo4c6M3fO3fazOOVfVoe2435Kn+3riik5njaq7vQ=; b=vS+qZg8y9tYPsahtBCPmmyDjBdZe0OMA72427/dIy8+UEMP6PAe9iApW6/kbekCvQ6 eXy+hTyHuMV+85zJsSanlCEbTIqKYLrMmHp7zFaBd4tXvUX3NQVfqsbQY3/pJx9l9ZSs dyyznx73cZS+Ve56WYaEYpkoYXav1ketjdvsa1rGwccbAc34uozOsdzzTvN9EfwkcsX8 PrjJyioB0MJ4oro9junqgFyQExbzgwmaxYuxGIzxcjT0/XEIrwNKfp5vqTiAG82H/RE3 w3i+IerO+bFxD4V1gG51Efk/pDu68qdWdfHJQM4hif94Xk45JyQinqDcpoyzzlrlndfc WRPQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=SHWPQsBj; 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 v10si2903810ejb.195.2021.04.05.09.25.27; Mon, 05 Apr 2021 09:25:27 -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=k20201202 header.b=SHWPQsBj; 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 S233879AbhDEQZc (ORCPT + 6 others); Mon, 5 Apr 2021 12:25:32 -0400 Received: from mail.kernel.org ([198.145.29.99]:36508 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233795AbhDEQZb (ORCPT ); Mon, 5 Apr 2021 12:25:31 -0400 Received: by mail.kernel.org (Postfix) with ESMTPSA id CC1F4613B1; Mon, 5 Apr 2021 16:25:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1617639925; bh=w90Al8UaQbEJVuWG1mLWXHAH5ooii7iwT892IfFmog8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=SHWPQsBjqWdAUwT89GesDL5EFdLHXxeP64C4a2wpU2y9bPcp/LvihmFDkPSu6XLzg 1mjc7bTnxg1zUbqDwQttubzN+hxaghPwlB00yjkA6LZxfatDbdKZ3AiDpaLBZNhoZR USEOZE8WfEsXY30x7otLnJGinE3MpwDPMja2Y4HTnvC/UP0VRsukhFIVRrUmAdWTei VZVz0kmqfwQJGO4e2xTUmsRm0grme4yPn6Gcp0joqugbY5QtI+lPKWsTLzcbJD7WsE PPfM/zxmBddsgd0ykqGRVj7HpcVdCPDDYu7Mn7d0OorXjWyQqbF8gns5pVN2qwucz0 OoXPdx8kJaXhg== From: Jonathan Cameron To: linux-iio@vger.kernel.org, Rob Herring Cc: Lars-Peter Clausen , devicetree@vger.kernel.org, Jonathan Cameron , Michael Hennerich Subject: [PATCH v2 2/2] dt-bindings:iio:adc:adi, ad7474: Add missing binding document Date: Mon, 5 Apr 2021 17:23:25 +0100 Message-Id: <20210405162325.627977-3-jic23@kernel.org> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20210405162325.627977-1-jic23@kernel.org> References: <20210405162325.627977-1-jic23@kernel.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Jonathan Cameron This binding covers class of simple SPI ADCs which only provide data output - they don't have MOSI pin. The only real variation between them is over how many supplies they use and which one is used for the reference. Michael listed as maintainer for this one as it is his driver and falls under the catch all MAINTAINERS entry for ADI devices. Signed-off-by: Jonathan Cameron Cc: Michael Hennerich --- .../bindings/iio/adc/adi,ad7476.yaml | 173 ++++++++++++++++++ 1 file changed, 173 insertions(+) -- 2.31.1 Reviewed-by: Rob Herring diff --git a/Documentation/devicetree/bindings/iio/adc/adi,ad7476.yaml b/Documentation/devicetree/bindings/iio/adc/adi,ad7476.yaml new file mode 100644 index 000000000000..bebf5b435947 --- /dev/null +++ b/Documentation/devicetree/bindings/iio/adc/adi,ad7476.yaml @@ -0,0 +1,173 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +# Copyright 2019 Analog Devices Inc. +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/iio/adc/adi,ad7476.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: AD7476 and similar simple SPI ADCs from multiple manufacturers. + +maintainers: + - Michael Hennerich + +description: | + A lot of simple SPI ADCs have very straight forward interfaces. + They typically don't provide a MOSI pin, simply reading out data + on MISO when the clock toggles. + +properties: + compatible: + enum: + - adi,ad7091 + - adi,ad7091r + - adi,ad7273 + - adi,ad7274 + - adi,ad7276 + - adi,ad7277 + - adi,ad7278 + - adi,ad7466 + - adi,ad7467 + - adi,ad7468 + - adi,ad7475 + - adi,ad7476 + - adi,ad7476a + - adi,ad7477 + - adi,ad7477a + - adi,ad7478 + - adi,ad7478a + - adi,ad7495 + - adi,ad7910 + - adi,ad7920 + - adi,ad7940 + - ti,adc081s + - ti,adc101s + - ti,adc121s + - ti,ads7866 + - ti,ads7867 + - ti,ads7868 + - lltc,ltc2314-14 + + reg: + maxItems: 1 + + vcc-supply: + description: + Main powersupply voltage for the chips, sometimes referred to as VDD on + datasheets. If there is no separate vref-supply, then this is needed + to establish channel scaling. + + vdrive-supply: + description: + Some devices have separate supply for their digital control side. + + vref-supply: + description: + Some devices have a specific reference voltage supplied on a different pin + to the other supplies. Needed to be able to establish channel scaling + unless there is also an internal reference available (e.g. ad7091r) + + spi-max-frequency: true + + adi,conversion-start-gpios: + description: A GPIO used to trigger the start of a conversion + +required: + - compatible + - reg + +additionalProperties: false + +allOf: + # Devices where reference is vcc + - if: + properties: + compatible: + contains: + enum: + - adi,ad7091 + - adi,ad7276 + - adi,ad7277 + - adi,ad7278 + - adi,ad7466 + - adi,ad7467 + - adi,ad7468 + - adi,ad7940 + - ti,adc081s + - ti,adc101s + - ti,adc121s + - ti,ads7866 + - ti,ads7868 + required: + - vcc-supply + # Devices with a vref + - if: + properties: + compatible: + contains: + enum: + - adi,ad7091r + - adi,ad7273 + - adi,ad7274 + - adi,ad7475 + - lltc,ltc2314-14 + then: + properties: + vref-supply: true + else: + properties: + vref-supply: false + # Devices with a vref where it is not optional + - if: + properties: + compatible: + contains: + enum: + - adi,ad7273 + - adi,ad7274 + - adi,ad7475 + - lltc,ltc2314-14 + then: + required: + - vref-supply + - if: + properties: + compatible: + contains: + enum: + - adi,ad7475 + - adi,ad7495 + then: + properties: + vdrive-supply: true + else: + properties: + vdrive-supply: false + - if: + properties: + compatible: + contains: + enum: + - adi,ad7091 + - adi,ad7091r + then: + properties: + adi,conversion-start-gpios: true + else: + properties: + adi,conversion-start-gpios: false + +examples: + - | + spi { + #address-cells = <1>; + #size-cells = <0>; + + adc@0 { + compatible = "adi,ad7091r"; + reg = <0>; + spi-max-frequency = <5000000>; + vcc-supply = <&adc_vcc>; + vref-supply = <&adc_vref>; + }; + }; +...