summaryrefslogtreecommitdiff
path: root/Documentation/devicetree/bindings/power_supply/lc709203f_battery.txt
blob: cab2883167762ab79a58db42cf517805bb99c6bf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
lc709203f battery
~~~~~~~~~~~~~~~~

Required properties :
 - compatible : Should contain "onsemi,lc709203f".
 - onsemi,initial-rsoc : INITIAL_RSOC register value to be written

Optional properties:
 - onsemi,tz-name : Thermal zone name.
 - onsemi,thermistor-beta : THERMISTOR_B register value to be written
 - onsemi,appli-adjustment: adjustment appli of parameter.
 - onsemi,thermistor-adjustment: adjustment thermistor pack.
 - onsemi,kernel-threshold-soc: Minimum SoC for kernel read from device.
	Bootloader jumps to kernel when SoC is more than this value.
	Driver make this SoC as 0% before reporting it to teh framework.
 - onsemi,kernel-maximum-soc: Maximum SoC for kernel read from device.
	Kernel read maximum SoC from device for given battery. Kernel
	translate the SoC to 100% before reporting to framework if it
	reads equal/more than this value.
 - onsemi,alert-low-rsoc : Alarm low RSOC programed to generate event
 - onsemi,alert-low-voltage : Alarm low Voltage programed to generate event

Note: The device has capabilty to read battery temp through thermistor.
This also calulate SoC based on temperature of battery. If thermistor
is not connected to this device on a given platform then the temp can be
written on the the device register to consider the battery temperature
on SoC calculation.

If battery thermistor is connected to the device's Tsense pin then following
properties are required:
	onsemi,thermistor-beta

if battery thermistor isnot connected to device and temperature is read from
other source then following properties are required:
	onsemi,tz-name

Example:

	lc709203f@0b {
		compatible = "onsemi,lc709203f";
		onsemi,tz-name = "battery-temp";
		onsemi,thermistor-beta = 0x0d34;
		onsemi,initial-rsoc = 0xAA55;
		onsemi,kernel-threshold-soc = <5>;
		onsemi,kernel-maximum-soc = <99>;
		onsemi,alert-low-rsoc = <0x0>;
		onsemi,alert-low-voltage = <0x0>;
	};