Commit 982295bf authored by Dmitry Baryshkov's avatar Dmitry Baryshkov Committed by Will Deacon
Browse files

dt-bindings: arm-smmu: fix clocks/clock-names schema 



Rework clocks/clock-names properties schema to properly describe
possible usage cases.

Reviewed-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Signed-off-by: default avatarDmitry Baryshkov <dmitry.baryshkov@linaro.org>
Link: https://lore.kernel.org/r/20221114170635.1406534-3-dmitry.baryshkov@linaro.org


Signed-off-by: default avatarWill Deacon <will@kernel.org>
parent dbf88f74

Documentation/devicetree/bindings/iommu/arm,smmu.yaml

+121 −8
Original line number Diff line number Diff line
@@ -161,16 +161,12 @@ properties: 
      present in such cases.



  clock-names:

    items:

      - const: bus

      - const: iface

    minItems: 1

    maxItems: 7



  clocks:

    items:

      - description: bus clock required for downstream bus access and for the

          smmu ptw

      - description: interface clock required to access smmu's registers

          through the TCU's programming interface.

    minItems: 1

    maxItems: 7



  power-domains:

    maxItems: 1
@@ -220,6 +216,123 @@ allOf: 
        reg:

          maxItems: 1



  - if:

      properties:

        compatible:

          contains:

            enum:

              - qcom,msm8998-smmu-v2

              - qcom,sdm630-smmu-v2

    then:

      anyOf:

        - properties:

            clock-names:

              items:

                - const: bus

            clocks:

              items:

                - description: bus clock required for downstream bus access and for

                    the smmu ptw

        - properties:

            clock-names:

              items:

                - const: iface

                - const: mem

                - const: mem_iface

            clocks:

              items:

                - description: interface clock required to access smmu's registers

                    through the TCU's programming interface.

                - description: bus clock required for memory access

                - description: bus clock required for GPU memory access

        - properties:

            clock-names:

              items:

                - const: iface-mm

                - const: iface-smmu

                - const: bus-mm

                - const: bus-smmu

            clocks:

              items:

                - description: interface clock required to access mnoc's registers

                    through the TCU's programming interface.

                - description: interface clock required to access smmu's registers

                    through the TCU's programming interface.

                - description: bus clock required for downstream bus access

                - description: bus clock required for the smmu ptw



  - if:

      properties:

        compatible:

          contains:

            enum:

              - qcom,msm8996-smmu-v2

              - qcom,sc7180-smmu-v2

              - qcom,sdm845-smmu-v2

    then:

      properties:

        clock-names:

          items:

            - const: bus

            - const: iface



        clocks:

          items:

            - description: bus clock required for downstream bus access and for

                the smmu ptw

            - description: interface clock required to access smmu's registers

                through the TCU's programming interface.



  - if:

      properties:

        compatible:

          contains:

            const: qcom,sc7280-smmu-500

    then:

      properties:

        clock-names:

          items:

            - const: gcc_gpu_memnoc_gfx_clk

            - const: gcc_gpu_snoc_dvm_gfx_clk

            - const: gpu_cc_ahb_clk

            - const: gpu_cc_hlos1_vote_gpu_smmu_clk

            - const: gpu_cc_cx_gmu_clk

            - const: gpu_cc_hub_cx_int_clk

            - const: gpu_cc_hub_aon_clk



        clocks:

          items:

            - description: GPU memnoc_gfx clock

            - description: GPU snoc_dvm_gfx clock

            - description: GPU ahb clock

            - description: GPU hlos1_vote_GPU smmu clock

            - description: GPU cx_gmu clock

            - description: GPU hub_cx_int clock

            - description: GPU hub_aon clock



  - if:

      properties:

        compatible:

          contains:

            enum:

              - qcom,sm8150-smmu-500

              - qcom,sm8250-smmu-500

    then:

      properties:

        clock-names:

          items:

            - const: ahb

            - const: bus

            - const: iface



        clocks:

          items:

            - description: bus clock required for AHB bus access

            - description: bus clock required for downstream bus access and for

                the smmu ptw

            - description: interface clock required to access smmu's registers

                through the TCU's programming interface.



examples:

  - |+

    /* SMMU with stream matching or stream indexing */