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

title: Renesas RZ/G3S PCIe host controller (and similar SoCs)

maintainers:
  - Claudiu Beznea <claudiu.beznea.uj@bp.renesas.com>

description: |
  PCIe host controller found in Renesas RZ/G3S and similar SoCs complies
  with PCIe Base Specification 4.0 and supports different link speeds
  depending on the SoC variant:
    - Gen2 (5 GT/s): RZ/G3{L,S}
    - Gen3 (8 GT/s): RZ/G3E, RZ/V2H(P), RZ/V2N

properties:
  compatible:
    oneOf:
      - enum:
          - renesas,r9a08g045-pcie # RZ/G3S
          - renesas,r9a08g046-pcie # RZ/G3L
          - renesas,r9a09g047-pcie # RZ/G3E
          - renesas,r9a09g057-pcie # RZ/V2H(P)
      - items:
          - const: renesas,r9a09g056-pcie # RZ/V2N
          - const: renesas,r9a09g047-pcie

  reg:
    maxItems: 1

  interrupts:
    minItems: 16
    items:
      - description: System error interrupt
      - description: System error on correctable error interrupt
      - description: System error on non-fatal error interrupt
      - description: System error on fatal error interrupt
      - description: AXI error interrupt
      - description: INTA interrupt
      - description: INTB interrupt
      - description: INTC interrupt
      - description: INTD interrupt
      - description: MSI interrupt
      - description: Link bandwidth interrupt
      - description: PME interrupt
      - description: DMA interrupt
      - description: PCIe event interrupt
      - description: Message interrupt
      - description: All interrupts
      - description: Link equalization request interrupt
      - description: Turn off event interrupt
      - description: PMU power off interrupt
      - description: D3 event function 0 interrupt
      - description: D3 event function 1 interrupt
      - description: Configuration PMCSR write clear function 0 interrupt
      - description: Configuration PMCSR write clear function 1 interrupt

  interrupt-names:
    minItems: 16
    items:
      - const: serr
      - const: serr_cor
      - const: serr_nonfatal
      - const: serr_fatal
      - const: axi_err
      - const: inta
      - const: intb
      - const: intc
      - const: intd
      - const: msi
      - const: link_bandwidth
      - const: pm_pme
      - const: dma
      - const: pcie_evt
      - const: msg
      - const: all
      - const: link_equalization_request
      - const: turn_off_event
      - const: pmu_poweroff
      - const: d3_event_f0
      - const: d3_event_f1
      - const: cfg_pmcsr_writeclear_f0
      - const: cfg_pmcsr_writeclear_f1

  interrupt-controller: true

  clocks:
    minItems: 2
    items:
      - description: System clock
      - description: PM control clock or clock for L1 substate handling
      - description: PM control clock

  clock-names:
    minItems: 2
    items:
      - const: aclk
      - enum: [pm, pmu]
      - const: pmu

  resets:
    minItems: 1
    items:
      - description: AXI2PCIe Bridge reset
      - description: Data link layer/transaction layer reset
      - description: Transaction layer (ACLK domain) reset
      - description: Transaction layer (PCLK domain) reset
      - description: Physical layer reset
      - description: Configuration register reset
      - description: Configuration register reset

  reset-names:
    minItems: 1
    items:
      - const: aresetn
      - const: rst_b
      - const: rst_gp_b
      - const: rst_ps_b
      - const: rst_rsm_b
      - const: rst_cfg_b
      - const: rst_load_b

  power-domains:
    maxItems: 1

  dma-ranges:
    description:
      A single range for the inbound memory region.
    maxItems: 1

  renesas,sysc:
    description: |
      System controller registers control and monitor various PCIe
      functionalities.

      Control:
      - transition to L1 state
      - receiver termination settings
      - RST_RSM_B signal

      Monitor:
      - clkl1pm clock request state
      - power off information in L2 state
      - errors (fatal, non-fatal, correctable)
    $ref: /schemas/types.yaml#/definitions/phandle-array
    items:
      - items:
          - description: Phandle to system controller
          - description: PCIe controller index
            enum: [0, 1]
        minItems: 1

patternProperties:
  "^pcie@0,[0-0]$":
    type: object
    allOf:
      - $ref: /schemas/pci/pci-pci-bridge.yaml#

    properties:
      reg:
        maxItems: 1

      vendor-id:
        const: 0x1912

      device-id:
        enum:
          - 0x0033
          - 0x0039
          - 0x003b

      clocks:
        items:
          - description: Reference clock

      clock-names:
        items:
          - const: ref

    required:
      - device_type
      - vendor-id
      - device-id
      - clocks
      - clock-names

    unevaluatedProperties: false

required:
  - compatible
  - reg
  - clocks
  - clock-names
  - resets
  - reset-names
  - interrupts
  - interrupt-names
  - interrupt-map
  - interrupt-map-mask
  - interrupt-controller
  - power-domains
  - "#address-cells"
  - "#size-cells"
  - "#interrupt-cells"
  - renesas,sysc

