Commit 29a79991 authored by AngeloGioacchino Del Regno's avatar AngeloGioacchino Del Regno Committed by Ulf Hansson
Browse files

dt-bindings: power: mediatek: Document access-controllers property 



Allow specifying access-controllers in the main power controller
node and deprecate the old mediatek,infracfg, mediatek,infracfg-nao
and mediatek,smi properties located in the children.

This is done in order to both simplify the power controller
nodes and in preparation for adding support for new generation
SoCs like MT8196/MT6991 and other variants, which will need
to set protection on new busses.

Reviewed-by: default avatarNícolas F. R. A. Prado <nfraprado@collabora.com>
Signed-off-by: default avatarAngeloGioacchino Del Regno <angelogioacchino.delregno@collabora.com>
Reviewed-by: default avatarRob Herring (Arm) <robh@kernel.org>
Link: https://lore.kernel.org/r/20250805074746.29457-4-angelogioacchino.delregno@collabora.com


Signed-off-by: default avatarUlf Hansson <ulf.hansson@linaro.org>
parent 91d7789f

Documentation/devicetree/bindings/power/mediatek,power-controller.yaml

+37 −0
Original line number Diff line number Diff line
@@ -44,6 +44,15 @@ properties: 
  '#size-cells':

    const: 0



  access-controllers:

    description:

      A number of phandles to external blocks to set and clear the required

      bits to enable or disable bus protection, necessary to avoid any bus

      faults while enabling or disabling a power domain.

      For example, this may hold phandles to INFRACFG and SMI.

    minItems: 1

    maxItems: 3



patternProperties:

  "^power-domain@[0-9a-f]+$":

    $ref: "#/$defs/power-domain-node"
@@ -123,14 +132,17 @@ $defs: 
      mediatek,infracfg:

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

        description: phandle to the device containing the INFRACFG register range.

        deprecated: true



      mediatek,infracfg-nao:

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

        description: phandle to the device containing the INFRACFG-NAO register range.

        deprecated: true



      mediatek,smi:

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

        description: phandle to the device containing the SMI register range.

        deprecated: true



    required:

      - reg
@@ -138,6 +150,31 @@ $defs: 
required:

  - compatible



allOf:

  - if:

      properties:

        compatible:

          contains:

            enum:

              - mediatek,mt8183-power-controller

    then:

      properties:

        access-controllers:

          minItems: 2

          maxItems: 2



  - if:

      properties:

        compatible:

          contains:

            enum:

              - mediatek,mt8365-power-controller

    then:

      properties:

        access-controllers:

          minItems: 3

          maxItems: 3



additionalProperties: false



examples: