xref: /linux/Documentation/devicetree/bindings/mfd/airoha,en7581-gpio-sysctl.yaml (revision 2d32fba02e0e5b67fb3a4ea51dde80c0db83f1c1)

# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/mfd/airoha,en7581-gpio-sysctl.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Airoha EN7581 GPIO System Controller

maintainers:
  - Christian Marangi <ansuelsmth@gmail.com>
  - Lorenzo Bianconi <lorenzo@kernel.org>

description:
  Airoha EN7581 SoC GPIO system controller which provided a register map
  for controlling the GPIO, pins and PWM of the SoC.

properties:
  compatible:
    items:
      - const: airoha,en7581-gpio-sysctl
      - const: syscon
      - const: simple-mfd

  reg:
    maxItems: 1

  pinctrl:
    type: object
    $ref: /schemas/pinctrl/airoha,en7581-pinctrl.yaml
    description:
      Child node definition for EN7581 Pin controller

  pwm:
    type: object
    $ref: /schemas/pwm/airoha,en7581-pwm.yaml
    description:
      Child node definition for EN7581 PWM controller

required:
  - compatible
  - reg

additionalProperties: false

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

    system-controller@1fbf0200 {
      compatible = "airoha,en7581-gpio-sysctl", "syscon", "simple-mfd";
      reg = <0x1fbf0200 0xc0>;

      pinctrl {
        compatible = "airoha,en7581-pinctrl";

        interrupt-parent = <&gic>;
        interrupts = <GIC_SPI 26 IRQ_TYPE_LEVEL_HIGH>;

        gpio-controller;
        #gpio-cells = <2>;

        interrupt-controller;
        #interrupt-cells = <2>;

        mmc-pins {
          mux {
            function = "emmc";
            groups = "emmc";
          };
        };

        mdio-pins {
          mux {
            function = "mdio";
            groups = "mdio";
          };

          conf {
            pins = "gpio2";
            output-enable;
          };
        };
      };

      pwm {
        compatible = "airoha,en7581-pwm";

        #pwm-cells = <3>;
      };
    };