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:
11*c6a43fb3SNeil 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
224df7e9a1SNeil Armstrongproperties:
234df7e9a1SNeil Armstrong  compatible:
244df7e9a1SNeil Armstrong    oneOf:
254df7e9a1SNeil Armstrong      - description: Always-on power domain UART controller
264df7e9a1SNeil Armstrong        items:
274df7e9a1SNeil Armstrong          - enum:
284df7e9a1SNeil Armstrong              - amlogic,meson6-uart
294df7e9a1SNeil Armstrong              - amlogic,meson8-uart
304df7e9a1SNeil Armstrong              - amlogic,meson8b-uart
314df7e9a1SNeil Armstrong              - amlogic,meson-gx-uart
3234de6666SXianwei Zhao              - amlogic,meson-s4-uart
334df7e9a1SNeil Armstrong          - const: amlogic,meson-ao-uart
344df7e9a1SNeil Armstrong      - description: Everything-Else power domain UART controller
354df7e9a1SNeil Armstrong        enum:
364df7e9a1SNeil Armstrong          - amlogic,meson6-uart
374df7e9a1SNeil Armstrong          - amlogic,meson8-uart
384df7e9a1SNeil Armstrong          - amlogic,meson8b-uart
394df7e9a1SNeil Armstrong          - amlogic,meson-gx-uart
4034de6666SXianwei Zhao          - amlogic,meson-s4-uart
414df7e9a1SNeil Armstrong
424df7e9a1SNeil Armstrong  reg:
434df7e9a1SNeil Armstrong    maxItems: 1
444df7e9a1SNeil Armstrong
454df7e9a1SNeil Armstrong  interrupts:
464df7e9a1SNeil Armstrong    maxItems: 1
474df7e9a1SNeil Armstrong
484df7e9a1SNeil Armstrong  clocks:
494df7e9a1SNeil Armstrong    items:
504df7e9a1SNeil Armstrong      - description: external xtal clock identifier
514df7e9a1SNeil Armstrong      - description: the bus core clock, either the clk81 clock or the gate clock
524df7e9a1SNeil Armstrong      - description: the source of the baudrate generator, can be either the xtal or the pclk
534df7e9a1SNeil Armstrong
544df7e9a1SNeil Armstrong  clock-names:
554df7e9a1SNeil Armstrong    items:
564df7e9a1SNeil Armstrong      - const: xtal
574df7e9a1SNeil Armstrong      - const: pclk
584df7e9a1SNeil Armstrong      - const: baud
594df7e9a1SNeil Armstrong
60f985b0b6SNeil Armstrong  fifo-size:
61f985b0b6SNeil Armstrong    description: The fifo size supported by the UART channel.
62f985b0b6SNeil Armstrong    $ref: /schemas/types.yaml#/definitions/uint32
63f985b0b6SNeil Armstrong    enum: [64, 128]
64f985b0b6SNeil Armstrong
654df7e9a1SNeil Armstrongrequired:
664df7e9a1SNeil Armstrong  - compatible
674df7e9a1SNeil Armstrong  - reg
684df7e9a1SNeil Armstrong  - interrupts
694df7e9a1SNeil Armstrong  - clocks
704df7e9a1SNeil Armstrong  - clock-names
714df7e9a1SNeil Armstrong
727f464532SRob HerringadditionalProperties: false
737f464532SRob Herring
744df7e9a1SNeil Armstrongexamples:
754df7e9a1SNeil Armstrong  - |
764df7e9a1SNeil Armstrong    serial@84c0 {
774df7e9a1SNeil Armstrong          compatible = "amlogic,meson-gx-uart";
784df7e9a1SNeil Armstrong          reg = <0x84c0 0x14>;
794df7e9a1SNeil Armstrong          interrupts = <26>;
804df7e9a1SNeil Armstrong          clocks = <&xtal>, <&pclk>, <&xtal>;
814df7e9a1SNeil Armstrong          clock-names = "xtal", "pclk", "baud";
824df7e9a1SNeil Armstrong    };
83