mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-12-14 22:44:27 +08:00
dt-bindings: power: Convert imx gpcv2 to json-schema
Convert the i.MX GPCv2 binding to DT schema format using json-schema Example is updated based on latest DT file and consumer's example is removed since it is NOT that useful. Signed-off-by: Anson Huang <Anson.Huang@nxp.com> Signed-off-by: Rob Herring <robh@kernel.org>
This commit is contained in:
parent
0c03fa00fd
commit
e6b12afe65
@ -1,77 +0,0 @@
|
|||||||
Freescale i.MX General Power Controller v2
|
|
||||||
==========================================
|
|
||||||
|
|
||||||
The i.MX7S/D General Power Control (GPC) block contains Power Gating
|
|
||||||
Control (PGC) for various power domains.
|
|
||||||
|
|
||||||
Required properties:
|
|
||||||
|
|
||||||
- compatible: Should be one of:
|
|
||||||
- "fsl,imx7d-gpc"
|
|
||||||
- "fsl,imx8mq-gpc"
|
|
||||||
|
|
||||||
- reg: should be register base and length as documented in the
|
|
||||||
datasheet
|
|
||||||
|
|
||||||
- interrupts: Should contain GPC interrupt request 1
|
|
||||||
|
|
||||||
Power domains contained within GPC node are generic power domain
|
|
||||||
providers, documented in
|
|
||||||
Documentation/devicetree/bindings/power/power-domain.yaml, which are
|
|
||||||
described as subnodes of the power gating controller 'pgc' node,
|
|
||||||
which, in turn, is expected to contain the following:
|
|
||||||
|
|
||||||
Required properties:
|
|
||||||
|
|
||||||
- reg: Power domain index. Valid values are defined in
|
|
||||||
include/dt-bindings/power/imx7-power.h for fsl,imx7d-gpc and
|
|
||||||
include/dt-bindings/power/imx8m-power.h for fsl,imx8mq-gpc
|
|
||||||
|
|
||||||
- #power-domain-cells: Should be 0
|
|
||||||
|
|
||||||
Optional properties:
|
|
||||||
|
|
||||||
- power-supply: Power supply used to power the domain
|
|
||||||
- clocks: a number of phandles to clocks that need to be enabled during
|
|
||||||
domain power-up sequencing to ensure reset propagation into devices
|
|
||||||
located inside this power domain
|
|
||||||
|
|
||||||
Example:
|
|
||||||
|
|
||||||
gpc: gpc@303a0000 {
|
|
||||||
compatible = "fsl,imx7d-gpc";
|
|
||||||
reg = <0x303a0000 0x1000>;
|
|
||||||
interrupt-controller;
|
|
||||||
interrupts = <GIC_SPI 87 IRQ_TYPE_LEVEL_HIGH>;
|
|
||||||
#interrupt-cells = <3>;
|
|
||||||
interrupt-parent = <&intc>;
|
|
||||||
|
|
||||||
pgc {
|
|
||||||
#address-cells = <1>;
|
|
||||||
#size-cells = <0>;
|
|
||||||
|
|
||||||
pgc_pcie_phy: power-domain@1 {
|
|
||||||
#power-domain-cells = <0>;
|
|
||||||
|
|
||||||
reg = <1>;
|
|
||||||
power-supply = <®_1p0d>;
|
|
||||||
};
|
|
||||||
};
|
|
||||||
};
|
|
||||||
|
|
||||||
|
|
||||||
Specifying power domain for IP modules
|
|
||||||
======================================
|
|
||||||
|
|
||||||
IP cores belonging to a power domain should contain a 'power-domains'
|
|
||||||
property that is a phandle for PGC node representing the domain.
|
|
||||||
|
|
||||||
Example of a device that is part of the PCIE_PHY power domain:
|
|
||||||
|
|
||||||
pcie: pcie@33800000 {
|
|
||||||
reg = <0x33800000 0x4000>,
|
|
||||||
<0x4ff00000 0x80000>;
|
|
||||||
/* ... */
|
|
||||||
power-domains = <&pgc_pcie_phy>;
|
|
||||||
/* ... */
|
|
||||||
};
|
|
108
Documentation/devicetree/bindings/power/fsl,imx-gpcv2.yaml
Normal file
108
Documentation/devicetree/bindings/power/fsl,imx-gpcv2.yaml
Normal file
@ -0,0 +1,108 @@
|
|||||||
|
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
||||||
|
%YAML 1.2
|
||||||
|
---
|
||||||
|
$id: http://devicetree.org/schemas/power/fsl,imx-gpcv2.yaml#
|
||||||
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
||||||
|
|
||||||
|
title: Freescale i.MX General Power Controller v2
|
||||||
|
|
||||||
|
maintainers:
|
||||||
|
- Andrey Smirnov <andrew.smirnov@gmail.com>
|
||||||
|
|
||||||
|
description: |
|
||||||
|
The i.MX7S/D General Power Control (GPC) block contains Power Gating
|
||||||
|
Control (PGC) for various power domains.
|
||||||
|
|
||||||
|
Power domains contained within GPC node are generic power domain
|
||||||
|
providers, documented in
|
||||||
|
Documentation/devicetree/bindings/power/power-domain.yaml, which are
|
||||||
|
described as subnodes of the power gating controller 'pgc' node.
|
||||||
|
|
||||||
|
IP cores belonging to a power domain should contain a 'power-domains'
|
||||||
|
property that is a phandle for PGC node representing the domain.
|
||||||
|
|
||||||
|
properties:
|
||||||
|
compatible:
|
||||||
|
enum:
|
||||||
|
- fsl,imx7d-gpc
|
||||||
|
- fsl,imx8mq-gpc
|
||||||
|
|
||||||
|
reg:
|
||||||
|
maxItems: 1
|
||||||
|
|
||||||
|
interrupts:
|
||||||
|
maxItems: 1
|
||||||
|
|
||||||
|
pgc:
|
||||||
|
type: object
|
||||||
|
description: list of power domains provided by this controller.
|
||||||
|
|
||||||
|
patternProperties:
|
||||||
|
"power-domain@[0-9]$":
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
|
||||||
|
'#power-domain-cells':
|
||||||
|
const: 0
|
||||||
|
|
||||||
|
reg:
|
||||||
|
description: |
|
||||||
|
Power domain index. Valid values are defined in
|
||||||
|
include/dt-bindings/power/imx7-power.h for fsl,imx7d-gpc and
|
||||||
|
include/dt-bindings/power/imx8m-power.h for fsl,imx8mq-gpc
|
||||||
|
maxItems: 1
|
||||||
|
|
||||||
|
clocks:
|
||||||
|
description: |
|
||||||
|
A number of phandles to clocks that need to be enabled during domain
|
||||||
|
power-up sequencing to ensure reset propagation into devices located
|
||||||
|
inside this power domain.
|
||||||
|
minItems: 1
|
||||||
|
maxItems: 5
|
||||||
|
|
||||||
|
power-supply: true
|
||||||
|
|
||||||
|
required:
|
||||||
|
- '#power-domain-cells'
|
||||||
|
- reg
|
||||||
|
|
||||||
|
required:
|
||||||
|
- compatible
|
||||||
|
- reg
|
||||||
|
- interrupts
|
||||||
|
- pgc
|
||||||
|
|
||||||
|
additionalProperties: false
|
||||||
|
|
||||||
|
examples:
|
||||||
|
- |
|
||||||
|
#include <dt-bindings/interrupt-controller/arm-gic.h>
|
||||||
|
|
||||||
|
gpc@303a0000 {
|
||||||
|
compatible = "fsl,imx7d-gpc";
|
||||||
|
reg = <0x303a0000 0x1000>;
|
||||||
|
interrupts = <GIC_SPI 87 IRQ_TYPE_LEVEL_HIGH>;
|
||||||
|
|
||||||
|
pgc {
|
||||||
|
#address-cells = <1>;
|
||||||
|
#size-cells = <0>;
|
||||||
|
|
||||||
|
pgc_mipi_phy: power-domain@0 {
|
||||||
|
#power-domain-cells = <0>;
|
||||||
|
reg = <0>;
|
||||||
|
power-supply = <®_1p0d>;
|
||||||
|
};
|
||||||
|
|
||||||
|
pgc_pcie_phy: power-domain@1 {
|
||||||
|
#power-domain-cells = <0>;
|
||||||
|
reg = <1>;
|
||||||
|
power-supply = <®_1p0d>;
|
||||||
|
};
|
||||||
|
|
||||||
|
pgc_hsic_phy: power-domain@2 {
|
||||||
|
#power-domain-cells = <0>;
|
||||||
|
reg = <2>;
|
||||||
|
power-supply = <®_1p2>;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
};
|
Loading…
Reference in New Issue
Block a user