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