14df7e9a1SNeil Armstrong# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
24df7e9a1SNeil Armstrong# Copyright 2019 BayLibre, SAS
34df7e9a1SNeil Armstrong%YAML 1.2
44df7e9a1SNeil Armstrong---
54df7e9a1SNeil Armstrong$id: "http://devicetree.org/schemas/serial/amlogic,meson-uart.yaml#"
64df7e9a1SNeil Armstrong$schema: "http://devicetree.org/meta-schemas/core.yaml#"
74df7e9a1SNeil Armstrong
84df7e9a1SNeil Armstrongtitle: Amlogic Meson SoC UART Serial Interface
94df7e9a1SNeil Armstrong
104df7e9a1SNeil Armstrongmaintainers:
11c6a43fb3SNeil Armstrong  - Neil Armstrong <neil.armstrong@linaro.org>
124df7e9a1SNeil Armstrong
134df7e9a1SNeil Armstrongdescription: |
144df7e9a1SNeil Armstrong  The Amlogic Meson SoC UART Serial Interface is present on a large range
154df7e9a1SNeil Armstrong  of SoCs, and can be present either in the "Always-On" power domain or the
164df7e9a1SNeil Armstrong  "Everything-Else" power domain.
174df7e9a1SNeil Armstrong
184df7e9a1SNeil Armstrong  The particularity of the "Always-On" Serial Interface is that the hardware
194df7e9a1SNeil Armstrong  is active since power-on and does not need any clock gating and is usable
204df7e9a1SNeil Armstrong  as very early serial console.
214df7e9a1SNeil Armstrong
22*4cb07402SKrzysztof KozlowskiallOf:
23*4cb07402SKrzysztof Kozlowski  - $ref: serial.yaml#
24*4cb07402SKrzysztof Kozlowski
254df7e9a1SNeil Armstrongproperties:
264df7e9a1SNeil Armstrong  compatible:
274df7e9a1SNeil Armstrong    oneOf:
284df7e9a1SNeil Armstrong      - description: Always-on power domain UART controller
294df7e9a1SNeil Armstrong        items:
304df7e9a1SNeil Armstrong          - enum:
314df7e9a1SNeil Armstrong              - amlogic,meson6-uart
324df7e9a1SNeil Armstrong              - amlogic,meson8-uart
334df7e9a1SNeil Armstrong              - amlogic,meson8b-uart
344df7e9a1SNeil Armstrong              - amlogic,meson-gx-uart
3534de6666SXianwei Zhao              - amlogic,meson-s4-uart
364df7e9a1SNeil Armstrong          - const: amlogic,meson-ao-uart
374df7e9a1SNeil Armstrong      - description: Everything-Else power domain UART controller
384df7e9a1SNeil Armstrong        enum:
394df7e9a1SNeil Armstrong          - amlogic,meson6-uart
404df7e9a1SNeil Armstrong          - amlogic,meson8-uart
414df7e9a1SNeil Armstrong          - amlogic,meson8b-uart
424df7e9a1SNeil Armstrong          - amlogic,meson-gx-uart
4334de6666SXianwei Zhao          - amlogic,meson-s4-uart
444df7e9a1SNeil Armstrong
454df7e9a1SNeil Armstrong  reg:
464df7e9a1SNeil Armstrong    maxItems: 1
474df7e9a1SNeil Armstrong
484df7e9a1SNeil Armstrong  interrupts:
494df7e9a1SNeil Armstrong    maxItems: 1
504df7e9a1SNeil Armstrong
514df7e9a1SNeil Armstrong  clocks:
524df7e9a1SNeil Armstrong    items:
534df7e9a1SNeil Armstrong      - description: external xtal clock identifier
544df7e9a1SNeil Armstrong      - description: the bus core clock, either the clk81 clock or the gate clock
554df7e9a1SNeil Armstrong      - description: the source of the baudrate generator, can be either the xtal or the pclk
564df7e9a1SNeil Armstrong
574df7e9a1SNeil Armstrong  clock-names:
584df7e9a1SNeil Armstrong    items:
594df7e9a1SNeil Armstrong      - const: xtal
604df7e9a1SNeil Armstrong      - const: pclk
614df7e9a1SNeil Armstrong      - const: baud
624df7e9a1SNeil Armstrong
63f985b0b6SNeil Armstrong  fifo-size:
64f985b0b6SNeil Armstrong    description: The fifo size supported by the UART channel.
65f985b0b6SNeil Armstrong    $ref: /schemas/types.yaml#/definitions/uint32
66f985b0b6SNeil Armstrong    enum: [64, 128]
67f985b0b6SNeil Armstrong
684df7e9a1SNeil Armstrongrequired:
694df7e9a1SNeil Armstrong  - compatible
704df7e9a1SNeil Armstrong  - reg
714df7e9a1SNeil Armstrong  - interrupts
724df7e9a1SNeil Armstrong  - clocks
734df7e9a1SNeil Armstrong  - clock-names
744df7e9a1SNeil Armstrong
75*4cb07402SKrzysztof KozlowskiunevaluatedProperties: false
767f464532SRob Herring
774df7e9a1SNeil Armstrongexamples:
784df7e9a1SNeil Armstrong  - |
794df7e9a1SNeil Armstrong    serial@84c0 {
804df7e9a1SNeil Armstrong          compatible = "amlogic,meson-gx-uart";
814df7e9a1SNeil Armstrong          reg = <0x84c0 0x14>;
824df7e9a1SNeil Armstrong          interrupts = <26>;
834df7e9a1SNeil Armstrong          clocks = <&xtal>, <&pclk>, <&xtal>;
844df7e9a1SNeil Armstrong          clock-names = "xtal", "pclk", "baud";
854df7e9a1SNeil Armstrong    };
86