: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.



             Default value: ``0``

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



             Default value: ``0``

         * - ``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).



             Default value: ``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).



             Default value: ``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.



             Default value: ``0``

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



             Default value: ``0``

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

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



             Default value: ``0``

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

                GPIO output unlock flag (0 or 1).



             Default value: ``0``

         * - ``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).



             Default value: ``0``

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

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



             Default value: ``0``

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

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



             Default value: ``0``

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

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



             Default value: ``0``

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

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



             Default value: ``0``

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

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



             Default value: ``0``

         * - ``prb-vref0-fw``
           - ``int``
           - .. code-block:: none

                PRB Vref0 firmware control flag (0 or 1).
                When 0, the PRB output is determined by prb-vref0-tap below.
                When 1, the PRB output is determined by the tap in the static config.



             Default value: ``0``

         * - ``prb-vref0-tap``
           - ``int``
           - .. code-block:: none

                PRB Vref0 tap selector (0-15).
                Selects the resistive divider tap for Vref0 in this state.



             Default value: ``0``

         * - ``prb-vref1-fw``
           - ``int``
           - .. code-block:: none

                PRB Vref1 firmware control flag (0 or 1).
                When 0, the PRB output is determined by prb-vref1-tap below.
                When 1, the PRB output is determined by the tap in the static config.



             Default value: ``0``

         * - ``prb-vref1-tap``
           - ``int``
           - .. code-block:: none

                PRB Vref1 tap selector (0-15).
                Selects the resistive divider tap for Vref1 in this state.



             Default value: ``0``

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

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



             Default value: ``0``

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

                CTB0 Opamp0 enable flag (0 or 1).


             Default value: ``0``

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

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



             Default value: ``0``

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

                CTB0 Opamp0 gain. Use IFX_AUTANALOG_CTB_OA_GAIN_* constants.



             Default value: ``0``

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

                CTB0 Opamp1 enable flag (0 or 1).


             Default value: ``0``

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

                CTB0 Opamp1 dynamic configuration selector (0-7).



             Default value: ``0``

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

                CTB0 Opamp1 gain. Use IFX_AUTANALOG_CTB_OA_GAIN_* constants.



             Default value: ``0``

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

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



             Default value: ``0``

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

                CTB1 Opamp0 enable flag (0 or 1).


             Default value: ``0``

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

                CTB1 Opamp0 dynamic configuration selector (0-7).



             Default value: ``0``

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

                CTB1 Opamp0 gain. Use IFX_AUTANALOG_CTB_OA_GAIN_* constants.



             Default value: ``0``

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

                CTB1 Opamp1 enable flag (0 or 1).


             Default value: ``0``

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

                CTB1 Opamp1 dynamic configuration selector (0-7).



             Default value: ``0``

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

                CTB1 Opamp1 gain. Use IFX_AUTANALOG_CTB_OA_GAIN_* constants.



             Default value: ``0``

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

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



             Default value: ``0``

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

                PTCOMP0 Comp0 enable flag (0 or 1).


             Default value: ``0``

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

                PTCOMP0 Comp0 dynamic configuration selector (0-7).



             Default value: ``0``

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

                PTCOMP0 Comp1 enable flag (0 or 1).


             Default value: ``0``

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

                PTCOMP0 Comp1 dynamic configuration selector (0-7).



             Default value: ``0``

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

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



             Default value: ``0``

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

                DAC0 enable flag (0 or 1).


             Default value: ``0``

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

                DAC0 trigger flag (0 or 1).


             Default value: ``0``

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

                DAC0 channel selector.


             Default value: ``0``

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

                DAC0 direction. Use IFX_AUTANALOG_DAC_DIR_* constants.



             Default value: ``0``

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

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



             Default value: ``0``

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

                DAC1 enable flag (0 or 1).


             Default value: ``0``

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

                DAC1 trigger flag (0 or 1).


             Default value: ``0``

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

                DAC1 channel selector.


             Default value: ``0``

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

                DAC1 direction. Use IFX_AUTANALOG_DAC_DIR_* constants.



             Default value: ``0``



   .. 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)