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/samsung 4 $id: http://devicetree.org/schemas/ufs/samsung,exynos-ufs.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Samsung SoC series UFS host controller !! 7 title: Samsung SoC series UFS host controller Device Tree Bindings
8 8
9 maintainers: 9 maintainers:
10 - Alim Akhtar <alim.akhtar@samsung.com> 10 - Alim Akhtar <alim.akhtar@samsung.com>
11 11
12 description: | 12 description: |
13 Each Samsung UFS host controller instance sh 13 Each Samsung UFS host controller instance should have its own node.
>> 14 This binding define Samsung specific binding other then what is used
>> 15 in the common ufshcd bindings
>> 16 [1] Documentation/devicetree/bindings/ufs/ufshcd-pltfrm.txt
14 17
15 properties: 18 properties:
>> 19
16 compatible: 20 compatible:
17 enum: 21 enum:
18 - google,gs101-ufs <<
19 - samsung,exynos7-ufs 22 - samsung,exynos7-ufs
20 - samsung,exynosautov9-ufs 23 - samsung,exynosautov9-ufs
21 - samsung,exynosautov9-ufs-vh 24 - samsung,exynosautov9-ufs-vh
22 - tesla,fsd-ufs <<
23 25
24 reg: 26 reg:
25 items: 27 items:
26 - description: HCI register 28 - description: HCI register
27 - description: vendor specific register 29 - description: vendor specific register
28 - description: unipro register 30 - description: unipro register
29 - description: UFS protector register 31 - description: UFS protector register
30 32
31 reg-names: 33 reg-names:
32 items: 34 items:
33 - const: hci 35 - const: hci
34 - const: vs_hci 36 - const: vs_hci
35 - const: unipro 37 - const: unipro
36 - const: ufsp 38 - const: ufsp
37 39
38 clocks: 40 clocks:
39 minItems: 2 <<
40 items: 41 items:
41 - description: ufs link core clock 42 - description: ufs link core clock
42 - description: unipro main clock 43 - description: unipro main clock
43 - description: fmp clock <<
44 - description: ufs aclk clock <<
45 - description: ufs pclk clock <<
46 - description: sysreg clock <<
47 44
48 clock-names: 45 clock-names:
49 minItems: 2 <<
50 items: 46 items:
51 - const: core_clk 47 - const: core_clk
52 - const: sclk_unipro_main 48 - const: sclk_unipro_main
53 - const: fmp !! 49
54 - const: aclk !! 50 interrupts:
55 - const: pclk !! 51 maxItems: 1
56 - const: sysreg <<
57 52
58 phys: 53 phys:
59 maxItems: 1 54 maxItems: 1
60 55
61 phy-names: 56 phy-names:
62 const: ufs-phy 57 const: ufs-phy
63 58
64 samsung,sysreg: 59 samsung,sysreg:
65 $ref: /schemas/types.yaml#/definitions/pha !! 60 $ref: '/schemas/types.yaml#/definitions/phandle-array'
66 items: !! 61 description: Should be phandle/offset pair. The phandle to the syscon node
67 - items: !! 62 which indicates the FSYSx sysreg interface and the offset of
68 - description: phandle to FSYSx sysr !! 63 the control register for UFS io coherency setting.
69 - description: offset of the control <<
70 description: <<
71 Phandle and offset to the FSYSx sysreg f <<
72 64
73 dma-coherent: true 65 dma-coherent: true
74 66
75 required: 67 required:
76 - compatible 68 - compatible
77 - reg 69 - reg
>> 70 - interrupts
78 - phys 71 - phys
79 - phy-names 72 - phy-names
80 - clocks 73 - clocks
81 - clock-names 74 - clock-names
82 75
83 allOf: !! 76 additionalProperties: false
84 - $ref: ufs-common.yaml <<
85 - if: <<
86 properties: <<
87 compatible: <<
88 contains: <<
89 const: google,gs101-ufs <<
90 <<
91 then: <<
92 properties: <<
93 clocks: <<
94 minItems: 6 <<
95 <<
96 clock-names: <<
97 minItems: 6 <<
98 <<
99 else: <<
100 properties: <<
101 clocks: <<
102 maxItems: 2 <<
103 <<
104 clock-names: <<
105 maxItems: 2 <<
106 <<
107 unevaluatedProperties: false <<
108 77
109 examples: 78 examples:
110 - | 79 - |
111 #include <dt-bindings/interrupt-controller 80 #include <dt-bindings/interrupt-controller/arm-gic.h>
112 #include <dt-bindings/clock/exynos7-clk.h> 81 #include <dt-bindings/clock/exynos7-clk.h>
113 82
114 ufs: ufs@15570000 { 83 ufs: ufs@15570000 {
115 compatible = "samsung,exynos7-ufs"; 84 compatible = "samsung,exynos7-ufs";
116 reg = <0x15570000 0x100>, 85 reg = <0x15570000 0x100>,
117 <0x15570100 0x100>, 86 <0x15570100 0x100>,
118 <0x15571000 0x200>, 87 <0x15571000 0x200>,
119 <0x15572000 0x300>; 88 <0x15572000 0x300>;
120 reg-names = "hci", "vs_hci", "unipro", 89 reg-names = "hci", "vs_hci", "unipro", "ufsp";
121 interrupts = <GIC_SPI 200 IRQ_TYPE_LEVE 90 interrupts = <GIC_SPI 200 IRQ_TYPE_LEVEL_HIGH>;
122 clocks = <&clock_fsys1 ACLK_UFS20_LINK> 91 clocks = <&clock_fsys1 ACLK_UFS20_LINK>,
123 <&clock_fsys1 SCLK_UFSUNIPRO20 92 <&clock_fsys1 SCLK_UFSUNIPRO20_USER>;
124 clock-names = "core_clk", "sclk_unipro_ 93 clock-names = "core_clk", "sclk_unipro_main";
125 pinctrl-names = "default"; 94 pinctrl-names = "default";
126 pinctrl-0 = <&ufs_rst_n &ufs_refclk_out 95 pinctrl-0 = <&ufs_rst_n &ufs_refclk_out>;
127 phys = <&ufs_phy>; 96 phys = <&ufs_phy>;
128 phy-names = "ufs-phy"; 97 phy-names = "ufs-phy";
129 }; 98 };
130 ... 99 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.