1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/arm/keyston 4 $id: http://devicetree.org/schemas/arm/keystone/ti,k3-sci-common.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Common K3 TI-SCI 7 title: Common K3 TI-SCI
8 8
9 maintainers: 9 maintainers:
10 - Nishanth Menon <nm@ti.com> 10 - Nishanth Menon <nm@ti.com>
11 11
12 description: | 12 description: |
13 The TI K3 family of SoCs usually have a cent 13 The TI K3 family of SoCs usually have a central System Controller Processor
14 that is responsible for managing various SoC 14 that is responsible for managing various SoC-level resources like clocks,
15 resets, interrupts etc. The communication wi 15 resets, interrupts etc. The communication with that processor is performed
16 through the TI-SCI protocol. 16 through the TI-SCI protocol.
17 17
18 Each specific device management node like a 18 Each specific device management node like a clock controller node, a reset
19 controller node or an interrupt-controller n 19 controller node or an interrupt-controller node should define a common set
20 of properties that enables them to implement 20 of properties that enables them to implement the corresponding functionality
21 over the TI-SCI protocol. The following are 21 over the TI-SCI protocol. The following are some of the common properties
22 needed by such individual nodes. The require 22 needed by such individual nodes. The required properties for each device
23 management node is defined in the respective 23 management node is defined in the respective binding.
24 24
25 properties: 25 properties:
26 ti,sci: 26 ti,sci:
27 $ref: /schemas/types.yaml#/definitions/pha 27 $ref: /schemas/types.yaml#/definitions/phandle
28 description: 28 description:
29 Should be a phandle to the TI-SCI System 29 Should be a phandle to the TI-SCI System Controller node
30 30
31 ti,sci-dev-id: 31 ti,sci-dev-id:
32 $ref: /schemas/types.yaml#/definitions/uin 32 $ref: /schemas/types.yaml#/definitions/uint32
33 description: | 33 description: |
34 Should contain the TI-SCI device id corr 34 Should contain the TI-SCI device id corresponding to the device. Please
35 refer to the corresponding System Contro 35 refer to the corresponding System Controller documentation for valid
36 values for the desired device. 36 values for the desired device.
37 37
38 ti,sci-proc-ids: 38 ti,sci-proc-ids:
39 description: Should contain a single tuple 39 description: Should contain a single tuple of <proc_id host_id>.
40 $ref: /schemas/types.yaml#/definitions/uin 40 $ref: /schemas/types.yaml#/definitions/uint32-array
41 items: 41 items:
42 - description: TI-SCI processor id for t 42 - description: TI-SCI processor id for the remote processor device
43 - description: TI-SCI host id to which p 43 - description: TI-SCI host id to which processor control ownership
44 should be transferred to 44 should be transferred to
45 45
46 additionalProperties: true 46 additionalProperties: true
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.