Re: [PATCH 2/3] dt: Document ModelGauge gauge bindings

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 




On Fri, Jan 10, 2014 at 1:49 AM, Vladimir Barinov
<vladimir.barinov@xxxxxxxxxxxxxxxxxx> wrote:
> These bindings can be used to register Maxim ModelGauge ICs fuel gauge
> (MAX17040/41/43/44/48/49/58/59)
>
> Signed-off-by: Vladimir Barinov <vladimir.barinov@xxxxxxxxxxxxxxxxxx>
>
> ---
>  Documentation/devicetree/bindings/power_supply/modelgauge_battery.txt |   82 ++++++++++
>  1 file changed, 82 insertions(+)
>
> Index: battery-2.6/Documentation/devicetree/bindings/power_supply/modelgauge_battery.txt
> ===================================================================
> --- /dev/null   1970-01-01 00:00:00.000000000 +0000
> +++ battery-2.6/Documentation/devicetree/bindings/power_supply/modelgauge_battery.txt   2014-01-09 15:09:38.035138887 +0400
> @@ -0,0 +1,82 @@
> +modelgauge_battery
> +~~~~~~~~~~~~~~~~~~
> +
> +Required properties:
> + - compatible          : should contain one of the following:
> +                         - "maxim,max17040" for MAX17040
> +                         - "maxim,max17041" for MAX17041
> +                         - "maxim,max17043" for MAX17043
> +                         - "maxim,max17044" for MAX17044
> +                         - "maxim,max17048" for MAX17048
> +                         - "maxim,max17049" for MAX17049
> +                         - "maxim,max17058" for MAX17058
> +                         - "maxim,max17059" for MAX17059
> +
> +Optional properties:
> + - maxim,empty_alert_threshold : Capacity threshold where an interrupt is
> +                                 generated on the ALRT pin;
> +
> + - soc_change_alert            : /* alert for 1% soc change */
> + - hibernate_threshold         : Hibernate threshold (crate), where IC
> +                                 enters hibernate mode
> + - active_threshold            : Active threshold (mV), where IC exits
> +                                 hibernate mode
> + - undervoltage                        : Voltage (mV), when IC alerts while battery
> +                                 voltage less then undervoltage
> + - overvoltage                 : Voltage (mV), when IC alerts while battery
> +                                 voltage greater then overvoltage
> + - maxim,resetvoltage          : Voltage threshold (mV) below which the IC
> +                                 resets itself. Used to detect battery removal
> +                                 and reinsertion;
> + - maxim,empty_adjustment      : Capacity charge empty design value;
> + - maxim,full_adjustment       : Capacity charge full design value;
> + - maxim,rcomp0                        : ModelGauge RCOMP parameter, used for
> +                                 temperature compensation;
> + - maxim,temp_co_up            : ModelGauge TempCoUp parameter, used for
> +                                 temperature compensation;
> + - maxim,temp_co_down          : ModelGauge TempCoDown parameter, used for
> +                                 temperature compensation;
> + - maxim,ocvtest               : ModelGauge OCVTest parameter, used for
> +                                 verification of Custom Model calibration data
> +                                 loaded into IC RAM;
> + - maxim,soc_check_a           : ModelGauge SOCCheckA parameter, used for
> +                                 verification of Custom Model calibration data
> +                                 loaded into IC RAM;
> + - maxim,soc_check_b           : ModelGauge SOCCheckB parameter, used for
> +                                 verification of Custom Model calibration data
> +                                 loaded into IC RAM;
> + - maxim,bits                  : ModelGauge Bits parameter, used as
> +                                 scaling parameter in Custom Model algorithm;
> + - maxim,model_data            : ModelGauge ModelData data,
> +                                 Custom Model calibration data.
Dose it open to vendor? we're using this chip. we don't need to setup
it at all. most of property except "rcomp" doesn't used.

Thank you,
Kyungmin Park
> +
> +Example:
> +
> +modelgauge@36 {
> +       compatible = "maxim,max17058";
> +       reg = <0x36>;
> +       interrupt-parent = <&msmgpio>;
> +       interrupts = <107 0x2>;
> +
> +       maxim,empty_alert_threshold = /bits/ 8 <15>;
> +       maxim,resetvoltage = /bits/ 16 <0>;
> +       maxim,empty_adjustment = /bits/ 8 <0>;
> +       maxim,full_adjustment = /bits/ 8 <100>;
> +       maxim,rcomp0 = /bits/ 8 <175>;
> +       maxim,temp_co_up = <(-1100)>;
> +       maxim,temp_co_down = <(-4000)>;
> +       maxim,ocvtest = /bits/ 16 <56144>;
> +       maxim,soc_check_a = /bits/ 8 <241>;
> +       maxim,soc_check_b = /bits/ 8 <243>;
> +       maxim,bits = /bits/ 8 <19>;
> +
> +       maxim,model_data = /bits/ 8 <
> +               0x9B 0x70 0xAB 0x30 0xB5 0xA0 0xB9 0xD0
> +               0xBB 0xA0 0xBC 0x00 0xBC 0xB0 0xBD 0x00
> +               0xBD 0x60 0xBE 0x40 0xBF 0x40 0xC1 0xF0
> +               0xC5 0x60 0xC8 0xA0 0xCD 0x00 0xD1 0x50
> +               0x00 0xE0 0x01 0x80 0x18 0x60 0x1C 0x20
> +               0x54 0x00 0x6A 0xC0 0x79 0x20 0x65 0xC0
> +               0x0B 0xE0 0x2A 0xC0 0x1D 0x00 0x17 0xE0
> +               0x15 0xE0 0x11 0xE0 0x11 0x00 0x11 0x00>;
> +};
> --
> To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
> the body of a message to majordomo@xxxxxxxxxxxxxxx
> More majordomo info at  http://vger.kernel.org/majordomo-info.html
> Please read the FAQ at  http://www.tux.org/lkml/
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Device Tree Compilter]     [Device Tree Spec]     [Linux Driver Backports]     [Video for Linux]     [Linux USB Devel]     [Linux PCI Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [XFree86]     [Yosemite Backpacking]
  Powered by Linux