1 # SPDX-License-Identifier: GPL-2.0-only OR BSD 1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/ufs/ufs-com 4 $id: http://devicetree.org/schemas/ufs/ufs-common.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Common properties for Universal Flash S 7 title: Common properties for Universal Flash Storage (UFS) Host Controllers
8 8
9 maintainers: 9 maintainers:
10 - Alim Akhtar <alim.akhtar@samsung.com> 10 - Alim Akhtar <alim.akhtar@samsung.com>
11 - Avri Altman <avri.altman@wdc.com> 11 - Avri Altman <avri.altman@wdc.com>
12 12
13 properties: 13 properties:
14 clocks: true 14 clocks: true
15 15
16 clock-names: true 16 clock-names: true
17 17
18 freq-table-hz: 18 freq-table-hz:
19 items: 19 items:
20 items: 20 items:
21 - description: Minimum frequency for g 21 - description: Minimum frequency for given clock in Hz
22 - description: Maximum frequency for g 22 - description: Maximum frequency for given clock in Hz
23 deprecated: true <<
24 description: | 23 description: |
25 Preferred is operating-points-v2. <<
26 <<
27 Array of <min max> operating frequencies 24 Array of <min max> operating frequencies in Hz stored in the same order
28 as the clocks property. If either this p !! 25 as the clocks property. If this property is not defined or a value in the
29 not defined or a value in the array is " !! 26 array is "0" then it is assumed that the frequency is set by the parent
30 frequency is set by the parent clock or !! 27 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 <<
36 order for each clock. If clock frequenc <<
37 assumed that the frequency is set by the <<
38 clock source. <<
39 <<
40 opp-table: <<
41 type: object <<
42 28
43 interrupts: 29 interrupts:
44 maxItems: 1 30 maxItems: 1
45 31
46 lanes-per-direction: 32 lanes-per-direction:
47 $ref: /schemas/types.yaml#/definitions/uin 33 $ref: /schemas/types.yaml#/definitions/uint32
48 enum: [1, 2] 34 enum: [1, 2]
49 default: 2 35 default: 2
50 description: 36 description:
51 Number of lanes available per direction. 37 Number of lanes available per direction. Note that it is assume same
52 number of lanes is used both directions 38 number of lanes is used both directions at once.
53 39
54 vdd-hba-supply: 40 vdd-hba-supply:
55 description: 41 description:
56 Phandle to UFS host controller supply re 42 Phandle to UFS host controller supply regulator node.
57 43
58 vcc-supply: 44 vcc-supply:
59 description: 45 description:
60 Phandle to VCC supply regulator node. 46 Phandle to VCC supply regulator node.
61 47
62 vccq-supply: 48 vccq-supply:
63 description: 49 description:
64 Phandle to VCCQ supply regulator node. 50 Phandle to VCCQ supply regulator node.
65 51
66 vccq2-supply: 52 vccq2-supply:
67 description: 53 description:
68 Phandle to VCCQ2 supply regulator node. 54 Phandle to VCCQ2 supply regulator node.
69 55
70 vcc-supply-1p8: 56 vcc-supply-1p8:
71 type: boolean 57 type: boolean
72 description: 58 description:
73 For embedded UFS devices, valid VCC rang 59 For embedded UFS devices, valid VCC range is 1.7-1.95V or 2.7-3.6V. This
74 boolean property when set, specifies to 60 boolean property when set, specifies to use low voltage range of
75 1.7-1.95V. Note for external UFS cards t 61 1.7-1.95V. Note for external UFS cards this property is invalid and valid
76 VCC range is always 2.7-3.6V. 62 VCC range is always 2.7-3.6V.
77 63
78 vcc-max-microamp: 64 vcc-max-microamp:
79 description: 65 description:
80 Specifies max. load that can be drawn fr 66 Specifies max. load that can be drawn from VCC supply.
81 67
82 vccq-max-microamp: 68 vccq-max-microamp:
83 description: 69 description:
84 Specifies max. load that can be drawn fr 70 Specifies max. load that can be drawn from VCCQ supply.
85 71
86 vccq2-max-microamp: 72 vccq2-max-microamp:
87 description: 73 description:
88 Specifies max. load that can be drawn fr 74 Specifies max. load that can be drawn from VCCQ2 supply.
89 75
90 msi-parent: true <<
91 <<
92 dependencies: 76 dependencies:
93 freq-table-hz: [ clocks ] !! 77 freq-table-hz: [ 'clocks' ]
94 operating-points-v2: [ clocks, clock-names ] <<
95 78
96 required: 79 required:
97 - interrupts 80 - interrupts
98 <<
99 allOf: <<
100 - if: <<
101 required: <<
102 - freq-table-hz <<
103 then: <<
104 properties: <<
105 operating-points-v2: false <<
106 - if: <<
107 required: <<
108 - operating-points-v2 <<
109 then: <<
110 properties: <<
111 freq-table-hz: false <<
112 81
113 additionalProperties: true 82 additionalProperties: true
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.