1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/serial/samsung_uart.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Samsung S3C, S5P and Exynos SoC UART Controller
8
9maintainers:
10  - Krzysztof Kozlowski <krzk@kernel.org>
11  - Greg Kroah-Hartman <gregkh@linuxfoundation.org>
12
13description: |+
14  Each Samsung UART should have an alias correctly numbered in the "aliases"
15  node, according to serialN format, where N is the port number (non-negative
16  decimal integer) as specified by User's Manual of respective SoC.
17
18properties:
19  compatible:
20    items:
21      - enum:
22          - samsung,s3c2410-uart
23          - samsung,s3c2412-uart
24          - samsung,s3c2440-uart
25          - samsung,s3c6400-uart
26          - samsung,s5pv210-uart
27          - samsung,exynos4210-uart
28
29  reg:
30    maxItems: 1
31
32  clocks:
33    minItems: 2
34    maxItems: 5
35
36  clock-names:
37    description: N = 0 is allowed for SoCs without internal baud clock mux.
38    minItems: 2
39    maxItems: 5
40    items:
41      - const: uart
42      - pattern: '^clk_uart_baud[0-3]$'
43      - pattern: '^clk_uart_baud[0-3]$'
44      - pattern: '^clk_uart_baud[0-3]$'
45      - pattern: '^clk_uart_baud[0-3]$'
46
47  interrupts:
48    description: RX interrupt and optionally TX interrupt.
49    minItems: 1
50    maxItems: 2
51
52  samsung,uart-fifosize:
53    description: The fifo size supported by the UART channel.
54    allOf:
55      - $ref: /schemas/types.yaml#/definitions/uint32
56      - enum: [16, 64, 256]
57
58required:
59  - compatible
60  - clocks
61  - clock-names
62  - interrupts
63  - reg
64
65allOf:
66  - if:
67      properties:
68        compatible:
69          contains:
70            enum:
71              - samsung,s3c2410-uart
72              - samsung,s5pv210-uart
73    then:
74      properties:
75        clocks:
76          minItems: 2
77          maxItems: 3
78        clock-names:
79          minItems: 2
80          maxItems: 3
81          items:
82            - const: uart
83            - pattern: '^clk_uart_baud[0-1]$'
84            - pattern: '^clk_uart_baud[0-1]$'
85
86  - if:
87      properties:
88        compatible:
89          contains:
90            enum:
91              - samsung,exynos4210-uart
92    then:
93      properties:
94        clocks:
95          minItems: 2
96          maxItems: 2
97        clock-names:
98          minItems: 2
99          maxItems: 2
100          items:
101            - const: uart
102            - const: clk_uart_baud0
103
104examples:
105  - |
106    #include <dt-bindings/clock/samsung,s3c64xx-clock.h>
107
108    uart0: serial@7f005000 {
109        compatible = "samsung,s3c6400-uart";
110        reg = <0x7f005000 0x100>;
111        interrupt-parent = <&vic1>;
112        interrupts = <5>;
113        clock-names = "uart", "clk_uart_baud2",
114                      "clk_uart_baud3";
115        clocks = <&clocks PCLK_UART0>, <&clocks PCLK_UART0>,
116                 <&clocks SCLK_UART>;
117        samsung,uart-fifosize = <16>;
118    };
119