[PATCH v2 1/2] Documentation: dt: dwc2: amend clocks property

From: Frank Wang
Date: Wed Feb 08 2017 - 21:44:14 EST

Move 'clocks' to optional properties since not every platform
is going to need to specify it and add pmu/utmi/ulpi/utmifs
optional clocks into 'clock-names' list.

Signed-off-by: Frank Wang <frank.wang@xxxxxxxxxxxxxx>
Documentation/devicetree/bindings/usb/dwc2.txt | 13 ++++++++++---
1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/Documentation/devicetree/bindings/usb/dwc2.txt b/Documentation/devicetree/bindings/usb/dwc2.txt
index 6c7c2bce..4d8b6dd 100644
--- a/Documentation/devicetree/bindings/usb/dwc2.txt
+++ b/Documentation/devicetree/bindings/usb/dwc2.txt
@@ -16,11 +16,18 @@ Required properties:
- snps,dwc2: A generic DWC2 USB controller with default parameters.
- reg : Should contain 1 register range (address and length)
- interrupts : Should contain 1 interrupt
-- clocks: clock provider specifier
-- clock-names: shall be "otg"
-Refer to clk/clock-bindings.txt for generic clock consumer properties

Optional properties:
+- clocks: A list of phandle + clock-specifier pairs for the clocks listed in clock-names.
+- clock-names: Contain the following optional clocks on demand:
+ - "otg": AHB clock. It is the scan clock for the core's AHB domain.
+ - "pmu": PMU hclk. Clock to PMU module when hibernation and/or ADP is enabled.
+ - "utmi": UTMI+ clock. Functionally used only when a UTMI PHY is selected,
+ but always used as the PHY domain clock during DFT Scan mode.
+ - "ulpi": ULPI PHY clock. Present only when a ULPI PHY is selected; negedge
+ is also used in DDR mode.
+ - "utmifs": UTMI FS clock. Present only when OTG_FSPHY_INTERFACE != 0.
+Refer to clk/clock-bindings.txt for generic clock consumer properties
- phys: phy provider specifier
- phy-names: shall be "usb2-phy"
Refer to phy/phy-bindings.txt for generic phy consumer properties