On Sat, 18 May 2019 18:55:42 -0300 Lucas Oshiro <lucasseikioshiro@xxxxxxxxx> wrote: > Convert the old device tree documentation to yaml format. > > Signed-off-by: Lucas Oshiro <lucasseikioshiro@xxxxxxxxx> > Signed-off-by: Rodrigo Ribeiro <rodrigorsdc@xxxxxxxxx> > Co-developed-by: Rodrigo Ribeiro <rodrigorsdc@xxxxxxxxx> > --- > > Hello, > We've added Stefan Popa as maintainer of the yaml documentation of this driver > because we found through git that he was the author of the older documentation. Definitely going to need an Ack from Stefan for that ;) I've not really gotten yaml formats into my head yet, but from a quick look I think this is fine. I will however be looking for review from others on these. Thanks, Jonathan > > .../bindings/iio/accel/adi,adxl372.yaml | 66 +++++++++++++++++++ > .../devicetree/bindings/iio/accel/adxl372.txt | 33 ---------- > 2 files changed, 66 insertions(+), 33 deletions(-) > create mode 100644 Documentation/devicetree/bindings/iio/accel/adi,adxl372.yaml > delete mode 100644 Documentation/devicetree/bindings/iio/accel/adxl372.txt > > diff --git a/Documentation/devicetree/bindings/iio/accel/adi,adxl372.yaml b/Documentation/devicetree/bindings/iio/accel/adi,adxl372.yaml > new file mode 100644 > index 000000000000..a6e2893d2ab1 > --- /dev/null > +++ b/Documentation/devicetree/bindings/iio/accel/adi,adxl372.yaml > @@ -0,0 +1,66 @@ > +# SPDX-License-Identifier: GPL-2.0 > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/iio/accelerometers/adi,adxl372.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Analog Devices ADXL372 3-Axis, +/-(200g) Digital Accelerometer > + > +maintainers: > + - Stefan Popa <stefan.popa@xxxxxxxxxx> > + > +description: | > + Analog Devices ADXL372 3-Axis, +/-(200g) Digital Accelerometer that supports > + both I2C & SPI interfaces > + https://www.analog.com/en/products/adxl372.html > + > +properties: > + compatible: > + enum: > + - adi,adxl372 > + > + reg: > + description: the I2C address or SPI chip select number for the device > + maxItems: 1 > + > + interrupts: > + description: > + interrupt mapping for IRQ as documented in > + Documentation/devicetree/bindings/interrupt-controller/interrupts.txt > + maxItems: 1 > + > +required: > + - compatible > + - reg > + > +examples: > + - | > + #include <dt-bindings/gpio/gpio.h> > + #include <dt-bindings/interrupt-controller/irq.h> > + i2c0 { > + #address-cells = <1>; > + #size-cells = <0>; > + > + /* Example for a I2C device node */ > + accelerometer@53 { > + compatible = "adi,adxl372"; > + reg = <0x53>; > + interrupt-parent = <&gpio>; > + interrupts = <25 IRQ_TYPE_EDGE_FALLING>; > + }; > + }; > + - | > + #include <dt-bindings/gpio/gpio.h> > + #include <dt-bindings/interrupt-controller/irq.h> > + spi0 { > + #address-cells = <1>; > + #size-cells = <0>; > + > + accelerometer@0 { > + compatible = "adi,adxl372"; > + reg = <0>; > + spi-max-frequency = <1000000>; > + interrupt-parent = <&gpio>; > + interrupts = <25 IRQ_TYPE_EDGE_FALLING>; > + }; > + }; > diff --git a/Documentation/devicetree/bindings/iio/accel/adxl372.txt b/Documentation/devicetree/bindings/iio/accel/adxl372.txt > deleted file mode 100644 > index a289964756a7..000000000000 > --- a/Documentation/devicetree/bindings/iio/accel/adxl372.txt > +++ /dev/null > @@ -1,33 +0,0 @@ > -Analog Devices ADXL372 3-Axis, +/-(200g) Digital Accelerometer > - > -http://www.analog.com/media/en/technical-documentation/data-sheets/adxl372.pdf > - > -Required properties: > - - compatible : should be "adi,adxl372" > - - reg: the I2C address or SPI chip select number for the device > - > -Required properties for SPI bus usage: > - - spi-max-frequency: Max SPI frequency to use > - > -Optional properties: > - - interrupts: interrupt mapping for IRQ as documented in > - Documentation/devicetree/bindings/interrupt-controller/interrupts.txt > - > -Example for a I2C device node: > - > - accelerometer@53 { > - compatible = "adi,adxl372"; > - reg = <0x53>; > - interrupt-parent = <&gpio>; > - interrupts = <25 IRQ_TYPE_EDGE_FALLING>; > - }; > - > -Example for a SPI device node: > - > - accelerometer@0 { > - compatible = "adi,adxl372"; > - reg = <0>; > - spi-max-frequency = <1000000>; > - interrupt-parent = <&gpio>; > - interrupts = <25 IRQ_TYPE_EDGE_FALLING>; > - };