1 # SPDX-License-Identifier: GPL-2.0 1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/serial/sams 4 $id: http://devicetree.org/schemas/serial/samsung_uart.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Samsung S3C, S5P, Exynos, and S5L (Appl 7 title: Samsung S3C, S5P, Exynos, and S5L (Apple SoC) SoC UART Controller
8 8
9 maintainers: 9 maintainers:
10 - Krzysztof Kozlowski <krzk@kernel.org> 10 - Krzysztof Kozlowski <krzk@kernel.org>
11 - Greg Kroah-Hartman <gregkh@linuxfoundation. 11 - Greg Kroah-Hartman <gregkh@linuxfoundation.org>
12 12
13 description: |+ 13 description: |+
14 Each Samsung UART should have an alias corre 14 Each Samsung UART should have an alias correctly numbered in the "aliases"
15 node, according to serialN format, where N i 15 node, according to serialN format, where N is the port number (non-negative
16 decimal integer) as specified by User's Manu 16 decimal integer) as specified by User's Manual of respective SoC.
17 17
18 properties: 18 properties:
19 compatible: 19 compatible:
20 oneOf: 20 oneOf:
21 - enum: 21 - enum:
22 - apple,s5l-uart 22 - apple,s5l-uart
23 - axis,artpec8-uart 23 - axis,artpec8-uart
24 - google,gs101-uart 24 - google,gs101-uart
25 - samsung,s3c6400-uart 25 - samsung,s3c6400-uart
26 - samsung,s5pv210-uart 26 - samsung,s5pv210-uart
27 - samsung,exynos4210-uart 27 - samsung,exynos4210-uart
28 - samsung,exynos5433-uart 28 - samsung,exynos5433-uart
29 - samsung,exynos850-uart 29 - samsung,exynos850-uart
30 - items: 30 - items:
31 - enum: 31 - enum:
32 - samsung,exynos7-uart 32 - samsung,exynos7-uart
33 - tesla,fsd-uart 33 - tesla,fsd-uart
34 - const: samsung,exynos4210-uart 34 - const: samsung,exynos4210-uart
35 - items: 35 - items:
36 - enum: 36 - enum:
37 - samsung,exynos7885-uart 37 - samsung,exynos7885-uart
38 - const: samsung,exynos5433-uart 38 - const: samsung,exynos5433-uart
39 - items: 39 - items:
40 - enum: 40 - enum:
41 - samsung,exynosautov9-uart 41 - samsung,exynosautov9-uart
42 - samsung,exynosautov920-uart 42 - samsung,exynosautov920-uart
43 - const: samsung,exynos850-uart 43 - const: samsung,exynos850-uart
44 44
45 reg: 45 reg:
46 maxItems: 1 46 maxItems: 1
47 47
48 reg-io-width: 48 reg-io-width:
49 description: | 49 description: |
50 The size (in bytes) of the IO accesses t 50 The size (in bytes) of the IO accesses that should be performed
51 on the device. 51 on the device.
52 enum: [ 1, 4 ] 52 enum: [ 1, 4 ]
53 53
54 clocks: 54 clocks:
55 minItems: 2 55 minItems: 2
56 maxItems: 5 56 maxItems: 5
57 57
58 clock-names: 58 clock-names:
>> 59 description: N = 0 is allowed for SoCs without internal baud clock mux.
59 minItems: 2 60 minItems: 2
60 maxItems: 5 !! 61 items:
>> 62 - const: uart
>> 63 - pattern: '^clk_uart_baud[0-3]$'
>> 64 - pattern: '^clk_uart_baud[0-3]$'
>> 65 - pattern: '^clk_uart_baud[0-3]$'
>> 66 - pattern: '^clk_uart_baud[0-3]$'
61 67
62 dmas: 68 dmas:
63 items: 69 items:
64 - description: DMA controller phandle an 70 - description: DMA controller phandle and request line for RX
65 - description: DMA controller phandle an 71 - description: DMA controller phandle and request line for TX
66 72
67 dma-names: 73 dma-names:
68 items: 74 items:
69 - const: rx 75 - const: rx
70 - const: tx 76 - const: tx
71 77
72 interrupts: 78 interrupts:
73 description: RX interrupt and optionally T 79 description: RX interrupt and optionally TX interrupt.
74 minItems: 1 80 minItems: 1
75 maxItems: 2 81 maxItems: 2
76 82
77 power-domains: 83 power-domains:
78 maxItems: 1 84 maxItems: 1
79 85
80 samsung,uart-fifosize: 86 samsung,uart-fifosize:
81 description: The fifo size supported by th 87 description: The fifo size supported by the UART channel.
82 $ref: /schemas/types.yaml#/definitions/uin 88 $ref: /schemas/types.yaml#/definitions/uint32
83 enum: [16, 64, 256] 89 enum: [16, 64, 256]
84 90
85 required: 91 required:
86 - compatible 92 - compatible
87 - clocks 93 - clocks
88 - clock-names 94 - clock-names
89 - interrupts 95 - interrupts
90 - reg 96 - reg
91 97
92 allOf: 98 allOf:
93 - $ref: serial.yaml# 99 - $ref: serial.yaml#
94 100
95 - if: 101 - if:
96 properties: 102 properties:
97 compatible: 103 compatible:
98 contains: 104 contains:
99 enum: 105 enum:
100 - samsung,s3c6400-uart !! 106 - samsung,s5pv210-uart
101 then: 107 then:
102 properties: 108 properties:
103 clocks: 109 clocks:
104 minItems: 3 !! 110 minItems: 2
105 maxItems: 3 111 maxItems: 3
106 <<
107 clock-names: <<
108 items: <<
109 - const: uart <<
110 - const: clk_uart_baud2 <<
111 - const: clk_uart_baud3 <<
112 <<
113 else: <<
114 properties: <<
115 clock-names: 112 clock-names:
116 minItems: 2 113 minItems: 2
117 items: 114 items:
118 - const: uart 115 - const: uart
119 - const: clk_uart_baud0 !! 116 - pattern: '^clk_uart_baud[0-1]$'
120 - const: clk_uart_baud1 !! 117 - pattern: '^clk_uart_baud[0-1]$'
121 - const: clk_uart_baud2 <<
122 - const: clk_uart_baud3 <<
123 <<
124 - if: <<
125 properties: <<
126 compatible: <<
127 contains: <<
128 enum: <<
129 - samsung,s5pv210-uart <<
130 then: <<
131 properties: <<
132 clocks: <<
133 minItems: 3 <<
134 maxItems: 3 <<
135 <<
136 clock-names: <<
137 minItems: 3 <<
138 maxItems: 3 <<
139 118
140 - if: 119 - if:
141 properties: 120 properties:
142 compatible: 121 compatible:
143 contains: 122 contains:
144 enum: 123 enum:
145 - apple,s5l-uart 124 - apple,s5l-uart
146 - axis,artpec8-uart 125 - axis,artpec8-uart
147 - samsung,exynos4210-uart 126 - samsung,exynos4210-uart
148 - samsung,exynos5433-uart 127 - samsung,exynos5433-uart
149 then: 128 then:
150 properties: 129 properties:
151 clocks: 130 clocks:
152 maxItems: 2 131 maxItems: 2
153 <<
154 clock-names: 132 clock-names:
155 maxItems: 2 !! 133 items:
>> 134 - const: uart
>> 135 - const: clk_uart_baud0
156 136
157 - if: 137 - if:
158 properties: 138 properties:
159 compatible: 139 compatible:
160 contains: 140 contains:
161 enum: 141 enum:
162 - google,gs101-uart 142 - google,gs101-uart
163 then: 143 then:
164 required: 144 required:
165 - samsung,uart-fifosize 145 - samsung,uart-fifosize
166 properties: <<
167 reg-io-width: false <<
168 <<
169 clocks: <<
170 maxItems: 2 <<
171 <<
172 clock-names: <<
173 maxItems: 2 <<
174 146
175 unevaluatedProperties: false 147 unevaluatedProperties: false
176 148
177 examples: 149 examples:
178 - | 150 - |
179 #include <dt-bindings/clock/samsung,s3c64x 151 #include <dt-bindings/clock/samsung,s3c64xx-clock.h>
180 152
181 uart0: serial@7f005000 { 153 uart0: serial@7f005000 {
182 compatible = "samsung,s3c6400-uart"; 154 compatible = "samsung,s3c6400-uart";
183 reg = <0x7f005000 0x100>; 155 reg = <0x7f005000 0x100>;
184 interrupt-parent = <&vic1>; 156 interrupt-parent = <&vic1>;
185 interrupts = <5>; 157 interrupts = <5>;
186 clock-names = "uart", "clk_uart_baud2" 158 clock-names = "uart", "clk_uart_baud2",
187 "clk_uart_baud3"; 159 "clk_uart_baud3";
188 clocks = <&clocks PCLK_UART0>, <&clock 160 clocks = <&clocks PCLK_UART0>, <&clocks PCLK_UART0>,
189 <&clocks SCLK_UART>; 161 <&clocks SCLK_UART>;
190 samsung,uart-fifosize = <16>; 162 samsung,uart-fifosize = <16>;
191 }; <<
192 - | <<
193 #include <dt-bindings/clock/google,gs101.h <<
194 #include <dt-bindings/interrupt-controller <<
195 #include <dt-bindings/interrupt-controller <<
196 <<
197 serial_0: serial@10a00000 { <<
198 compatible = "google,gs101-uart"; <<
199 reg = <0x10a00000 0xc0>; <<
200 clocks = <&cmu_peric0 CLK_GOUT_PERIC0_PE <<
201 <&cmu_peric0 CLK_GOUT_PERIC0_PE <<
202 clock-names = "uart", "clk_uart_baud0"; <<
203 interrupts = <GIC_SPI 634 IRQ_TYPE_LEVEL <<
204 pinctrl-0 = <&uart0_bus>; <<
205 pinctrl-names = "default"; <<
206 samsung,uart-fifosize = <256>; <<
207 }; 163 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.