Documentation/devicetree/bindings/serial/renesas,scifa.yaml

   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
   7 title: Renesas Serial Communications Interface with FIFO A (SCIFA)
   8
   9 maintainers:
  10   - Geert Uytterhoeven <geert+renesas@glider.be>
  11
  12 allOf:
  13   - $ref: serial.yaml#
  14
  15 properties:
  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
  70 required:
  71   - compatible
  72   - reg
  73   - interrupts
  74   - clocks
  75   - clock-names
  76   - power-domains
  77
  78 unevaluatedProperties: false
  79
  80 if:
  81   properties:
  82     compatible:
  83       contains:
  84         enum:
  85           - renesas,rcar-gen2-scifa
  86 then:
  87   required:
  88     - resets
  89
  90 examples:
  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     };