1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: "http://devicetree.org/schemas/serial/renesas,scifa.yaml#"
5$schema: "http://devicetree.org/meta-schemas/core.yaml#"
6
7title: Renesas Serial Communications Interface with FIFO A (SCIFA)
8
9maintainers:
10  - Geert Uytterhoeven <geert+renesas@glider.be>
11
12allOf:
13  - $ref: serial.yaml#
14
15properties:
16  compatible:
17    oneOf:
18      - items:
19          - enum:
20              - renesas,scifa-r8a73a4      # R-Mobile APE6
21              - renesas,scifa-r8a7740      # R-Mobile A1
22              - renesas,scifa-sh73a0       # SH-Mobile AG5
23          - const: renesas,scifa           # generic SCIFA compatible UART
24
25      - items:
26          - enum:
27              - renesas,scifa-r8a7743      # R8A7743 RZ/G1M
28              - renesas,scifa-r8a7744      # R8A7744 RZ/G1N
29              - renesas,scifa-r8a7745      # R8A7745 RZ/G1E
30              - renesas,scifa-r8a7790      # R8A7790 R-Car H2
31              - renesas,scifa-r8a7791      # R8A7791 R-Car M2-W
32              - renesas,scifa-r8a7793      # R8A7793 R-Car M2-N
33              - renesas,scifa-r8a7794      # R8A7794 R-Car E2
34          - const: renesas,rcar-gen2-scifa # R-Car Gen2 and RZ/G1
35          - const: renesas,scifa           # generic SCIFA compatible UART
36
37  reg:
38    maxItems: 1
39
40  interrupts:
41    maxItems: 1
42
43  clocks:
44    maxItems: 1
45
46  clock-names:
47    enum:
48      - fck # UART functional clock
49
50  power-domains:
51    maxItems: 1
52
53  resets:
54    maxItems: 1
55
56  dmas:
57    description:
58      Must contain a list of pairs of references to DMA specifiers, one for
59      transmission, and one for reception.
60
61  dma-names:
62    minItems: 2
63    maxItems: 4
64    items:
65      enum:
66        - tx
67        - rx
68
69required:
70  - compatible
71  - reg
72  - interrupts
73  - clocks
74  - clock-names
75  - power-domains
76
77if:
78  properties:
79    compatible:
80      contains:
81        enum:
82          - renesas,rcar-gen2-scifa
83then:
84  required:
85    - resets
86
87examples:
88  - |
89    #include <dt-bindings/clock/r8a7790-cpg-mssr.h>
90    #include <dt-bindings/interrupt-controller/arm-gic.h>
91    #include <dt-bindings/power/r8a7790-sysc.h>
92    aliases {
93            serial0 = &scifa0;
94    };
95
96    scifa0: serial@e6c40000 {
97            compatible = "renesas,scifa-r8a7790", "renesas,rcar-gen2-scifa",
98                         "renesas,scifa";
99            reg = <0xe6c40000 64>;
100            interrupts = <GIC_SPI 144 IRQ_TYPE_LEVEL_HIGH>;
101            clocks = <&cpg CPG_MOD 204>;
102            clock-names = "fck";
103            power-domains = <&sysc R8A7790_PD_ALWAYS_ON>;
104            resets = <&cpg 204>;
105            dmas = <&dmac0 0x21>, <&dmac0 0x22>, <&dmac1 0x21>, <&dmac1 0x22>;
106            dma-names = "tx", "rx", "tx", "rx";
107    };
108