1*65c8a798SAndreas DannenbergTexas Instruments TI SCI Reset Controller
2*65c8a798SAndreas Dannenberg=========================================
3*65c8a798SAndreas Dannenberg
4*65c8a798SAndreas DannenbergSome TI SoCs contain a system controller (like the SYSFW, etc...) that is
5*65c8a798SAndreas Dannenbergresponsible for controlling the state of the IPs that are present.
6*65c8a798SAndreas DannenbergCommunication between the host processor running an OS and the system
7*65c8a798SAndreas Dannenbergcontroller happens through a protocol known as TI SCI [1].
8*65c8a798SAndreas Dannenberg
9*65c8a798SAndreas Dannenberg[1] http://processors.wiki.ti.com/index.php/TISCI
10*65c8a798SAndreas Dannenberg
11*65c8a798SAndreas DannenbergReset Controller Node
12*65c8a798SAndreas Dannenberg=====================
13*65c8a798SAndreas DannenbergThe reset controller node represents the resets of various hardware modules
14*65c8a798SAndreas Dannenbergpresent on the SoC managed by the SYSFW. Because this relies on the TI SCI
15*65c8a798SAndreas Dannenbergprotocol to communicate with the SYSFW it must be a child of the sysfw node.
16*65c8a798SAndreas Dannenberg
17*65c8a798SAndreas DannenbergRequired Properties:
18*65c8a798SAndreas Dannenberg--------------------
19*65c8a798SAndreas Dannenberg - compatible: Must be "ti,sci-reset"
20*65c8a798SAndreas Dannenberg - #reset-cells: Must be 2. Please see the reset consumer node below for
21*65c8a798SAndreas Dannenberg		 usage details.
22*65c8a798SAndreas Dannenberg
23*65c8a798SAndreas DannenbergExample (AM65x):
24*65c8a798SAndreas Dannenberg----------------
25*65c8a798SAndreas Dannenberg	sysfw: sysfw {
26*65c8a798SAndreas Dannenberg		compatible = "ti,am654-system-controller";
27*65c8a798SAndreas Dannenberg		...
28*65c8a798SAndreas Dannenberg		k3_reset: reset-controller {
29*65c8a798SAndreas Dannenberg			compatible = "ti,sci-reset";
30*65c8a798SAndreas Dannenberg			#reset-cells = <2>;
31*65c8a798SAndreas Dannenberg		};
32*65c8a798SAndreas Dannenberg	};
33*65c8a798SAndreas Dannenberg
34*65c8a798SAndreas DannenbergReset Consumers
35*65c8a798SAndreas Dannenberg===============
36*65c8a798SAndreas DannenbergEach of the reset consumer nodes should have the following properties,
37*65c8a798SAndreas Dannenbergin addition to their own properties.
38*65c8a798SAndreas Dannenberg
39*65c8a798SAndreas DannenbergRequired Properties:
40*65c8a798SAndreas Dannenberg--------------------
41*65c8a798SAndreas Dannenberg - resets: A phandle and reset specifier pair, one pair for each reset signal
42*65c8a798SAndreas Dannenberg	   that affects the device, or that the device manages. The phandle
43*65c8a798SAndreas Dannenberg	   should point to the TI SCI reset controller node, and the reset
44*65c8a798SAndreas Dannenberg	   specifier should have 2 cell-values. The first cell should contain
45*65c8a798SAndreas Dannenberg	   the device ID. The second cell should contain the reset mask value
46*65c8a798SAndreas Dannenberg	   used by system controller.
47*65c8a798SAndreas Dannenberg
48*65c8a798SAndreas DannenbergExample (AM65x):
49*65c8a798SAndreas Dannenberg----------------
50*65c8a798SAndreas Dannenberg	uart2: serial@02800000 {
51*65c8a798SAndreas Dannenberg		compatible = "ti,omap4-uart";
52*65c8a798SAndreas Dannenberg		...
53*65c8a798SAndreas Dannenberg		resets = <&k3_reset 5 1>;
54*65c8a798SAndreas Dannenberg	};
55