Re: [PATCH 2/3] doc,dts - add XRA1403 DTS binding documentation
From: Rob Herring
Date: Fri Mar 31 2017 - 14:50:04 EST
On Mon, Mar 27, 2017 at 09:23:01AM +0300, Nandor Han wrote:
> Add the XRA1403 DTS binding documentation.
"dt-bindings: gpio: ..." for the subject prefix please.
>
> Signed-off-by: Nandor Han <nandor.han@xxxxxx>
> ---
> .../devicetree/bindings/gpio/gpio-xra1403.txt | 37 ++++++++++++++++++++++
> 1 file changed, 37 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/gpio/gpio-xra1403.txt
>
> diff --git a/Documentation/devicetree/bindings/gpio/gpio-xra1403.txt b/Documentation/devicetree/bindings/gpio/gpio-xra1403.txt
> new file mode 100644
> index 0000000..ccf5337
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/gpio/gpio-xra1403.txt
> @@ -0,0 +1,37 @@
> +GPIO Driver for XRA1403 16-BIT GPIO Expander With Reset Input from EXAR
> +
> +The XRA1403 is an 16-bit GPIO expander with an SPI interface. Features available:
> + - Individually programmable inputs:
> + - Internal pull-up resistors
> + - Polarity inversion
> + - Individual interrupt enable
> + - Rising edge and/or Falling edge interrupt
> + - Input filter
> + - Individually programmable outputs
> + - Output Level Control
> + - Output Three-State Control
> +
> +Properties
> +----------
> +Check documentation for SPI and GPIO controllers regarding properties needed to configure the node.
> +
> + - compatible = "exar,xra1403".
> + - reg = SPI id of the device.
> + - gpio-controller: mark the node as gpio.
#gpio-cells?
> +
> +Optional properties:
> +-------------------
> + - reset-gpios: in case available used to control the device reset line.
> +
> +Example
> +--------
> +
> + gpioxra0: gpio@2 {
> + compatible = "exar,xra1403";
> + reg = <2>;
> + gpio-controller;
> + #gpio-cells = <2>;
> + reset-gpios = <&gpio3 6 GPIO_ACTIVE_LOW>;
> + spi-max-frequency = <1000000>;
> + status = "okay";
Don't show status in examples.
> + };
> --
> 2.10.1
>