xref: /freebsd/sys/contrib/device-tree/Bindings/serial/renesas,scifa.yaml (revision e8d8bef961a50d4dc22501cde4fb9fb0be1b2532) 
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-r8a7742      # RZ/G1H
28              - renesas,scifa-r8a7743      # RZ/G1M
29              - renesas,scifa-r8a7744      # RZ/G1N
30              - renesas,scifa-r8a7745      # RZ/G1E
31              - renesas,scifa-r8a7790      # R-Car H2
32              - renesas,scifa-r8a7791      # R-Car M2-W
33              - renesas,scifa-r8a7793      # R-Car M2-N
34              - renesas,scifa-r8a7794      # R-Car E2
35          - const: renesas,rcar-gen2-scifa # R-Car Gen2 and RZ/G1
36          - const: renesas,scifa           # generic SCIFA compatible UART
37
38  reg:
39    maxItems: 1
40
41  interrupts:
42    maxItems: 1
43
44  clocks:
45    maxItems: 1
46
47  clock-names:
48    enum:
49      - fck # UART functional clock
50
51  power-domains:
52    maxItems: 1
53
54  resets:
55    maxItems: 1
56
57  dmas:
58    description:
59      Must contain a list of pairs of references to DMA specifiers, one for
60      transmission, and one for reception.
61
62  dma-names:
63    minItems: 2
64    maxItems: 4
65    items:
66      enum:
67        - tx
68        - rx
69
70required:
71  - compatible
72  - reg
73  - interrupts
74  - clocks
75  - clock-names
76  - power-domains
77
78unevaluatedProperties: false
79
80if:
81  properties:
82    compatible:
83      contains:
84        enum:
85          - renesas,rcar-gen2-scifa
86then:
87  required:
88    - resets
89
90examples:
91  - |
92    #include <dt-bindings/clock/r8a7790-cpg-mssr.h>
93    #include <dt-bindings/interrupt-controller/arm-gic.h>
94    #include <dt-bindings/power/r8a7790-sysc.h>
95    aliases {
96            serial0 = &scifa0;
97    };
98
99    scifa0: serial@e6c40000 {
100            compatible = "renesas,scifa-r8a7790", "renesas,rcar-gen2-scifa",
101                         "renesas,scifa";
102            reg = <0xe6c40000 64>;
103            interrupts = <GIC_SPI 144 IRQ_TYPE_LEVEL_HIGH>;
104            clocks = <&cpg CPG_MOD 204>;
105            clock-names = "fck";
106            power-domains = <&sysc R8A7790_PD_ALWAYS_ON>;
107            resets = <&cpg 204>;
108            dmas = <&dmac0 0x21>, <&dmac0 0x22>, <&dmac1 0x21>, <&dmac1 0x22>;
109            dma-names = "tx", "rx", "tx", "rx";
110    };
111