Wiki

Below is the source of this page. To edit this source as well as other pages on the wiki, you must login.
====== ADP5061 I2C Linear Battery Charger Linux Driver ======

===== Supported Devices =====

  * [[adi>ADP5061]]

===== Evaluation Boards =====

  * [[adi>EVAL-ADP5061]] 

====== Source Code ======

===== Status =====

^ Source ^ Mainlined? ^
| [[https://github.com/analogdevicesinc/linux/blob/master/drivers/power/supply/adp5061.c|git]] | [No] |

===== Files =====

^ Function ^ File ^
| driver  | [[https://github.com/analogdevicesinc/linux/blob/master/drivers/power/supply/adp5061.c]] |

===== Devicetree =====

Required devicetree properties:
  * compatible: should be "adi,adp5061"
  * reg: i2c address of the device

<code>
	adp5061@14 {
		    compatible = "adi,adp5061";
		    reg = <0x14>;
	};
</code>

====== Driver testing ======

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/> **cd /sys/class/power_supply**
root:/sys/class/power_supply> ls
adp5061

root:/sys/class/power_supply>**cd adp5061**
root:/sys/class/power_supply/adp5061> **ls -l**
-r--r--r-- 1 root root 4096 Apr  2 14:25 capacity_level
-rw-r--r-- 1 root root 4096 Apr  2 14:25 charge_term_current
-r--r--r-- 1 root root 4096 Apr  2 14:25 charge_type
-rw-r--r-- 1 root root 4096 Apr  2 14:25 charging_enabled
-rw-r--r-- 1 root root 4096 Apr  2 14:25 charging_vlim_enabled
-rw-r--r-- 1 root root 4096 Apr  2 14:25 constant_charge_current
-rw-r--r-- 1 root root 4096 Apr  2 14:25 constant_charge_voltage_max
lrwxrwxrwx 1 root root    0 Apr  2 14:25 device -> ../../../0-0014
-rw-r--r-- 1 root root 4096 Apr  2 14:25 input_current_limit
drwxr-xr-x 2 root root    0 Apr  2 14:25 power
-rw-r--r-- 1 root root 4096 Apr  2 14:25 precharge_current
-r--r--r-- 1 root root 4096 Apr  2 14:25 present
-r--r--r-- 1 root root 4096 Apr  2 14:25 status
lrwxrwxrwx 1 root root    0 Apr  2 14:25 subsystem -> ../../../../../../../../class/power_supply
-r--r--r-- 1 root root 4096 Apr  2 14:25 type
-rw-r--r-- 1 root root 4096 Apr  2 14:25 uevent
-rw-r--r-- 1 root root 4096 Apr  2 14:25 voltage_avg
-rw-r--r-- 1 root root 4096 Apr  2 14:25 voltage_max
-rw-r--r-- 1 root root 4096 Apr  2 14:25 voltage_min
</xterm></WRAP>

=== Show Charger status ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **cat status**
Charging
</xterm></WRAP>

=== Show charge type ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **cat charge_type**
Fast
</xterm></WRAP>

=== Show the battery status ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **cat capacity_level**
Normal
</xterm></WRAP>

=== Enable Charging ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **cat charging_enabled**
0
root:/sys/class/power_supply/adp5061> **echo 1 > charging_enabled**
root:/sys/class/power_supply/adp5061> **cat charging_enabled**
1
</xterm></WRAP>

=== Enable Charging Voltage Limit ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **cat charging_vlim_enabled**
0
root:/sys/class/power_supply/adp5061> **echo 1 > charging_vlim_enabled**
root:/sys/class/power_supply/adp5061> **cat charging_vlim_enabled**
1
</xterm></WRAP>

=== Show Termination Voltage (VTRM) ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **cat voltage_max**
4200000
</xterm></WRAP>

=== Set Termination Voltage (VTRM) ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **echo 3800000 > voltage_max** 
root:/sys/class/power_supply/adp5061> **cat voltage_max**
3800000
</xterm></WRAP>

=== Set the Input Current Limit into VINx (ILIM) ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **cat input_current_limit**
100000
root:/sys/class/power_supply/adp5061> **echo 200000 > input_current_limit**
root:/sys/class/power_supply/adp5061> **cat input_current_limit**
200000
</xterm></WRAP>

=== Set the Trickle to Fast Charge Threshold (VTRK_DEAD) ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **cat voltage_min**
2500000
root:/sys/class/power_supply/adp5061> **echo 200000 > voltage_min**
root:/sys/class/power_supply/adp5061> **cat voltage_min**
200000
</xterm></WRAP>

=== Set the Charging Voltage Limit (CHG_VLIM) ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **cat constant_charge_voltage_max**
3200000
root:/sys/class/power_supply/adp5061> **echo 3800000 > constant_charge_voltage_max**
root:/sys/class/power_supply/adp5061> **cat constant_charge_voltage_max**
3800000
</xterm></WRAP>

=== Set the Constant Charge Current (ICHG) ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **cat constant_charge_current**
750000
root:/sys/class/power_supply/adp5061> **echo 500000 > constant_charge_current**
root:/sys/class/power_supply/adp5061> **cat constant_charge_current**
500000
</xterm></WRAP>

=== Set the Trickle and Weak Charge Currents (ITRK_DEAD) ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **cat precharge_current**
20000
root:/sys/class/power_supply/adp5061> **echo 10000 > precharge_current**
root:/sys/class/power_supply/adp5061> **cat precharge_current**
10000
</xterm></WRAP>

=== Set the VWEAK Threshold ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **cat voltage_avg**
3000000
root:/sys/class/power_supply/adp5061> **echo 3400000 > voltage_avg**
root:/sys/class/power_supply/adp5061> **cat voltage_avg**
3400000
</xterm></WRAP>

=== Set Termination Current (IEND) ===

<WRAP box bggreen><wrap info>This specifies any shell prompt running on the target</wrap>
<xterm>
root:/sys/class/power_supply/adp5061> **cat charge_term_current**
52500
root:/sys/class/power_supply/adp5061> **echo 72500 > charge_term_current**
root:/sys/class/power_supply/adp5061> **cat charge_term_current**
72500 
</xterm></WRAP>

====== More Information ======
  * [[adi>media/en/technical-documentation/data-sheets/ADP5061.pdf|ADP5061 Datasheet]]
  * [[https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/ABI/testing|Linux Kernel Documentation]]
  * [[https://github.com/analogdevicesinc/linux/blob/master/Documentation/ABI/testing/sysfs-class-power|Linux Kernel Documentation sysfs_class_power]]
  * [[https://www.kernel.org/doc/Documentation/power/power_supply_class.txt|Power Supply Documentation]]
==== Need help? ====
  * [[ez>community/linux-device-drivers/linux-software-drivers|Analog Devices Linux Device Drivers Help Forum]]
Analog Devices Wiki

Page Tools
