richtek,rtmv20-regulator.yaml

  1# SPDX-License-Identifier: GPL-2.0
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/regulator/richtek,rtmv20-regulator.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Richtek RTMV20 laser diode regulator
  8
  9maintainers:
 10  - ChiYuan Huang <cy_huang@richtek.com>
 11
 12description: |
 13  Richtek RTMV20 is a load switch current regulator that can supply up to 6A.
 14  It is used to drive laser diode. There're two signals for chip controls
 15  (Enable/Fail), Enable pin to turn chip on, and Fail pin as fault indication.
 16  There're still four pins for camera control, two inputs (strobe and vsync),
 17  the others for outputs (fsin1 and fsin2). Strobe input to start the current
 18  supply, vsync input from IR camera, and fsin1/fsin2 output for the optional.
 19
 20properties:
 21  compatible:
 22    const: richtek,rtmv20
 23
 24  reg:
 25    maxItems: 1
 26
 27  wakeup-source: true
 28
 29  interrupts:
 30    maxItems: 1
 31
 32  enable-gpios:
 33    description: A connection of the 'enable' gpio line.
 34    maxItems: 1
 35
 36  richtek,ld-pulse-delay-us:
 37    description: |
 38      load current pulse delay in microsecond after strobe pin pulse high.
 39    minimum: 0
 40    maximum: 100000
 41    default: 0
 42
 43  richtek,ld-pulse-width-us:
 44    description: |
 45      Load current pulse width in microsecond after strobe pin pulse high.
 46    minimum: 0
 47    maximum: 10000
 48    default: 1200
 49
 50  richtek,fsin1-delay-us:
 51    description: |
 52      Fsin1 pulse high delay in microsecond after vsync signal pulse high.
 53    minimum: 0
 54    maximum: 100000
 55    default: 23000
 56
 57  richtek,fsin1-width-us:
 58    description: |
 59      Fsin1 pulse high width in microsecond after vsync signal pulse high.
 60    minimum: 40
 61    maximum: 10000
 62    default: 160
 63
 64  richtek,fsin2-delay-us:
 65    description: |
 66      Fsin2 pulse high delay in microsecond after vsync signal pulse high.
 67    minimum: 0
 68    maximum: 100000
 69    default: 23000
 70
 71  richtek,fsin2-width-us:
 72    description: |
 73      Fsin2 pulse high width in microsecond after vsync signal pulse high.
 74    minimum: 40
 75    maximum: 10000
 76    default: 160
 77
 78  richtek,es-pulse-width-us:
 79    description: Eye safety function pulse width limit in microsecond.
 80    minimum: 0
 81    maximum: 10000
 82    default: 1200
 83
 84  richtek,es-ld-current-microamp:
 85    description: Eye safety function load current limit in microamp.
 86    minimum: 0
 87    maximum: 6000000
 88    default: 3000000
 89
 90  richtek,lbp-level-microvolt:
 91    description: Low battery protection level in microvolt.
 92    minimum: 2400000
 93    maximum: 3700000
 94    default: 2700000
 95
 96  richtek,lbp-enable:
 97    description: Low battery protection function enable control.
 98    type: boolean
 99
100  richtek,strobe-polarity-high:
101    description: Strobe pin active polarity control.
102    type: boolean
103
104  richtek,vsync-polarity-high:
105    description: Vsync pin active polarity control.
106    type: boolean
107
108  richtek,fsin-enable:
109    description: Fsin function enable control.
110    type: boolean
111
112  richtek,fsin-output:
113    description: Fsin function output control.
114    type: boolean
115
116  richtek,es-enable:
117    description: Eye safety function enable control.
118    type: boolean
119
120  lsw:
121    description: load switch current regulator description.
122    type: object
123    $ref: regulator.yaml#
124    unevaluatedProperties: false
125
126required:
127  - compatible
128  - reg
129  - wakeup-source
130  - interrupts
131  - enable-gpios
132  - lsw
133
134additionalProperties: false
135
136examples:
137  - |
138    #include <dt-bindings/interrupt-controller/irq.h>
139    i2c {
140      #address-cells = <1>;
141      #size-cells = <0>;
142
143      rtmv20@34 {
144        compatible = "richtek,rtmv20";
145        reg = <0x34>;
146        wakeup-source;
147        interrupts-extended = <&gpio26 2 IRQ_TYPE_LEVEL_LOW>;
148        enable-gpios = <&gpio26 3 0>;
149
150        richtek,strobe-polarity-high;
151        richtek,vsync-polarity-high;
152
153        lsw {
154                regulator-name = "rtmv20,lsw";
155                regulator-min-microamp = <0>;
156                regulator-max-microamp = <6000000>;
157        };
158      };
159    };
160...