Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

Documentation: Document Exynos5 USB 3.0 DRD PHY

Add necessary binding documentation for USB 3.0 DRD PHY present on
Exynos5 SoC series.

Signed-off-by: Vivek Gautam <gautam.vivek@samsung.com>
Signed-off-by: Kishon Vijay Abraham I <kishon@ti.com>

authored by

Vivek Gautam and committed by
Kishon Vijay Abraham I
9e552a04 3fc03f3d

+47
+47
Documentation/devicetree/bindings/phy/samsung-phy.txt
··· 114 114 compatible = "samsung,exynos-sataphy-i2c"; 115 115 reg = <0x38>; 116 116 }; 117 + 118 + Samsung Exynos5 SoC series USB DRD PHY controller 119 + -------------------------------------------------- 120 + 121 + Required properties: 122 + - compatible : Should be set to one of the following supported values: 123 + - "samsung,exynos5250-usbdrd-phy" - for exynos5250 SoC, 124 + - "samsung,exynos5420-usbdrd-phy" - for exynos5420 SoC. 125 + - reg : Register offset and length of USB DRD PHY register set; 126 + - clocks: Clock IDs array as required by the controller 127 + - clock-names: names of clocks correseponding to IDs in the clock property; 128 + Required clocks: 129 + - phy: main PHY clock (same as USB DRD controller i.e. DWC3 IP clock), 130 + used for register access. 131 + - ref: PHY's reference clock (usually crystal clock), used for 132 + PHY operations, associated by phy name. It is used to 133 + determine bit values for clock settings register. 134 + For Exynos5420 this is given as 'sclk_usbphy30' in CMU. 135 + - samsung,pmu-syscon: phandle for PMU system controller interface, used to 136 + control pmu registers for power isolation. 137 + - #phy-cells : from the generic PHY bindings, must be 1; 138 + 139 + For "samsung,exynos5250-usbdrd-phy" and "samsung,exynos5420-usbdrd-phy" 140 + compatible PHYs, the second cell in the PHY specifier identifies the 141 + PHY id, which is interpreted as follows: 142 + 0 - UTMI+ type phy, 143 + 1 - PIPE3 type phy, 144 + 145 + Example: 146 + usbdrd_phy: usbphy@12100000 { 147 + compatible = "samsung,exynos5250-usbdrd-phy"; 148 + reg = <0x12100000 0x100>; 149 + clocks = <&clock 286>, <&clock 1>; 150 + clock-names = "phy", "ref"; 151 + samsung,pmu-syscon = <&pmu_system_controller>; 152 + #phy-cells = <1>; 153 + }; 154 + 155 + - aliases: For SoCs like Exynos5420 having multiple USB 3.0 DRD PHY controllers, 156 + 'usbdrd_phy' nodes should have numbered alias in the aliases node, 157 + in the form of usbdrdphyN, N = 0, 1... (depending on number of 158 + controllers). 159 + Example: 160 + aliases { 161 + usbdrdphy0 = &usb3_phy0; 162 + usbdrdphy1 = &usb3_phy1; 163 + };