From: Martin Blumenstingl <martin.blumenstingl@xxxxxxxxxxxxxx>
This adds the initial documentation for the RCU module (a MFD device
which provides USB PHYs, reset controllers and more).
Signed-off-by: Hauke Mehrtens <hauke@xxxxxxxxxx>
---
.../devicetree/bindings/mips/lantiq/rcu.txt | 82 ++++++++++++++++++++++
1 file changed, 82 insertions(+)
create mode 100644 Documentation/devicetree/bindings/mips/lantiq/rcu.txt
diff --git a/Documentation/devicetree/bindings/mips/lantiq/rcu.txt b/Documentation/devicetree/bindings/mips/lantiq/rcu.txt
new file mode 100644
index 000000000000..9e5b1e7493e4
--- /dev/null
+++ b/Documentation/devicetree/bindings/mips/lantiq/rcu.txt
@@ -0,0 +1,82 @@
+Lantiq XWAY SoC RCU binding
+===========================
+
+This binding describes the RCU (reset controller unit) multifunction device,
+where each sub-device has it's own set of registers.
+
+
+-------------------------------------------------------------------------------
+Required properties:
+- compatible : The first and second values must be: "simple-mfd", "syscon"
+- reg : The address and length of the system control registers
+
+
+-------------------------------------------------------------------------------
+Example of the RCU bindings on a xRX200 SoC:
+ rcu0: rcu@203000 {
+ compatible = "simple-mfd", "syscon";
+ reg = <0x203000 0x100>;
+ big-endian;
+
+ gphy0: rcu_gphy@0 {
+ compatible = "lantiq,xrx200a2x-rcu-gphy";
+ lantiq,rcu-syscon = <&rcu0 0x20>;
+ resets = <&rcu_reset0 31>;
+ reset-names = "gphy";
+ lantiq,gphy-mode = <GPHY_MODE_GE>;
+ clocks = <&pmu0 XRX200_PMU_GATE_GPHY>;
+ clock-names = "gphy";
+ };
+
+ gphy1: rcu_gphy@1 {
+ compatible = "lantiq,xrx200a2x-rcu-gphy";
+ lantiq,rcu-syscon = <&rcu0 0x68>;
+ resets = <&rcu_reset0 29>;
+ reset-names = "gphy";
+ lantiq,gphy-mode = <GPHY_MODE_FE>;
+ clocks = <&pmu0 XRX200_PMU_GATE_GPHY>;
+ clock-names = "gphy";
+ };
+
+ rcu_reset0: rcu_reset@0 {
+ compatible = "lantiq,rcu-reset";
+ lantiq,rcu-syscon = <&rcu0 0x10 0x14>;
+ #reset-cells = <1>;
+ reset-request = <31>, <29>, <21>, <19>, <16>, <12>;
+ reset-status = <30>, <28>, <16>, <25>, <5>, <24>;
+ };
+
+ rcu_reset1: rcu_reset@1 {
+ compatible = "lantiq,rcu-reset";
+ lantiq,rcu-syscon = <&rcu0 0x48 0x24>;
+ #reset-cells = <1>;
+ };
+
+ usb_phys0: rcu-usb2-phy@0 {
+ compatible = "lantiq,xrx200-rcu-usb2-phy";
+
+ lantiq,rcu-syscon = <&rcu0 0x18 0x38>;
+ resets = <&rcu_reset1 4>, <&rcu_reset0 4>;
+ reset-names = "phy", "ctrl";
+ #phy-cells = <0>;
+ };
+
+ usb_phys1: rcu-usb2-phy@1 {
+ compatible = "lantiq,xrx200-rcu-usb2-phy";
+
+ lantiq,rcu-syscon = <&rcu0 0x34 0x3C>;
+ resets = <&rcu_reset1 5>, <&rcu_reset0 4>;
+ reset-names = "phy", "ctrl";
+ #phy-cells = <0>;
+ };
+
+ reboot {
+ compatible = "syscon-reboot";
+ regmap = <&rcu0>;
+ offset = <0x10>;
+ mask = <0x40000000>;
+ };
+
+ /* more sub-device nodes (USB PHY, etc.) */
+ };
+
--
2.11.0
