114 lines · yaml
1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause2%YAML 1.23---4$id: http://devicetree.org/schemas/ufs/ufs-common.yaml#5$schema: http://devicetree.org/meta-schemas/core.yaml#6 7title: Common properties for Universal Flash Storage (UFS) Host Controllers8 9maintainers:10 - Alim Akhtar <alim.akhtar@samsung.com>11 - Avri Altman <avri.altman@wdc.com>12 13properties:14 clocks: true15 16 clock-names: true17 18 freq-table-hz:19 items:20 items:21 - description: Minimum frequency for given clock in Hz22 - description: Maximum frequency for given clock in Hz23 deprecated: true24 description: |25 Preferred is operating-points-v2.26 27 Array of <min max> operating frequencies in Hz stored in the same order28 as the clocks property. If either this property or operating-points-v2 is29 not defined or a value in the array is "0" then it is assumed that the30 frequency is set by the parent clock or a fixed rate clock source.31 32 operating-points-v2:33 description:34 Preferred over freq-table-hz.35 If present, each OPP must contain array of frequencies stored in the same36 order for each clock. If clock frequency in the array is "0" then it is37 assumed that the frequency is set by the parent clock or a fixed rate38 clock source.39 40 opp-table:41 type: object42 43 interrupts:44 maxItems: 145 46 lanes-per-direction:47 $ref: /schemas/types.yaml#/definitions/uint3248 enum: [1, 2]49 default: 250 description:51 Number of lanes available per direction. Note that it is assume same52 number of lanes is used both directions at once.53 54 vdd-hba-supply:55 description:56 Phandle to UFS host controller supply regulator node.57 58 vcc-supply:59 description:60 Phandle to VCC supply regulator node.61 62 vccq-supply:63 description:64 Phandle to VCCQ supply regulator node.65 66 vccq2-supply:67 description:68 Phandle to VCCQ2 supply regulator node.69 70 vcc-supply-1p8:71 type: boolean72 description:73 For embedded UFS devices, valid VCC range is 1.7-1.95V or 2.7-3.6V. This74 boolean property when set, specifies to use low voltage range of75 1.7-1.95V. Note for external UFS cards this property is invalid and valid76 VCC range is always 2.7-3.6V.77 78 vcc-max-microamp:79 description:80 Specifies max. load that can be drawn from VCC supply.81 82 vccq-max-microamp:83 description:84 Specifies max. load that can be drawn from VCCQ supply.85 86 vccq2-max-microamp:87 description:88 Specifies max. load that can be drawn from VCCQ2 supply.89 90 msi-parent: true91 92dependencies:93 freq-table-hz: [ clocks ]94 operating-points-v2: [ clocks, clock-names ]95 96required:97 - interrupts98 99allOf:100 - if:101 required:102 - freq-table-hz103 then:104 properties:105 operating-points-v2: false106 - if:107 required:108 - operating-points-v2109 then:110 properties:111 freq-table-hz: false112 113additionalProperties: true114