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