doc: charger: Adds introductory context to documentation

Adds some introductory context to the charger documentation. This
is being aided to help developers understand what a charger device
is and how the charger_driver_api is relevant to system operation.

Signed-off-by: Ricardo Rivera-Matos <ricardo.rivera-matos@cirrus.com>
This commit is contained in:
Ricardo Rivera-Matos 2024-04-22 11:34:34 -05:00 committed by Henrik Brix Andersen
commit d929fc513c

View file

@ -5,6 +5,18 @@ Chargers
The charger subsystem exposes an API to uniformly access battery charger devices.
A charger device, or charger peripheral, is a device used to take external power provided to the
system as an input and provide power as an output downstream to the battery pack(s) and system.
The charger device can exist as a module, an integrated circuit, or as a functional block in a power
management integrated circuit (PMIC).
The action of charging a battery pack is referred to as a charge cycle. When the charge cycle is
executed the battery pack is charged according to the charge profile configured on the charger
device. The charge profile is defined in the battery pack's specification that is provided by the
manufacturer. On charger devices with a control port, the charge profile can be configured by the
host controller by setting the relevant properties, and can be adjusted at runtime to respond to
environmental changes.
Basic Operation
***************