Commit 44aa656f authored by Suman Anna's avatar Suman Anna Committed by Bjorn Andersson
Browse files

dt-bindings: arm: keystone: Add common TI SCI bindings 



Add a bindings document that defines the common TI SCI properties
used by various K3 device management nodes such as clock controllers,
interrupt controllers, reset controllers or remoteproc devices.

The required properties for each device management node shall be
specified in the respective binding document.

Reviewed-by: default avatarRob Herring <robh@kernel.org>
Signed-off-by: default avatarSuman Anna <s-anna@ti.com>
Link: https://lore.kernel.org/r/20200721223617.20312-2-s-anna@ti.com


Signed-off-by: default avatarBjorn Andersson <bjorn.andersson@linaro.org>
parent 42a51c75

Documentation/devicetree/bindings/arm/keystone/ti,k3-sci-common.yaml

0 → 100644
+44 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only or BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/arm/keystone/ti,k3-sci-common.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Common K3 TI-SCI bindings



maintainers:

  - Nishanth Menon <nm@ti.com>



description: |

  The TI K3 family of SoCs usually have a central System Controller Processor

  that is responsible for managing various SoC-level resources like clocks,

  resets, interrupts etc. The communication with that processor is performed

  through the TI-SCI protocol.



  Each specific device management node like a clock controller node, a reset

  controller node or an interrupt-controller node should define a common set

  of properties that enables them to implement the corresponding functionality

  over the TI-SCI protocol. The following are some of the common properties

  needed by such individual nodes. The required properties for each device

  management node is defined in the respective binding.



properties:

  ti,sci:

    $ref: /schemas/types.yaml#/definitions/phandle

    description:

      Should be a phandle to the TI-SCI System Controller node



  ti,sci-dev-id:

    $ref: /schemas/types.yaml#/definitions/uint32

    description: |

      Should contain the TI-SCI device id corresponding to the device. Please

      refer to the corresponding System Controller documentation for valid

      values for the desired device.



  ti,sci-proc-ids:

    description: Should contain a single tuple of <proc_id host_id>.

    $ref: /schemas/types.yaml#/definitions/uint32-array

    items:

      - description: TI-SCI processor id for the remote processor device

      - description: TI-SCI host id to which processor control ownership

                     should be transferred to

MAINTAINERS

+1 −0
Original line number Diff line number Diff line
@@ -16887,6 +16887,7 @@ M: Tero Kristo <t-kristo@ti.com> 
M:	Santosh Shilimkar <ssantosh@kernel.org>

L:	linux-arm-kernel@lists.infradead.org

S:	Maintained

F:	Documentation/devicetree/bindings/arm/keystone/ti,k3-sci-common.yaml

F:	Documentation/devicetree/bindings/arm/keystone/ti,sci.txt

F:	Documentation/devicetree/bindings/clock/ti,sci-clk.txt

F:	Documentation/devicetree/bindings/interrupt-controller/ti,sci-inta.txt

CRA Git | Maintained and supported by SUSTech CRA and CCSE