blob: 4d40d0dcb6d7751ff7c65f100929674bcf5bc116 [file] [log] [blame]
Lokesh Vutla32cd2512018-08-27 15:57:32 +05301Texas Instruments System Control Interface (TI-SCI) Message Protocol
2--------------------------------------------------------------------
3
4Texas Instrument's processors including those belonging to Keystone generation
5of processors have separate hardware entity which is now responsible for the
6management of the System on Chip (SoC) system. These include various system
7level functions as well.
8
9An example of such an SoC is K2G, which contains the system control hardware
10block called Power Management Micro Controller (PMMC). This hardware block is
11initialized early into boot process and provides services to Operating Systems
12on multiple processors including ones running Linux.
13
14See http://processors.wiki.ti.com/index.php/TISCI for protocol definition.
15
16TI-SCI controller Device Node:
17=============================
18
19The TI-SCI node describes the Texas Instrument's System Controller entity node.
20This parent node may optionally have additional children nodes which describe
21specific functionality such as clocks, power domain, reset or additional
22functionality as may be required for the SoC. This hierarchy also describes the
23relationship between the TI-SCI parent node to the child node.
24
25Required properties:
26-------------------
27- compatible: should be "ti,k2g-sci"
28- mbox-names:
29 "rx" - Mailbox corresponding to receive path
30 "tx" - Mailbox corresponding to transmit path
31
32- mboxes: Mailboxes corresponding to the mbox-names. Each value of the mboxes
33 property should contain a phandle to the mailbox controller device
34 node and an args specifier that will be the phandle to the intended
35 sub-mailbox child node to be used for communication.
36
37Optional Properties:
38-------------------
39- reg-names:
40 debug_messages - Map the Debug message region
41- reg: register space corresponding to the debug_messages
42- ti,system-reboot-controller: If system reboot can be triggered by SoC reboot
43- ti,secure-host: If the host is defined as secure.
44
45Example:
46-------------
47 dmsc: dmsc {
48 compatible = "ti,k2g-sci";
49 ti,host-id = <12>;
50 #address-cells = <1>;
51 #size-cells = <1>;
52 ranges;
53 }
54
55
56TI-SCI Client Device Node:
57=========================
58
59Client nodes are maintained as children of the relevant TI-SCI device node.
60
61Example:
62-------------
63 dmsc: dmsc {
64 compatible = "ti,k2g-sci";
65 ...
66
67 my_clk_node: clk_node {
68 ...
69 ...
70 };
71
72 my_pd_node: pd_node {
73 ...
74 ...
75 };
76 };