From e916ffe78eeb85fdf21b8f253284481dcc108939 Mon Sep 17 00:00:00 2001 From: Kavya Nunna Date: Tue, 17 Nov 2020 22:23:19 +0530 Subject: [PATCH] bindings: SMB358: Add documentation for smb358 charger Add snapshot of smb358 charger documentation from msm-4.14 'commit 50f9f83dd79b ("Merge "defconfig : Enable pinctrl and clock driver for SA8195"")'. SMB358 is a single-cell battery charger. It can charge the battery and power the system via the USB/AC adapter input. Change-Id: Id3aef2dab81a67061d728f661ce568917e86b08e --- bindings/power/supply/qcom/smb358-charger.txt | 106 ++++++++++++++++++ 1 file changed, 106 insertions(+) create mode 100644 bindings/power/supply/qcom/smb358-charger.txt diff --git a/bindings/power/supply/qcom/smb358-charger.txt b/bindings/power/supply/qcom/smb358-charger.txt new file mode 100644 index 000000000000..55c2ced3f877 --- /dev/null +++ b/bindings/power/supply/qcom/smb358-charger.txt @@ -0,0 +1,106 @@ +Summit smb358 battery charger + +SMB358 is a single-cell battery charger. It can charge +the battery and power the system via the USB/AC adapter input. + +The smb358 interface is via I2C bus. + +Required Properties: +- compatible Must be "qcom,smb358-charger". +- reg The device 7-bit I2C address. +- interrupt-parent parent of interrupt. +- interrupts This indicates the IRQ number of the GPIO + connected to the STAT pin. +- qcom,irq-gpio GPIO which receives interrupts from STAT output. +- qcom,bms-psy-name This is a string and it points to the bms + power supply name. +- qcom,float-voltage-mv Float Voltage in mV - the maximum voltage up to which + the battery is charged. Supported range 3500mV to 4500mV + +Optional Properties: + +- qcom,fastchg-current-max-ma Fast Charging current in mA. Supported range is + from 200mA to 2000mA. +- qcom,chg-valid-gpio GPIO which indicates the charger presence. + This GPIO is connected to the SYSOK pin. +- qcom,chg-autonomous-mode This is a bool property and it indicates that the + charger is configured for autonomous operation and + does not require any software configuration. +- qcom,disable-apsd This is a bool property which disables automatic + power source detection (APSD). If this is set + charger detection is done by DCIN UV irq. +- qcom,charger-disabled This is a bool property which disables charging. +- qcom,using-pmic-therm This property indicates thermal pin connected to pmic or smb. +- qcom,vcc-i2c-supply Power source required to power up i2c bus. +- qcom,bms-controlled-charging This property indicates integrating with VMBMS, charger + driver and BMS communicates with each other via power_supply + framework. Property "qcom,iterm-disabled" also needs defined + if using this feature to make sure that the charger doesn't + terminate charging on its own. +- qcom,iterm-ma Specifies the termination current to indicate end-of-charge. + Possible values in mA - 30, 40, 60, 80, 100, 125, 150, 200. +- qcom,iterm-disabled Disables the termination current feature. This is a bool + property. +- qcom,recharge-mv Recharge threshold in mV - the offset from the float-volatge + as which the charger restarts charging. Possible + values are 50mV to 300mV. +- qcom,recharge-disabled Boolean value which disables the auto-recharge. +- qcom,chg-inhibit-disabled This is a bool property which disables charger inhibit. + Charger inhibit option prevents battery charging upon insertion + of the charger when battery voltage is above the programmed inhibit + threshold. +- qcom,chg-adc_tm phandle to the corresponding VADC device to read the ADC channels. +- qcom,cold-bat-decidegc Cold battery temperature in decidegC. +- qcom,hot-bat-decidegc Hot battery temperature in decidegC. +- qcom,bat-present-decidegc This is a property indicating battery present temperature, if + higher than it, battery should exist. Default value is negative, + if this property is 200, it stands for -200 decidegC. +- qcom,warm-bat-decidegc: Warm battery temperature in decidegC. After hitting this threshold, + "qcom,warm-bat-ma" defines maximum charging current and + "qcom,warm-bat-mv" defines maximum target voltage. +- qcom,cool-bat-decidegc: Cool battery temperature in decidegC. After hitting this threshold, + "qcom,cool-bat-ma" defines maximum charging current and + "qcom,cool-bat-mv" defines maximum target voltage. +- qcom,warm-bat-ma: Maximum warm battery charge current in milli-amps. +- qcom,cool-bat-ma: Maximum cool battery charge current in milli-amps. +- qcom,warm-bat-mv: Maximum warm battery target voltage in milli-volts. +- qcom,cool-bat-mv: Maximum cool battery target voltage in milli-volts. +- qcom,chg-vadc Corresponding VADC device's phandle. +- qcom,skip-usb-suspend-for-fake-battery: A boolean property to skip suspending USB path for fake + battery. If this property is not present then 'qcom,batt-id-vref-uv' and + 'qcom,batt-id-rpullup-kohm' should be present. +- qcom,batt-id-vref-uv The reference voltage on the battery-ID line + specified in micro-volts. +- qcom,batt-id-rpullup-kohm The pull-up resistor connected on the battery-ID + (vref) line. +- qcom,using-vbat-sns Bool property to indicate that VBAT sense can be + done by PMIC. + +Example: + i2c@f9967000 { + smb358-charger@1b { + compatible = "qcom,smb358-charger"; + reg = <0x1b>; + interrupt-parent = <&msmgpio>; + interrupts = <17 0x0>; + qcom,irq-gpio = <&msmgpio 17 0x00>; + qcom,vcc-i2c-supply = <&pm8226_lvs1>; + qcom,float-voltage-mv = <4350>; + qcom,disable-apsd; + qcom,chg-inhibit-disabled; + qcom,bms-controlled-charging; + qcom,fastchg-current-max-ma = <1500>; + qcom,bms-psy-name = "bms"; + qcom,chg-vadc = <&pm8226_vadc>; + qcom,chg-adc_tm = <&pm8226_adc_tm>; + qcom,hot-bat-decidegc = <500>; + qcom,cold-bat-decidegc = <0>; + qcom,bat-present-decidegc = <200>; + qcom,warm-bat-decidegc = <450>; + qcom,cool-bat-decidegc = <100>; + qcom,warm-bat-ma = <350>; + qcom,cool-bat-ma = <350>; + qcom,warm-bat-mv = <4200>; + qcom,cool-bat-mv = <4200>; + }; + };