xref: /freebsd-src/sys/contrib/device-tree/Bindings/mips/lantiq/rcu.txt (revision b97ee269eae3cbaf35c18f51a459aea581c2a7dc)
1c66ec88fSEmmanuel VadotLantiq XWAY SoC RCU binding
2c66ec88fSEmmanuel Vadot===========================
3c66ec88fSEmmanuel Vadot
4c66ec88fSEmmanuel VadotThis binding describes the RCU (reset controller unit) multifunction device,
5*b97ee269SEmmanuel Vadotwhere each sub-device has its own set of registers.
6c66ec88fSEmmanuel Vadot
7c66ec88fSEmmanuel VadotThe RCU register range is used for multiple purposes. Mostly one device
8c66ec88fSEmmanuel Vadotuses one or multiple register exclusively, but for some registers some
9c66ec88fSEmmanuel Vadotbits are for one driver and some other bits are for a different driver.
10c66ec88fSEmmanuel VadotWith this patch all accesses to the RCU registers will go through
11c66ec88fSEmmanuel Vadotsyscon.
12c66ec88fSEmmanuel Vadot
13c66ec88fSEmmanuel Vadot
14c66ec88fSEmmanuel Vadot-------------------------------------------------------------------------------
15c66ec88fSEmmanuel VadotRequired properties:
16c66ec88fSEmmanuel Vadot- compatible	: The first and second values must be:
17c66ec88fSEmmanuel Vadot		  "lantiq,xrx200-rcu", "simple-mfd", "syscon"
18c66ec88fSEmmanuel Vadot- reg		: The address and length of the system control registers
19c66ec88fSEmmanuel Vadot
20c66ec88fSEmmanuel Vadot
21c66ec88fSEmmanuel Vadot-------------------------------------------------------------------------------
22c66ec88fSEmmanuel VadotExample of the RCU bindings on a xRX200 SoC:
23c66ec88fSEmmanuel Vadot	rcu0: rcu@203000 {
24c66ec88fSEmmanuel Vadot		compatible = "lantiq,xrx200-rcu", "simple-mfd", "syscon";
25c66ec88fSEmmanuel Vadot		reg = <0x203000 0x100>;
26c66ec88fSEmmanuel Vadot		ranges = <0x0 0x203000 0x100>;
27c66ec88fSEmmanuel Vadot		big-endian;
28c66ec88fSEmmanuel Vadot
29c66ec88fSEmmanuel Vadot		reset0: reset-controller@10 {
30c66ec88fSEmmanuel Vadot			compatible = "lantiq,xrx200-reset";
31c66ec88fSEmmanuel Vadot			reg = <0x10 4>, <0x14 4>;
32c66ec88fSEmmanuel Vadot
33c66ec88fSEmmanuel Vadot			#reset-cells = <2>;
34c66ec88fSEmmanuel Vadot		};
35c66ec88fSEmmanuel Vadot
36c66ec88fSEmmanuel Vadot		reset1: reset-controller@48 {
37c66ec88fSEmmanuel Vadot			compatible = "lantiq,xrx200-reset";
38c66ec88fSEmmanuel Vadot			reg = <0x48 4>, <0x24 4>;
39c66ec88fSEmmanuel Vadot
40c66ec88fSEmmanuel Vadot			#reset-cells = <2>;
41c66ec88fSEmmanuel Vadot		};
42c66ec88fSEmmanuel Vadot
43c66ec88fSEmmanuel Vadot		usb_phy0: usb2-phy@18 {
44c66ec88fSEmmanuel Vadot			compatible = "lantiq,xrx200-usb2-phy";
45c66ec88fSEmmanuel Vadot			reg = <0x18 4>, <0x38 4>;
46c66ec88fSEmmanuel Vadot
47c66ec88fSEmmanuel Vadot			resets = <&reset1 4 4>, <&reset0 4 4>;
48c66ec88fSEmmanuel Vadot			reset-names = "phy", "ctrl";
49c66ec88fSEmmanuel Vadot			#phy-cells = <0>;
50c66ec88fSEmmanuel Vadot		};
51c66ec88fSEmmanuel Vadot
52c66ec88fSEmmanuel Vadot		usb_phy1: usb2-phy@34 {
53c66ec88fSEmmanuel Vadot			compatible = "lantiq,xrx200-usb2-phy";
54c66ec88fSEmmanuel Vadot			reg = <0x34 4>, <0x3C 4>;
55c66ec88fSEmmanuel Vadot
56c66ec88fSEmmanuel Vadot			resets = <&reset1 5 4>, <&reset0 4 4>;
57c66ec88fSEmmanuel Vadot			reset-names = "phy", "ctrl";
58c66ec88fSEmmanuel Vadot			#phy-cells = <0>;
59c66ec88fSEmmanuel Vadot		};
60c66ec88fSEmmanuel Vadot
61c66ec88fSEmmanuel Vadot		reboot@10 {
62c66ec88fSEmmanuel Vadot			compatible = "syscon-reboot";
63c66ec88fSEmmanuel Vadot			reg = <0x10 4>;
64c66ec88fSEmmanuel Vadot
65c66ec88fSEmmanuel Vadot			regmap = <&rcu0>;
66c66ec88fSEmmanuel Vadot			offset = <0x10>;
67c66ec88fSEmmanuel Vadot			mask = <0x40000000>;
68c66ec88fSEmmanuel Vadot		};
69c66ec88fSEmmanuel Vadot	};
70