drivers: fuelgauge: Add Onsemi LC709203F driver

Update documentation for the Adafruit Feather ESP32-S2 boards

Signed-off-by: Philipp Steiner <[email protected]>

Author: DBS06

boards/adafruit/feather_esp32s2/doc/adafruit_feather_esp32s2.rst

@@ -16,7 +16,7 @@ Hardware
 - 320KB SRAM, 4MB flash + 2MB PSRAM
 - USB-C directly connected to the ESP32-S2 for USB
 - LiPo connector and built-in battery charging when powered via USB-C
-- LC709203 or MAX17048 fuel gauge for battery voltage and state-of-charge reporting
+- LC709203F or MAX17048 fuel gauge for battery voltage and state-of-charge reporting
 - Built-in NeoPixel indicator RGB LED
 - STEMMA QT connector for I2C devices, with switchable power for low-power mode
 
@@ -28,12 +28,10 @@ Hardware
      overlay. All boards, except the `Adafruit ESP32-S2 Feather with BME280 Sensor`_ have a
      space for it, but will not be shipped with.
    - As of May 31, 2023 - Adafruit has changed the battery monitor chip from the
-     now-discontinued LC709203 to the MAX17048. Check the back silkscreen of your Feather to
+     now-discontinued LC709203F to the MAX17048. Check the back silkscreen of your Feather to
      see which chip you have.
-   - For the MAX17048 a driver in zephyr exists and is supported, but needs to be added via
-     a devicetree overlay.
-   - For the LC709203 a driver does'nt exists yet and the fuel gauge for boards with this IC
-     is not available.
+   - For the MAX17048 and LC709203F a driver in zephyr exists and is supported, but needs to be
+     added via a devicetree overlay.
    - For the `Adafruit ESP32-S2 Feather`_ there are two different Revisions ``rev B`` and
      ``rev C``. The ``rev C`` board has revised the power circuitry for the NeoPixel and I2C
      QT port. Instead of a transistor the ``rev C`` has a LDO regulator. To enable the
@@ -304,19 +302,30 @@ functioning correctly with Zephyr:
       :board: adafruit_feather_esp32s2@C
       :goals: build flash
 
-Testing the Fuel Gauge (MAX17048)
-*********************************
+Testing the Fuel Gauge
+**********************
 
-There is a sample available to verify that the MAX17048 fuel gauge on the board are
-functioning correctly with Zephyr:
+There are samples available to verify that the MAX17048 or LC709203F fuel gauge on the board are
+functioning correctly with Zephyr
 
 .. note::
-   As of May 31, 2023 Adafruit changed the battery monitor chip from the now-discontinued LC709203
+   As of May 31, 2023 Adafruit changed the battery monitor chip from the now-discontinued LC709203F
    to the MAX17048.
 
+**MAX17048 Fuel Gauge**
+
 .. zephyr-app-commands::
-   :zephyr-app: samples/fuel_gauge/max17048/
-   :board: adafruit_feather_esp32s2@C
+   :zephyr-app: samples/fuel_gauge
+   :board: adafruit_feather_esp32s2
+   :west-args: --extra-dtc-overlay="boards/adafruit_feather_esp32s2_max17048.overlay"
+   :goals: build flash
+
+**LC709203F Fuel Gauge**
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/fuel_gauge
+   :board: adafruit_feather_esp32s2
+   :west-args: --extra-dtc-overlay="boards/adafruit_feather_esp32s2_lc709203f.overlay"
    :goals: build flash
 
 Testing Wi-Fi

boards/adafruit/feather_esp32s2/doc/adafruit_feather_esp32s2_tft.rst

@@ -16,7 +16,7 @@ Hardware
 - 320KB SRAM, 4MB flash + 2MB PSRAM
 - USB-C directly connected to the ESP32-S2 for USB
 - LiPo connector and built-in battery charging when powered via USB-C