allOf:
  - $ref: /schemas/pci/pci-host-bridge.yaml#
  - if:
      properties:
        compatible:
          contains:
            const: renesas,r9a08g045-pcie
    then:
      properties:
        interrupts:
          maxItems: 16
        interrupt-names:
          maxItems: 16
        clocks:
          maxItems: 2
        clock-names:
          items:
            - const: aclk
            - const: pm
        resets:
          minItems: 7
        reset-names:
          minItems: 7
  - if:
      properties:
        compatible:
          contains:
            const: renesas,r9a08g046-pcie
    then:
      properties:
        interrupts:
          maxItems: 16
        interrupt-names:
          maxItems: 16
        clocks:
          minItems: 3
        clock-names:
          items:
            - const: aclk
            - const: pm
            - const: pmu
        resets:
          maxItems: 1
        reset-names:
          maxItems: 1
  - if:
      properties:
        compatible:
          contains:
            enum:
              - renesas,r9a09g047-pcie
              - renesas,r9a09g057-pcie
    then:
      properties:
        interrupts:
          minItems: 23
        interrupt-names:
          minItems: 23
        clocks:
          maxItems: 2
        clock-names:
          items:
            - const: aclk
            - const: pmu
        resets:
          maxItems: 1
        reset-names:
          maxItems: 1
  - if:
      properties:
        compatible:
          contains:
            const: renesas,r9a09g057-pcie
    then:
      properties:
        num-lanes:
          enum: [2, 4]
        renesas,sysc:
          items:
            - minItems: 2
      required:
        - num-lanes
    else:
      properties:
        renesas,sysc:
          items:
            - maxItems: 1

unevaluatedProperties: false

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

    bus {
        #address-cells = <2>;
        #size-cells = <2>;

        pcie@11e40000 {
            compatible = "renesas,r9a08g045-pcie";
            reg = <0 0x11e40000 0 0x10000>;
            ranges = <0x02000000 0 0x30000000 0 0x30000000 0 0x08000000>;
            /* Map all possible DRAM ranges (4 GB). */
            dma-ranges = <0x42000000 0 0x40000000 0 0x40000000 1 0x00000000>;
            bus-range = <0x0 0xff>;
            interrupts = <GIC_SPI 395 IRQ_TYPE_LEVEL_HIGH>,
                         <GIC_SPI 396 IRQ_TYPE_LEVEL_HIGH>,
                         <GIC_SPI 397 IRQ_TYPE_LEVEL_HIGH>,
                         <GIC_SPI 398 IRQ_TYPE_LEVEL_HIGH>,
                         <GIC_SPI 399 IRQ_TYPE_LEVEL_HIGH>,
                         <GIC_SPI 400 IRQ_TYPE_LEVEL_HIGH>,
                         <GIC_SPI 401 IRQ_TYPE_LEVEL_HIGH>,
                         <GIC_SPI 402 IRQ_TYPE_LEVEL_HIGH>,
                         <GIC_SPI 403 IRQ_TYPE_LEVEL_HIGH>,
                         <GIC_SPI 404 IRQ_TYPE_LEVEL_HIGH>,
                         <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>,
                         <GIC_SPI 409 IRQ_TYPE_LEVEL_HIGH>,
                         <GIC_SPI 410 IRQ_TYPE_LEVEL_HIGH>;
            interrupt-names = "serr", "serr_cor", "serr_nonfatal",
                              "serr_fatal", "axi_err", "inta",
                              "intb", "intc", "intd", "msi",
                              "link_bandwidth", "pm_pme", "dma",
                              "pcie_evt", "msg", "all";
            #interrupt-cells = <1>;
            interrupt-controller;
            interrupt-map-mask = <0 0 0 7>;
            interrupt-map = <0 0 0 1 &pcie 0 0 0 0>, /* INTA */
                            <0 0 0 2 &pcie 0 0 0 1>, /* INTB */
                            <0 0 0 3 &pcie 0 0 0 2>, /* INTC */
                            <0 0 0 4 &pcie 0 0 0 3>; /* INTD */
            clocks = <&cpg CPG_MOD R9A08G045_PCI_ACLK>,
                     <&cpg CPG_MOD R9A08G045_PCI_CLKL1PM>;
            clock-names = "aclk", "pm";
            resets = <&cpg R9A08G045_PCI_ARESETN>,
                     <&cpg R9A08G045_PCI_RST_B>,
                     <&cpg R9A08G045_PCI_RST_GP_B>,
                     <&cpg R9A08G045_PCI_RST_PS_B>,
                     <&cpg R9A08G045_PCI_RST_RSM_B>,
                     <&cpg R9A08G045_PCI_RST_CFG_B>,
                     <&cpg R9A08G045_PCI_RST_LOAD_B>;
            reset-names = "aresetn", "rst_b", "rst_gp_b", "rst_ps_b",
                          "rst_rsm_b", "rst_cfg_b", "rst_load_b";
            power-domains = <&cpg>;
            device_type = "pci";
            #address-cells = <3>;
            #size-cells = <2>;
            renesas,sysc = <&sysc>;

            pcie@0,0 {
                reg = <0x0 0x0 0x0 0x0 0x0>;
                ranges;
                clocks = <&versa3 5>;
                clock-names = "ref";
                device_type = "pci";
                vendor-id = <0x1912>;
                device-id = <0x0033>;
                #address-cells = <3>;
                #size-cells = <2>;
            };
        };
    };

...