staging: wilc1000: updated DT binding documentation

Merged the DT binding documentation of SDIO and SPI into a single file.
Removed documentation for some of the properties which are not required
and handled review comments received in [1] & [2].

[1]. https://lore.kernel.org/linux-wireless/20200303020230.GA15543@bogus
[2]. https://lore.kernel.org/linux-wireless/20200303015558.GA6876@bogus

Signed-off-by: Ajay Singh <ajay.kathat@microchip.com>
Link: https://lore.kernel.org/r/20200307085523.7320-4-ajay.kathat@microchip.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
This commit is contained in:
Ajay Singh 2020-03-07 08:55:32 +00:00 committed by Greg Kroah-Hartman
parent 9aa4e8de3b
commit 1693a2fa4b
3 changed files with 72 additions and 129 deletions

View File

@ -1,68 +0,0 @@
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/net/wireless/microchip,wilc1000,sdio.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Microchip WILC wireless SDIO devicetree bindings
maintainers:
- Adham Abozaeid <adham.abozaeid@microchip.com>
- Ajay Singh <ajay.kathat@microchip.com>
description:
The wilc1000 chips can be connected via SDIO. The node is used to
specify child node to the SDIO controller that connects the device
to the system.
properties:
compatible:
const: microchip,wilc1000-sdio
irq-gpios:
description: The GPIO phandle connect to a host IRQ.
maxItems: 1
reg:
description: Slot ID used in the controller.
maxItems: 1
clocks:
description: phandle to the clock connected on rtc clock line.
maxItems: 1
bus-width:
description: The number of data lines wired up the slot.
allOf:
- $ref: /schemas/types.yaml#/definitions/uint32
- enum: [1, 4, 8]
- default: 1
required:
- compatible
- irq-gpios
- reg
examples:
- |
mmc1: mmc@fc000000 {
#address-cells = <1>;
#size-cells = <0>;
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_mmc1_clk_cmd_dat0 &pinctrl_mmc1_dat1_3>;
non-removable;
vmmc-supply = <&vcc_mmc1_reg>;
vqmmc-supply = <&vcc_3v3_reg>;
status = "okay";
wilc_sdio@0 {
compatible = "microchip,wilc1000-sdio";
irq-gpios = <&pioC 27 0>;
reg = <0>;
clocks = <&pck1>;
clock-names = "rtc_clk";
assigned-clocks = <&pck1>;
assigned-clock-rates = <32768>;
status = "okay";
bus-width = <4>;
};
};

View File

@ -1,61 +0,0 @@
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/net/wireless/microchip,wilc1000,spi.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Microchip WILC wireless SPI devicetree bindings
maintainers:
- Adham Abozaeid <adham.abozaeid@microchip.com>
- Ajay Singh <ajay.kathat@microchip.com>
description:
The wilc1000 chips can be connected via SPI. This document describes
the binding for the SPI connected module.
properties:
compatible:
const: microchip,wilc1000-spi
spi-max-frequency:
description: Maximum SPI clocking speed of device in Hz.
maxItems: 1
reg:
description: Chip select address of device.
maxItems: 1
irq-gpios:
description: The GPIO phandle connect to a host IRQ.
maxItems: 1
clocks:
description: phandle to the clock connected on rtc clock line.
maxItems: 1
required:
- compatible
- spi-max-frequency
- reg
- irq-gpios
examples:
- |
spi1: spi@fc018000 {
#address-cells = <1>;
#size-cells = <0>;
cs-gpios = <&pioB 21 0>;
status = "okay";
wilc_spi@0 {
compatible = "microchip,wilc1000-spi";
spi-max-frequency = <48000000>;
reg = <0>;
irq-gpios = <&pioC 27 0>;
clocks = <&pck1>;
clock-names = "rtc_clk";
assigned-clocks = <&pck1>;
assigned-clock-rates = <32768>;
status = "okay";
};
};

View File

@ -0,0 +1,72 @@
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/net/wireless/microchip,wilc1000.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Microchip WILC wireless devicetree bindings
maintainers:
- Adham Abozaeid <adham.abozaeid@microchip.com>
- Ajay Singh <ajay.kathat@microchip.com>
description:
The wilc1000 chips can be connected via SPI or SDIO. This document
describes the binding to connect wilc devices.
properties:
compatible:
const: microchip,wilc1000
spi-max-frequency: true
interrupts:
maxItems: 1
clocks:
description: phandle to the clock connected on rtc clock line.
maxItems: 1
clock-names:
const: rtc
required:
- compatible
- interrupts
examples:
- |
spi1: spi@fc018000 {
#address-cells = <1>;
#size-cells = <0>;
cs-gpios = <&pioB 21 0>;
wifi@0 {
compatible = "microchip,wilc1000";
spi-max-frequency = <48000000>;
reg = <0>;
interrupt-parent = <&pioC>;
interrupts = <27 0>;
clocks = <&pck1>;
clock-names = "rtc";
};
};
- |
mmc1: mmc@fc000000 {
#address-cells = <1>;
#size-cells = <0>;
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_mmc1_clk_cmd_dat0 &pinctrl_mmc1_dat1_3>;
non-removable;
vmmc-supply = <&vcc_mmc1_reg>;
vqmmc-supply = <&vcc_3v3_reg>;
bus-width = <4>;
wifi@0 {
compatible = "microchip,wilc1000";
reg = <0>;
interrupt-parent = <&pioC>;
interrupts = <27 0>;
clocks = <&pck1>;
clock-names = "rtc";
};
};