0001 # SPDX-License-Identifier: (GPL-2.0-only or BSD-2-Clause)
0002 %YAML 1.2
0003 ---
0004 $id: http://devicetree.org/schemas/soc/ti/sci-pm-domain.yaml#
0005 $schema: http://devicetree.org/meta-schemas/core.yaml#
0006
0007 title: TI-SCI generic power domain node bindings
0008
0009 maintainers:
0010 - Nishanth Menon <nm@ti.com>
0011
0012 allOf:
0013 - $ref: /schemas/power/power-domain.yaml#
0014
0015 description: |
0016 Some TI SoCs contain a system controller (like the Power Management Micro
0017 Controller (PMMC) on Keystone 66AK2G SoC) that are responsible for controlling
0018 the state of the various hardware modules present on the SoC. Communication
0019 between the host processor running an OS and the system controller happens
0020 through a protocol called TI System Control Interface (TI-SCI protocol).
0021
0022 This PM domain node represents the global PM domain managed by the TI-SCI
0023 controller. Since this relies on the TI SCI protocol to communicate with
0024 the TI-SCI controller, it must be a child of the TI-SCI controller node.
0025
0026 properties:
0027 compatible:
0028 const: ti,sci-pm-domain
0029
0030 "#power-domain-cells":
0031 enum: [1, 2]
0032 description:
0033 The two cells represent values that the TI-SCI controller defines.
0034
0035 The first cell should contain the device ID.
0036
0037 The second cell, if cell-value is 2, should be one of the following
0038 TI_SCI_PD_EXCLUSIVE - Allows the device to be exclusively controlled
0039 or
0040 TI_SCI_PD_SHARED - Allows the device to be shared by multiple hosts.
0041 Please refer to dt-bindings/soc/ti,sci_pm_domain.h for the definitions.
0042
0043 Please see http://processors.wiki.ti.com/index.php/TISCI for
0044 protocol documentation for the values to be used for different devices.
0045
0046 additionalProperties: false
0047
0048 examples:
0049 - |
0050 k2g_pds: power-controller {
0051 compatible = "ti,sci-pm-domain";
0052 #power-domain-cells = <1>;
0053 };
0054
0055 - |
0056 k3_pds: power-controller {
0057 compatible = "ti,sci-pm-domain";
0058 #power-domain-cells = <2>;
0059 };
