Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit ffbebf06 authored by Fenglin Wu's avatar Fenglin Wu
Browse files

power: smb23x-charger: Add SMB23X charger driver 



SMB23x is a linear charger capable of supporting 1.5 ampere maximum
input current which including 1 ampere maximum battery charging current.

Add the driver to support it. This driver allows to control the charging
enable/disable and other charging configurations, such as charging
current, termination current, etc. It also supports to detect the VBUS
detection/notification and other battery status updating via
power_supply framework.

Change-Id: I89c6b3c019a9598f1b91ff6d09de92817ff4e1bb
Signed-off-by: default avatarFenglin Wu <fenglinw@codeaurora.org>
parent d70d0441

Documentation/devicetree/bindings/power/smb23x-charger.txt

0 → 100644
+118 −0
Original line number Diff line number Diff line 
SMB23x battery charger



SMB23x is a single-cell linear battery charger which could draw 1.5 ampere

current at max from USB adapter to power the system and charge the battery,

and support 1 amper charging current at max.



The SMB23x interface is via I2C bus.



Required Properties:

- compatible:			Must be "qcom,smb231-lbc", "qcom,smb232-lbc" or

				"qcom,smb233-lbc".

- reg:				The device 7-bit I2C address.



Optional Properties:



- interrupts			This indicates the IRQ number of the GPIO connected to

				the STAT pin.

- qcom,bms-psy-name		The power supply name which used for getting the battery

				capacity. If left unspecified a pre-defined default value

				will be used for capacity value.

- pinctrl-names			The pinctrl state name of the pin which connects to the

				STAT line for interrupt notification.

				Only support: "default".

- pinctrl-0			The phandle to specify the configuration of the pin which

				connects to the STAT line for interrupt notification.

- qcom,float-voltage-mv	 	Float Voltage in mV - the maximum voltage up to which

				the battery is charged. Supported range from 3480mV

				to 4720mV.

- qcom,charging-timeout		Maximum duration in minutes that a single charge cycle

				may last.  Supported values are: 0, 180, 270, 360.

				A value of 0 means that no charge cycle timeout is used

				and charging can continue indefinitely.

- qcom,recharge-thresh-mv	Specifies the minimum voltage drop in millivolts below

				the float voltage that is required in order to initiate

				a new charging cycle.

				Supported values are: 150, 80mV.

- qcom,iterm-ma			Specifies the termination current to indicate

				end-of-charge. Possible values in mA: 20, 30, 50, 75.

- qcom,fastchg-ma		Specifies the maximum fast charge current. The possible

				value for fast charge current in mA: 100, 250, 300, 370,

				500, 600, 700, 1000.

- qcom,chg-inhibit-thresh-mv	Specifies the maximum voltage drop in millivolts below

				the float voltage for charging inhibit. The possible

				value for the threshold in mV: 265, 385, 512.

- qcom,hot-bat-decidegc		Hot battery temperature in decidegC. Charging will be

				stopped if battery temperature higher than it.

				The possible value: 500, 550, 600, 650.

- qcom,cold-bat-decidegc	Cold battery temperature in decidegC. Charging will be

				stopped if battery temperature lower than it.

				The possible value: (-50), 0, 50, 100.

- qcom,warm-bat-decidegc	Warm battery temperature in decidegC. The float voltage

				and fastchg current compensation(reduction) will be

				applied when the battery temperature higher than it but

				lower than "qcom,hot-bat-decidegc".

				The possible value: 400, 450, 500, 550.

- qcom,cool-bat-decidegc	Cool battery temperature in decidegC. The float voltage

				and fastchg current compensation(reduction) will be

				applied when the battery temperature lower than it but

				higher than "qcom,cold-bat-decidegc".

				The possible value: 0, 50, 100, 150.

- qcom,soft-temp-vfloat-comp-mv

				Specifies the float voltage compensation(reduction)

				in mV used for battery charging in warm/cool status.

				The possible value in mV: 80, 120, 160, 200.

