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 <narmstrong@baylibre.com>
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: <<
23 - $ref: serial.yaml# <<
24 <<
25 properties: 22 properties:
26 compatible: 23 compatible:
27 oneOf: 24 oneOf:
28 - description: Always-on power domain UA 25 - description: Always-on power domain UART controller
29 items: 26 items:
30 - enum: !! 27 - enum:
31 - amlogic,meson6-uart <<
32 - amlogic,meson8-uart <<
33 - amlogic,meson8b-uart <<
34 - amlogic,meson-gx-uart <<
35 - amlogic,meson-s4-uart <<
36 - amlogic,meson-a1-uart <<
37 - const: amlogic,meson-ao-uart <<
38 - description: Always-on power domain UA <<
39 items: <<
40 - const: amlogic,meson-g12a-uart <<
41 - const: amlogic,meson-gx-uart <<
42 - const: amlogic,meson-ao-uart <<
43 - description: Everything-Else power dom <<
44 enum: <<
45 - amlogic,meson6-uart 28 - amlogic,meson6-uart
46 - amlogic,meson8-uart 29 - amlogic,meson8-uart
47 - amlogic,meson8b-uart 30 - amlogic,meson8b-uart
48 - amlogic,meson-gx-uart 31 - amlogic,meson-gx-uart
49 - amlogic,meson-s4-uart !! 32 - const: amlogic,meson-ao-uart
50 - amlogic,meson-a1-uart !! 33 - description: Everything-Else power domain UART controller
51 - description: Everything-Else power dom !! 34 enum:
52 items: !! 35 - amlogic,meson6-uart
53 - const: amlogic,meson-g12a-uart !! 36 - amlogic,meson8-uart
54 - const: amlogic,meson-gx-uart !! 37 - amlogic,meson8b-uart
55 - description: UART controller on S4 com !! 38 - amlogic,meson-gx-uart
56 items: <<
57 - enum: <<
58 - amlogic,a4-uart <<
59 - amlogic,t7-uart <<
60 - const: amlogic,meson-s4-uart <<
61 39
62 reg: 40 reg:
63 maxItems: 1 41 maxItems: 1
64 42
65 interrupts: 43 interrupts:
66 maxItems: 1 44 maxItems: 1
67 45
68 clocks: 46 clocks:
69 items: 47 items:
70 - description: external xtal clock ident 48 - description: external xtal clock identifier
71 - description: the bus core clock, eithe 49 - description: the bus core clock, either the clk81 clock or the gate clock
72 - description: the source of the baudrat 50 - description: the source of the baudrate generator, can be either the xtal or the pclk
73 51
74 clock-names: 52 clock-names:
75 items: 53 items:
76 - const: xtal 54 - const: xtal
77 - const: pclk 55 - const: pclk
78 - const: baud 56 - const: baud
79 57
80 fifo-size: <<
81 description: The fifo size supported by th <<
82 $ref: /schemas/types.yaml#/definitions/uin <<
83 enum: [64, 128] <<
84 <<
85 required: 58 required:
86 - compatible 59 - compatible
87 - reg 60 - reg
88 - interrupts 61 - interrupts
89 - clocks 62 - clocks
90 - clock-names 63 - clock-names
91 64
92 unevaluatedProperties: false !! 65 additionalProperties: false
93 66
94 examples: 67 examples:
95 - | 68 - |
96 serial@84c0 { 69 serial@84c0 {
97 compatible = "amlogic,meson-gx-uart"; !! 70 compatible = "amlogic,meson-gx-uart";
98 reg = <0x84c0 0x14>; !! 71 reg = <0x84c0 0x14>;
99 interrupts = <26>; !! 72 interrupts = <26>;
100 clocks = <&xtal>, <&pclk>, <&xtal>; !! 73 clocks = <&xtal>, <&pclk>, <&xtal>;
101 clock-names = "xtal", "pclk", "baud"; !! 74 clock-names = "xtal", "pclk", "baud";
102 }; 75 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.