cris: return of class_create should be considered
[cascardo/linux.git] / Documentation / devicetree / bindings / power / bq24257.txt
index 5c9d394..d693702 100644 (file)
@@ -1,21 +1,64 @@
-Binding for TI bq24257 Li-Ion Charger
+Binding for TI bq24250/bq24251/bq24257 Li-Ion Charger
 
 Required properties:
 - compatible: Should contain one of the following:
+ * "ti,bq24250"
+ * "ti,bq24251"
  * "ti,bq24257"
-- reg:                    integer, i2c address of the device.
+- reg: integer, i2c address of the device.
+- interrupt-parent: Should be the phandle for the interrupt controller. Use in
+    conjunction with "interrupts".
+- interrupts: Interrupt mapping for GPIO IRQ (configure for both edges). Use in
+    conjunction with "interrupt-parent".
 - ti,battery-regulation-voltage: integer, maximum charging voltage in uV.
-- ti,charge-current:      integer, maximum charging current in uA.
-- ti,termination-current:  integer, charge will be terminated when current in
-                          constant-voltage phase drops below this value (in uA).
+- ti,charge-current: integer, maximum charging current in uA.
+- ti,termination-current: integer, charge will be terminated when current in
+    constant-voltage phase drops below this value (in uA).
+
+Optional properties:
+- pg-gpios: GPIO used for connecting the bq2425x device PG (Power Good) pin.
+    This pin is not available on all devices however it should be used if
+    possible as this is the recommended way to obtain the charger's input PG
+    state. If this pin is not specified a software-based approach for PG
+    detection is used.
+- ti,current-limit: The maximum current to be drawn from the charger's input
+    (in uA). If this property is not specified, the input limit current is
+    set automatically using USB D+/D- signal based charger type detection.
+    If the hardware does not support the D+/D- based detection, a default
+    of 500,000 is used (=500mA) instead.
+- ti,ovp-voltage: Configures the over voltage protection voltage (in uV). If
+    not specified a default of 6,5000,000 (=6.5V) is used.
+- ti,in-dpm-voltage: Configures the threshold input voltage for the dynamic
+    power path management (in uV). If not specified a default of 4,360,000
+    (=4.36V) is used.
 
 Example:
 
 bq24257 {
        compatible = "ti,bq24257";
        reg = <0x6a>;
+       interrupt-parent = <&gpio1>;
+       interrupts = <16 IRQ_TYPE_EDGE_BOTH>;
+
+       pg-gpios = <&gpio1 28 GPIO_ACTIVE_HIGH>;
 
        ti,battery-regulation-voltage = <4200000>;
        ti,charge-current = <1000000>;
        ti,termination-current = <50000>;
 };
+
+Example:
+
+bq24250 {
+       compatible = "ti,bq24250";
+       reg = <0x6a>;
+       interrupt-parent = <&gpio1>;
+       interrupts = <16 IRQ_TYPE_EDGE_BOTH>;
+
+       ti,battery-regulation-voltage = <4200000>;
+       ti,charge-current = <500000>;
+       ti,termination-current = <50000>;
+       ti,current-limit = <900000>;
+       ti,ovp-voltage = <9500000>;
+       ti,in-dpm-voltage = <4440000>;
+};