xref: /linux/Documentation/devicetree/bindings/serial/samsung_uart.yaml (revision 34f7c6e7d4396090692a09789db231e12cb4762b) 
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, Exynos, and S5L (Apple SoC) 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          - apple,s5l-uart
23          - axis,artpec8-uart
24          - samsung,s3c2410-uart
25          - samsung,s3c2412-uart
26          - samsung,s3c2440-uart
27          - samsung,s3c6400-uart
28          - samsung,s5pv210-uart
29          - samsung,exynos4210-uart
30          - samsung,exynos5433-uart
31          - samsung,exynos850-uart
32
33  reg:
34    maxItems: 1
35
36  reg-io-width:
37    description: |
38      The size (in bytes) of the IO accesses that should be performed
39      on the device.
40    $ref: /schemas/types.yaml#/definitions/uint32
41    enum: [ 1, 4 ]
42
43  clocks:
44    minItems: 2
45    maxItems: 5
46
47  clock-names:
48    description: N = 0 is allowed for SoCs without internal baud clock mux.
49    minItems: 2
50    items:
51      - const: uart
52      - pattern: '^clk_uart_baud[0-3]$'
53      - pattern: '^clk_uart_baud[0-3]$'
54      - pattern: '^clk_uart_baud[0-3]$'
55      - pattern: '^clk_uart_baud[0-3]$'
56
57  dmas:
58    items:
59      - description: DMA controller phandle and request line for RX
60      - description: DMA controller phandle and request line for TX
61
62  dma-names:
63    items:
64      - const: rx
65      - const: tx
66
67  interrupts:
68    description: RX interrupt and optionally TX interrupt.
69    minItems: 1
70    maxItems: 2
71
72  samsung,uart-fifosize:
73    description: The fifo size supported by the UART channel.
74    $ref: /schemas/types.yaml#/definitions/uint32
75    enum: [16, 64, 256]
76
77required:
78  - compatible
79  - clocks
80  - clock-names
81  - interrupts
82  - reg
83
84unevaluatedProperties: false
85
86allOf:
87  - $ref: serial.yaml#
88
89  - if:
90      properties:
91        compatible:
92          contains:
93            enum:
94              - samsung,s3c2410-uart
95              - samsung,s5pv210-uart
96    then:
97      properties:
98        clocks:
99          minItems: 2
100          maxItems: 3
101        clock-names:
102          minItems: 2
103          maxItems: 3
104          items:
105            - const: uart
106            - pattern: '^clk_uart_baud[0-1]$'
107            - pattern: '^clk_uart_baud[0-1]$'
108
109  - if:
110      properties:
111        compatible:
112          contains:
113            enum:
114              - apple,s5l-uart
115              - axis,artpec8-uart
116              - samsung,exynos4210-uart
117              - samsung,exynos5433-uart
118    then:
119      properties:
120        clocks:
121          minItems: 2
122          maxItems: 2
123        clock-names:
124          minItems: 2
125          maxItems: 2
126          items:
127            - const: uart
128            - const: clk_uart_baud0
129
130examples:
131  - |
132    #include <dt-bindings/clock/samsung,s3c64xx-clock.h>
133
134    uart0: serial@7f005000 {
135        compatible = "samsung,s3c6400-uart";
136        reg = <0x7f005000 0x100>;
137        interrupt-parent = <&vic1>;
138        interrupts = <5>;
139        clock-names = "uart", "clk_uart_baud2",
140                      "clk_uart_baud3";
141        clocks = <&clocks PCLK_UART0>, <&clocks PCLK_UART0>,
142                 <&clocks SCLK_UART>;
143        samsung,uart-fifosize = <16>;
144    };
145