From patchwork Sun Aug 9 11:17:41 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Cameron X-Patchwork-Id: 247563 Delivered-To: patch@linaro.org Received: by 2002:a92:cc90:0:0:0:0:0 with SMTP id x16csp3995533ilo; Sun, 9 Aug 2020 04:20:03 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzAe1QkehwxfhGfmefjAwHS7brwkugS31U7h2+DF2pSyouGC+94H9avtZ5OqNwQtRrzaz7A X-Received: by 2002:a05:6402:e:: with SMTP id d14mr16908646edu.262.1596972003138; Sun, 09 Aug 2020 04:20:03 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1596972003; cv=none; d=google.com; s=arc-20160816; b=X2JOIyFWw1oznStF1gPcjL8ZBquBqWOArliM0bPnI1oS6z3szJzxK0Ya+Tui7ZVSl5 qb5RzdJPDzZzkymmPFzqFN65Cr28G+DjmVEYfrVguKNNq+D590JbEW4ouElraz4uzZX+ NvBMRyvfB/U9sj4g8jMr2MYYZIrrFQN2ZkfksmLWm14bWJrQ/70nBufcs1K6WhMVwU7W arhlo7IYBayLXcNC6pjyjquMru5cG1EX0KvUmC64CpO123i9xxLCGZgcXFBMQVFcy7SU eIrlyIh1MONleYyIo1SCX7tm5uEN2W1JYX9l6sxas0AEUXm0o7O1gJePAqA7QzFrIcqv JYuA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=BjcxLvEZDgYJtcfFOkeCpkuAOZtA/o2iGEUUfI3hm2k=; b=QA2WvsYjbZrinAyIpA5vm61wmn7dFF96828PDPMlV8WXWOIXge42tAvVUJVHX0c72Q 2qV6BLHFz1XvS7ibHbryRKQDytWfQsv9lliFn5X8irgtP4JtzRZYc5TMEYSlrzShEwty aKllU06ZVKJNHVYlB4JKE9IEkQJ4KjJz/wNysMeZFjbiA0I7ETV5wqri2QexP+f/nZcQ 0C98MFM0WDE1JxlcIvOV+3Bket/vrDf1LYDqSkua6v4Abyur6rY76vrPDV1PENV50tdO EfXN+nkcJmSmFz/Kc7BZqU6P+stcF1r8oXCicCPnt1/uhhgZGMNqX/4xkYOGQrEEIwR7 TYhQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=hXUpfyjZ; 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 x18si8375699eds.427.2020.08.09.04.20.02; Sun, 09 Aug 2020 04:20:03 -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=hXUpfyjZ; 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 S1726322AbgHILUB (ORCPT + 6 others); Sun, 9 Aug 2020 07:20:01 -0400 Received: from mail.kernel.org ([198.145.29.99]:53920 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726199AbgHILUB (ORCPT ); Sun, 9 Aug 2020 07:20:01 -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 61CFD206E9; Sun, 9 Aug 2020 11:19:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1596972000; bh=v5q4uRk0HDMOm1sRyCARO2rfzcScDo6WU31sLgpF0sk=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=hXUpfyjZEwoVX20nXwoTGr4MyiylW0Gkk+mHU+z/IYTYe8sUBXzQkIL8n+FIIa5YI cg7XDbM+5TysgypReB2+POwl9fib/cKeVF02VLzR8l2XtL1yVlpmlHsmd8n25x/DDR YBCIUeUytRpLZKSzrn9yYzPkIDpPRvdyLorCenZY= From: Jonathan Cameron To: linux-iio@vger.kernel.org Cc: Rob Herring , devicetree@vger.kernel.org, Jonathan Cameron , Oskar Andero Subject: [PATCH 01/13] dt-bindings: iio: adc: microchip, mcp3201 yaml conversion. Date: Sun, 9 Aug 2020 12:17:41 +0100 Message-Id: <20200809111753.156236-2-jic23@kernel.org> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20200809111753.156236-1-jic23@kernel.org> References: <20200809111753.156236-1-jic23@kernel.org> MIME-Version: 1.0 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Jonathan Cameron Drops the deprecated compatibles without the vendor name. Whilst the driver continues to support these for old dt blobs, any dt bindings that are actuallly verified against this document should be fixed to add the vendor name. Enforces rule that spi-cpol == spi-cpha. Is there a cleaner way to do this? Added the #io-channel-cells property to allow for consumers. Signed-off-by: Jonathan Cameron Cc: Oskar Andero --- .../devicetree/bindings/iio/adc/mcp320x.txt | 57 ------------ .../bindings/iio/adc/microchip,mcp3201.yaml | 93 +++++++++++++++++++ 2 files changed, 93 insertions(+), 57 deletions(-) -- 2.28.0 Reviewed-by: Rob Herring diff --git a/Documentation/devicetree/bindings/iio/adc/mcp320x.txt b/Documentation/devicetree/bindings/iio/adc/mcp320x.txt deleted file mode 100644 index 56373d643f76..000000000000 --- a/Documentation/devicetree/bindings/iio/adc/mcp320x.txt +++ /dev/null @@ -1,57 +0,0 @@ -* Microchip Analog to Digital Converter (ADC) - -The node for this driver must be a child node of a SPI controller, hence -all mandatory properties described in - - Documentation/devicetree/bindings/spi/spi-bus.txt - -must be specified. - -Required properties: - - compatible: Must be one of the following, depending on the - model: - "mcp3001" (DEPRECATED) - "mcp3002" (DEPRECATED) - "mcp3004" (DEPRECATED) - "mcp3008" (DEPRECATED) - "mcp3201" (DEPRECATED) - "mcp3202" (DEPRECATED) - "mcp3204" (DEPRECATED) - "mcp3208" (DEPRECATED) - "mcp3301" (DEPRECATED) - - "microchip,mcp3001" - "microchip,mcp3002" - "microchip,mcp3004" - "microchip,mcp3008" - "microchip,mcp3201" - "microchip,mcp3202" - "microchip,mcp3204" - "microchip,mcp3208" - "microchip,mcp3301" - "microchip,mcp3550-50" - "microchip,mcp3550-60" - "microchip,mcp3551" - "microchip,mcp3553" - - NOTE: The use of the compatibles with no vendor prefix - is deprecated and only listed because old DT use them. - - - spi-cpha, spi-cpol (boolean): - Either SPI mode (0,0) or (1,1) must be used, so specify - none or both of spi-cpha, spi-cpol. The MCP3550/1/3 - is more efficient in mode (1,1) as only 3 instead of - 4 bytes need to be read from the ADC, but not all SPI - masters support it. - - - vref-supply: Phandle to the external reference voltage supply. - -Examples: -spi_controller { - mcp3x0x@0 { - compatible = "microchip,mcp3002"; - reg = <0>; - spi-max-frequency = <1000000>; - vref-supply = <&vref_reg>; - }; -}; diff --git a/Documentation/devicetree/bindings/iio/adc/microchip,mcp3201.yaml b/Documentation/devicetree/bindings/iio/adc/microchip,mcp3201.yaml new file mode 100644 index 000000000000..38dfb856da62 --- /dev/null +++ b/Documentation/devicetree/bindings/iio/adc/microchip,mcp3201.yaml @@ -0,0 +1,93 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/iio/adc/microchip,mcp3201.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Microchip mcp3201 and similar ADCs + +maintainers: + - Oskar Andero + +description: | + Family of simple ADCs with an I2C inteface. + +properties: + compatible: + enum: + - microchip,mcp3001 + - microchip,mcp3002 + - microchip,mcp3004 + - microchip,mcp3008 + - microchip,mcp3201 + - microchip,mcp3202 + - microchip,mcp3204 + - microchip,mcp3208 + - microchip,mcp3301 + - microchip,mcp3550-50 + - microchip,mcp3550-60 + - microchip,mcp3551 + - microchip,mcp3553 + + reg: + maxItems: 1 + + spi-max-frequency: true + spi-cpha: true + spi-cpol: true + + vref-supply: + description: External reference. + + "#io-channel-cells": + const: 1 + +allOf: + - if: + required: + - spi-cpha + then: + required: + - spi-cpol + else: + properties: + spi-cpol: false + - if: + required: + - spi-cpol + then: + required: + - spi-cpha + else: + properties: + spi-cpha: false + +required: + - compatible + - reg + - vref-supply + +additionalProperties: false + +examples: + - | + spi { + #address-cells = <1>; + #size-cells = <0>; + + adc@0 { + compatible = "microchip,mcp3002"; + reg = <0>; + vref-supply = <&vref_reg>; + spi-cpha; + spi-cpol; + #io-channel-cells = <1>; + }; + adc@1 { + compatible = "microchip,mcp3002"; + reg = <1>; + vref-supply = <&vref_reg>; + spi-max-frequency = <1500000>; + }; + }; +...