Documentation/devicetree/bindings/serial/renesas,scifb.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,scifb.yaml#"
   5 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
   6
   7 title: Renesas Serial Communications Interface with FIFO B (SCIFB)
   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,scifb-r8a73a4      # R-Mobile APE6
  21               - renesas,scifb-r8a7740      # R-Mobile A1
  22               - renesas,scifb-sh73a0       # SH-Mobile AG5
  23           - const: renesas,scifb           # generic SCIFB compatible UART
  24
  25       - items:
  26           - enum:
  27               - renesas,scifb-r8a7742      # RZ/G1H
  28               - renesas,scifb-r8a7743      # RZ/G1M
  29               - renesas,scifb-r8a7744      # RZ/G1N
  30               - renesas,scifb-r8a7745      # RZ/G1E
  31               - renesas,scifb-r8a7790      # R-Car H2
  32               - renesas,scifb-r8a7791      # R-Car M2-W
  33               - renesas,scifb-r8a7793      # R-Car M2-N
  34               - renesas,scifb-r8a7794      # R-Car E2
  35           - const: renesas,rcar-gen2-scifb # R-Car Gen2 and RZ/G1
  36           - const: renesas,scifb           # generic SCIFB 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-scifb
  86 then:
  87   required:
  88     - resets
  89
  90 examples:
  91   - |
  92     #include <dt-bindings/clock/r8a7740-clock.h>
  93     #include <dt-bindings/interrupt-controller/arm-gic.h>
  94     scifb: serial@e6c30000 {
  95             compatible = "renesas,scifb-r8a7740", "renesas,scifb";
  96             reg = <0xe6c30000 0x100>;
  97             interrupts = <GIC_SPI 108 IRQ_TYPE_LEVEL_HIGH>;
  98             clocks = <&mstp2_clks R8A7740_CLK_SCIFB>;
  99             clock-names = "fck";
 100             power-domains = <&pd_a3sp>;
 101     };