adi,adp5360-charger

Description

ADI ADP5360 Battery Management PMIC.
The charger is modeled in DT as a child device of "adi,adp5360" compatible node.

Properties

Properties not inherited from the base binding file.

Name

Type

Details

device-chemistry

string

This describes the chemical technology of the battery. The "lithium-ion" value is a blanket type for all lithium-ion batteries. If the specific chemistry is unknown, this value can be used instead of the precise "lithium-ion-X" options.

This property is required.

Legal values: nickel-cadmium, nickel-metal-hydride, lithium-ion, lithium-ion-polymer, lithium-ion-iron-phosphate, lithium-ion-manganese-oxide

re-charge-voltage-microvolt

int

The device default for this setting is 120mV.

Default value: 120000

precharge-current-microamp

int

The device default for this setting is 5mA.

Default value: 5000

charge-term-current-microamp

int

current for charge termination phase

This property is required.

constant-charge-current-max-microamp

int

maximum constant input current

This property is required.

constant-charge-voltage-max-microvolt

int

maximum constant input voltage

This property is required.

battery-name

string

Battery name connected to the PMIC.

This property is required.

charger-init-adpichg-limit-uv

int

Sets the initial adaptive current limit to VBUS voltage threshold.
The device default for this setting is 4.6V.

Default value: 4600000

battery-voltage-weak-threshold-uv

int

Weak battery voltage rising threshold. Determines the operating mode of
the charger if the threshold falls below this value.
Below V_WEAK, the charger will operate in weak charge mode.
Above V_WEAK, the charger will operate in fast charge mode.
The device default for this setting is 3V.

Default value: 3000000

charger-init-input-i-limit-ua

int

Initial Current input limit for VBUS.
The device default for this setting is 100mA.

Default value: 100000

battery-voltage-cold-threshold-uv

int

Voltage threshold for Cold Battery status.
The device default for this setting is 1.8V.

Default value: 1800000

battery-voltage-cool-threshold-uv

int

Voltage threshold for Cool Battery status.
The device default for this setting is 1.13V.

Default value: 1130000

battery-voltage-warm-threshold-uv

int

Voltage threshold for Warm Battery status.
The device default for this setting is 286mV.

Default value: 286000

battery-voltage-hot-threshold-uv

int

Voltage threshold for Hot Battery status.
The device default for this setting is 172mV.

Default value: 172000

thermistor-current-limit-ua

int

Sets the thermistor current ITHR.
The device default for this setting is 60uA.

Default value: 60

Legal values: 60, 12, 6

enable-thermistor-current

boolean

Enable ITHR even while VBUS < VBUS_OK.

charger-voltage-trk-to-fast-uv

int

Trickle to Fast Charge Battery threshold. switches from trickle mode to
fast charge mode.
The device default for this setting is 2.5V.

Default value: 2500000

Legal values: 2000000, 2500000, 2600000, 2900000

disable-recharge

boolean

Disables the recharge function of the charger.

enable-charge-complete-timer

boolean

Enables the charge complete timer (tEND).

enable-trickle-fast-charge-timer

boolean

Enables the trickle charge timer (tTRK) and the fast charge timer (tCHG).

trickle-fast-charge-timer-period

int

Sets tTRK and tCHG period.
0 - tTRK = 15 minutes, tCHG = 150 minutes
1 - tTRK = 30 minutes, tCHG = 300 minutes
2 - tTRK = 45 minutes, tCHG = 450 minutes
3 - tTRK = 60 minutes, tCHG = 600 minutes
The device default for this setting is set to 0.

Legal values: 0, 1, 2, 3

enable-jeita-temp-spec

boolean

Enables the JEITA Li-Ion temperature battery charging specification.

ilim-jeita-cool-10pct

boolean

Uses approximately 10% of programmed ILIM when battery is cool.
If not set, 50% of programmed ILIM will be used during cool battery.

enable-voltage-adpichg

boolean

Enables V_ADPICHG for adaptive current-limit during charging.

disable-end-of-charge

boolean

Disables end of charge function.

set-vsys-5v

boolean

Sets the V_SYSTEM voltage to 5V if set. Otherwise uses V_TRM + 200mV.

disable-low-dropout

boolean

Enables the Low Dropout (LDO) FET of the charger.
LDO must be active for charger operations to function.

disable-isofet

boolean

Forces the Battery Isolation FET to turn off.

enable-battery-protection

boolean

Enables battery protection features of the charger.

disable-charge-with-undervoltage

boolean

Enables charging while battery is undervoltage.

set-isofet-overcharge-off

boolean

Sets the battery isolation FET off when an overcharge event occurs.
If not set, battery isolation FET turns on when an overcharge occurs.

set-overcurrent-discharge-hiccup

boolean

Sets the overcurrent discharge protection mode to hiccup.
If unset mode is set to latch up.

set-overcurrent-charge-hiccup

boolean

Sets the overcurrent charge protection mode to hiccup.
If unset mode is set to latch up.

battery-undervolt-discharge-threshold-uv

int

Battery undervoltage discharge threshold. Indicates a battery voltage condition.
The device default for this setting is 2.5V.

Default value: 2500000

battery-undervolt-discharge-hysteresis

int

Hysteresis percentage for battery undervolt discharge.
Indicates the hysteresis range relative to the battery undervolt discharge threshold.
The device default for this setting is 2%.

Default value: 2

Legal values: 2, 4, 6, 8

battery-undervolt-discharge-deglitch-ms

int

Battery undervoltage deglitch time.
Indicates the timing window when battery voltage passes the set threshold.
The device default for this setting is 30ms.

Default value: 30

Legal values: 30, 60, 120, 240

battery-overcurrent-discharge-ua

int

Battery overcurrent discharge threshold. Indicates a battery charging condition.
The device default for this setting is 600mA.

Default value: 600000

battery-overcurrent-discharge-deglitch-us

int

Battery overcurrent deglitch time.
Indicates the timing window when battery discharging current passes the set threshold.
The device default for this setting is 5ms.

Default value: 5000

Legal values: 500, 1000, 5000, 10000, 20000, 50000, 100000

battery-overvolt-charge-threshold-uv

int

Battery overvoltage charge threshold. Indicates a battery voltage condition.
The device default for this setting is 4.3V.

Default value: 4300000

battery-overvolt-charge-hysteresis

int

Hysteresis percentage for battery overvolt charge.
Indicates the hysteresis range relative to the battery undervolt discharge threshold.
The device default for this setting is 2%.

Default value: 2

Legal values: 2, 4, 6, 8

battery-overvolt-charge-deglitch-ms

int

Battery overvoltage deglitch time.
Indicates the timing window when battery voltage passes the set threshold.
The device default for this setting is 500ms.

Default value: 500

Legal values: 500, 1000

battery-overcurrent-charge-ua

int

Battery overcurrent charge threshold. Indicates a battery charging condition.
The device default for this setting is 150mA.

Default value: 150000

battery-overcurrent-charge-deglitch-ms

int

Battery overcurrent deglitch time.
Indicates the timing window when battery charging current passes the set threshold.
The device default for this setting is 10ms.

Default value: 10

Legal values: 5, 10, 20, 40