1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-C 1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 # Copyright 2019 BayLibre, SAS 2 # Copyright 2019 BayLibre, SAS
3 %YAML 1.2 3 %YAML 1.2
4 --- 4 ---
5 $id: http://devicetree.org/schemas/serial/amlo 5 $id: http://devicetree.org/schemas/serial/amlogic,meson-uart.yaml#
6 $schema: http://devicetree.org/meta-schemas/co 6 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 7
8 title: Amlogic Meson SoC UART Serial Interface 8 title: Amlogic Meson SoC UART Serial Interface
9 9
10 maintainers: 10 maintainers:
11 - Neil Armstrong <neil.armstrong@linaro.org> 11 - Neil Armstrong <neil.armstrong@linaro.org>
12 12
13 description: | 13 description: |
14 The Amlogic Meson SoC UART Serial Interface 14 The Amlogic Meson SoC UART Serial Interface is present on a large range
15 of SoCs, and can be present either in the "A 15 of SoCs, and can be present either in the "Always-On" power domain or the
16 "Everything-Else" power domain. 16 "Everything-Else" power domain.
17 17
18 The particularity of the "Always-On" Serial 18 The particularity of the "Always-On" Serial Interface is that the hardware
19 is active since power-on and does not need a 19 is active since power-on and does not need any clock gating and is usable
20 as very early serial console. 20 as very early serial console.
21 21
22 allOf: 22 allOf:
23 - $ref: serial.yaml# 23 - $ref: serial.yaml#
24 24
25 properties: 25 properties:
26 compatible: 26 compatible:
27 oneOf: 27 oneOf:
28 - description: Always-on power domain UA 28 - description: Always-on power domain UART controller
29 items: 29 items:
30 - enum: 30 - enum:
31 - amlogic,meson6-uart 31 - amlogic,meson6-uart
32 - amlogic,meson8-uart 32 - amlogic,meson8-uart
33 - amlogic,meson8b-uart 33 - amlogic,meson8b-uart
34 - amlogic,meson-gx-uart 34 - amlogic,meson-gx-uart
35 - amlogic,meson-s4-uart 35 - amlogic,meson-s4-uart
36 - amlogic,meson-a1-uart <<
37 - const: amlogic,meson-ao-uart 36 - const: amlogic,meson-ao-uart
38 - description: Always-on power domain UA 37 - description: Always-on power domain UART controller on G12A SoCs
39 items: 38 items:
40 - const: amlogic,meson-g12a-uart 39 - const: amlogic,meson-g12a-uart
41 - const: amlogic,meson-gx-uart 40 - const: amlogic,meson-gx-uart
42 - const: amlogic,meson-ao-uart 41 - const: amlogic,meson-ao-uart
43 - description: Everything-Else power dom 42 - description: Everything-Else power domain UART controller
44 enum: 43 enum:
45 - amlogic,meson6-uart 44 - amlogic,meson6-uart
46 - amlogic,meson8-uart 45 - amlogic,meson8-uart
47 - amlogic,meson8b-uart 46 - amlogic,meson8b-uart
48 - amlogic,meson-gx-uart 47 - amlogic,meson-gx-uart
49 - amlogic,meson-s4-uart 48 - amlogic,meson-s4-uart
50 - amlogic,meson-a1-uart <<
51 - description: Everything-Else power dom 49 - description: Everything-Else power domain UART controller on G12A SoCs
52 items: 50 items:
53 - const: amlogic,meson-g12a-uart 51 - const: amlogic,meson-g12a-uart
54 - const: amlogic,meson-gx-uart 52 - const: amlogic,meson-gx-uart
55 - description: UART controller on S4 com <<
56 items: <<
57 - enum: <<
58 - amlogic,a4-uart <<
59 - amlogic,t7-uart <<
60 - const: amlogic,meson-s4-uart <<
61 53
62 reg: 54 reg:
63 maxItems: 1 55 maxItems: 1
64 56
65 interrupts: 57 interrupts:
66 maxItems: 1 58 maxItems: 1
67 59
68 clocks: 60 clocks:
69 items: 61 items:
70 - description: external xtal clock ident 62 - description: external xtal clock identifier
71 - description: the bus core clock, eithe 63 - description: the bus core clock, either the clk81 clock or the gate clock
72 - description: the source of the baudrat 64 - description: the source of the baudrate generator, can be either the xtal or the pclk
73 65
74 clock-names: 66 clock-names:
75 items: 67 items:
76 - const: xtal 68 - const: xtal
77 - const: pclk 69 - const: pclk
78 - const: baud 70 - const: baud
79 71
80 fifo-size: 72 fifo-size:
81 description: The fifo size supported by th 73 description: The fifo size supported by the UART channel.
82 $ref: /schemas/types.yaml#/definitions/uin 74 $ref: /schemas/types.yaml#/definitions/uint32
83 enum: [64, 128] 75 enum: [64, 128]
84 76
85 required: 77 required:
86 - compatible 78 - compatible
87 - reg 79 - reg
88 - interrupts 80 - interrupts
89 - clocks 81 - clocks
90 - clock-names 82 - clock-names
91 83
92 unevaluatedProperties: false 84 unevaluatedProperties: false
93 85
94 examples: 86 examples:
95 - | 87 - |
96 serial@84c0 { 88 serial@84c0 {
97 compatible = "amlogic,meson-gx-uart"; 89 compatible = "amlogic,meson-gx-uart";
98 reg = <0x84c0 0x14>; 90 reg = <0x84c0 0x14>;
99 interrupts = <26>; 91 interrupts = <26>;
100 clocks = <&xtal>, <&pclk>, <&xtal>; 92 clocks = <&xtal>, <&pclk>, <&xtal>;
101 clock-names = "xtal", "pclk", "baud"; 93 clock-names = "xtal", "pclk", "baud";
102 }; 94 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.