charger: Adds basic stub API doc.

Adds a short stub doc as a placeholder for future documentation in the
charger API.

Signed-off-by: Ricardo Rivera-Matos <rriveram@opensource.cirrus.com>

doc/develop/api/overview.rst

@@ -45,6 +45,10 @@ between major releases are available in the :ref:`zephyr_release_notes`.
      - Stable
      - 1.14
 
+   * - :ref:`charger_api`
+     - Experimental
+     - 3.3
+
    * - :ref:`counter_api`
      - Unstable
      - 1.14

doc/hardware/peripherals/charger.rst

@@ -0,0 +1,38 @@
+.. _charger_api:
+
+Chargers (Experimental API Stub Doc)
+#######################################
+
+The charger subsystem exposes an API to uniformly access battery charger devices. Currently,
+only reading data is supported.
+
+Note: This API is currently experimental and this doc will be significantly changed as new features
+are added to the API.
+
+Basic Operation
+***************
+
+Properties
+==========
+
+Fundamentally, a property is a configurable setting, state, or quantity that a charger device can
+measure.
+
+Chargers typically support multiple properties, such as temperature readings of the battery-pack
+or present-time current/voltage.
+
+Properties are fetched using a client allocated array of :c:struct:`charger_get_property`.  This
+array is then populated by values as according to its `property_type` field.
+
+Caching
+=======
+
+The Charger API explicitly provides no caching for its clients.
+
+
+.. _charger_api_reference:
+
+API Reference
+*************
+
+.. doxygengroup:: charger_interface

doc/hardware/peripherals/index.rst

@@ -9,6 +9,7 @@ Peripherals
    adc.rst
    audio/index.rst
    canbus/index.rst
+   charger.rst
    coredump.rst
    counter.rst
    clock_control.rst