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

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: "http://devicetree.org/schemas/serial/renesas,sci.yaml#"
$schema: "http://devicetree.org/meta-schemas/core.yaml#"

title: Renesas Serial Communication Interface

maintainers:
  - Geert Uytterhoeven <geert+renesas@glider.be>

allOf:
  - $ref: serial.yaml#

properties:
  compatible:
    oneOf:
      - items:
          - enum:
              - renesas,r9a07g044-sci     # RZ/G2{L,LC}
              - renesas,r9a07g054-sci     # RZ/V2L
          - const: renesas,sci            # generic SCI compatible UART

      - items:
          - const: renesas,sci            # generic SCI compatible UART

  reg:
    maxItems: 1

  interrupts:
    items:
      - description: Error interrupt
      - description: Receive buffer full interrupt
      - description: Transmit buffer empty interrupt
      - description: Transmit end interrupt

  interrupt-names:
    items:
      - const: eri
      - const: rxi
      - const: txi
      - const: tei

  clocks:
    minItems: 1
    maxItems: 2

  clock-names:
    minItems: 1
    maxItems: 2
    items:
      enum:
        - fck # UART functional clock
        - sck # optional external clock input

  uart-has-rtscts: false

required:
  - compatible
  - reg
  - interrupts
  - clocks
  - clock-names

if:
  properties:
    compatible:
      contains:
        enum:
          - renesas,r9a07g044-sci
          - renesas,r9a07g054-sci
then:
  properties:
    resets:
      maxItems: 1

    power-domains:
      maxItems: 1

  required:
    - resets
    - power-domains

unevaluatedProperties: false

examples:
  - |
    #include <dt-bindings/clock/r9a07g044-cpg.h>
    #include <dt-bindings/interrupt-controller/arm-gic.h>

    aliases {
            serial0 = &sci0;
    };

    sci0: serial@1004d000 {
            compatible = "renesas,r9a07g044-sci", "renesas,sci";
            reg = <0x1004d000 0x400>;
            interrupts = <GIC_SPI 405 IRQ_TYPE_LEVEL_HIGH>,
                         <GIC_SPI 406 IRQ_TYPE_LEVEL_HIGH>,
                         <GIC_SPI 407 IRQ_TYPE_LEVEL_HIGH>,
                         <GIC_SPI 408 IRQ_TYPE_LEVEL_HIGH>;
            interrupt-names = "eri", "rxi", "txi", "tei";
            clocks = <&cpg CPG_MOD R9A07G044_SCI0_CLKP>;
            clock-names = "fck";
            power-domains = <&cpg>;
            resets = <&cpg R9A07G044_SCI0_RST>;
    };