Commit 8d7eab62 authored by Jonathan Cameron's avatar Jonathan Cameron
Browse files

dt-bindings: iio: adc: microchip,mcp3201 yaml conversion.



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.

Added the #io-channel-cells property to allow for consumers.

Signed-off-by: default avatarJonathan Cameron <Jonathan.Cameron@huawei.com>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Cc: Oskar Andero <oskar.andero@gmail.com>
Link: https://lore.kernel.org/r/20200809111753.156236-2-jic23@kernel.org
parent 65e02d0b
Loading
Loading
Loading
Loading
+0 −57
Original line number Diff line number Diff line
* 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>;
	};
};
+77 −0
Original line number Diff line number Diff line
# 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 <oskar.andero@gmail.com>

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

dependencies:
  spi-cpol: [ spi-cpha ]
  spi-cpha: [ spi-cpol ]

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>;
        };
    };
...