Documentation/devicetree/bindings/regulator/richtek,rt4801-regulator.yaml

   1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/regulator/richtek,rt4801-regulator.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Richtek RT4801 Display Bias regulators
   8
   9 maintainers:
  10   - ChiYuan Huang <cy_huang@richtek.com>
  11
  12 description: |
  13   Regulator nodes should be named to DSVP and DSVN. The
  14   definition for each of these nodes is defined using the standard
  15   binding for regulators at
  16   Documentation/devicetree/bindings/regulator/regulator.txt.
  17   Datasheet is available at
  18   https://www.richtek.com/assets/product_file/RT4801H/DS4801H-00.pdf
  19
  20 #The valid names for RT4801 regulator nodes are:
  21 #DSVP, DSVN
  22
  23 properties:
  24   compatible:
  25     enum:
  26       - richtek,rt4801
  27
  28   reg:
  29     maxItems: 1
  30
  31   enable-gpios:
  32     description: GPIOs to use to enable DSVP/DSVN regulator.
  33       The first one is ENP to enable DSVP, and second one is ENM to enable DSVN.
  34       Number of GPIO in the array list could be 1 or 2.
  35       If only one gpio is specified, only one gpio used to control ENP/ENM.
  36       Else both are spefied, DSVP/DSVN could be controlled individually.
  37       Othersie, this property not specified. treat both as always-on regulator.
  38     minItems: 1
  39     maxItems: 2
  40
  41 patternProperties:
  42   "^DSV(P|N)$":
  43     type: object
  44     $ref: regulator.yaml#
  45     description:
  46       Properties for single display bias regulator.
  47
  48 required:
  49   - compatible
  50   - reg
  51
  52 additionalProperties: false
  53
  54 examples:
  55   - |
  56     i2c {
  57         #address-cells = <1>;
  58         #size-cells = <0>;
  59
  60         rt4801@73 {
  61             compatible = "richtek,rt4801";
  62             reg = <0x73>;
  63             enable-gpios = <&gpio26 2 0>, <&gpio26 3 0>;
  64
  65             dsvp: DSVP {
  66                 regulator-name = "rt4801,dsvp";
  67                 regulator-min-microvolt = <4000000>;
  68                 regulator-max-microvolt = <6000000>;
  69                 regulator-boot-on;
  70             };
  71             dsvn: DSVN {
  72                 regulator-name = "rt4801,dsvn";
  73                 regulator-min-microvolt = <4000000>;
  74                 regulator-max-microvolt = <6000000>;
  75                 regulator-boot-on;
  76             };
  77
  78         };
  79     };