# SPDX-License-Identifier: GPL-2.0
%YAML 1.2
---
$id: http://devicetree.org/schemas/regulator/mediatek,rt5133.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Richtek RT5133 voltage regulator

maintainers:
  - Jeff Chang <jeff_chang@richtek.com>
  - Tina Yang <tina_yang@richtek.com>

description: |
  Richtek RT5133 is a integrated IC that includes 8 LDOs and 3 output only
  GPIO. There's a limit for GPIO output. It tied to LDO1 output. For example,
  if LDO1 is 1.8V, the GPIO output high level will be 1.8V.

properties:
  compatible:
    const: mediatek,rt5133

  reg:
    maxItems: 1

  wakeup-source: true

  interrupts:
    maxItems: 1

  enable-gpio:
    maxItems: 1
    description: A connection of the 'enable' gpio line.

  gpio-controller: true

  gpio-supply: true

  "#gpio-cells":
    const: 2

  regulators:
    type: object

    patternProperties:
      "BASE":
        type: object
        $ref: "regulator.yaml#"

        properties:
          oc_shutdown_all:
            description: |
              If any LDO OC event occurred, to disable all LDOs or not.
            $ref: "/schemas/types.yaml#/definitions/uint32"
            minimum: 0
            maximum: 1
            default: 0

          pgb_shutdown_all:
            description: |
              If any LDO PGB event occurred, to disable all LDOs or not.
            $ref: "/schemas/types.yaml#/definitions/uint32"
            minimum: 0
            maximum: 1
            default: 0

        unevaluatedProperties: false

      "^LDO[1-8]$":
        type: object
        $ref: "regulator.yaml#"

        properties:
          oc_ptsel:
            description: Specify OC protect behavior.
            $ref: "/schemas/types.yaml#/definitions/uint32"
            minimum: 0
            maximum: 1
            default: 1

          pgb_ptsel:
            description: Specify PGB protect behavior.
            $ref: "/schemas/types.yaml#/definitions/uint32"
            minimum: 0
            maximum: 1
            default: 1

          soft_start_time_sel:
            description: Specify soft start time selection.
            $ref: "/schemas/types.yaml#/definitions/uint32"
            minimum: 0
            maximum: 3
            default: 1

        unevaluatedProperties: false

    additionalProperties: false

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/irq.h>
    i2c {
      #address-cells = <1>;
      #size-cells = <0>;

      rt5133@18 {
        compatible = "mediatek,rt5133-regulator";
        reg = <0x18>;
        wakeup-source;
        interrupts-extend = <&gpio26 2 IRQ_TYPE_LEVEL_LOW>;
        enable-gpio = <&gpio26 3 0>;
        gpio-supply = <&ldo1>;
        gpio-controller;
        #gpio-cells = <2>;

        regulators {
          BASE {
            regulator-name = "rt5133,base";
            oc_shutdown_all = <0>;
            pgb_shutdown_all = <0>;
          };
          ldo1: LDO1 {
            regulator-name = "rt5133,ldo1";
            regulator-min-microvolt = <1800000>;
            regulator-max-microvolt = <3200000>;
            oc_ptsel = <1>;
            pgb_ptsel = <1>;
            soft_start_time_sel = <1>;
          };
          LDO2 {
            regulator-name = "rt5133,ldo2";
            regulator-min-microvolt = <1800000>;
            regulator-max-microvolt = <3200000>;
            oc_ptsel = <1>;
            pgb_ptsel = <1>;
            soft_start_time_sel = <1>;
          };
          LDO3 {
            regulator-name = "rt5133,ldo3";
            regulator-min-microvolt = <1700000>;
            regulator-max-microvolt = <3000000>;
            oc_ptsel = <1>;
            pgb_ptsel = <1>;
            soft_start_time_sel = <1>;
          };
          LDO4 {
            regulator-name = "rt5133,ldo4";
            regulator-min-microvolt = <1700000>;
            regulator-max-microvolt = <3000000>;
            oc_ptsel = <1>;
            pgb_ptsel = <1>;
            soft_start_time_sel = <1>;
          };
          LDO5 {
            regulator-name = "rt5133,ldo5";
            regulator-min-microvolt = <1700000>;
            regulator-max-microvolt = <3000000>;
            oc_ptsel = <1>;
            pgb_ptsel = <1>;
            soft_start_time_sel = <1>;
          };
          LDO6 {
            regulator-name = "rt5133,ldo6";
            regulator-min-microvolt = <1700000>;
            regulator-max-microvolt = <3000000>;
            oc_ptsel = <1>;
            pgb_ptsel = <1>;
            soft_start_time_sel = <1>;
          };
          LDO7 {
            regulator-name = "rt5133,ldo7";
            regulator-min-microvolt = <900000>;
            regulator-max-microvolt = <1800000>;
            oc_ptsel = <1>;
            pgb_ptsel = <1>;
            soft_start_time_sel = <1>;
          };
          LDO8 {
            regulator-name = "rt5133,ldo8";
            regulator-min-microvolt = <900000>;
            regulator-max-microvolt = <1800000>;
            oc_ptsel = <1>;
            pgb_ptsel = <1>;
            soft_start_time_sel = <1>;
          };
        };
      };
    };
...