Commit e820de1d authored by Krzysztof Kozlowski's avatar Krzysztof Kozlowski Committed by Martin K. Petersen
Browse files

scsi: ufs: dt-bindings: common: Add OPP table 



Except scaling UFS and bus clocks, it's necessary to scale also the
voltages of regulators or power domain performance state levels.  Adding
Operating Performance Points table allows to adjust power domain
performance state, depending on the UFS clock speed.

OPPv2 deprecates previous property limited to clock scaling:
freq-table-hz.

Signed-off-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Signed-off-by: default avatarManivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
Link: https://lore.kernel.org/r/20231012172129.65172-2-manivannan.sadhasivam@linaro.org


Signed-off-by: default avatarMartin K. Petersen <martin.petersen@oracle.com>
parent 058676b5

Documentation/devicetree/bindings/ufs/ufs-common.yaml

+32 −3
Original line number Diff line number Diff line
@@ -20,11 +20,25 @@ properties: 
      items:

        - description: Minimum frequency for given clock in Hz

        - description: Maximum frequency for given clock in Hz

    deprecated: true

    description: |

      Preferred is operating-points-v2.



      Array of <min max> operating frequencies in Hz stored in the same order

      as the clocks property. If this property is not defined or a value in the

      array is "0" then it is assumed that the frequency is set by the parent

      clock or a fixed rate clock source.

      as the clocks property. If either this property or operating-points-v2 is

      not defined or a value in the array is "0" then it is assumed that the

      frequency is set by the parent clock or a fixed rate clock source.



  operating-points-v2:

    description:

      Preferred over freq-table-hz.

      If present, each OPP must contain array of frequencies stored in the same

      order for each clock.  If clock frequency in the array is "0" then it is

      assumed that the frequency is set by the parent clock or a fixed rate

      clock source.



  opp-table:

    type: object



  interrupts:

    maxItems: 1
@@ -75,8 +89,23 @@ properties: 


dependencies:

  freq-table-hz: [ clocks ]

  operating-points-v2: [ clocks, clock-names ]



required:

  - interrupts



allOf:

  - if:

      required:

        - freq-table-hz

    then:

      properties:

        operating-points-v2: false

  - if:

      required:

        - operating-points-v2

    then:

      properties:

        freq-table-hz: false



additionalProperties: true