: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:: infineon,autanalog-ac-state
.. _dtbinding_infineon_autanalog_ac_state:

infineon,autanalog-ac-state
###########################

.. sidebar:: Overview

   :Name: ``infineon,autanalog-ac-state``
   :Vendor: :ref:`Infineon Technologies <dt_vendor_infineon>`
   :Used in: :zephyr:board-catalog:`List of boards <#compatibles=infineon,autanalog-ac-state>` using
               this compatible

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



.. code-block:: none

   Infineon AutAnalog Autonomous Controller (AC) State Transition Table entry.

   Each node with this compatible represents one state in the AC State Transition
   Table (STT).  The node is referenced by phandle from the parent autanalog
   device's ac-states property, which determines the state's index in the table.

   This binding covers all sub-peripheral STT fields: AC, SAR, CTB (×2),
   PTCOMP, and DAC (×2).  All properties default to 0, so only the fields
   relevant to a particular state need to be specified.

   Use constants from <dt-bindings/mfd/infineon-autanalog.h> for condition,
   action, GPIO output, CTB gain, and DAC direction values.

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

         * - ``ac-unlock``
           - ``int``
           - .. code-block:: none

                AC unlock flag (0 or 1).
                When set to 1, the AC is unlocked (allowed to modify config) in this state.



         * - ``ac-lp-mode``
           - ``int``
           - .. code-block:: none

                Low-power mode flag (0 or 1).
                When set to 1, the sub-system enters low-power mode in this state.



         * - ``ac-condition``
           - ``int``
           - .. code-block:: none

                AC condition code. Use IFX_AUTANALOG_AC_COND_* constants
                from <dt-bindings/mfd/infineon-autanalog.h>.
                Default: FALSE (0).



         * - ``ac-action``
           - ``int``
           - .. code-block:: none

                AC action code. Use IFX_AUTANALOG_AC_ACTION_* constants
                from <dt-bindings/mfd/infineon-autanalog.h>.
                Default: STOP (0).



         * - ``branch-state``
           - ``int``
           - .. code-block:: none

                Branch target state index (0-63) within the ac-states list.
                Used when the action is a BRANCH_* or WAIT_FOR type.



         * - ``ac-trig-int``
           - ``int``
           - .. code-block:: none

                Trigger-interrupt flag (0 or 1).
                When set to 1, the AC generates an interrupt on entering this state.



         * - ``ac-count``
           - ``int``
           - .. code-block:: none

                Repetition count (0-4095).
                The actual repetition count is value + 1.



         * - ``ac-unlock-gpio-out``
           - ``int``
           - .. code-block:: none

                GPIO output unlock flag (0 or 1).



         * - ``ac-gpio-out``
           - ``int``
           - .. code-block:: none

                GPIO output mask. Use IFX_AUTANALOG_AC_GPIO_OUT_* constants
                from <dt-bindings/mfd/infineon-autanalog.h>.
                Can be OR'd for multiple outputs (e.g., OUT0 | OUT1 = 0x3).



         * - ``sar-unlock``
           - ``int``
           - .. code-block:: none

                SAR unlock flag (0 or 1).
                When set to 1, the SAR configuration is unlocked in this state.



         * - ``sar-enable``
           - ``int``
           - .. code-block:: none

                SAR enable flag (0 or 1).
                When set to 1, the SAR is enabled in this state.



         * - ``sar-trigger``
           - ``int``
           - .. code-block:: none

                SAR trigger flag (0 or 1).
                When set to 1, the SAR conversion is triggered in this state.



         * - ``sar-entry-state``
           - ``int``
           - .. code-block:: none

                SAR entry state index (0-31).
                Selects the SAR sequencer entry point for this AC state.



         * - ``ctb0-unlock``
           - ``int``
           - .. code-block:: none

                CTB0 unlock flag (0 or 1).
                When 1, CTB0 opamp fields below take effect in this state.



         * - ``ctb0-enable-opamp0``
           - ``int``
           - .. code-block:: none

                CTB0 Opamp0 enable flag (0 or 1).


         * - ``ctb0-cfg-opamp0``
           - ``int``
           - .. code-block:: none

                CTB0 Opamp0 dynamic configuration selector (0-7).
                Selects from the CTB dynamic configuration table.



         * - ``ctb0-gain-opamp0``
           - ``int``
           - .. code-block:: none

                CTB0 Opamp0 gain. Use IFX_AUTANALOG_CTB_OA_GAIN_* constants.



         * - ``ctb0-enable-opamp1``
           - ``int``
           - .. code-block:: none

                CTB0 Opamp1 enable flag (0 or 1).


         * - ``ctb0-cfg-opamp1``
           - ``int``
           - .. code-block:: none

                CTB0 Opamp1 dynamic configuration selector (0-7).



         * - ``ctb0-gain-opamp1``
           - ``int``
           - .. code-block:: none

                CTB0 Opamp1 gain. Use IFX_AUTANALOG_CTB_OA_GAIN_* constants.



         * - ``ctb1-unlock``
           - ``int``
           - .. code-block:: none

                CTB1 unlock flag (0 or 1).
                When 1, CTB1 opamp fields below take effect in this state.



         * - ``ctb1-enable-opamp0``
           - ``int``
           - .. code-block:: none

                CTB1 Opamp0 enable flag (0 or 1).


         * - ``ctb1-cfg-opamp0``
           - ``int``
           - .. code-block:: none

                CTB1 Opamp0 dynamic configuration selector (0-7).



         * - ``ctb1-gain-opamp0``
           - ``int``
           - .. code-block:: none

                CTB1 Opamp0 gain. Use IFX_AUTANALOG_CTB_OA_GAIN_* constants.



         * - ``ctb1-enable-opamp1``
           - ``int``
           - .. code-block:: none

                CTB1 Opamp1 enable flag (0 or 1).


         * - ``ctb1-cfg-opamp1``
           - ``int``
           - .. code-block:: none

                CTB1 Opamp1 dynamic configuration selector (0-7).



         * - ``ctb1-gain-opamp1``
           - ``int``
           - .. code-block:: none

                CTB1 Opamp1 gain. Use IFX_AUTANALOG_CTB_OA_GAIN_* constants.



         * - ``ptcomp0-unlock``
           - ``int``
           - .. code-block:: none

                PTCOMP0 unlock flag (0 or 1).
                When 1, PTCOMP0 comparator fields below take effect in this state.



         * - ``ptcomp0-enable-comp0``
           - ``int``
           - .. code-block:: none

                PTCOMP0 Comp0 enable flag (0 or 1).


         * - ``ptcomp0-dyn-cfg-idx-comp0``
           - ``int``
           - .. code-block:: none

                PTCOMP0 Comp0 dynamic configuration selector (0-7).



         * - ``ptcomp0-enable-comp1``
           - ``int``
           - .. code-block:: none

                PTCOMP0 Comp1 enable flag (0 or 1).


         * - ``ptcomp0-dyn-cfg-idx-comp1``
           - ``int``
           - .. code-block:: none

                PTCOMP0 Comp1 dynamic configuration selector (0-7).



         * - ``dac0-unlock``
           - ``int``
           - .. code-block:: none

                DAC0 unlock flag (0 or 1).
                When 1, DAC0 fields below take effect in this state.



         * - ``dac0-enable``
           - ``int``
           - .. code-block:: none

                DAC0 enable flag (0 or 1).


         * - ``dac0-trigger``
           - ``int``
           - .. code-block:: none

                DAC0 trigger flag (0 or 1).


         * - ``dac0-channel``
           - ``int``
           - .. code-block:: none

                DAC0 channel selector.


         * - ``dac0-direction``
           - ``int``
           - .. code-block:: none

                DAC0 direction. Use IFX_AUTANALOG_DAC_DIR_* constants.



         * - ``dac1-unlock``
           - ``int``
           - .. code-block:: none

                DAC1 unlock flag (0 or 1).
                When 1, DAC1 fields below take effect in this state.



         * - ``dac1-enable``
           - ``int``
           - .. code-block:: none

                DAC1 enable flag (0 or 1).


         * - ``dac1-trigger``
           - ``int``
           - .. code-block:: none

                DAC1 trigger flag (0 or 1).


         * - ``dac1-channel``
           - ``int``
           - .. code-block:: none

                DAC1 channel selector.


         * - ``dac1-direction``
           - ``int``
           - .. code-block:: none

                DAC1 direction. Use IFX_AUTANALOG_DAC_DIR_* constants.





   .. 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 "infineon,autanalog-ac-state" compatible.

      (None)