xref: /freebsd/sys/contrib/device-tree/Bindings/leds/leds-ktd2692.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel Vadot* Kinetic Technologies - KTD2692 Flash LED Driver
2*c66ec88fSEmmanuel Vadot
3*c66ec88fSEmmanuel VadotKTD2692 is the ideal power solution for high-power flash LEDs.
4*c66ec88fSEmmanuel VadotIt uses ExpressWire single-wire programming for maximum flexibility.
5*c66ec88fSEmmanuel Vadot
6*c66ec88fSEmmanuel VadotThe ExpressWire interface through CTRL pin can control LED on/off and
7*c66ec88fSEmmanuel Vadotenable/disable the IC, Movie(max 1/3 of Flash current) / Flash mode current,
8*c66ec88fSEmmanuel VadotFlash timeout, LVP(low voltage protection).
9*c66ec88fSEmmanuel Vadot
10*c66ec88fSEmmanuel VadotAlso, When the AUX pin is pulled high while CTRL pin is high,
11*c66ec88fSEmmanuel VadotLED current will be ramped up to the flash-mode current level.
12*c66ec88fSEmmanuel Vadot
13*c66ec88fSEmmanuel VadotRequired properties:
14*c66ec88fSEmmanuel Vadot- compatible : Should be "kinetic,ktd2692".
15*c66ec88fSEmmanuel Vadot- ctrl-gpios : Specifier of the GPIO connected to CTRL pin.
16*c66ec88fSEmmanuel Vadot- aux-gpios : Specifier of the GPIO connected to AUX pin.
17*c66ec88fSEmmanuel Vadot
18*c66ec88fSEmmanuel VadotOptional properties:
19*c66ec88fSEmmanuel Vadot- vin-supply : "vin" LED supply (2.7V to 5.5V).
20*c66ec88fSEmmanuel Vadot  See Documentation/devicetree/bindings/regulator/regulator.txt
21*c66ec88fSEmmanuel Vadot
22*c66ec88fSEmmanuel VadotA discrete LED element connected to the device must be represented by a child
23*c66ec88fSEmmanuel Vadotnode - See Documentation/devicetree/bindings/leds/common.txt
24*c66ec88fSEmmanuel Vadot
25*c66ec88fSEmmanuel VadotRequired properties for flash LED child nodes:
26*c66ec88fSEmmanuel Vadot  See Documentation/devicetree/bindings/leds/common.txt
27*c66ec88fSEmmanuel Vadot- led-max-microamp : Minimum Threshold for Timer protection
28*c66ec88fSEmmanuel Vadot  is defined internally (Maximum 300mA).
29*c66ec88fSEmmanuel Vadot- flash-max-microamp : Flash LED maximum current
30*c66ec88fSEmmanuel Vadot  Formula : I(mA) = 15000 / Rset.
31*c66ec88fSEmmanuel Vadot- flash-max-timeout-us : Flash LED maximum timeout.
32*c66ec88fSEmmanuel Vadot
33*c66ec88fSEmmanuel VadotOptional properties for flash LED child nodes:
34*c66ec88fSEmmanuel Vadot- label : See Documentation/devicetree/bindings/leds/common.txt
35*c66ec88fSEmmanuel Vadot
36*c66ec88fSEmmanuel VadotExample:
37*c66ec88fSEmmanuel Vadot
38*c66ec88fSEmmanuel Vadotktd2692 {
39*c66ec88fSEmmanuel Vadot	compatible = "kinetic,ktd2692";
40*c66ec88fSEmmanuel Vadot	ctrl-gpios = <&gpc0 1 0>;
41*c66ec88fSEmmanuel Vadot	aux-gpios = <&gpc0 2 0>;
42*c66ec88fSEmmanuel Vadot	vin-supply = <&vbat>;
43*c66ec88fSEmmanuel Vadot
44*c66ec88fSEmmanuel Vadot	flash-led {
45*c66ec88fSEmmanuel Vadot		label = "ktd2692-flash";
46*c66ec88fSEmmanuel Vadot		led-max-microamp = <300000>;
47*c66ec88fSEmmanuel Vadot		flash-max-microamp = <1500000>;
48*c66ec88fSEmmanuel Vadot		flash-max-timeout-us = <1835000>;
49*c66ec88fSEmmanuel Vadot	};
50*c66ec88fSEmmanuel Vadot};
51