-- LC709203 or MAX17048 fuel gauge for battery voltage and state-of-charge reporting
+- LC709203F or MAX17048 fuel gauge for battery voltage and state-of-charge reporting
 - Charging indicator LED, user LED, reset and boot buttons.
 - Built-in NeoPixel indicator RGB LED
 - STEMMA QT connector for I2C devices, with switchable power for low-power mode
@@ -26,12 +26,10 @@ Hardware
 
    - The board has a space for a BME280, but will not be shipped with.
    - As of May 31, 2023 - Adafruit has changed the battery monitor chip from the
-     now-discontinued LC709203 to the MAX17048. Check the back silkscreen of your Feather to
+     now-discontinued LC709203F to the MAX17048. Check the back silkscreen of your Feather to
      see which chip you have.
-   - For the MAX17048 a driver in zephyr exists and is supported, but needs to be added via
-     a devicetree overlay.
-   - For the LC709203 a driver does'nt exists yet and the fuel gauge for boards with this IC
-     is not available.
+   - For the MAX17048 and LC709203F a driver in zephyr exists and is supported, but needs to be
+     added via a devicetree overlay.
 
 Supported Features
 ==================
@@ -252,19 +250,30 @@ Testing the TFT
    :board: adafruit_feather_esp32s2_tft
    :goals: build flash
 
-Testing the Fuel Gauge (MAX17048)
-*********************************
+Testing the Fuel Gauge
+**********************
 
-There is a sample available to verify that the MAX17048 fuel gauge on the board are
-functioning correctly with Zephyr:
+There are samples available to verify that the MAX17048 or LC709203F fuel gauge on the board are
+functioning correctly with Zephyr
 
 .. note::
-   As of May 31, 2023 Adafruit changed the battery monitor chip from the now-discontinued LC709203
+   As of May 31, 2023 Adafruit changed the battery monitor chip from the now-discontinued LC709203F
    to the MAX17048.
 
+**MAX17048 Fuel Gauge**
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/fuel_gauge
+   :board: adafruit_feather_esp32s2_tft
+   :west-args: --extra-dtc-overlay="boards/adafruit_feather_esp32s2_max17048.overlay"
+   :goals: build flash
+
+**LC709203F Fuel Gauge**
+
 .. zephyr-app-commands::
-   :zephyr-app: samples/fuel_gauge/max17048/
+   :zephyr-app: samples/fuel_gauge
    :board: adafruit_feather_esp32s2_tft
+   :west-args: --extra-dtc-overlay="boards/adafruit_feather_esp32s2_max17048.overlay"
    :goals: build flash
 
 Testing Wi-Fi

boards/adafruit/feather_esp32s2/doc/adafruit_feather_esp32s2_tft_reverse.rst

@@ -16,7 +16,7 @@ Hardware
 - 320KB SRAM, 4MB flash + 2MB PSRAM
 - USB-C directly connected to the ESP32-S2 for USB
 - LiPo connector and built-in battery charging when powered via USB-C
-- LC709203 or MAX17048 fuel gauge for battery voltage and state-of-charge reporting
+- MAX17048 fuel gauge for battery voltage and state-of-charge reporting
 - Charging indicator LED, user LED, reset and boot buttons and has 2 additional buttons.
 - Built-in NeoPixel indicator RGB LED
 - 240x135 pixel IPS TFT color display with 1.14" diagonal and ST7789 chipset.
@@ -249,18 +249,14 @@ functioning correctly with Zephyr:
    :board: adafruit_feather_esp32s2_tft_reverse
    :goals: build flash
 
-Testing the Fuel Gauge (MAX17048)
-*********************************
+Testing the Fuel Gauge
+**********************
 
 There is a sample available to verify that the MAX17048 fuel gauge on the board are
 functioning correctly with Zephyr:
 
-.. note::
-   As of May 31, 2023 Adafruit changed the battery monitor chip from the now-discontinued LC709203
-   to the MAX17048.
-
 .. zephyr-app-commands::
-   :zephyr-app: samples/fuel_gauge/max17048/
+   :zephyr-app: samples/fuel_gauge
    :board: adafruit_feather_esp32s2_tft_reverse
    :goals: build flash