:orphan:

.. raw:: html

    <!--
    FIXME: do not limit page width until content uses another representation
    format other than tables
    -->
    <style>.wy-nav-content { max-width: none; !important }</style>

.. dtcompatible:: adi,adp5360-charger
.. _dtbinding_adi_adp5360_charger:

adi,adp5360-charger
###################

.. sidebar:: Overview

   :Name: ``adi,adp5360-charger``
   :Vendor: :ref:`Analog Devices, Inc. <dt_vendor_adi>`
   :Used in: :zephyr:board-catalog:`List of boards <#compatibles=adi,adp5360-charger>` using
               this compatible
   :Driver: :zephyr_file:`drivers/charger/charger_adp5360.c`

Description
***********



.. code-block:: none

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

Properties
**********

.. tabs::

   .. group-tab:: Node specific properties

      Properties not inherited from the base binding file.

      .. list-table::
         :widths: 1 1 4
         :header-rows: 1

         * - Name
           - Type
           - Details

         * - ``device-chemistry``
           - ``string``
           - .. code-block:: none

                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``
           - .. code-block:: none

                The device default for this setting is 120mV.


             Default value: ``120000``

         * - ``precharge-current-microamp``
           - ``int``
           - .. code-block:: none

                The device default for this setting is 5mA.


             Default value: ``5000``

         * - ``charge-term-current-microamp``
           - ``int``
           - .. code-block:: none

                current for charge termination phase


             This property is **required**.

         * - ``constant-charge-current-max-microamp``
           - ``int``
           - .. code-block:: none

                maximum constant input current


             This property is **required**.

         * - ``constant-charge-voltage-max-microvolt``
           - ``int``
           - .. code-block:: none

                maximum constant input voltage


             This property is **required**.

         * - ``battery-name``
           - ``string``
           - .. code-block:: none

                Battery name connected to the PMIC.



             This property is **required**.

         * - ``charger-init-adpichg-limit-uv``
           - ``int``
           - .. code-block:: none

                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``
           - .. code-block:: none

                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``
           - .. code-block:: none

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



             Default value: ``100000``

         * - ``battery-voltage-cold-threshold-uv``
           - ``int``
           - .. code-block:: none

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



             Default value: ``1800000``

         * - ``battery-voltage-cool-threshold-uv``
           - ``int``
           - .. code-block:: none

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



             Default value: ``1130000``

         * - ``battery-voltage-warm-threshold-uv``
           - ``int``
           - .. code-block:: none

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



             Default value: ``286000``

         * - ``battery-voltage-hot-threshold-uv``
           - ``int``
           - .. code-block:: none

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



             Default value: ``172000``

         * - ``thermistor-current-limit-ua``
           - ``int``
           - .. code-block:: none

                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``
           - .. code-block:: none

                Enable ITHR even while VBUS < VBUS_OK.



         * - ``charger-voltage-trk-to-fast-uv``
           - ``int``
           - .. code-block:: none

                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``
           - .. code-block:: none

                Disables the recharge function of the charger.



         * - ``enable-charge-complete-timer``
           - ``boolean``
           - .. code-block:: none

                Enables the charge complete timer (tEND).



         * - ``enable-trickle-fast-charge-timer``
           - ``boolean``
           - .. code-block:: none

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



         * - ``trickle-fast-charge-timer-period``
           - ``int``
           - .. code-block:: none

                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``
           - .. code-block:: none

                Enables the JEITA Li-Ion temperature battery charging specification.



         * - ``ilim-jeita-cool-10pct``
           - ``boolean``
           - .. code-block:: none

                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``
           - .. code-block:: none

                Enables V_ADPICHG for adaptive current-limit during charging.



         * - ``disable-end-of-charge``
           - ``boolean``
           - .. code-block:: none

                Disables end of charge function.



         * - ``set-vsys-5v``
           - ``boolean``
           - .. code-block:: none

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



         * - ``disable-low-dropout``
           - ``boolean``
           - .. code-block:: none

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



         * - ``disable-isofet``
           - ``boolean``
           - .. code-block:: none

                Forces the Battery Isolation FET to turn off.



         * - ``enable-battery-protection``
           - ``boolean``
           - .. code-block:: none

                Enables battery protection features of the charger.



         * - ``disable-charge-with-undervoltage``
           - ``boolean``
           - .. code-block:: none

                Enables charging while battery is undervoltage.



         * - ``set-isofet-overcharge-off``
           - ``boolean``
           - .. code-block:: none

                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``
           - .. code-block:: none

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



         * - ``set-overcurrent-charge-hiccup``
           - ``boolean``
           - .. code-block:: none

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



         * - ``battery-undervolt-discharge-threshold-uv``
           - ``int``
           - .. code-block:: none

                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``
           - .. code-block:: none

                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``
           - .. code-block:: none

                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``
           - .. code-block:: none

                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``
           - .. code-block:: none

                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``
           - .. code-block:: none

                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``
           - .. code-block:: none

                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``
           - .. code-block:: none

                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``
           - .. code-block:: none

                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``
           - .. code-block:: none

                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``



   .. group-tab:: Deprecated node specific properties

      Deprecated properties not inherited from the base binding file.

      (None)

   .. group-tab:: Base properties

      Properties inherited from the base binding file, which defines
      common properties that may be set on many nodes. Not all of these
      may apply to the "adi,adp5360-charger" compatible.

      (None)