bindings/serial/renesas%2Cscifb.yaml

0001 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
0002 %YAML 1.2
0003 ---
0004 $id: "http://devicetree.org/schemas/serial/renesas,scifb.yaml#"
0005 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
0006
0007 title: Renesas Serial Communications Interface with FIFO B (SCIFB)
0008
0009 maintainers:
0010   - Geert Uytterhoeven <geert+renesas@glider.be>
0011
0012 allOf:
0013   - $ref: serial.yaml#
0014
0015 properties:
0016   compatible:
0017     oneOf:
0018       - items:
0019           - enum:
0020               - renesas,scifb-r8a73a4      # R-Mobile APE6
0021               - renesas,scifb-r8a7740      # R-Mobile A1
0022               - renesas,scifb-sh73a0       # SH-Mobile AG5
0023           - const: renesas,scifb           # generic SCIFB compatible UART
0024
0025       - items:
0026           - enum:
0027               - renesas,scifb-r8a7742      # RZ/G1H
0028               - renesas,scifb-r8a7743      # RZ/G1M
0029               - renesas,scifb-r8a7744      # RZ/G1N
0030               - renesas,scifb-r8a7745      # RZ/G1E
0031               - renesas,scifb-r8a7790      # R-Car H2
0032               - renesas,scifb-r8a7791      # R-Car M2-W
0033               - renesas,scifb-r8a7793      # R-Car M2-N
0034               - renesas,scifb-r8a7794      # R-Car E2
0035           - const: renesas,rcar-gen2-scifb # R-Car Gen2 and RZ/G1
0036           - const: renesas,scifb           # generic SCIFB compatible UART
0037
0038   reg:
0039     maxItems: 1
0040
0041   interrupts:
0042     maxItems: 1
0043
0044   clocks:
0045     maxItems: 1
0046
0047   clock-names:
0048     enum:
0049       - fck # UART functional clock
0050
0051   power-domains:
0052     maxItems: 1
0053
0054   resets:
0055     maxItems: 1
0056
0057   dmas:
0058     minItems: 2
0059     maxItems: 4
0060     description:
0061       Must contain a list of pairs of references to DMA specifiers, one for
0062       transmission, and one for reception.
0063
0064   dma-names:
0065     minItems: 2
0066     maxItems: 4
0067     items:
0068       enum:
0069         - tx
0070         - rx
0071
0072 required:
0073   - compatible
0074   - reg
0075   - interrupts
0076   - clocks
0077   - clock-names
0078   - power-domains
0079
0080 unevaluatedProperties: false
0081
0082 if:
0083   properties:
0084     compatible:
0085       contains:
0086         enum:
0087           - renesas,rcar-gen2-scifb
0088 then:
0089   required:
0090     - resets
0091
0092 examples:
0093   - |
0094     #include <dt-bindings/clock/r8a7740-clock.h>
0095     #include <dt-bindings/interrupt-controller/arm-gic.h>
0096     scifb: serial@e6c30000 {
0097             compatible = "renesas,scifb-r8a7740", "renesas,scifb";
0098             reg = <0xe6c30000 0x100>;
0099             interrupts = <GIC_SPI 108 IRQ_TYPE_LEVEL_HIGH>;
0100             clocks = <&mstp2_clks R8A7740_CLK_SCIFB>;
0101             clock-names = "fck";
0102             power-domains = <&pd_a3sp>;
0103     };