linux/Documentation/devicetree/bindings/mfd/as3711.txt
<<
>>
Prefs
   1AS3711 is an I2C PMIC from Austria MicroSystems with multiple DCDC and LDO power
   2supplies, a battery charger and an RTC. So far only bindings for the two stepup
   3DCDC converters are defined. Other DCDC and LDO supplies are configured, using
   4standard regulator properties, they must belong to a sub-node, called
   5"regulators" and be called "sd1" to "sd4" and "ldo1" to "ldo8." Stepup converter
   6configuration should be placed in a subnode, called "backlight."
   7
   8Compulsory properties:
   9- compatible            : must be "ams,as3711"
  10- reg                   : specifies the I2C address
  11
  12To use the SU1 converter as a backlight source the following two properties must
  13be provided:
  14- su1-dev               : framebuffer phandle
  15- su1-max-uA            : maximum current
  16
  17To use the SU2 converter as a backlight source the following two properties must
  18be provided:
  19- su2-dev               : framebuffer phandle
  20- su1-max-uA            : maximum current
  21
  22Additionally one of these properties must be provided to select the type of
  23feedback used:
  24- su2-feedback-voltage  : voltage feedback is used
  25- su2-feedback-curr1    : CURR1 input used for current feedback
  26- su2-feedback-curr2    : CURR2 input used for current feedback
  27- su2-feedback-curr3    : CURR3 input used for current feedback
  28- su2-feedback-curr-auto: automatic current feedback selection
  29
  30and one of these to select the over-voltage protection pin
  31- su2-fbprot-lx-sd4     : LX_SD4 is used for over-voltage protection
  32- su2-fbprot-gpio2      : GPIO2 is used for over-voltage protection
  33- su2-fbprot-gpio3      : GPIO3 is used for over-voltage protection
  34- su2-fbprot-gpio4      : GPIO4 is used for over-voltage protection
  35
  36If "su2-feedback-curr-auto" is selected, one or more of the following properties
  37have to be specified:
  38- su2-auto-curr1        : use CURR1 input for current feedback
  39- su2-auto-curr2        : use CURR2 input for current feedback
  40- su2-auto-curr3        : use CURR3 input for current feedback
  41
  42Example:
  43
  44as3711@40 {
  45        compatible = "ams,as3711";
  46        reg = <0x40>;
  47
  48        regulators {
  49                sd4 {
  50                        regulator-name = "1.215V";
  51                        regulator-min-microvolt = <1215000>;
  52                        regulator-max-microvolt = <1235000>;
  53                };
  54                ldo2 {
  55                        regulator-name = "2.8V CPU";
  56                        regulator-min-microvolt = <2800000>;
  57                        regulator-max-microvolt = <2800000>;
  58                        regulator-always-on;
  59                        regulator-boot-on;
  60                };
  61        };
  62
  63        backlight {
  64                compatible = "ams,as3711-bl";
  65                su2-dev = <&lcdc>;
  66                su2-max-uA = <36000>;
  67                su2-feedback-curr-auto;
  68                su2-fbprot-gpio4;
  69                su2-auto-curr1;
  70                su2-auto-curr2;
  71                su2-auto-curr3;
  72        };
  73};
  74