Documentation/devicetree/bindings/regulator/maxim,max20086.yaml

# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/regulator/maxim,max20086.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Maxim Integrated MAX20086-MAX20089 Camera Power Protector

maintainers:
  - Laurent Pinchart <laurent.pinchart@ideasonboard.com>

description: |
  The MAX20086-MAX20089 are dual/quad camera power protectors, designed to
  deliver power over coax for radar and camera modules. They support
  software-configurable output switching and monitoring. The output voltage and
  current limit are fixed by the hardware design.

properties:
  compatible:
    enum:
      - maxim,max20086
      - maxim,max20087
      - maxim,max20088
      - maxim,max20089

  reg:
    maxItems: 1

  enable-gpios:
    maxItems: 1
    description: GPIO connected to the EN pin, active high

  in-supply:
    description: Input supply for the camera outputs (IN pin, 3.0V to 15.0V)

  vdd-supply:
    description: Input supply for the device (VDD pin, 3.0V to 5.5V)

  regulators:
    type: object

    patternProperties:
      "^OUT[1-4]$":
        type: object
        $ref: regulator.yaml#

    additionalProperties: false

required:
  - compatible
  - reg
  - in-supply
  - vdd-supply
  - regulators

allOf:
  - if:
      properties:
        compatible:
          contains:
            enum:
              - maxim,max20088
              - maxim,max20089
    then:
      properties:
        regulators:
          properties:
            OUT3: false
            OUT4: false

additionalProperties: false

examples:
  - |
    #include <dt-bindings/gpio/gpio.h>

    i2c {
        #address-cells = <1>;
        #size-cells = <0>;

        regulator@28 {
            compatible = "maxim,max20087";
            reg = <0x28>;

            in-supply = <&reg_12v0>;
            vdd-supply = <&reg_3v3>;

            enable-gpios = <&gpio 108 GPIO_ACTIVE_HIGH>;

            regulators {
                OUT1 {
                    regulator-name = "VOUT1";
                };
                OUT2 {
                    regulator-name = "VOUT2";
                };
                OUT3 {
                    regulator-name = "VOUT3";
                };
                OUT4 {
                    regulator-name = "VOUT4";
                };
            };
        };
    };
...