# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/power/renesas,r8a78000-mdlc.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Renesas R-Car X5H Module Controller

maintainers:
  - Geert Uytterhoeven <geert+renesas@glider.be>

description:
  Each instance of the R-Car X5H Module Controller (MODULE CONTROL) provides
  Power Gating for up to 64 Power Domains, and Module Standby and Reset for up
  to 256 modules in the Power Domain of each Module hierarchy.

properties:
  compatible:
    const: renesas,r8a78000-mdlc

  reg:
    maxItems: 1
 
  '#power-domain-cells':
    description: |
      - The first power domain specifier cell is the power domain part, and
        must be either the Module Power Domain Gating (MPDG) register index
        (0x00-0x3f) from the datasheet, for power domains which are backed by
        MPDG bits and which can be controlled in that manner,  or a Power
        Domain number, as defined in
        <dt-bindings/power/renesas,r8a78000-mdlc.h>, for power domains which
        are always on, and for which there are no MPDG bits to control them.
 
      - The second power domain specifier cell is the module standby part, and
        must be the module number (0x00-0xff), composed of the Module System
        Reset (MSRES) register index in the high nibble, and the Module Reset
        Destination bitfield index in the low nibble.
    const: 2
 
  '#reset-cells':
    description:
      The single reset specifier cell must be the module number (0x00-0xff),
      and thus identical to the second power domain specifier cell.
    const: 1

required:
  - compatible
  - reg
  - '#power-domain-cells'
  - '#reset-cells'

additionalProperties: false

examples:
  - |
    system-controller@c3060000 {
            compatible = "renesas,r8a78000-mdlc";
            reg = <0xc3060000 0x1000>;
            #power-domain-cells = <2>;
            #reset-cells = <1>;
    };