- qcom,soft-temp-current-comp-ma

				Specifies the fastchg current compensation(reduction)

				in mA used for battery charging in warm/cool status.

				The possible value in mA should range from 0 to the

				value set in "qcom,fastchg-ma".

- qcom,thermal-mitigation	Array of input current limit values for different

				system thermal mitigation level.

- qcom,charging-disabled	A boolean property to specify if charging should be

				disabled in the build by default.

- qcom,recharge-disabled	A boolean property to specify if recharging depends

				on the voltage drop should be disabled. If yes, the

				battery won't be recharging whatever the battery

				voltage drops below the float voltage.

- qcom,aicl-disabled		A boolean property used to disable AICL function.

- qcom,apsd-disabled		A boolean property used to disable APSD function.

- qcom,chg-inhibit-disabled:	A boolean property used to disable the charger-inhibit

				function.

- qcom,iterm-disabled		A boolean property used to disable the current

				termination current feature.

- qcom,bms-controlled-charging  A boolean property to indicate if the charging

				termination and the recharging behavior will be

				controlled by BMS power supply according to the

				battery SoC (state of charge). If this property

				is specified, charging termination based on

				current and recharging based on voltage drop will

				be disabled automatically.

				"qcom,bms-psy-name" is need if it's been specified.



Example:

&i2c_4 {

	smb23x-lbc@1b {

		compatible = "qcom,smb231-lbc";

		reg = <0x12>;

		interrupt-parent = <&msm_gpio>;

		interrupts = <58 2>;

		qcom,bms-psy-name = "bms";

		pinctrl-names = "default";

		pinctrl-0 = <&smb_int_default>;

		qcom,float-voltage-mv = <4200>;

		qcom,charging-timeout = <360>;

		qcom,recharge-thresh-mv = <150>;

		qcom,iterm-ma = <50>;

		qcom,fastchg-ma = <1000>;

		qcom,hot-bat-decidegc = <550>;

		qcom,warm-bat-decidegc = <450>;

		qcom,cool-bat-decidegc = <50>;

		qcom,cold-bat-decidegc = <(-50)>;

		qcom,soft-temp-vfloat-comp-mv = <200>;

		qcom,soft-temp-current-comp-ma = <400>;

		qcom,chg-inhibit-disabled;

		qcom,apsd-disabled;

		qcom,thermal-mitigation = <1500 900 500 100>;

	};

};

drivers/power/Kconfig

+11 −0
Original line number Diff line number Diff line
@@ -451,6 +451,17 @@ config SMB358_CHARGER 
	  The driver reports the charger status via the power supply framework.

	  A charger status change triggers an IRQ via the device STAT pin.



config SMB23X_CHARGER

	tristate "SMB23X Battery Charger"

	depends on I2C

	help

	  Say Y to include support for SMB23X Battery Charger.

	  SMB23X is a single path linear charger capable of charging

	  the battery with 1Amps of current.

	  The driver supports charger enable/disable.

	  The driver reports the charger status via the power supply framework.

	  A charger status change triggers an IRQ via the device STAT pin.



config BATTERY_BQ28400

	tristate "BQ28400 battery driver"

	depends on I2C

drivers/power/Makefile

+1 −0
Original line number Diff line number Diff line
@@ -64,6 +64,7 @@ obj-$(CONFIG_SMB350_CHARGER) += smb350_charger.o 
obj-$(CONFIG_SMB135X_CHARGER)   += smb135x-charger.o

obj-$(CONFIG_SMB1360_CHARGER_FG) += smb1360-charger-fg.o

obj-$(CONFIG_SMB358_CHARGER)	+= smb358-charger.o

obj-$(CONFIG_SMB23X_CHARGER)	+= smb23x-charger.o

obj-$(CONFIG_BATTERY_BQ28400)	+= bq28400_battery.o

obj-$(CONFIG_QPNP_BMS)		+= qpnp-bms.o batterydata-lib.o

obj-$(CONFIG_QPNP_VM_BMS)	+= qpnp-vm-bms.o batterydata-lib.o batterydata-interface.o

drivers/power/smb23x-charger.c

0 → 100644
+2450 −0

File added.

Preview size limit exceeded, changes collapsed.