Files
linux/Documentation/devicetree/bindings/soc/ti/sci-pm-domain.yaml
Nishanth Menon fda55c7256 dt-bindings: soc: ti: Convert ti,sci-pm-domain to json schema
Convert the ti,sci-pm-domain to json schema for better checks and
documentation.

Differences being:
 - Drop consumer example as they are documented in the corresponding
   bindings themselves.
 - Drop phandle description for reset consumer or cell definition as it
   is redundant.

Signed-off-by: Nishanth Menon <nm@ti.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Reviewed-by: Tero Kristo <kristo@kernel.org>
Acked-by: Stephen Boyd <sboyd@kernel.org>
Link: https://lore.kernel.org/r/20210426155457.21221-4-nm@ti.com
Signed-off-by: Rob Herring <robh@kernel.org>
2021-05-10 11:54:31 -05:00

60 lines
1.9 KiB
YAML

# SPDX-License-Identifier: (GPL-2.0-only or BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/soc/ti/sci-pm-domain.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: TI-SCI generic power domain node bindings
maintainers:
- Nishanth Menon <nm@ti.com>
allOf:
- $ref: /schemas/power/power-domain.yaml#
description: |
Some TI SoCs contain a system controller (like the Power Management Micro
Controller (PMMC) on Keystone 66AK2G SoC) that are responsible for controlling
the state of the various hardware modules present on the SoC. Communication
between the host processor running an OS and the system controller happens
through a protocol called TI System Control Interface (TI-SCI protocol).
This PM domain node represents the global PM domain managed by the TI-SCI
controller. Since this relies on the TI SCI protocol to communicate with
the TI-SCI controller, it must be a child of the TI-SCI controller node.
properties:
compatible:
const: ti,sci-pm-domain
"#power-domain-cells":
enum: [1, 2]
description:
The two cells represent values that the TI-SCI controller defines.
The first cell should contain the device ID.
The second cell, if cell-value is 2, should be one of the following
TI_SCI_PD_EXCLUSIVE - Allows the device to be exclusively controlled
or
TI_SCI_PD_SHARED - Allows the device to be shared by multiple hosts.
Please refer to dt-bindings/soc/ti,sci_pm_domain.h for the definitions.
Please see http://processors.wiki.ti.com/index.php/TISCI for
protocol documentation for the values to be used for different devices.
additionalProperties: false
examples:
- |
k2g_pds: power-controller {
compatible = "ti,sci-pm-domain";
#power-domain-cells = <1>;
};
- |
k3_pds: power-controller {
compatible = "ti,sci-pm-domain";
#power-domain-cells = <2>;
};